Onerway
POST

申请或取消退款

该接口用于对已支付成功的交易发起退款,或在 Onerway 审核通过前取消已提交的退款申请。是否支持退款及申请时限取决于支付方式。

请求

merchantNo
Onerway 分配的商户号;获取方式参见接入准备。
示例:
refundType
退款操作类型:申请退款或取消已提交的退款申请。
示例:
可选值
0
申请退款。
1
取消退款申请。
约束
规则
是否支持退款、部分退款及多次退款,以及申请退款的时限,均取决于支付方式。大多数支付方式支持部分退款及多次退款。
规则
取消退款申请须在 Onerway 审核通过前发起。审核通过后,Onerway 将退款请求提交给支付渠道或发卡行;退款仍在处理中不代表仍可取消。
merchantTxnId
本次退款的商户交易号,用于跟踪和对账。
示例:
约束
规则
不传时由 Onerway 自动生成。重复提交会被拒绝。
originTransactionId
本次退款操作对应的 Onerway 交易号。
示例:
约束
规则
refundType=0(申请退款)时,传入原支付交易号;refundType=1(取消退款申请)时,传入要取消的退款交易号。
refundAmount
退款金额。
示例:
约束
一致性
退款金额使用原支付交易的币种。
一致性
累计退款金额不得超过支付金额。
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
refundType=0 时,20000 表示退款申请已受理,不代表退款成功。请处理退款结果通知或退款审核拒绝通知;未收到通知时可查询退款记录。取消退款申请(refundType=1)成功不发送通知。其他响应码见响应码。
约束
规则
大部分退款即时到账;非即时到账的退款最长需要 25 天。
respMsg
响应码对应的可读消息。
data
退款交易号。
约束
规则
refundType=0(申请退款)返回 Onerway 新创建的退款交易号;refundType=1 取消成功时,该值等于请求中的 originTransactionId。

响应示例

{
  "respCode": "20000",
  "respMsg": "Success",
  "data": "demo_refund_transaction_id"
}
该接口暂未记录错误响应。