交易事件

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

交易通知webhook

交易通知webhook

POST{callbackUrl payment}

Header parameters

Body

application/json

req

dataPaymentWebhookReq

支付webhook请求

typestring

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

Example: "transaction.success"

Response

200

OK

Body

*/*response body

string

Request

JavaScriptCurlPython

const response = await fetch('{callbackUrl payment}', {
    method: 'POST',
    headers: {
      "gateway-no": "text",
      "request-id": "text",
      "request-time": "text",
      "sign-info": "text",
      "version": "text",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

200

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