退款(预授权卡支付)
适用市场:ZA 南非
请求路径
对已捕获的卡支付订单发起退款,将已结算资金通过原卡退回持卡人账户。仅适用于Capture单状态 orderStatus = 2 (succeeded) 的订单。
前置条件:订单
orderStatus = 2 (succeeded)时方可调用。
⚠️ 预授权未捕获时请使用 [Cancel] 取消授权,不要调用 Refund。
请求参数
是 必填 · 否 选填
返回值
示例
请求 / 响应
适用市场:ZA 南非
请求路径/api/v2/payment/merchant/refund对已捕获的卡支付订单发起退款,将已结算资金通过原卡退回持卡人账户。仅适用于Capture单状态 orderStatus = 2 (succeeded) 的订单。
前置条件:订单
orderStatus = 2 (succeeded)时方可调用。
⚠️ 预授权未捕获时请使用 [Cancel] 取消授权,不要调用 Refund。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| originOrderNo | string | 是 | 原捕获订单的平台订单号 |
| orderId | string | 是 | 商户唯一订单号 |
| notifyUrl | string | 否 | 退款结果异步通知地址 |
| nonceStr | string | 是 | 随机字符串(参与签名) |
| requestTime | integer | 是 | Unix 秒时间戳 |
| version | string | 是 | 2.0.0.0 |
是 必填 · 否 选填
| 字段 | 说明 |
|---|---|
| orderNo | 退款订单号(PalmPay 生成) |
| orderId | 商户订单号(回显) |
| orderStatus | 1 (pending) = 异步处理中,最终结果需查询或等通知 |
| amount | 退款金额(分) |
请求 / 响应
curl 'https://open-gw-daily.palmpay-inc.com/api/v2/payment/merchant/refund' \
-H 'CountryCode: ZA' -H 'Authorization: Bearer xxx' -H 'Content-Type: application/json' \
-d '{"originOrderNo":"24260608092828582939","orderId":"testc9ffae997fc1",
"notifyUrl":"/callback","nonceStr":"xxx","requestTime":16999258500,"version":"2.0.0.0"}'{
"respCode": "00000000",
"respMsg": "success",
"status": true,
"data": {
"orderNo": "2424220903032435363613",
"orderId": "testc9ffae997fc1",
"orderStatus": 1,
"amount": 1000
}
}