异步通知

Webhook

POST/notify

支付请求中提交的 pay_notifyurl 会收到异步通知。请先验签再更新订单状态，处理成功后请返回 `OK`。

Bodyapplication/x-www-form-urlencoded

memberidstringrequiredsign

平台分配的商户号。

orderidstringrequiredsign

商户订单号。

amountstringrequiredsign

提交的订单金额。

true_amountstringrequiredsign

买家实际付款金额。

currencystringsign

支付币种。

transaction_idstringrequiredsign

平台交易号。

returncodestringrequiredsign

交易状态：00 — 成功；2 — 失败。

datetimestring, YYYYMMDDHHmmssrequiredsign

交易时间。

signstringrequired

MD5 签名算法说明

attachstring

支付请求中传入的附加备注。

POST/notify

请求示例curl

场景SuccessFailed

curl

curl --request POST \
  --url https://yourdomain.com/notify \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data 'memberid=10153&orderid=O20260601001&amount=1.00&true_amount=1.00&currency=USD&transaction_id=966782078392&returncode=00&datetime=20260601090657&sign=YOUR_SIGN&attach=note'

POST/notify

处理示例PHPJavaPythonJavascriptGo

php

<?php
$key = 'your_secret_key';
$params = $_POST;
$sign = $params['sign'] ?? '';
unset($params['sign'], $params['attach']);

ksort($params);
$parts = [];
foreach ($params as $name => $value) {
  if ($value !== '' && $value !== null) {
    $parts[] = $name . '=' . $value;
  }
}
$parts[] = 'key=' . $key;
$expected = strtoupper(md5(implode('&', $parts)));

if ($expected !== strtoupper($sign)) {
  http_response_code(400);
  exit('INVALID SIGN');
}

if (($params['returncode'] ?? '') === '00') {
  // TODO: mark order as paid
}

echo 'OK';