Appearance
查询 - Payment query
请求地址
HTTP
https://{{gateway_domain}}/pg/v2/payment/query
请求参数
HTTP Method
POST
HTTP Header
字段 | 数据类型 | 长度限制 | 是否必填项 | 说明 |
---|---|---|---|---|
Content-Type | String | N/A | 是 | 字段值只支持 application/json |
Accept | String | N/A | 是 | 字段值只支持 application/json |
Authorization | String | 是 | Authorization: {type} {credentials},详情参考签名规范部分 |
HTTP Body
字段 | 数据类型 | 长度限制 | 是否必填项 | 说明 |
---|---|---|---|---|
merchantTradeNo | String | 50 | merchantTradeNo, paymentNo 二选一 | 商户订单号 |
paymentNo | String | 32 | merchantTradeNo, paymentNo 二选一 |
响应结果
HTTP Header
字段 | 数据类型 | 是否必填项 | 说明 |
---|---|---|---|
Content-Type | String | 是 | 字段值只支持 application/json |
Authorization | String | 是 | Authorization: {type} {credentials},详情参考签名规范部分 |
HTTP Body
字段 | 数据类型 | 是否必填项 | 说明 |
---|---|---|---|
code | Enum String | 是 | |
message | |||
data | JSON Object |
data 字段说明
字段 | 数据类型 | 是否必填项 | 说明 |
---|---|---|---|
paymentNo | String | 是 | 支付平台交易流水号 |
merchantTradeNo | String | 是 | 商户生成的订单号 |
amount | String | 是 | 订单金额 |
currency | Enum String | 是 | 订单的币种 |
status | Enum String | 是 | 详见订单状态,值映射待定 |
refundStatus | Enum String | 是 | 详见订单退款状态 |
rrn | String | 否 | 渠道检索参考号码,依赖渠道返回 |
merchantAttach | String | 否 | 支付请求时,如使用此字段,支付平台则返回 |
createdTime | String | 是 | 订单创建时间 |
paidTime | String | 是 | 支付成功时间未支付成功返回 null |
示例
请求
HTTP
curl https://{{gateway_domain}}/pg/v2/payment/create \
-X POST \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H 'Authorization: V2_SHA256 appId=1111b620f93b48c5904210ff47bb1111,sign=9e494e8a91bcdd08f18ad5b2cfdbfd5654f5c00c89f8216eebd7c1637b6ce01b,timestamp=1714128828114,nonce=C7CA27DC6D55DA935DFC8450C721CC99' \
-d '{
"merchantTradeNo": "MTU-1162"
}'
响应
HTTP
HTTP/1.1 200 OK
Content-Type: application/json
Server: nginx/1.18.0
Date: Mon, 06 Mar 2024 12:00:00 GMT
Authorization: V2_SHA256 appId=1111b620f93b48c5904210ff47bb1111,sign=ac6ae72f8c46f5c2092c3dab9bb0e08b6cdb6d5e7ff8ad190499a8955d57f297,timestamp=1714128245401,nonce=28FA11BF8FD1309767551B4FD8A57BD5
{
"code": "OK",
"errorMessage": null,
"data": {
"paymentNo": "20240423221044300800001096000005",
"merchantTradeNo": "MTU-1162",
"amount": "1.00",
"currency": "INR",
"status": "PENDING",
"refundStatus": "NO_REFUND",
"rrn": "123456789",
"merchantAttach": null,
"createdTime": "2024-04-23T22:10:45+08:00",
"paidTime": null
}
}
Payment 订单状态
状态 | 说明 |
---|---|
PENDING | 待支付 |
PROCESSING | 支付中 |
PAID | 支付成功 |
FAILURE | 支付失败 |
Payment 订单退款状态
状态 | 说明 |
---|---|
NO_REFUND | 未退款 |
REFUNDING | 退款中 |
REFUNDED | 全额退款 |
PARTIAL_REFUNDED | 部分退款 |