预授权撤销(Void)
POST
/api功能描述
::: tip
可对预授权交易进行撤销操作,撤销成功后,客户被冻结的资金将被解冻。
:::
- 预授权撤销金额必须和预授权金额一样
时序图
sequenceDiagram
Merchant->>UseePay Server: 请求预授权撤销
UseePay Server->>Merchant: 返回预授权撤销结果
Merchant-->>UseePay Server: 异步通知notifyUrl预授权撤销结果
请求参数
Header 参数
Content-Type
string
必需
示例值:
application/x-www-form-urlencoded
Body 参数application/x-www-form-urlencoded
version
string
必需
max=5 调用的接口版本,固定为:1.0
示例值:
1.0
merchantNo
string
必需
max=16 商户号,由 USEEPAY 分配
示例值:
500000000007362
transactionId
string
必需
max=64 UseePay 商户订单号,建议每次请求的 transactionId 唯一,有利于后续订单查询和对账。
示例值:
202301300237532
transactionType
string
必需
max=18 交易类型: authorizationVoid
示例值:
authorizationVoid
originalTransactionId
string
必需
max=64 原始商户订单号
示例值:
202301300237532
notifyUrl
string
可选
max=512 USEEPAY 回调商户地址
示例值:
https://gatewaytest.useepay.com/notifyV2u0
echoParam
string
可选
max=256 回声参数,响应报文会原样返回
示例值:
echoParam
signType
string
必需
max=16 商户生成签名字符串所使用的签名算法类型 RSA/MD5
示例值:
MD5
sign
string
必需
max=256 商户请求参数的签名串
示例值:
decb3b9b728c7af4251acae23804939b
示例代码
返回响应
成功(200)
HTTP 状态码: 200
内容格式: JSONapplication/json
数据结构
transactionType
string
必需
max=18 交易类型: authorizationVoid
reference
string
可选
max=64 USEEPAY 订单号
echoParam
string
可选
max=256 回声参数,响应报文会原样返回
originalTransactionId
string
必需
max=64 原始预授权完成/支付商户订单号
resultCode
string
必需
max=32 业务结果(详见 业务结果码)
sign
string
必需
max=256 商户请求参数的签名串
errorCode
string
可选
错误码(详见 错误码 errorCode)
signType
string
必需
max=16 商户生成签名字符串所使用的签名算法类型 RSA/MD5
transactionId
string
必需
max=64 商户订单号,需保证在商户端不重复
merchantNo
string
必需
max=16 商户号,由 USEEPAY 分配
errorMsg
string
必需
错误码(详见 错误码 errorMsg)
示例
{
"transactionType": "authorizationVoid",
"reference": "1122305282117689132",
"echoParam": "echoParam",
"originalTransactionId": "202305280917268",
"resultCode": "succeed",
"sign": "acd54b23a7302be97efffcdd77f576d9",
"errorCode": "0000",
"signType": "MD5",
"transactionId": "202305280917403",
"merchantNo": "500000000007362",
"errorMsg": "Approved or completed successfully"
}
最后修改时间: 1 年前