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

返回时间戳

PreviousCheckoutNextSearch

Last updated