Refund

退款

请求地址：POST /api/refund

请求参数

参数	类型	必填	说明
uniqueId	String(128)	M	原交易系统返回唯一交易 ID
amount	Number(12,3)	M	退款金额
refundTransactionId	String(128)	C	商户退款 ID
remark	String(255)	C	退款备注

请求实例

{
    "uniqueId": 1604020559254036481,
    "refundTransactionId": "1234567890",
    "amount": 339.1,
    "remark": "request refund"
}

返回实例

退款申请成功

{
    "code": 110,
    "refundTransactionId": "1677816791",
    "uniqueId": "1631507932124540930",
    "refundUniqueId": "1631507992681902081",
    "refundCurrency": "USD",
    "refundAmount": "1.00",
    "refundRequestAt": "2023-03-03 13:59:15",
    "refundAt": "2023-03-03 14:02:01",
    "message": "Refund request successful",
    "timestamp": 1677816792069
}

退款申请失败

{
    "code": 112,
    "message": "The refund amount is greater than the transaction amount",
    "timestamp": 1677816881662
}

返回参数

参数	类型	必填
code	Number(3)	M	返回码,详见附录
refundTransactionId	String(128)	C	商户申请退款 ID
uniqueId	String(128)	M	退款原交易 ID
refundUniqueId	String(128)	M	系统退款订单唯一 ID
refundCurrency	String(3)	M	退款币种(CNY/USD)
refundAmount	String(12)	M	退款金额
refundRequestAt	String(20)	M	退款申请时间
refundAt	String(20)	C	退款时间
message	String(255)	O	退款返回信息
timestamp	Number	M	返回时间戳