3DS One-Time-Password
This template is triggered when a 3DS-enabled transaction is initiated.
https://<customerHost:Port>/webhook
Header
Field | Description |
---|---|
Content-Type | application/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
Fields | Description | Type |
---|---|---|
referenceCode | This 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 |
otp | This is the 3DS OTP (one time password) for the transaction. | String |
clientHashId | The unique client identifier that's generated and shared before the API handshake. | UUID |
customerHashId | The unique customer identifier that's generated on customer creation. | UUID |
walletHashId | The unique wallet identifier that's generated simultaneously with customer creation. | UUID |
cardHashId | The unique card identifier that's generated during the new/add-on card issuance. | UUID |
cardNumber | This field contains the 16-digit masked card number in the 1234-56xx-xxxx-3456 format. | String |
transactionCurrency | This field contains the three-letter ISO-4217 transaction currency code. | String |
transactionAmount | This field contains the transaction amount. | String |
merchantName | This field contains the merchant name. | String |
template | The value for this field is CARD_3DS_OTP_WEBHOOK . | String |