Skip to main content

支付回调查询

注意

Notify URL 或 Callback URL 用于在支付完成后通知服务器交易状态

危险

请确保您已在商户后台填写 Callback URL

响应参数 ​

参数 类型 必填 描述 示例
appId 字符串 / 数字 是 商户 App ID，与商户的 client_id 相同。 234234
orderId 字符串 是 回调外层返回的订单 ID，可在解密 encryptedData 之前用于快速定位订单。 1234567890
merchantOrderId 字符串 是 回调外层返回的商户订单号，可在解密 encryptedData 之前用于快速定位订单。 1233423
encryptedData 字符串 是 需使用 CLIENT_SYMMETRIC_KEY 解密的加密数据 a83cf72884cbbb....3ddf0744646e0cf0b482

响应示例

{
  "appId": 234234,
  "orderId": "1234567890",
  "merchantOrderId": "1233423",
  "encryptedData": "e4e9ac1120ed867a7af108af8b1ab918cbec6db7b4d7c29908085a73e2b29e97547da6eae91928b3330241f1fb898eebd8c3355105fdd5c68b6ceea761f41dc3085ed888d3c0473beef128ebd208c4f60299df64a622d04d21d81513c02e2d47bfcce2a6c246eabcc1c823aaf3d9133004cf7c4c08236395a05dc19a98c33a301c8b73d4e7fd33cd911619de86dfdb45"
}

使用 CLIENT_SYMMETRIC_KEY 解密 encryptedData

对称方式解密 encryptedData，e4e9ac1120ed867a7af108af8b1ab918cbec6db7b4d7c29908085a73e2b29e97547da6eae91928b3330241f1fb898eebd8c3355105fdd5c68b6ceea761f41dc3085ed888d3c0473beef128ebd208c4f60299df64a622d04d21d81513c02e2d47bfcce2a6c246eabcc1c823aaf3d9133004cf7c4c08236395a05dc19a98c33a301c8b73d4e7fd33cd911619de86dfdb45
使用 CLIENT_SYMMETRIC_KEY，PCd1dlEmFnBXaVce06Pzp7Vike0oHnVJ

明文结果如下

{
  "data": {
      "status": "SUCCESS",
      "transaction": {
          "id": 10310,
          "amountPaid": 124.1,
          "confirmedAt": "2022-10-28T16:15:58.314Z",
          "paymentMethod": "CIMB_MY",
          "commissionFee": 3.1025,
          "remark": "Long Wan" // If its FPX related, have chance returned with buyer bank account name
      },
      "order": {
          "id": "20220918020002",
          "amount": 124.1,
          "currencyType": "MYR"
      },
      "customer": {
          "name": "114",
          "phone": "0123456789",
          "email": "longwan@gmail.com"
      }
  }
}

解密后载荷参数 ​

参数 类型 必填 描述 示例
data 对象 是 支付回调解密后的顶层对象。 {...}
data.status 字符串 是 当前交易状态。可能的值包括 PAYING、PENDING、SUCCESS 和 FAILED。 SUCCESS
data.transaction 对象 是 支付回调中的交易详情对象。 {...}
data.transaction.id 数字 是 此次回调对应的 SuperPay 交易 ID。 10310
data.transaction.amountPaid 数字 是 充值 / 支付交易总支付金额，包含交易手续费。 124.1
data.transaction.confirmedAt 字符串 / 空值 是 支付确认时间；交易成功前该值可能为 null。 2022-10-28T16:15:58.314Z
data.transaction.paymentMethod 字符串 / 空值 是 完成该笔交易所使用的支付方式代码。 CIMB_MY
data.transaction.commissionFee 数字 是 SuperPay 收取的交易手续费。 3.1025
data.transaction.payer_name 字符串 / 空值 否 支付服务商返回的付款人或买家姓名。目；其他情况为 null。 Long Wan
data.transaction.remark 字符串 / 空值 是 客户姓名或交易备注。 Long Wan
data.transaction.failedRemark 字符串 / 空值 是 经脱敏处理的拒绝或失败原因。若交易未失败，此字段为 null。 Payment expired before the user completed it.
data.order 对象 是 与该交易关联的商户原始订单信息。 {...}
data.order.id 字符串 是 创建订单时提交的商户订单 ID。 20220918020002
data.order.amount 数字 是 商户原始请求金额。 124.1
data.order.currencyType 字符串 是 订单金额的货币代码。 MYR
data.customer 对象 是 支付交易关联的客户信息。 {...}
data.customer.name 字符串 / 空值 是 客户或付款人姓名。 114
data.customer.phone 字符串 / 空值 是 客户手机号。 0123456789
data.customer.email 字符串 / 空值 是 客户邮箱地址。 longwan@gmail.com