订单查询API - 海科融通

查询订单API

业务功能
根据商户订单号或者平台订单号查询平台的具体订单信息。
微信、支付宝、银联的返回原生参数在attach参数中，请按需解析。
交互模式
后台系统调用交互模式
测试url：
http://47.95.131.62:8080/api/v1/pay/polymeric/query

请求参数(O-非必传 ,M-必传):

![](/uploads/saas/images/m_fbfb63c972049724d199d154fc7ccb08_r.png)![](/uploads/saas/images/m_27e6b2057b0407d5000bccb8b51bdeed_r.png)

参数	参数名称	类型	参数说明	样例	可空
trade_no	交易订单号	String	trade_no和out_trade_no和channel_trade_no必传其中一个，三个都传则以trade_no为准，推荐使用trade_no		O
out_trade_no	服务商交易订单号	String	服务商的交易订单编号	161018121614000624679888	O
channel_trade_no	凭证条码订单号	String	凭证条码订单号(v1.24增加)	161018121614000624679888	O

请求示例:

{
    "accessid": "cpostest",
    "out_trade_no": "20200325142120573",
    "trade_no": "AL200325141943092770216077",
    "sign": "652EEE98F0502E78C75E98C8A6BAA4C2"
}

返回参数:

参数	参数名称	类型	参数说明	样例	可空
trade_no	交易订单号	String	SaaS平台的交易订单编号		M
out_trade_no	服务商交易订单号	String	服务商的交易订单编号	161018121614000624679888	M
channel_trade_no	凭证条码订单号	String	凭证条码订单号(v1.24增加)	161018121614000624679888	M
total_amount	订单金额	String	订单总金额，以元为单位	100	M
trade_type	交易类型	String	微信支付:WX 支付宝支付:ALI 银联二维码支付:UNIONQR		M
trade_status	交易状态	String	1：交易成功 2：交易失败 3：交易进行中 4：交易超时	1	M
rate	费率	String			M
fee	手续费	String			M
error_code	错误码	String			O
error_msg	错误消息	String			O
userid	支付宝支付的用户id	String	只有该交易为支付宝类型交易时返回		O
alipay_no	支付宝平台的订单号	String	只有该交易为支付宝类型交易时返回(v1.23增加)		O
appid	微信支付的appid	String	只有该交易为微信类型交易时返回		O
openid	微信支付的用户openid	String	只有该交易为微信类型交易时返回		O
weixin_no	微信平台的订单号	String	只有该交易为微信类型交易时返回(v1.23增加)		O
trade_end_time	支付完成时间	String	微信支付宝取通道返回的支付完成时间，银联二维码取接收成功通知的时间	2019-11-18 14:11:23	O
refunded_amount	已退款金额	String	已退款金额(v1.30增加)		M
remanent_amount	剩余可退款金额	String	剩余可退款金额(v1.30增加)		M
fee_subsidy_party	手续费补贴方	String	手续费补贴方		O
pre_fee_subsidy_amount	手续费预补贴金额	String	手续费预补贴金额	1、手续费预计补贴金额是服务商上送交易费补贴金额	C
real_fee_subsidy_amount	手续费实际补贴金额	String	手续费实际补贴金额	该笔交易实际补贴金额。例如：服务商上送预计手续费补贴金额为6元，根据交易费率计算手续费为5元，则该笔交易实际补贴为5元	C
real_fee_amount	手续费实收金额	String	手续费实收金额	该笔交易手续费实收金额。例如：服务商上送预计手续费补贴金额为2元，根据交易费率计算手续费为5元，则商户手续费金额（5元）减去补贴金额（2元）等于手续费实收金额（3元）	C
real_fee_subsidy_rate	银联二维码实际营销补贴费率	String	银联二维码实际营销补贴费率	银联二维码上送营销补贴费率时为一组费率值，该数值代表我司系统计算营销补贴手续费费率值	M
market_subsidy_info	营销补贴信息	JSONArray	营销补贴信息详情		O
attach	支付宝/微信原生参数	String			O
couponInfo	优惠类信息(银联单品券时使用)	String			O
card_no	银联二维码付款卡号	String	只有该交易为银联二维码类型交易成功时返回，卡号保留前6位和后4位为明文，中间带星脱敏	622812*********1234	O
card_type	银联二维码付款卡类型	String	只有该交易为银联二维码类型交易成功时返回，01：借记卡，02：贷记卡	01	O

