退款异步通知

退款 Webhook

POST/webhook/refund

Base URLhttps://yourdomain.com/webhook/refund

退款处理完成或失败时发送的异步通知。请在商户后台配置 Dispute webhook URL，验签后返回 `OK`。

配置说明

登录商户后台，在右上角基本信息中填写 Dispute webhook URL。

Bodyapplication/x-www-form-urlencoded

memberidstringsign

平台分配的商户号。

orderidstringsign

商户订单号。

transaction_idstringsign

平台交易号。

amountstringsign

原订单金额。

refund_orderidstringsign

退款单号，alert_type 为 Refund 时返回。

refund_amountstringsign

退款金额。

alert_datetimestringsign

通知时间。

alert_contentstringsign

退款原因或失败说明。

alert_typestringsign

告警类型：Ethoca、RDR、Chargebacks 或 Refund。

alert_statusstringsign

退款结果：00 — 成功；11 — 失败。

signstring

MD5 签名算法说明

POST/webhook/refund

请求示例curl

场景SuccessFailed

curl

curl --request POST \
  --url https://yourdomain.com/webhook/refund \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data 'memberid=10153&orderid=O2026060182255&transaction_id=966782078392&amount=1.00&refund_orderid=R20260601001&refund_amount=1.00&alert_datetime=2026-06-01%2009%3A06%3A57&alert_content=Refund%20completed&alert_type=Refund&alert_status=00&sign=YOUR_SIGN'

POST/webhook/refund

处理示例PHPJavaPythonJavascriptGo

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['alert_status'] ?? '') === '00') {
  // TODO: update refund status
}

echo 'OK';