Skip to content

查询 - Payment query

请求地址

HTTP
https://{{gateway_domain}}/pg/v2/payment/query

请求参数

HTTP Method

POST

HTTP Header

字段数据类型长度限制是否必填项说明
Content-TypeStringN/A字段值只支持 application/json
AcceptStringN/A字段值只支持 application/json
AuthorizationStringAuthorization: {type} {credentials},详情参考签名规范部分

HTTP Body

字段数据类型长度限制是否必填项说明
merchantTradeNoString50merchantTradeNo, paymentNo 二选一商户订单号
paymentNoString32merchantTradeNo, paymentNo 二选一

响应结果

HTTP Header

字段数据类型是否必填项说明
Content-TypeString字段值只支持 application/json
AuthorizationStringAuthorization: {type} {credentials},详情参考签名规范部分

HTTP Body

字段数据类型是否必填项说明
codeEnum String
message
dataJSON Object

data 字段说明

字段数据类型是否必填项说明
paymentNoString支付平台交易流水号
merchantTradeNoString商户生成的订单号
amountString订单金额
currencyEnum String订单的币种
statusEnum String详见订单状态,值映射待定
refundStatusEnum String详见订单退款状态
rrnString渠道检索参考号码,依赖渠道返回
merchantAttachString支付请求时,如使用此字段,支付平台则返回
createdTimeString订单创建时间
paidTimeString支付成功时间未支付成功返回 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部分退款