营销补贴信息:market_subsidy_info

参数	参数名称	类型	参数说明	样例	可空
party	营销补贴账户	String	在海科开通的营销补贴账户号		M
amt	营销补贴金额	String	营销补贴金额（单位：元）	20	M

微信原生参数:attach

参数	参数名称	类型	参数说明	样例	可空
sub_appid	子商户公众账号ID	String		wx8888888888888888	O
sub_mch_id	子商户号	String		1900000109	M
device_info	设备号	String			O
sub_openid	用户子标识	String			O
trade_type	交易类型	String	调用接口提交的交易类型，取值如下 JSAPI，NATIVE，APP，MICROPAY		M
trade_state	交易状态	String	SUCCESS-支付成功 REFUND-转入退款 NOTPAY-未支付 CLOSED-已关闭 REVOKED- 已撤销(刷卡支付) USERPAYING-用户支付中 PAYERROR-支付失败(其他原因，如银行返回失败)		M
bank_type	付款银行	String		CMC	M
promotion_detail	优惠券详情	String		“[{“amount”:100,”merchant_contribute”:”100”,”other_contribute”:”0”,”promotion_id”:”15171754411”,”type”:”DISCOUNT”,”wxpay_contribute”:”0”,”scope”:”GLOBAL”,”activity_id”:”15079378”,”name”:”翠微测试”}]”	O
total_fee	标价金额	int	订单总金额，单位为分，只能为整数	888	M
fee_type	标价币种	String		CNY	O
settlement_total_fee	应结订单金额	String	单位：分		O
cash_fee	现金支付金额	String	单位：分		M
cash_fee_type	现金支付币种	String		CNY	O
transaction_id	银联/网联订单号	String			M
out_trade_no	商户订单号	String			M
time_end	支付完成时间	String			M
trade_state_desc	交易状态描述	String			M
coupon_fee	代金券金额	String	单位：分		O

微信优惠参数:promotion_detail

参数	参数名称	类型	参数说明	样例	可空
promotion_id	券ID	String	券或者立减优惠id	109519	M
name	优惠名称	String	优惠名称	单品惠-6	O
scope	优惠范围	String	GLOBAL- 全场代金券 SINGLE- 单品优惠	SINGLE	O
type	优惠类型	String	COUPON- 代金券，需要走结算资金的充值型代金券,（境外商户券币种与支付币种一致）DISCOUNT- 优惠券，不走结算资金的免充值型优惠券，（境外商户券币种与标价币种一致	DISCOUNT	O
amount	优惠券面额	String	用户享受优惠的金额	5	M
activity_id	活动ID	String	在微信商户后台配置的批次ID	931386	M
wxpay_contribute	微信出资	String	特指由微信支付商户平台创建的优惠，出资金额等于本项优惠总金额，单位为分	0	O
merchant_contribute	商户出资	String	特指商户自己创建的优惠，出资金额等于本项优惠总金额，单位为分	0	O
other_contribute	其他出资	String	其他出资方出资金额，单位为分	7	O
goods_detail	单品列表	Json	单品信息，使用Json格式		O

单品信息:goods_detail

参数	参数名称	类型	参数说明	样例	可空
goods_id	商品编码	String	由半角的大小写字母、数字、中划线、下划线中的一种或几种组成	商品编码	M
goods_remark	商品备注	String	goods_remark为备注字段，按照配置原样返回，字段内容在微信后台配置券时进行设置。	1001	O
discount_amount	商品优惠金额	String	单品的总优惠金额，单位为：分	3	M
quantity	商品数量	String	用户购买的数量	1	M
price	商品价格	String	单位为：分。如果商户有优惠，需传输商户优惠后的单价(例如：用户对一笔100元的订单使用了商场发的纸质优惠券100-50，则活动商品的单价应为原单价-50)	528800	M

支付宝原生参数:attach

