1. 06 Webhook
YUNMO-API
  • API
    • 01 Preparations
      • 1.1 Protocol Specification
      • 1.2 Appendix
      • 1.3 Login authorization
    • 02 Customer
      • 2.1 Create Customer
      • 2.2 Query customer information
    • 03 KYC
      • 3.1 Submit KYC Information
      • 3.2 Get Liveness H5 Link
      • 3.3 Query Liveness Results
      • 3.4 Querying KYC Status
    • 04 Card
      • 4.01 Query available card samples
      • 4.02 Create virtual card
      • 4.03 Query customer card
      • 4.04 Customer card balance adjustment
      • 4.05 Customer card top-up order query
      • 4.06 Query customer card detail
      • 4.07 Destroy card
      • 4.08 Freeze card
      • 4.09 Unfreeze card
      • 4.10 Query card PAN-HTML
      • 4.11 Query card PAN
      • 4.12 Query card PIN
      • 4.13 Update phone number
      • 4.14 Update email
      • 4.15 Update card limit
      • 4.16 Bind physical card
      • 4.17 Activate physical card
    • 05 Transaction
      • 5.1 3DS Authorization Confirmation
    • 06 Webhook
      • 6.1 Notification Specification
      • 6.2 KYC callback
      • 6.3 3DS Notification
      • 6.4 Transaction Notification
    • Schemas
      • GetTokenVo
      • ApiResponse«GetTokenVo»
      • ApiRequest«GetTokenDto»
      • ApiRequest«CreateCardDto»
      • ApiRequest«CardRechargeDto»
      • ApiRequest«RechargeOrderQueryDto»
      • ApiRequest«CardDetailDto»
      • ApiRequest«CardStatusUpdateDto»
      • ApiRequest«CardPanHtmlDto»
      • ApiRequest«CardPanEncryptDto»
      • ApiRequest«CardQueryPinDto»
      • ApiRequest«CardPhoneDto»
      • ApiRequest«CardEmailDto»
      • ApiRequest«CardTradeLimitDto»
      • ApiRequest«BindCardDto»
      • ApiRequest«ActiveCardDto»
      • ApiRequest«CustomerAddDto»
      • ApiRequest«CustomerQueryDto»
      • ApiRequest«GetLivenessUrlDto»
      • ApiRequest«GetLivenessResultDto»
      • ApiRequest«KycDto»
      • ApiRequest«Confirm3DSDto»
      • CardSampleInfoVo
      • ApiRequest«Object»
      • ApiRequest«CardQueryDto»
      • ApiRequest«SubmitKycDto»
      • CreateCardDto
      • GetTokenDto
      • CardBenefitVo
      • ApiResponse«List«CardSampleInfoVo»»
      • CreateCardVo
      • ApiResponse«CreateCardVo»
      • CardQueryVo
      • ApiResponse«List«CardQueryVo»»
      • CardQueryDto
      • CardRechargeVo
      • ApiResponse«CardRechargeVo»
      • CardRechargeDto
      • RechargeOrderQueryVo
      • ApiResponse«RechargeOrderQueryVo»
      • RechargeOrderQueryDto
      • CardDetailVo
      • ApiResponse«CardDetailVo»
      • CardDetailDto
      • ApiResponse«Boolean»
      • CardStatusUpdateDto
      • ApiResponse«String»
      • CardPanHtmlDto
      • ApiEncryptVo
      • ApiResponse«ApiEncryptVo»
      • CardPanEncryptDto
      • CardQueryPinDto
      • CardPhoneDto
      • CardEmailDto
      • CardTradeLimitDto
      • BindCardVo
      • ApiResponse«BindCardVo»
      • BindCardDto
      • ActiveCardDto
      • CustomerAddVo
      • ApiResponse«CustomerAddVo»
      • CustomerAddDto
      • CustomerQueryVo
      • ApiResponse«CustomerQueryVo»
      • CustomerQueryDto
      • LivenessUrlQueryDto
      • ApiResponse«LivenessUrlQueryDto»
      • GetLivenessUrlDto
      • LivenessResultQueryDto
      • ApiResponse«LivenessResultQueryDto»
      • GetLivenessResultDto
      • SubmitKycDto
      • InHouseKycInfoVo
      • ApiResponse«InHouseKycInfoVo»
      • KycDto
      • Confirm3DSDto
  1. 06 Webhook

6.3 3DS Notification

Webhook
POST

Request

Body Params application/jsonRequired

Example
{
    "nonce": "SV4pjn9P5mk5d1Vs",
    "sign": "7caf6acc1e95a84bd05c0236744b59de",
    "merchantNo": "BU078255558",
    "requestTime": 1770874913457,
    "version": "v1.0",
    "eventType": "_3DS",
    "eventName": "3ds",
    "data": {
        "authId": "a6cf9960-f14d-443b-b087-b15d99d400f7",
        "cardId": "CDAU079134567V02",
        "customerId": "AU079134567",
        "txnAmount": "10.0000",
        "txnCurrency": "USD",
        "txnTimeStamp": 1769429446615,
        "merchantCountryCode": null,
        "terminalMerchantName": "Example Merchant",
        "authExpireTimeStamp": null,
        "authType": 2,
        "otp": "234323"
    }
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://your-api-server.com' \
--header 'Content-Type: application/json' \
--data '{
    "nonce": "SV4pjn9P5mk5d1Vs",
    "sign": "7caf6acc1e95a84bd05c0236744b59de",
    "merchantNo": "BU078255558",
    "requestTime": 1770874913457,
    "version": "v1.0",
    "eventType": "_3DS",
    "eventName": "3ds",
    "data": {
        "authId": "a6cf9960-f14d-443b-b087-b15d99d400f7",
        "cardId": "CDAU079134567V02",
        "customerId": "AU079134567",
        "txnAmount": "10.0000",
        "txnCurrency": "USD",
        "txnTimeStamp": 1769429446615,
        "merchantCountryCode": null,
        "terminalMerchantName": "Example Merchant",
        "authExpireTimeStamp": null,
        "authType": 2,
        "otp": "234323"
    }
}'

Responses

🟢200Success
text/plain
Example
OK
Modified at 2026-02-12 06:46:00
Previous
6.2 KYC callback
Next
6.4 Transaction Notification
Built with