获取用户的支付记录
接口
GET /hserve/v2.2/idp/pay/order/
请求参数
参数 | 类型 | 说明 |
---|---|---|
merchandise_record_id | string | 商品记录 ID,可用于定位用户购买的物品 |
merchandise_schema_id | integer | 商品表 ID,可用于定位用户购买的物品 |
status | string | 订单支付状态,可选值有:pending(待支付)、success(支付成功) |
refund_status | string | 订单退款状态,可选值有:complete(退款成功)、partial(部分退款)、failed(退款失败)、' '(空字符串,订单没有发生退款操作时的默认状态) |
trade_no | string | 真正的交易 ID, 业务方在微信后台对账时可看到此字段 |
transaction_no | string | 知晓云平台所记录的流水号 |
gateway_type | string | 支付方法,可选值有:weixin_tenpay(微信支付)、alipay(支付宝支付) |
请求示例
curl -X GET \
-H "X-Hydrogen-Client-ID: [[client_id]]" \
-H "Authorization: Hydrogen-r1 {{AccessToken}}" \
-H "Content-Type: application/json" \
-G \
--data-urlencode 'status=success' \
https://{{服务器域名}}/hserve/v2.2/idp/pay/order/
返回参数说明
部分关键字段:
参数 | 类型 | 说明 |
---|---|---|
created_at | integer | 订单创建时间 |
merchandise_description | string | 微信支付-微信支付凭证-商品详情上的文字描述 |
paid_at | integer | 付款时间, 未支付的话为 null |
status | string | 订单支付状态 |
refund_status | string | 退款状态 |
total_cost | integer | 发起交易请求时的支付金额 |
trade_no | string | 真正的交易 ID, 业务方在微信后台对账时可看到此字段 |
transaction_no | string | 知晓云平台所记录的流水号 |
gateway_extra_info | String | 支付结果返回信息 |
返回实例
{
"meta": {
"limit": 20,
"next": "/hserve/v2.2/idp/pay/order/?limit=20&offset=20",
"offset": 0,
"previous": null,
"total_count": 2
},
"objects": [
{
"created_at": 1497524129,
"gateway_extra_info": {},
"id": 5,
"ip_address": "127.0.0.1",
"merchandise_description": "",
"merchandise_record_id": null,
"merchandise_schema_id": null,
"merchandise_snapshot": {},
"paid_at": null,
"status": "success",
"refund_status": null,
"total_cost": 100.00,
"trade_no": "1dLSQzzjRcJshqosJCeNruA******",
"transaction_no": "DEqbLRjWWtCqjxOUapRxaLb******",
"updated_at": 1497524129,
"created_by_id": 1091431,
},
{
"created_at": 1497524130,
"gateway_extra_info": {},
"id": 6,
"ip_address": "127.0.0.1",
"merchandise_description": "",
"merchandise_record_id": null,
"merchandise_schema_id": null,
"merchandise_snapshot": {},
"paid_at": null,
"status": "success",
"refund_status": null,
"total_cost": 100.00,
"trade_no": "1dLSR0EopQfRVkbLFrRNFKT*********",
"transaction_no": "znVAJaEKrwriaTlwjDlVdLZ*********",
"updated_at": 1497524130,
"created_by_id": 1091431,
}
]
}
支付结果返回信息 gateway_extra_info 参数说明
gateway_extra_info 目前只支持 gateway_type == 'weixin_tenpay'
(微信支付)时,返回支付成功后回调的订单详细信息。
gateway_extra_info 返回的数据结构如下:
{
"gateway_extra_info": {
"wechat_response": {
"appid": "wx3b040d33346exxxx",
"bank_type": "OTHERS",
"cash_fee": "1",
"fee_type": "CNY",
"is_subscribe": "N",
"mch_id": "1501889000",
"nonce_str": "1jFEJyNvEkr2IePMYXOeUEOHP11eXXXX",
"openid": "om4vu0FZiwoQbTVAt0U-FEzXXXXX",
"out_trade_no": "1jFEJyxlAuqzAtGcd4uuNxJwMS1TXXXX",
"result_code": "SUCCESS",
"return_code": "SUCCESS",
"sign": "AB329F580E6E342246350DFE96AEXXXX",
"time_end": "20200320175220",
"total_fee": "1",
"trade_type": "JSAPI",
"transaction_id": "4200000519202003205153312216"
}
}
}
wechat_response 中部分关键字段:
参数 | 类型 | 说明 |
---|---|---|
appid | String | 微信分配的小程序ID |
bank_type | String | 银行类型,采用字符串类型的银行标识,银行类型见银行列表 |
total_fee | String | 订单总金额,单位为分 |
is_subscribe | String | 用户是否关注公众账号,Y-关注,N-未关注 |
fee_type | String | 货币类型,符合ISO4217标准的三位字母代码,默认人民币:CNY,其他值列表详见货币类型 |
具体返回参数详情可参照微信支付结果通知
状态码说明
200
: 查询成功
400
: 参数错误