交易查询

应用场景

根据单号进行交易查询

接口说明

请求方式

【POST】/pay/trade/query

请求参数

参数	必填	类型	说明
merchant_no	是	String(32)	商户号
out_trade_sn	三选一	String(32)	接口自定义交流水单号
trade_no	三选一	String(32)	聚合系统单号
pay_trade_no	三选一	String(32)	支付凭证【商户单号】
transaction_id	是	String(32)	支付凭证【交易单号】(微信或者支付宝生成)

返回结果

参数	必填	类型	说明
trade_state	是	String(32)	交易状态 SUCCESS 交易成功 REFUND 交易有退款 REFUND_PART 交易部分退款 REFUND_SUCCESS 交易已全额退款 CREATED 交易已创建 NOTPAY 未支付 CLOSED 已关闭 REVOKED 已撤销（付款码支付） USERPAYING 用户支付中（付款码支付） PAYERROR 支付失败(其他原因，如银行返回失败)
out_trade_sn	是	String(32)	自定义的交易流水号
trade_no	是	String(32)	平台交易单号
pay_trade_no	是	String(32)	用户支付凭证里的【商户单号】
transaction_id	是	String(32)	支付平台交易单号
merchant_no	是	String(32)	商户号
sub_appid	是	String(32)	公众号/小程序的APPID
buyer_id	是	String(32)	支付宝用户Id 或 微信sub_openid
total_amount	是	String(32)	订单总金额 单位为分
subject	是	String(32)	交易标题
payment_method	是	String(32)	支付方式 wxpay 微信支付 alipay 支付宝 unionpay 银联云闪付 jdpay 京东支付 bestpay 翼支付
trade_type	是	String(32)	交易类型 JSAPI 公众号支付 MINIAPP 小程序支付 MICROPAY 付款码支付 APP APP 支付
payer_client_ip	是	String(32)	客户端 IP
pay_time	否	String(32)	交易付款时间，UNIX 时间戳
limit_pay	否	String(32)	指定支付方式 no_credit指定不能使用信用卡支付
pay_store_id	否	String(32)	支付平台门店 Id
goods_tag	否	String(32)	附加信息 指定的优惠信息参数
attach	否	String(32)	附加信息 商户附加信息，可做扩展参数
fund_bill_list	否	JSON	交易支付使用的资金渠道 [{'fund_channel':'ALIPAYACCOUNT', 'amount':'1000', 'real_amount':'1121'}]