# 1.3 Virtual Account callback notification api

# Description
  • Virtual Account callback
# Request URL
  • /xxx
# Request method
  • POST
# Request params
parameter name Is it mandatory type of data length description
aggregateOrderId mandatory string 100 Merchant Order Id
transactionId mandatory string 50 PayCools Transaction ID
channelCode mandatory string 100 Used for payment callback - Channel Code
referenceNumber mandatory string 50 Used for VA - Payment reference code
amount mandatory int - Amount
transactionStatus mandatory string 50 Transaction Status:PENDING,COMPLETE,FAILED
eventName mandatory string 50 Event Name(payment.success)
sign mandatory string text Sign
createTime mandatory string - Create Time
returnTime mandatory string - Return Time
remark optional string 255 Remark
# Callback example
// va payment success callback
{
  "amount": 503700,
  "aggregateOrderId": "CCVA1653350151938813",
  "channelCode": "CEBUANA_VA",
  "createTime": "2022-05-31 09:38:06",
  "eventName": "payment.success",
  "referenceNumber": "JT20250928000001",
  "remark": "PayCools LifeTimeId payment",
  "sign": "xxxxxxxxxxxxx",
  "returnTime": "2022-05-31 09:38:06",
  "transactionId": "C1032653961085706055",
  "transactionStatus": "COMPLETE"
}

# Response example
{
  "code": 1,
  "msg": "success",
  "data": {
  }
}