POST
申请或取消退款
该接口用于对已支付成功的交易发起退款,或在 Onerway 审核通过前取消已提交的退款申请。是否支持退款及申请时限取决于支付方式。
请求
refundType退款操作类型:申请退款或取消已提交的退款申请。
示例:
0可选值
0- 申请退款。
1- 取消退款申请。
约束
- 规则
- 是否支持退款、部分退款及多次退款,以及申请退款的时限,均取决于支付方式。大多数支付方式支持部分退款及多次退款。
- 规则
- 取消退款申请须在 Onerway 审核通过前发起。审核通过后,Onerway 将退款请求提交给支付渠道或发卡行;退款仍在处理中不代表仍可取消。
merchantTxnId本次退款的商户交易号,用于跟踪和对账。
示例:
refund_demo_202606210001约束
- 规则
- 不传时由 Onerway 自动生成。重复提交会被拒绝。
originTransactionId本次退款操作对应的 Onerway 交易号。
示例:
demo_payment_transaction_id约束
- 规则
refundType=0(申请退款)时,传入原支付交易号;refundType=1(取消退款申请)时,传入要取消的退款交易号。
refundAmount退款金额。
示例:
20约束
- 一致性
- 退款金额使用原支付交易的币种。
- 一致性
- 累计退款金额不得超过支付金额。
sign请求签名字符串;生成方式详见请求签名。
curl -X POST 'https://sandbox-acq.onerway.com/v1/txn/onlineRefund' \
-H 'Content-Type: application/json' \
--data-raw '{
"merchantNo": "demo_merchantNo",
"refundType": "0",
"merchantTxnId": "demo_refund_merchant_txn_id",
"originTransactionId": "demo_payment_transaction_id",
"refundAmount": "20",
"sign": "replace_with_signature"
}'{
"respCode": "20000",
"respMsg": "Success",
"data": "demo_refund_transaction_id"
}该接口暂未记录错误响应。