交易事件

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

交易通知webhook

post

交易通知webhook

Header parameters

gateway-noanyRequired

网关号

request-idanyRequired

请求id，30分钟之内唯一

request-timeanyRequired

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

sign-infoanyRequired

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

versionanyRequired

webhook版本号

Body

支付webhook请求对象

typestringOptional

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

Example: transaction.success

Responses

200

OK

*/*

Responsestring

post

HTTPcURLJavaScriptPython

POST / HTTP/1.1
Host: {callbackUrl payment}
gateway-no: null
request-id: null
request-time: null
sign-info: null
version: null
Content-Type: application/json
Accept: */*
Content-Length: 320

{
  "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

OK

text

请求报文示例

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"，则表示通知成功，否则会继续通知