参数	参数名称	类型	参数说明	样例	可空
trade_no	银联/网联交易号	String		2013112011001000000121536	M
out_trade_no	原支付订单商户订单号	String			M
buyer_logon_id	买家支付宝账号	String		159****5620	M
trade_status	交易状态	String	交易状态：WAIT_BUYER_PAY(交易创建，等待买家付款)、TRADE_CLOSED(未付款交易超时关闭，或支付完成后全额退款)、 TRADE_SUCCESS(交易支付成功)、TRADE_FINISHED(交易结束，不可退款)		M
total_amount	订单交易金额	Price	交易的订单金额，单位为元，两位小数该参数的值为支付时传入的 total_amount		M
buyer_pay_amount	买家实付金额	String	单位：元		O
invoice_amount	交易中可给用户开具发票的金额	Price			O
alipay_store_id	支付宝店铺编号	String			O
receipt_amount	商家入账金额（未扣除手续费）	String	单位：元		O
store_id	商户门店编号	String			O
terminal_id	商户机具终端编号	String			O
fund_bill_list	资金渠道信息	JSONArray		[{“amount”:”36.00”,”fund_channel”:”ALIPAYACCOUNT”}]	O
store_name	交易门店名称	String			O
buyer_user_id	买家在支付宝的用户id	String			M
discount_goods_detail	本次交易支付所使用的单品券优惠的商品优惠信息	String		[{“goods_id”:”STANDARD1026181538”,”goods_name”:”雪碧”,”discount_amount”:”100.00”,”voucher_id”:”2015102600073002039000002D5O”}]	O
voucher_detail_list	本交易支付时使用的所有优惠券信息	JSONArray	详见下文说明		O
mdiscount_amount	商家入账金额	String	单位：元		O
discount_amount	平台优惠金额	String	单位：元		O

资金渠道信息:fund_bill_list

参数	参数名称	类型	参数说明	样例	可空
fund_channel	交易使用的资金渠道	String		ALIPAYACCOUNT	M
bank_code	银行卡支付时的银行代码	String		CEB	O
amount	该支付工具类型所使用的金额	String	单位：元		O
fund_type	渠道所使用的资金类型	String	目前只在资金渠道 (fund_channel) 是银行卡渠道(BANKCARD)的情况下才返回该信息。DEBIT_CARD:借记卡CREDIT_CARD:信用卡MIXED_CARD:借贷合一卡	DEBIT_CARD	O
real_amount	渠道实际付款金额	String	单位：元		O

优惠券信息:voucher_detail_list

参数	参数名称	类型	参数说明	可空
id	券id	String		M
name	券名称	String		M
type	类型	String	ALIPAY_FIX_VOUCHER-全场代金券 ALIPAY_DISCOUNT_VOUCHER-折扣券 ALIPAY_ITEM_VOUCHER- 单品优惠注：不排除将来新增其他类型的可能，商家接入时注意兼容性避免硬编码	M
amount	券面额	Price	优惠券面额，它应该会等于商家出资加上其他出资方出资	M
merchant_contribute	商家出资	Price	商家出资（特指发起交易的商家出资金额）	O
other_contribute	其他出资	Price	其他出资方出资金额，可能是支付宝，可能是品牌商，或者其他方，也可能是他们的一起出资	O
memo	备注	String		O

(银联二维码)couponInfo:优惠信息

参数	参数名称	类型	参数说明	样例	可空
spnsrId	出资方	String	银联作为出资方：固定填写00010000；付款方作为出资方：填写 8 位付款方机构代码商户作为出资方：填写 15 位商户代码(银联商户号)。		M
offstAmt	优惠金额	String	以分为单位		M

返回示例:

{
    "trade_no": "AL200325141943092770216077",
    "out_trade_no": "20200325141703575",
    "total_amount": "26.00",
    "trade_status": "3",
    "trade_begin_time": "2020-03-25 14:19:43",
    "userid": "2088212026361584",
    "trade_type": "ALI",
    "alipay_no": "2020032522001461581430594633",
    "channel_trade_no": "010920032514191297612MC",
    "remanent_amount": "26.00",
    "refunded_amount": "0.00",
    "return_code": 10000,
    "sign": "7C1508A311326AF6645030160A067DD0"
}

文档更新时间: 2023-09-15 10:59 作者：admin