订单预授权完成(Capture)
全球收单-SandBox环境
https://pay-gateway1.uat.useepay.com
全球收单-SandBox环境
https://pay-gateway1.uat.useepay.com
POST
/api
功能说明
注意
Top2:预授权完成最好在3个工作日内完成，否则万事达卡会被加收0.033欧元+0.28%的手续费，同时，超过3天的预授权拒付是无法申诉的。
时序图
Response响应参数说明
| 字段 | 长度 | 描述 | 是否必要 |
|---|---|---|---|
| merchantNo | max=16 | max=16 商户编号，由 USEEPAY 分配 | yes |
| transactionId | max=64 | 商户订单号，需保证在商户端不重复 | yes |
| originalTransactionId | max=64 | 原始预授权的商户订单号 | yes |
| transactionType | max=18 | 交易类型：capture | yes |
| reference | max=32 | USEEPAY 订单号 | |
| amount | max=12 | 支付金额，单位为对应币种的最小货币单位金额和货币单位 | yes |
| currency | max=3 | 3 位 ISO 大写字母货币代码金额和货币单位 | yes |
| resultCode | max=32 | 业务结果（业务结果码（ResultCode））判断交易是否成功的依据 | yes |
| errorCode | max=4 | 错误码（详见 错误码 errorCode） | |
| errorMsg | max=256 | 错误码消息描述 | |
| echoParam | max=256 | 回声参数，响应报文会原样返回 | |
| sign | max=256 | 签名 | yes |
请求参数
Header 参数
Body 参数application/x-www-form-urlencoded
返回响应
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://pay-gateway1.uat.useepay.com/api' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'version=1.0' \
--data-urlencode 'merchantNo=500000000007362' \
--data-urlencode 'transactionId={% mock '\''uuid'\'' %}' \
--data-urlencode 'transactionType=capture' \
--data-urlencode 'amount=1234' \
--data-urlencode 'originalTransactionId={% mock '\''uuid'\'' %}' \
--data-urlencode 'signType=MD5' \
--data-urlencode 'echoParam=' \
--data-urlencode 'notifyUrl=https://gatewaytest.useepay.com/notifyV2u0' \
--data-urlencode 'sign=82b04931f07474ec423510207c461d74'响应示例响应示例
{
"amount": "100",
"resultCode": "succeed",
"sign": "8a6a0792f318a29d7232ad3af05437e3",
"errorCode": "0000",
"transactionId": "202305281007042",
"errorMsg": "Approved or completed successfully",
"transactionType": "capture",
"reference": "1112305282207689135",
"echoParam": "echoParam",
"originalTransactionId": "202305281006558",
"signType": "MD5",
"currency": "USD",
"merchantNo": "500000000007362"
}修改于 2025-09-02 11:09:48