3DS One-Time-Password

This template is triggered when a 3DS-enabled transaction is initiated.

https://<customerHost:Port>/webhook

Header

FieldDescription
Content-Typeapplication/json

Request example

curl --location --request POST 'https://<customerHost:Port>/webhook' \
-H 'content-type: application/json' \
-d '{
      "referenceCode": "DWP",
      "otp":"112233",
      "clientHashId":"0498f10f-1968-494f-9f7a-454ed23942a0",
      "customerHashId":"2e096369-d93d-424b-93b8-1e7e14399b44",
      "cardHashId":"04390049-f005-4909-a307-9db59ca6e207",
      "cardNumber":"4001-35xx-xxxx-1950",        
      "transactionCurrency":"SGD",
      "transactionAmount":"10.00",
      "merchantName":"Frankie Tibbs",
      "template":"CARD_3DS_OTP_WEBHOOK"
}'

Request body

FieldsDescriptionType
referenceCodeThis is a unique value generated with each new OTP value . In the instance where the consumer can receive multiple OTPs for the same transaction, this field can be leveraged to show the consumer which specific OTP is expected to be entered. This value should be sent in the SMS or Email along with the OTP and then displayed on the consumer screen.String
otpThis is the 3DS OTP (one time password) for the transaction.String
clientHashIdThe unique client identifier that's generated and shared before the API handshake.UUID
customerHashIdThe unique customer identifier that's generated on customer creation.UUID
walletHashIdThe unique wallet identifier that's generated simultaneously with customer creation.UUID
cardHashIdThe unique card identifier that's generated during the new/add-on card issuance.UUID
cardNumberThis field contains the 16-digit masked card number in the 1234-56xx-xxxx-3456 format.String
transactionCurrencyThis field contains the three-letter ISO-4217 transaction currency code.String
transactionAmountThis field contains the transaction amount.String
merchantNameThis field contains the merchant name.String
templateThe value for this field is CARD_3DS_OTP_WEBHOOK.String