交易查询
演示请求地址 | http://demo.asbamboo.com/openpay-example/public/index.php/api |
---|---|
说明: 如果请求地址(url),浏览器不信任它,使用测试工具时,无法正常获取响应结果。所以,请先在浏览器受访问一下请求地址(url),确定请求地址(url)是受信任的。
字段 | 类型 | 取值范围 | 必须 | 默认值 | 说明 |
---|---|---|---|---|---|
api_name | string | api列表中支持的名称 | 必须 | trade.query | api名称 |
format | string | json | json | 表示需要接口返回什么格式的数据,仅支持json | |
version | string | api列表中支持的版本 | api版本。如果没传,表示使用最新的版本 |
字段 | 类型 | 取值范围 | 必须 | 默认值 | 说明 |
---|---|---|---|---|---|
in_trade_no | string length(32) | 当out_trade_no为空时必填 | 交易编号(聚合系统内的) | ||
out_trade_no | string length(45) | 当in_trade_no为空时必填 | 交易编号(商户端的) | ||
third_part | json() | 可选 | [] | 第三方支付平台的参数,请自行查阅相关支付平台相关文档中的参数列表 |
curl http://demo.asbamboo.com/openpay-example/public/index.php/api \
-d api_name=trade.query \
-d format=json \
-d in_trade_no= \
-d out_trade_no=2018101310270023 \
-d third_part=%7B%22limit_pay%22%3A%22no_credit%22%7D \
-d version=v1.0 \
字段名 | 类型 | 取值范围 | 说明 |
---|---|---|---|
code | string | 状态码。成功时返回'0'。 | |
data | data | 响应数据信息 见响应信息data具体字段 | |
message | string | 状态说明。成功时是"success", 错误时返回与code对应的错误信息 |
字段名 | 类型 | 取值范围 | 说明 |
---|---|---|---|
app_pay_json | string json | 手机APP调起支付渠道的参数,只有手机APP支付时才应该返回这个参数 | |
cancel_ymdhis | string date(YYYY-mm-dd HH:ii:ss) | 交易取消时间 | |
channel | string length(45) | ALIPAY_APP[支付宝APP支付] ALIPAY_PC[支付宝PC支付] ALIPAY_QRCD[支付宝扫码支付] WXPAY_APP[微信APP支付] WXPAY_H5[微信H5支付] WXPAY_QRCD[微信扫码支付] | 支付渠道 |
client_ip | string | 客户ip | |
in_trade_no | string length(32) | 交易编号 与支付请求的编号对应的聚合平台生成的交易编号 是一个全局唯一的编号 | |
out_trade_no | string length(45) | 交易编号只能是数字 | |
payed_ymdhis | string date(YYYY-mm-dd HH:ii:ss) | 交易支付成功[不可退款]时间 | |
payok_ymdhis | string date(YYYY-mm-dd HH:ii:ss) | 交易支付成功[可退款]时间 | |
qr_code | string length(200) | 二维码(买家扫商家适用),特定的支付渠道返回此参数 | |
title | string length(45) | 交易标题 | |
total_fee | int | 交易金额 单位为分 | |
trade_status | string length(45) | NOPAY[尚未支付] CANCLE[取消支付] PAYFAILED[支付失败] PAYING[正在支付] PAYOK[支付成功-可退款] PAYED[支付成功-不可退款] | 交易状态 |