业务说明
支持的交易类型:
4.2条码支付、4.3扫码支付、4.13jsapi支付、4.14微信小程序支付、4.21聚合动态码支付、4.22小程序支付收银台下单
交易请求报文
JSON:
{
"request_type": "barcode_query_request",
"isspid": "39493002",
"pos_id": "8888888888",
"store_id": "8888888888",
"pos_seq": "2018121400000005",
"user_id": "user01",
"system_id": "8888",
"barcode_query_request": {
"pay_type": "502",
"org_pos_seq": "2018121400000001"
},
"sign": "79CB18BC49A4D60C457506EA4EF27C14"
}
XML:
<?xml version="1.0" encoding="GBK"?>
<business_trans>
<request_type>barcode_query_request</request_type>
<isspid>39493002</isspid>
<pos_id>1511300001</pos_id>
<store_id>1511300001</store_id>
<pos_seq>1511300000003</pos_seq>
<user_id>user01</user_id>
<system_id>8888</system_id>
<barcode_query_request>
<pay_type>502</pay_type>
<org_pos_seq>1511300000001</org_pos_seq>
</barcode_query_request>
</business_trans>
交易请求报文说明
节点名称 | 中文名称 | 类型 | 说明 | 是否必填 |
---|---|---|---|---|
sign | 报文签名 | String(32) | 请求报文格式为JSON时必填 计算签名方式请看2.1章节 | 可选 |
request_type | 请求类型 | String(32) | 固定值:barcode_query_request | 必填 |
isspid | 商户号 | String(8) | 翼码商户号,由翼码提供 | 必填 |
pos_id | 终端号 | String(20) | 商户自定义终端号 | 必填 |
store_id | 门店号 | String(20) | 商户自定义门店号 | 必填 |
pos_seq | 查询请求流水号 | String(32) | 可空 有值时必须同一个翼码商户号下唯一,不可重复使用,且大于12位 | 可空 |
user_id | 操作员标识 | String(20) | 操作员号 | 可空 |
system_id | 系统平台号 | String(4) | 由翼码提供 | 必填 |
barcode_query_request ->pay_type | 支付类型 | String(3) | 502:支付宝 503:微信支付 512:银联二维码 515:微信小程序 516:数字人民币 519:会员余额支付 521:聚分期 | 可空 |
barcode_query_request ->org_pos_seq | 支付请求流水号 | String(32) | 被查询的支付请求流水号 | 必填 |
交易返回报文
JSON:
{
"response_type": "barcode_query_response",
"isspid": "39493002",
"pos_id": "8888888888",
"pos_seq": "2018121400000005",
"trans_time": "20181214143957",
"pay_type": "502",
"extend": "<![CDATA[]]>",
"sys_seq": "0f041092d0ccc6ae",
"buss_discount_amt": 0,
"platform_discount_amt": 0,
"discount_amt": 0,
"mdiscount_amt": 0,
"coupon_amt": 0,
"mcard_amt": 0,
"mcoupon_amt": 0,
"point_amt": 0,
"memo": "订单备注",
"fund_freeze_stat": "",
"freeze_time": "",
"unfreeze_amt": "",
"unfreeze_time": "",
"alipay_res_info": {
"trade_no": "2018121422001429700548119225",
"out_trade_no": "0001056562600000122014",
"atu_trade_no": "2018121422001429700548119225",
"atu_out_trade_no": "0001056562600000122014",
"buy_user_id": "",
"buy_logon_id": "",
"gmt_payment": "20181214135757",
"total_fee": "1",
"receipt_amount": "1",
"invoice_amount": "1",
"buyer_pay_amount": "1",
"charge_amount": "1",
"fund_bill_list": [
{
"amount": "1",
"fund_channel": "ALIPAYACCOUNT"
},
{
"amount": "1",
"fund_channel": "COUPON"
}
],
"voucher_detail_list": [
{
"amount": "1000",
"id": "2015102600073002039000002D5O",
"memo": "学生专用优惠",
"merchant_contribute": "900",
"name": "XX超市5折优惠",
"other_contribute": "100",
"type": "ALIPAY_FIX_VOUCHER",
"discount_goods_detail": [
{
"goods_id": "STANDARD1026181538",
"goods_name": "雪碧",
"discount_amount": "10000",
"voucher_id": "2015102600073002039000002D5O"
}
]
},
{
"amount": "1000",
"id": "2015102600073002039000002D5O",
"memo": "学生专用优惠",
"merchant_contribute": "900",
"name": "XX超市5折优惠",
"other_contribute": "100",
"type": "ALIPAY_FIX_VOUCHER",
"discount_goods_detail": [
{
"goods_id": "STANDARD1026181538",
"goods_name": "雪碧",
"discount_amount": "10000",
"voucher_id": "2015102600073002039000002D5O"
}
]
}
],
"detail_error_code": "10000",
"detail_error_desc": "Success"
},
"wxpay_res_info": {
"buyer_pay_amount": 1,
"trade_no": "4200000196201812146252898537",
"out_trade_no": "2018121400000002",
"atu_trade_no": "4200000196201812146252898537",
"atu_out_trade_no": "2018121400000002",
"app_id": "wx5acb63e448b4fc22",
"mch_id": "1241109502",
"open_id": "oVTJstwEIdlt3ExaSCxF_cfdRADE",
"is_subscribe": "N",
"sub_openid": "",
"sub_is_subscribe": "",
"trade_type": "MICROPAY",
"bank_type": "CFT",
"total_fee": "1",
"coupon_fee": "",
"charge_amount": "0",
"gmt_payment": "20181214141132",
"detail_error_code": "SUCCESS",
"detail_error_desc": "OK",
"settlement_total_fee": "1",
"promotion_detail": {
"promotion_detail": [
{
"promotion_id": "109519",
"name": "单品惠-6",
"scope": "SINGLE",
"type": "DISCOUNT",
"amount": 5,
"activity_id": "931386",
"wxpay_contribute": 0,
"merchant_contribute": 0,
"other_contribute": 5,
"goods_detail": [
{
"goods_id": "a_goods1",
"goods_remark": "商品备注",
"quantity": 7,
"price": 1,
"discount_amount": 4
},
{
"goods_id": "a_goods2",
"goods_remark": "商品备注",
"quantity": 1,
"price": 2,
"discount_amount": 1
}
]
}
]
}
},
"wxapp_res_info": {
"buyer_pay_amount": 1,
"trade_no": "4200000196201812146252898537",
"out_trade_no": "2018121400000002",
"atu_trade_no": "4200000196201812146252898537",
"atu_out_trade_no": "2018121400000002",
"app_id": "wx5acb63e448b4fc22",
"mch_id": "1241109502",
"open_id": "oVTJstwEIdlt3ExaSCxF_cfdRADE",
"is_subscribe": "N",
"sub_openid": "oXI_E5KN-FJi1Hf65mWeiBF8fUlU",
"sub_is_subscribe": "",
"trade_type": "MICROPAY",
"bank_type": "CFT",
"total_fee": "1",
"coupon_fee": "",
"charge_amount": "0",
"gmt_payment": "20181214141132",
"detail_error_code": "SUCCESS",
"detail_error_desc": "OK",
"settlement_total_fee": "1",
"promotion_detail": {
"promotion_detail": [
{
"promotion_id": "109519",
"name": "单品惠-6",
"scope": "SINGLE",
"type": "DISCOUNT",
"amount": 5,
"activity_id": "931386",
"wxpay_contribute": 0,
"merchant_contribute": 0,
"other_contribute": 5,
"goods_detail": [
{
"goods_id": "a_goods1",
"goods_remark": "商品备注",
"quantity": 7,
"price": 1,
"discount_amount": 4
},
{
"goods_id": "a_goods2",
"goods_remark": "商品备注",
"quantity": 1,
"price": 2,
"discount_amount": 1
}
]
}
]
}
},
"upay_res_info": {
"trade_no": "20180504050741694554",
"out_trade_no": "1805040000021",
"atu_trade_no": "20180504050741694554",
"atu_out_trade_no": "1805040000021",
"buyer_pay_amount": "1",
"total_fee": "1",
"charge_amount": "0"
},
"ecny_res_info": {
"trade_no": "20180504050741694554",
"out_trade_no": "1805040000021",
"buyer_pay_amount": "1",
"total_fee": "1",
"receipt_fee": "1",
"charge_amount": "0",
"gmt_payment": "20210205113225",
"detail_error_code": "",
"detail_error_desc": "",
"order_status": "03"
},
"balpay_res_info": {
"trade_no": "20180504050741694554",
"out_trade_no": "1805040000021",
"total_fee": "25",
"charge_amount": "0",
"gmt_payment": "20230530105300",
"member_id": "1542"
},
"jfqpay_res_info": {
"trade_no": "20180504050741694554",
"out_trade_no": "1805040000021",
"atu_trade_no": "20180504050741694554",
"atu_out_trade_no": "1805040000021",
"total_fee": "25",
"charge_amount": "0",
"gmt_payment": "20230530105300",
"bank_code": "",
},
"result": {
"id": "0000",
"comment": "交易成功"
},
"sign": "79D928004531AE15DFA6AD7E9A6A2447"
}
XML:
<?xml version="1.0" encoding="GBK"?>
<business_trans>
<response_type>barcode_query_response</response_type>
<isspid>39493002</isspid>
<pos_id>123456789</pos_id>
<pos_seq>000000000001</pos_seq>
<sys_seq>000000000244</sys_seq>
<trans_time>20090405010104</trans_time>
<pay_type>502</pay_type>
<extend><![CDATA[扩展字段(json格式)]]></extend>
<buss_discount_amt>2</buss_discount_amt>
<platform_discount_amt>2</platform_discount_amt>
<discount_amt>0</discount_amt>
<mdiscount_amt>0</mdiscount_amt>
<coupon_amt>0</coupon_amt>
<mcard_amt>0</mcard_amt>
<mcoupon_amt>0</mcoupon_amt>
<point_amt>0</point_amt>
<memo>订单备注</memo>
<fund_freeze_stat></fund_freeze_stat>
<freeze_time></freeze_time>
<unfreeze_amt></unfreeze_amt>
<unfreeze_time></unfreeze_time>
<alipay_res_info>
<trade_no>2018111522001429701012895360</trade_no>
<out_trade_no>1811150000001</out_trade_no>
<atu_trade_no>2018111522001429701012895360</atu_trade_no>
<atu_out_trade_no>1811150000001</atu_out_trade_no>
<buy_user_id>2088123456789012</buy_user_id>
<buy_logon_id>502***@qq.com</buy_logon_id>
<total_fee>1</total_fee>
<receipt_amount>1</receipt_amount>
<invoice_amount>1</invoice_amount>
<buyer_pay_amount>1</buyer_pay_amount>
<charge_amount>0</charge_amount>
<fund_bill_list></fund_bill_list>
<gmt_payment>20181115085738</gmt_payment>
<detail_error_code></detail_error_code>
<detail_error_desc></detail_error_desc>
<voucher_detail_list>[{单品优惠信息(JOSN)}]</voucher_detail_list>
</alipay_res_info>
<wxpay_res_info>
<trade_no>4001172001201604144821605495</trade_no>
<out_trade_no>1811150000002</out_trade_no>
<atu_trade_no>4001172001201604144821605495</atu_trade_no>
<atu_out_trade_no>1811150000002</atu_out_trade_no>
<app_id>wx5acb63e448b4fc22</app_id>
<mch_id>1241109502</mch_id>
<open_id>oVTJstwEIdlt3ExaSCxF_cfdRADE</open_id>
<is_subscribe>N</is_subscribe>
<sub_openid>oVTJstwEIdlt3ExaSCxF_cfdRADE</sub_openid>
<sub_is_subscribe>N</sub_is_subscribe>
<trade_type>MICROPAY</trade_type>
<bank_type>CCB_DEBIT</bank_type>
<total_fee>1</total_fee>
<coupon_fee>0</coupon_fee>
<charge_amount>0</charge_amount>
<gmt_payment>20181115090351</gmt_payment>
<detail_error_code>SUCCESS</detail_error_code>
<detail_error_desc>OK</detail_error_desc>
<promotion_detail>[{单品优惠信息(JOSN)}]</promotion_detail>
<buyer_pay_amount>1</buyer_pay_amount>
<settlement_total_fee>1</settlement_total_fee>
</wxpay_res_info>
<wxapp_res_info>
<trade_no>4001172001201604144821605495</trade_no>
<out_trade_no>1811150000002</out_trade_no>
<atu_trade_no>4001172001201604144821605495</atu_trade_no>
<atu_out_trade_no>1811150000002</atu_out_trade_no>
<app_id>wx5acb63e448b4fc22</app_id>
<mch_id>1241109502</mch_id>
<open_id>oVTJstwEIdlt3ExaSCxF_cfdRADE</open_id>
<is_subscribe>N</is_subscribe>
<sub_openid>oXI_E5KN-FJi1Hf65mWeiBF8fUlU</sub_openid>
<sub_is_subscribe>N</sub_is_subscribe>
<trade_type>MICROPAY</trade_type>
<bank_type>CCB_DEBIT</bank_type>
<total_fee>1</total_fee>
<coupon_fee>0</coupon_fee>
<charge_amount>0</charge_amount>
<gmt_payment>20181115090351</gmt_payment>
<detail_error_code>SUCCESS</detail_error_code>
<detail_error_desc>OK</detail_error_desc>
<promotion_detail>[{单品优惠信息(JOSN)}]</promotion_detail>
<buyer_pay_amount>1</buyer_pay_amount>
<settlement_total_fee>1</settlement_total_fee>
</wxapp_res_info>
<upay_res_info>
<trade_no>20180504050741694554</trade_no>
<out_trade_no>1805040000021</out_trade_no>
<atu_trade_no>20180504050741694554</atu_trade_no>
<atu_out_trade_no>1805040000021</atu_out_trade_no>
<buyer_pay_amount>1</buyer_pay_amount>
<total_fee>1</total_fee>
<charge_amount>0</charge_amount>
</upay_res_info>
<ecny_res_info>
<trade_no>20180504050741694554</trade_no>
<out_trade_no>1805040000021</out_trade_no>
<buyer_pay_amount>1</buyer_pay_amount>
<total_fee>1</total_fee>
<receipt_fee>1</receipt_fee>
<charge_amount>0</charge_amount>
<gmt_payment>20210205113225</gmt_payment>
<detail_error_code></detail_error_code>
<detail_error_desc></detail_error_desc>
<order_status>03</order_status>"
</ecny_res_info>
<balpay_res_info>
<trade_no>20180504050741694554</trade_no>
<out_trade_no>1805040000021</out_trade_no>
<total_fee>25</total_fee>
<charge_amount>0</charge_amount>
<gmt_payment>20230530105300</gmt_payment>
<member_id>1542</member_id>
</balpay_res_info>
<jfqpay_res_info>
<trade_no>20180504050741694554</trade_no>
<out_trade_no>1805040000021</out_trade_no>
<atu_trade_no>20180504050741694554</atu_trade_no>
<atu_out_trade_no>1805040000021</atu_out_trade_no>
<total_fee>25</total_fee>
<charge_amount>0</charge_amount>
<gmt_payment>20230530105300</gmt_payment>
<bank_code></bank_code>
</jfqpay_res_info>
<result>
<id>0000</id>
<comment>成功</comment>
</result>
</business_trans>
交易返回报文说明
标准接口会因业务升级需要而新增节点,请在解析返回报文时避免新增未知节点产生的程序出错!
节点名称 | 中文名称 | 类型 | 说明 | 是否必填 |
---|---|---|---|---|
sign | 报文签名 | String(32) | 返回报文格式为JSON时必填 计算签名方式请看2.1章节 | 可选 |
response_type | 返回类型 | String(32) | 固定值:barcode_query_response | 必填 |
isspid | 商户号 | String(8) | 翼码商户号,由翼码提供 | 必填 |
pos_id | 终端号 | String(20) | 商户自定义终端号 | 必填 |
pos_seq | 查询请求流水号 | String(32) | 查询请求流水号,和请求报文相同 | 可选 |
sys_seq | 随机串号 | String(16) | 随机生成串号,仅用于日志跟踪用,不保存 | 必填 |
trans_time | 接口返回时间 | String(14) | 接口返回时间,格式:yyyyMMddHHmmss | 必填 |
pay_type | 支付类型 | String(3) | 502:支付宝 503:微信支付 512:银联二维码 515:微信小程序 516:数字人民币 519:会员余额支付 521:聚分期 当支付单为聚合动态码时,用户未扫码下单前为空 | 可空 |
extend | 扩展信息 | String | 扩展信息字段内容为json格式 预留字段后续业务扩展使用 | 可空 |
buss_discount_amt | 商家优惠金额 | String(16) | 商家优惠金额,单位为分 | 可空 |
platform_discount_amt | 平台优惠金额 | String(16) | 平台优惠金额,单位为分 | 可空 |
discount_amt | 支付宝折扣券 | String(16) | 仅支付宝时返回,单位为分 | 可空 |
mdiscount_amt | 商户优惠券 | String(16) | 仅支付宝时返回,单位为分 | 可空 |
coupon_amt | 支付宝红包 | String(16) | 仅支付宝时返回,单位为分 | 可空 |
mcard_amt | 商户店铺卡 | String(16) | 仅支付宝时返回,单位为分 | 可空 |
mcoupon_amt | 商户红包 | String(16) | 仅支付宝时返回,单位为分 | 可空 |
point_amt | 支付宝积分 | String(16) | 仅支付宝时返回,单位为分 | 可空 |
memo | 订单备注 | String(128) | 返回支付请求时内容 | 可空 |
fund_freeze_stat | 资金冻结状态 | String(2) | 01:冻结 02:解冻 空表示无此类业务 | 可空 |
freeze_time | 冻结时间 | String(14) | 格式:yyyyMMddHHmmss 空表示无此类业务 | 可空 |
unfreeze_amt | 解冻金额 | String(9) | 单位:分 | 可空 |
unfreeze_time | 解冻时间 | String(14) | 格式:yyyyMMddHHmmss | 可空 |
seller_account | 收款账户编号 | String(64) | 可空 | |
account_alias | 收款账户标识 | String(100) | 收款账户编号对应的标识,未设置标识则为空 | 可空 |
result ->id | 响应码 | String(4) | 0000:成功 9998:等待付款,需要调用支付查询交易确认结果 其它代表失败,错误信息说明见“响应码解释”字段 | 必填 |
result ->comment | 响应码解释 | String(64) | 响应码对应中文注解,用于显示提示 | 必填 |
支付宝返回以下数据 | ||||
alipay_res_info ->trade_no | 支付通道订单号 | String(64) | 直连为支付宝订单号 间连为通道订单号 | 可空 |
alipay_res_info ->out_trade_no | 支付通道商户单号 | String(64) | 直连为支付宝商户订单号 间连为请求通道订单号 | 可空 |
alipay_res_info ->atu_trade_no | ATU订单号 | String(64) | 支付宝/微信/银联订单号 客户手机支付凭证上的订单号 | 可空 |
alipay_res_info ->atu_out_trade_no | ATU商户订单号 | String(64) | 支付宝/微信/银联商户订单号 客户手机支付凭证上的商户订单号 | 可空 |
alipay_res_info ->buy_user_id | 买家支付宝用户号 | String(30) | 直连通道交易成功时候,必填 | 可空 |
alipay_res_info ->buy_logon_id | 买家支付宝帐号 | String(100) | 直连通道交易成功时候,必填 | 可空 |
alipay_res_info ->total_fee | 交易总金额 | String(16) | 直连通道交易成功时候,必填。单位为分,不支持小数点 | 可空 |
alipay_res_info ->receipt_amount | 实收金额 | String(16) | 直连通道交易成功时候,必填 | 可空 |
alipay_res_info ->invoice_amount | 交易中可给用户开具发票的金额 | String(16) | 可空 | 可空 |
alipay_res_info ->buyer_pay_amount | 买家付款的金额 | String(16) | 直连通道交易成功时候,必填,单位为分 | 可空 |
alipay_res_info ->charge_amount | 交易手续费 | String(9) | 单位为分,交易成功时必填 | 可空 |
alipay_res_info ->fund_bill_list ->amount | 支付金额 | String(16) | 支付金额 | 可空 |
alipay_res_info ->fund_bill_list ->fund_channel | 支付渠道 | String(2) | 支付宝支付渠道说明 使用xml报文时不支持,返回为空 | 可空 |
alipay_res_info ->gmt_payment | 支付完成时间 | String(14) | 支付完成时间 | 可空 |
alipay_res_info ->detail_error_code | 支付详细错误码 | String(48) | 可空 | |
alipay_res_info ->detail_error_desc | 支付详细错误码说明 | String(64) | 可空 | |
alipay_res_info ->voucher_detail_list | 单品优惠信息 | JSONArray | 本交易支付时使用的所有单品优惠信息,以JSON格式返回 详细参数见下表 | 可空 |
微信支付返回以下数据 | ||||
wxpay_res_info ->trade_no | 支付通道订单号 | String(64) | 直连为微信订单号 间连为通道订单号 | 可空 |
wxpay_res_info ->out_trade_no | 支付通道商户单号 | String(64) | 直连为微信商户订单号 间连为请求通道订单号 | 可空 |
wxpay_res_info ->atu_trade_no | ATU订单号 | String(64) | 支付宝/微信/银联订单号 客户手机支付凭证上的订单号 | 可空 |
wxpay_res_info ->atu_out_trade_no | ATU商户订单号 | String(64) | 支付宝/微信/银联商户订单号 客户手机支付凭证上的商户订单号 | 可空 |
wxpay_res_info ->app_id | 服务商公众号ID | String(32) | 直连通道交易成功时候,必填 | 可空 |
wxpay_res_info ->mch_id | 服务商商户号 | String(32) | 直连通道交易成功时候,必填 | 可空 |
wxpay_res_info ->open_id | 用户相对服务商公众号标识 | String(128) | 直连通道交易成功时候,必填 | 可空 |
wxpay_res_info ->is_subscribe | 是否已关注服务商公众帐号 | String(1) | 直连通道交易成功时候,必填 Y-已关注 N-未关注 | 可空 |
wxpay_res_info ->sub_openid | 用户相对子商户公众号标识 | String(128) | 可空 | |
wxpay_res_info ->sub_is_subscribe | 是否已关注子商户公众帐号 | String(1) | Y-已关注 N-未关注 | 可空 |
wxpay_res_info ->trade_type | 交易类型 | String(16) | 直连通道交易成功时候,必填 | 可空 |
wxpay_res_info ->bank_type | 付款银行 | String(16) | 直连通道交易成功时候,必填 | 可空 |
wxpay_res_info ->total_fee | 总金额 | String(64) | 直连通道交易成功时候,必填 | 可空 |
wxpay_res_info ->coupon_fee | 代金券金额 | String(64) | 直连通道交易成功时候,必填 | 可空 |
wxpay_res_info ->charge_amount | 交易手续费 | String(9) | 单位为分,交易成功时必填 | 可空 |
wxpay_res_info ->gmt_payment | 支付完成时间 | String(14) | 直连通道交易成功时候,必填 | 可空 |
wxpay_res_info ->detail_error_code | 支付详细错误码 | String(48) | 直连通道交易成功时候,必填 | 可空 |
wxpay_res_info ->detail_error_desc | 支付详细错误码说明 | String(128) | 直连通道交易成功时候,必填 | 可空 |
wxpay_res_info ->promotion_detail | 单品优惠信息 | JSON | 本次交易支付的单品优惠信息,以JSON格式返回 详细参数见下表 | 可空 |
wxpay_res_info ->buyer_pay_amount | 买家实付金额 | String(16) | 直连通道交易成功时候,必填,单位为分 | 可空 |
wxpay_res_info ->settlement_total_fee | 应结订单金额 | String(16) | 单位为分 当订单使用了免充值型优惠券后返回该参数,应结订单金额=订单金额-免充值优惠券金额。 | 可空 |
微信小程序支付返回以下数据 | ||||
wxapp_res_info ->trade_no | 支付通道订单号 | String(64) | 直连为微信订单号 间连为通道订单号 | 可空 |
wxapp_res_info ->out_trade_no | 支付通道商户单号 | String(64) | 直连为微信商户订单号 间连为请求通道订单号 | 可空 |
wxapp_res_info ->atu_trade_no | ATU订单号 | String(64) | 支付宝/微信/银联订单号 客户手机支付凭证上的订单号 | 可空 |
wxapp_res_info ->atu_out_trade_no | ATU商户订单号 | String(64) | 支付宝/微信/银联商户订单号 客户手机支付凭证上的商户订单号 | 可空 |
wxapp_res_info ->app_id | 服务商公众号ID | String(32) | 直连通道交易成功时候,必填 | 可空 |
wxapp_res_info ->mch_id | 服务商商户号 | String(32) | 直连通道交易成功时候,必填 | 可空 |
wxapp_res_info ->open_id | 用户相对服务商公众号标识 | String(128) | 直连通道交易成功时候,必填 | 可空 |
wxapp_res_info ->is_subscribe | 是否已关注服务商公众帐号 | String(1) | 直连通道交易成功时候,必填 Y-已关注 N-未关注 | 可空 |
wxapp_res_info ->sub_openid | 用户相对子商户公众号标识 | String(128) | 直连通道交易成功时候,必填 | 可空 |
wxapp_res_info ->sub_is_subscribe | 是否已关注子商户公众帐号 | String(1) | 直连通道交易成功时候,必填 Y-已关注 N-未关注 | 可空 |
wxapp_res_info ->trade_type | 交易类型 | String(16) | 直连通道交易成功时候,必填 | 可空 |
wxapp_res_info ->bank_type | 付款银行 | String(16) | 直连通道交易成功时候,必填 | 可空 |
wxapp_res_info ->total_fee | 总金额 | String(64) | 直连通道交易成功时候,必填 | 可空 |
wxapp_res_info ->coupon_fee | 代金券金额 | String(64) | 直连通道交易成功时候,必填 | 可空 |
wxapp_res_info ->charge_amount | 交易手续费 | String(9) | 单位为分,交易成功时必填 | 可空 |
wxapp_res_info ->gmt_payment | 支付完成时间 | String(14) | 直连通道交易成功时候,必填 | 可空 |
wxapp_res_info ->detail_error_code | 支付详细错误码 | String(48) | 直连通道交易成功时候,必填 | 可空 |
wxapp_res_info ->detail_error_desc | 支付详细错误码说明 | String(128) | 直连通道交易成功时候,必填 | 可空 |
wxapp_res_info ->promotion_detail | 单品优惠信息 | JSON | 本次交易支付的单品优惠信息,以JSON格式返回 详细参数见下表 | 可空 |
wxapp_res_info ->buyer_pay_amount | 买家实付金额 | String(16) | 直连通道交易成功时候,必填,单位为分 | 可空 |
wxapp_res_info ->settlement_total_fee | 应结订单金额 | String(16) | 单位为分 当订单使用了免充值型优惠券后返回该参数,应结订单金额=订单金额-免充值优惠券金额。 | 可空 |
银联二维码返回以下数据 | ||||
upay_res_info ->trade_no | 支付通道订单号 | String(64) | 直连为银联订单号 间连为通道订单号 | 可空 |
upay_res_info ->out_trade_no | 支付通道商户单号 | String(64) | 直连为银联商户订单号 间连为请求通道订单号 | 可空 |
upay_res_info ->atu_trade_no | ATU订单号 | String(64) | 支付宝/微信/银联订单号 客户手机支付凭证上的订单号 | 可空 |
upay_res_info ->atu_out_trade_no | ATU商户订单号 | String(64) | 支付宝/微信/银联商户订单号 客户手机支付凭证上的商户订单号 | 可空 |
upay_res_info ->buyer_pay_amount | 买家实付金额 | String(16) | 直连通道交易成功时候,必填,单位为分 | 可空 |
upay_res_info ->total_fee | 订单总金额 | String(9) | 单位为分 标准银联/合利宝/星POS通道,交易成功时候,必填 | 可空 |
upay_res_info ->charge_amount | 交易手续费 | String(9) | 单位为分,交易成功时必填 | 可空 |
数字人民币返回以下数据 | ||||
ecny_res_info ->trade_no | 平台订单号 | String(64) | 直连通道交易成功时候,必填 | 可空 |
ecny_res_info ->out_trade_no | 支付商户订单号 | String(64) | 直连通道交易成功时候,必填 | 可空 |
ecny_res_info ->buyer_pay_amount | 买家付款的金额 | String(16) | 直连通道交易成功时候,必填,单位为分 | 可空 |
ecny_res_info ->total_fee | 订单金额 | String(64) | 直连通道交易成功时候,必填 | 可空 |
ecny_res_info ->receipt_fee | 实付金额 | String(64) | 直连通道交易成功时候,必填 | 可空 |
ecny_res_info ->charge_amount | 交易手续费 | String(9) | 单位为分,交易成功时必填 | 可空 |
ecny_res_info ->gmt_payment | 交易时间 | String(64) | 直连通道交易成功时候,必填 | 可空 |
ecny_res_info ->order_status | 原始订单的状态 | String(64) | 01:订单创建,02:用户支付中,03:已关闭,04:部分退款,05:全部退款,06:交易成功 | 可空 |
ecny_res_info ->detail_error_code | 通道原始应答码,直连通道交易成功时候 | String(64) | 直连通道交易失败时候 | 可空 |
ecny_res_info ->detail_error_desc | 通道原始应答说明,直连通道交易成功时候 | String(64) | 直连通道交易失败时候 | 可空 |
会员余额支付返回以下数据 | ||||
balpay_res_info ->trade_no | 支付平台订单号 | String(64) | 可空 | |
balpay_res_info ->out_trade_no | 支付商户订单号 | String(64) | 可空 | |
balpay_res_info ->total_fee | 订单总金额 | String(9) | 单位为分 | 可空 |
balpay_res_info ->charge_amount | 交易手续费 | String(9) | 单位为分,交易成功时必填 | 可空 |
balpay_res_info ->gmt_payment | 支付完成时间 | String(14) | 格式:yyyyMMddHHmmss | 可空 |
balpay_res_info ->member_id | 会员id | String(9) | 可空 | |
聚分期返回以下数据 | ||||
jfqpay_res_info ->trade_no | 支付平台订单号 | String(64) | 可空 | |
jfqpay_res_info ->out_trade_no | 支付商户订单号 | String(64) | 可空 | |
jfqpay_res_info ->atu_trade_no | ATU订单号 | String(64) | 支付宝/微信/银联订单号 客户手机支付凭证上的订单号 | 可空 |
jfqpay_res_info ->atu_out_trade_no | ATU商户订单号 | String(64) | 支付宝/微信/银联商户订单号 客户手机支付凭证上的商户订单号 | 可空 |
jfqpay_res_info ->total_fee | 订单总金额 | String(9) | 单位为分 | 可空 |
jfqpay_res_info ->charge_amount | 交易手续费 | String(9) | 单位为分,交易成功时必填 | 可空 |
jfqpay_res_info ->gmt_payment | 支付完成时间 | String(14) | 格式:yyyyMMddHHmmss | 可空 |
jfqpay_res_info ->bank_code | 发卡行编码 | String(20) | 可空 |
标准接口会因业务升级需要而新增节点,请在解析返回报文时避免新增未知节点产生的程序出错!
voucher_detail_list 优惠券信息 (JSONArray)
JSON节点 | 类型 | 说明 | 是否必填 | 范例 |
---|---|---|---|---|
id | String(32) | 券id | 必填 | 2015102600073002039000002D5O |
name | String(64) | 券名称 | 必填 | xx超市5折优惠 |
type | String(32) | 当前有三种类型: ALIPAY_FIX_VOUCHER - 全场代金券 ALIPAY_DISCOUNT_VOUCHER - 折扣券 ALIPAY_ITEM_VOUCHER - 单品优惠 注:不排除将来新增其他类型的可能,商家接入时注意兼容性避免硬编码 | 必填 | ALIPAY_FIX_VOUCHER |
amount | String(16) | 优惠券面额,它应该会等于商家出资加上其他出资方出资,单位为分 | 必填 | 1000 |
merchant_contribute | String(16) | 商家出资(特指发起交易的商家出资金额,单位为分) | 可空 | 900 |
other_contribute | String(16) | 其他出资方出资金额,可能是支付宝,可能是品牌商,或者其他方,也可能是他们的一起出资,单位为分 | 可空 | 100 |
memo | String(256) | 优惠券备注信息 | 可空 | 学生专用优惠 |
discount_goods_detail | Array | 单品信息 | 必填 | |
discount_goods_detail ->goods_id | String(32) | 商品的编号 | 必填 | apple-01 |
discount_goods_detail ->goods_name | String(256) | 商品名称 | 必填 | ipad |
discount_goods_detail ->discount_amount | String(16) | 优惠金额,单位为分 | 必填 | 200000 |
discount_goods_detail ->voucher_id | String(32) | 优惠券id | 必填 | 2015102600073002039000002D5O |
voucher_detail_list 样例:
[
{
"amount":"1000",
"id":"2015102600073002039000002D5O",
"memo":"学生专用优惠",
"merchant_contribute":"900",
"name":"XX超市5折优惠",
"other_contribute":"100",
"type":"ALIPAY_FIX_VOUCHER",
"discount_goods_detail":[
{
"goods_id":"STANDARD1026181538",
"goods_name":"雪碧",
"discount_amount":"10000",
"voucher_id":"2015102600073002039000002D5O"
}
]
},
{
"amount":"1000",
"id":"2015102600073002039000002D5O",
"memo":"学生专用优惠",
"merchant_contribute":"900",
"name":"XX超市5折优惠",
"other_contribute":"100",
"type":"ALIPAY_FIX_VOUCHER",
"discount_goods_detail":[
{
"goods_id":"STANDARD1026181538",
"goods_name":"雪碧",
"discount_amount":"10000",
"voucher_id":"2015102600073002039000002D5O"
}
]
}
]
promotion_detail 优惠活动信息 (JSON)
JSON节点 | 类型 | 说明 | 是否必填 | 范例 |
---|---|---|---|---|
promotion_detail | Array | promotion_detail | 必填 |
promotion_detail 优惠活动信息
JSON节点 | 类型 | 说明 | 是否必填 | 范例 |
---|---|---|---|---|
promotion_id | String(32) | 券或者立减优惠id | 必填 | 109519 |
name | String(64) | 优惠名称 | 可空 | 单品惠-6 |
scope | String(32) | 优惠范围 GLOBAL - 全场代金券 SINGLE - 单品优惠 | 可空 | SINGLE |
type | String(32) | 优惠类型 COUPON - 代金券,需要走结算资金的充值型代金券,(境外商户券币种与支付币种一致) DISCOUNT - 优惠券,不走结算资金的免充值型优惠券,(境外商户券币种与标价币种一致) | 可空 | DISCOUNT |
amount | Number(16) | 优惠券面额,用户享受的优惠的金额 | 必填 | 5 |
activity_id | String(32) | 活动ID 在微信商户后台配置的批次ID | 必填 | 931386 |
wxpay_contribute | Number(16) | 微信出资(特指由微信支付商户平台创建的优惠,出资金额等于本项优惠总金额,单位为分) | 可空 | 0 |
merchant_contribute | Number(16) | 商家出资(特指商户自己创建的优惠,出资金额等于本项优惠总金额,单位为分) | 可空 | 0 |
other_contribute | Number(16) | 其他出资方出资金额,单位为分 | 可空 | 5 |
goods_detail | Array | 单品列表 | 可空 | |
goods_detail ->goods_id | String(32) | 商品编码 | 必填 | a_goods1 |
goods_detail ->goods_remark | String(128) | 商品备注 | 可选 | 1001 |
goods_detail ->discount_amount | Number(16) | 商品优惠金额,单位为分 | 必填 | 100 |
goods_detail ->quantity | Number(10) | 商品数量 | 必填 | 1 |
goods_detail ->price | Number(16) | 商品价格,单位为分 如果商户有优惠,需传输商户优惠后的单价(例如:用户对一笔100元的订单使用了商场发的纸质优惠券100-50,则活动商品的单价应为原单价-50) | 必填 | 528800 |
promotion_detail 样例:
{
"promotion_detail": [
{
"promotion_id": "109519",
"name": "单品惠-6",
"scope": "SINGLE",
"type": "DISCOUNT",
"amount": 5,
"activity_id": "931386",
"wxpay_contribute": 0,
"merchant_contribute": 0,
"other_contribute": 5,
"goods_detail": [
{
"goods_id": "a_goods1",
"goods_remark": "商品备注",
"quantity": 7,
"price": 1,
"discount_amount": 4
},
{
"goods_id": "a_goods2",
"goods_remark": "商品备注",
"quantity": 1,
"price": 2,
"discount_amount": 1
}
]
}
]
}