退款

退款 API 支持全额退款和多次部分退款

退款

POST BASE_URL/api

Headers

Name	Type	Description
content-type*	String	application/x-www-form-urlencoded

Request Body

Name	Type	Description
version*	String	max=5 调用的接口版本，固定为：1.0
merchantNo*	String	max=16 商户号，由 USEEPAY 分配
transactionId*	String	max=64 商户订单号，建议每次请求的 transactionId 唯一，有利于后续订单查询和对账。
transactionType*	String	max=18 交易类型：refund
originalTransactionId*	String	max=64 原始预授权完成/支付商户订单号
amount*	String	max=12 订单金额（必须大于 0），单位为对应币种的最小货币单位(详见 ISO 4217)
currency*	String	max=3 3 位 ISO 大写字母货币代码(详见 ISO 4217)。退款币种需与正向交易币种相同
signType*	String	max=4 商户生成签名字符串所使用的签名算法类型
sign*	String	max=256 商户请求参数的签名串
notifyUrl	String	USEEPAY 回调商户地址

200: OK

{
    "amount": "1", 
    "resultCode": "pending",
    "sign": "035bfd3acf5732e6ce9c9f772bf85158",
    "errorCode": "0000",
    "transactionId": "202110141059261", // 商户订单号，需保证在商户端不重复
    "errorMsg": "Approved or completed successfully",
    "transactionType": "refund", // 交易类型：refund
    "reference": "1062110141059650859", 
    "echoParam": "echoParam",
    "originalTransactionId": "202110141054086",
    "reserved": "reserved",
    "signType": "MD5",
    "currency": "USD",
    "merchantNo": "500000000007381" // 商户编号，由 USEEPAY 分配
}

Response

version	max=5 调用的接口版本，固定为：1.0
merchantNo	max=16 商户编号，由 USEEPAY 分配
transactionId	max=64商户订单号，需保证在商户端不重复
transactionType	max=18 交易类型：refund
reference	max=32USEEPAY 订单号
amount	max=12 支付金额，单位为对应币种的最小货币单位(详见 ISO 4217)
currency	max=3 3 位 ISO 大写字母货币代码(详见 ISO 4217)
resultCode	max=32 业务结果（详见 业务结果码）
errorCode	max=4 错误码（详见 错误码 errorCode）
errorMsg	max=256 错误码消息描述
echoParam	max=256 回声参数，响应报文会原样返回
reserved	max=256 预留字段，值同请求报文
sign	max=256 商户请求参数的签名串