代付通知

POST/payout/notify

Base URLhttps://yourdomain.com/payout/notify

代付完成后异步通知到创建代付时提交的 notifyurl。请先验签再更新订单状态，处理成功后请返回 `OK`。

Bodyapplication/x-www-form-urlencoded

memberidstringsign

平台分配的商户号。

out_trade_nostringsign

商户代付订单号。

transaction_idstringsign

平台交易号。

amountstringsign

申请代付金额。

actualamountstringsign

实际到账金额。

original_amountstringsign

扣费前原始代付金额。

datetimeintsign

交易时间（Unix 秒级时间戳）。

transferMessagestringsign

转账结果说明。

statusstringsign

代付状态：SUCCESS 或 FAIL。

signstring

MD5 签名算法说明

POST/payout/notify

请求示例

场景

curl

curl --request POST \
  --url https://yourdomain.com/payout/notify \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data 'memberid=10010&out_trade_no=O20260601001&transaction_id=257354624363&amount=10.00&actualamount=9.80&original_amount=10.00&datetime=1722318667&transferMessage=Transfer%20successful&status=SUCCESS&sign=YOUR_SIGN'

POST/payout/notify

处理示例

php

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

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['status'] ?? '') === 'SUCCESS') {
  // TODO: mark payout as completed
}

echo 'OK';