交易事件

交易完成后，或者交易状态变更时，会触发交易事件的通知

交易通知webhook

交易通知webhook

post

{callbackUrl payment}

Header parameters

gateway-noanyrequired

网关号

request-idanyrequired

请求id，30分钟之内唯一

request-timeanyrequired

时间戳，以毫秒（ms）为单位，请求误差不能超过10分钟

sign-infoanyrequired

验签字段，具体验签方式请参阅数据签名过程章节

versionanyrequired

webhook版本号

Body

dataobject

事件数据对象

typestring

webhook事件类型 transaction.success:交易成功事件； transaction.fail:交易失败事件； transaction.pending:交易待处理事件； transaction.clear:交易清算事件

Example: transaction.success

Responses

*/*

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url '{callbackUrl payment}' \
  --header 'Content-Type: application/json' \
  --data '{
    "data": {
      "orderAmount": 100.12,
      "orderCurrency": "USD",
      "orderInfo": "orderInfo",
      "orderNo": 12167001000000000000,
      "orderStatus": "success",
      "remark": "remark",
      "riskInfo": {
        "riskDetails": [
          {
            "passStatus": 1,
            "riskDescription": "sourceUrl=0.0;"
          }
        ]
      },
      "tradeNo": 2.0210507155918938e+21,
      "transactionType": "remark"
    },
    "type": "transaction.success"
  }'

200

200

text

OK

请求报文示例

webhook.sh

curl --request POST \
  --url https://{callbackUrl payment} \
  --header 'Content-Type: application/json' \
  --header 'request-id: 58675' \
  --header 'request-time: 1651888520935' \
  --header 'gateway-no: 12345001' \
  --header 'version: V2022-03' \
  --header 'sign-info: 787966BF2479A1BE8E1886CD18E6919447FAF4F357E7056188D4F035661B822B' \
  --data '{
    "data": {
        "transactionType": "Sale",
        "orderAmount": "63.65",
        "orderNo": "NEW_API9985936096881",
        "tradeNo": "2022051811043674149462",
        "orderCurrency": "EUR",
        "orderInfo": "Transaction Approved",
        "orderStatus": "success",
        "remark": "TEST"
    },
    "type": "transaction.success"
}'

{callbackUrl payment} 地址为交易时填写的 callbackUrl 参数

商户收到该事件通知后，返回"success"，则表示通知成功，否则会继续通知