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.4 Transaction Notification

Webhook
POST

Request

Body Params application/jsonRequired

Example
{
  "nonce": "QqD0LtTiz6V8slPz",
  "sign": "d9978ded84a099d8a1aba28560ed1671",
  "merchantNo": "BU078255558",
  "requestTime": 1770119513457,
  "version": "v1.0",
  "eventType": "TRADE",
  "eventName": "trade",
  "data": {
    "orderNo": "OR260203023701CL6252",
    "subOrderNo": "SU260203023701CL6027",
    "cardId": "CDAU079126648V01",
    "eventType": null,
    "subType": null,
    "status": null,
    "subStatus": null,
    "amount": "5700.00",
    "currency": "PHP",
    "principal": "96.78",
    "refund": null,
    "refundFee": null,
    "reversal": null,
    "reversalFee": null,
    "atmFee": "0.00",
    "authorizationFee": "0.00",
    "fxFee": "0.0000",
    "serviceFee": "0.00",
    "cardFixedAmount": null,
    "eventTime": "2026-01-20 03:18:23",
    "terminalMerchantId": null,
    "terminalMerchantName": null,
    "terminalMerchantCountry": "PH",
    "terminalMerchantCity": null,
    "terminalMerchantMccCode": null,
    "terminalMerchantMccCategory": null,
    "terminalMerchantPostCode": null,
    "transactionCategory": null,
    "transactionChannel": null,
    "channelPrincipal": "96.78",
    "channelRefund": null,
    "channelRefundFee": null,
    "channelAtmFee": "0.00",
    "channelFixedAmount": null
  }
}

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": "QqD0LtTiz6V8slPz",
  "sign": "d9978ded84a099d8a1aba28560ed1671",
  "merchantNo": "BU078255558",
  "requestTime": 1770119513457,
  "version": "v1.0",
  "eventType": "TRADE",
  "eventName": "trade",
  "data": {
    "orderNo": "OR260203023701CL6252",
    "subOrderNo": "SU260203023701CL6027",
    "cardId": "CDAU079126648V01",
    "eventType": null,
    "subType": null,
    "status": null,
    "subStatus": null,
    "amount": "5700.00",
    "currency": "PHP",
    "principal": "96.78",
    "refund": null,
    "refundFee": null,
    "reversal": null,
    "reversalFee": null,
    "atmFee": "0.00",
    "authorizationFee": "0.00",
    "fxFee": "0.0000",
    "serviceFee": "0.00",
    "cardFixedAmount": null,
    "eventTime": "2026-01-20 03:18:23",
    "terminalMerchantId": null,
    "terminalMerchantName": null,
    "terminalMerchantCountry": "PH",
    "terminalMerchantCity": null,
    "terminalMerchantMccCode": null,
    "terminalMerchantMccCategory": null,
    "terminalMerchantPostCode": null,
    "transactionCategory": null,
    "transactionChannel": null,
    "channelPrincipal": "96.78",
    "channelRefund": null,
    "channelRefundFee": null,
    "channelAtmFee": "0.00",
    "channelFixedAmount": null
  }
}'

Responses

🟢200Success
text/plain
Example
OK
Modified at 2026-02-12 06:46:06
Previous
6.3 3DS Notification
Next
GetTokenVo
Built with