订单查询Query
全球收单-SandBox环境
https://pay-gateway1.uat.useepay.com
全球收单-SandBox环境
https://pay-gateway1.uat.useepay.com
POST
/api
功能描述
时序图
Response 参数对象说明
| 参数 | 说明 | 是否必须 |
|---|---|---|
| merchantNo | max=16 商户编号，由 USEEPAY 分配 | true |
| resultCode | max=32本次查询的业务结果（详见 业务结果码） | true |
| errorCode | max=4本次查询的错误码 | false |
| errorMsg | max=256本次查询的错误码消息描述 | false |
| transactionInfo | 交易信息。resultCode=xxxx 的时候有返回 | |
| reserved | max=256预留字段，值同请求报文 | false |
| echoParam | max=256 回声参数，响应报文会原样返回 | false |
| sign | max=256商户请求参数的签名串 | true |
transactionInfo 参数对象说明
| 参数 | 描述 | 是否必须 |
|---|---|---|
| transactionId | max=64商户订单号 | true |
| originalTransactionId | max=64 原始商户订单号 | |
| reference | max=32USEEPAY 订单号 | false |
| transactionType | max=64 pay； authorization; refund; capture;authorizationVoid; | true |
| amount | max=12交易金额，单位为对应币种的最小货币单位(详见 ISO 4217) | false |
| currency | max=33 位 ISO 大写字母货币代码(详见 ISO 4217) | false |
| arn | max=128 ARN | false |
| settlement | List集合 支付成功的订单的结算信息 | false |
| resultCode | max=32业务结果（详见 业务结果码） | true |
| errorCode | max=4错误码（详见 错误码 errorCode） | false |
| errorMsg | max=256错误码消息描述 | false |
settlement 参数对象说明
| 参数 | 描述 | 是否必须 |
|---|---|---|
| settlementCurrency | max=3 结算币种 | false |
| settlementRate | max=12 结算汇率 | false |
| settlementCurrency | max=12 结算金额 | false |
请求参数
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=202301300237522' \
--data-urlencode 'transactionType=query' \
--data-urlencode 'reference=202301300237522' \
--data-urlencode 'notifyUrl=https://gatewaytest.useepay.com/gateway-test/redirectV2u0' \
--data-urlencode 'signType=MD5' \
--data-urlencode 'sign=decb3b9b728c7af4251acae23804939b' \
--data-urlencode 'echoParam=echoParam'响应示例响应示例
成功示例
{
"echoParam": "echoParam",
"resultCode": "succeed",
"sign": "26e12b8a690f9d4584d19272359a5520",
"signType": "MD5",
"errorCode": "0000",
"merchantNo": "500000000008901",
"errorMsg": "Successful payment",
"transactionInfo": "{\"transactionType\":\"pay\",\"reference\":\"1012404081006710607\",\"amount\":\"1111\",\"originalTransactionId\":\"\",\"resultCode\":\"succeed\",\"errorCode\":\"0000\",\"currency\":\"USD\",\"arn\":\"6612404081006710607\",\"transactionId\":\"202404081006163\",\"settlement\":[{\"settlementCurrency\":\"USD\",\"settlementRate\":\"1\",\"settlementAmount\":\"11.11\"}],\"errorMsg\":\"Successful payment\"}"
}修改于 2025-10-14 10:58:45