交易请求报文
<?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>
交易请求报文说明
| 节点名称 | 中文名称 | 类型 | 说明 | 是否必填 |
|---|---|---|---|---|
| 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:微信支付 504:翼支付 507:和包支付 508:和包验证码支付 512:银联二维码 514:招行掌上生活 515:微信小程序 516:数字人民币 519:会员余额支付 传空时自动识别 | 可空 |
| barcode_query_request ->org_pos_seq | 需要查询的支付交易流水号 | String(32) | 需要查询的支付交易流水号,且大于12位 | 必填 |
交易返回报文
<?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><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><seller_account>20880000000000</seller_account><account_alias></account_alias><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><fund_bill_list><trade_fund_bill><amount>1</amount><fund_channel>00</fund_channel></trade_fund_bill></fund_bill_list><gmt_payment></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>oVTJstwEIDlO3EsHScxc_cfqpFDE</open_id><is_subscribe>N</is_subscribe><sub_openid>oVTJstwEIDlO3EsHScxc_cfqpFDE</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><gmt_payment>20181115090351</gmt_payment><detail_error_code>SUCCESS</detail_error_code><detail_error_desc>OK</detail_error_desc><promotion_detail>[{单品优惠信息(JOSN)}]</promotion_detail></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>oVTJstwEIDlO3EsHScxc_cfqpFDE</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><gmt_payment>20181115090351</gmt_payment><detail_error_code>SUCCESS</detail_error_code><detail_error_desc>OK</detail_error_desc><promotion_detail>[{单品优惠信息(JOSN)}]</promotion_detail></wxapp_res_info><yzf_res_info><transNo></transNo><orderSeq></orderSeq><orderReqSeq></orderReqSeq><orderDate></orderDate><channel></channel><transAmt></transAmt><transStatus></transStatus><settleDate></settleDate><payAccount></payAccount><bankName></bankName><openBranch></openBranch><openProvince></openProvince><merchantName></merchantName></yzf_res_info><cmpay_res_info><trade_no></trade_no><out_trade_no>0001034843100000001963</out_trade_no><bank_type></bank_type><total_fee>2</total_fee><coupon_fee>0</coupon_fee><vch_fee>0</vch_fee><cash_fee>2</cash_fee><time_end>20160726</time_end><detail_error_code></detail_error_code><detail_error_desc></detail_error_desc><buyer_pay_amount>1</buyer_pay_amount></cmpay_res_info><umpay_res_info><trade_no></trade_no><out_trade_no>0001034843100000001964</out_trade_no><total_fee></total_fee><coupon_fee></coupon_fee><detail_error_code></detail_error_code><detail_error_desc></detail_error_desc><refund_fee>0</refund_fee></umpay_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><total_fee>1</total_fee></upay_res_info><cmb_res_info><trade_no>190418134820292638937088</trade_no><out_trade_no>201904151090222222</out_trade_no><buyer_pay_amount>900</buyer_pay_amount><totalamt>4000</totalamt><bonuspoint>0</bonuspoint><receivableamt>3200</receivableamt><commissionamt>0</commissionamt><invoiceamt>1900</invoiceamt><couponamt>2000</couponamt><couponcmbsubsidyamt>600</couponcmbsubsidyamt><couponmersubsidyamt>400</couponmersubsidyamt><coupons>543641756355,591770022507</coupons><actualamt>900</actualamt><randomdiscountamt>0</randomdiscountamt><fulldiscountamt>600</fulldiscountamt><fulldiscountmersubsidyamt>400</fulldiscountmersubsidyamt><fulldiscountcmbsubsidyamt>200</fulldiscountcmbsubsidyamt><voucheramt>500</voucheramt><vouchercmbsubsidyamt>500</vouchercmbsubsidyamt><vouchermersubsidyamt>0</vouchermersubsidyamt><coupondetail>[{优惠券详情(JOSN)}]</coupondetail></cmb_res_info><ecny_res_info><trade_no>20180504050741694554</trade_no><out_trade_no>1805040000021</out_trade_no><total_fee></total_fee></ecny_res_info><balpay_res_info><trade_no>20180504050741694554</trade_no><out_trade_no>1805040000021</out_trade_no><total_fee></total_fee></balpay_res_info><result><id>0000</id><comment>成功</comment></result></business_trans>
交易返回报文说明
标准接口会因业务升级需要而新增节点,请在解析返回报文时避免新增未知节点产生的程序出错!
| 节点名称 | 中文名称 | 类型 | 说明 | 是否必填 |
|---|---|---|---|---|
| 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:微信支付 504:翼支付 507:和包支付 508:和包验证码支付 512:银联二维码 514:招行掌上生活 515:微信小程序 516:数字人民币 519:会员余额支付 当支付单为聚合动态码时,用户未扫码下单前为空 | 可空 |
| 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) | 仅支付宝时返回,单位为分 | 可空 |
| 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 ->fund_bill_list ->trade_fund_bill ->amount | 支付金额 | String(16) | 支付金额 | 可空 |
| alipay_res_info ->fund_bill_list ->trade_fund_bill ->fund_channel | 支付渠道 | String(2) | 支付渠道 | 可空 |
| 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 | 单品优惠信息 | String | 本交易支付时使用的所有单品优惠信息,以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 | 微信公众帐号 | 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 ->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 | 单品优惠信息 | String | 本次交易支付的单品优惠信息,以JSON格式返回 详细参数见下表 | 可空 |
| 微信小程序的时候 | 返回以下数据 | |||
| wxapp_res_info ->trade_no | 支付通道订单号 | String(64) | 直连为微信订单号 间连为通道订单号 | 可空 |
| wxpay_res_wxapp_res_infoinfo ->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 | 微信公众帐号 | 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 ->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 | 单品优惠信息 | String | 本次交易支付的单品优惠信息,以JSON格式返回 详细参数见下表 | 可空 |
| 翼支付支付的时候 | 返回以下数据 | |||
| yzf_res_info ->transNo | 网关平台流水号 | n30 | 交易成功时候,必填 | 可空 |
| yzf_res_info ->orderSeq | 商户总订单号 | an30 | 交易成功时候,必填 | 可空 |
| yzf_res_info ->orderReqSeq | 商户总订单请求流水号 | an30 | 交易成功时候,必填 | 可空 |
| yzf_res_info ->orderDate | 商户总订单日期 | n14 | YYYYMMDDHHmmss | 可空 |
| yzf_res_info ->channel | 接入渠道 | n2 | 01:WEB 02:WAP 04:语音 05:客户端 | 可空 |
| yzf_res_info ->transAmt | 交易金额 | n30 | 单位:分 | 可空 |
| yzf_res_info ->transStatus | 交易状态 | n | A:请求 B:成功 C:失败 G:作废 | 可空 |
| yzf_res_info ->settleDate | 清算日期 | n8 | YYYYMMDD | 可空 |
| yzf_res_info ->payAccount | 银行卡号或账号 | n30 | 可空 | |
| yzf_res_info ->bankName | 银行名称 | ans50 | 可空 | |
| yzf_res_info ->openBranch | 开户支行 | ans50 | 可空 | |
| yzf_res_info ->openProvince | 开户省份 | ans50 | 可空 | |
| yzf_res_info ->merchantName | 商户名称 | ans50 | 交易成功时候,必填 | 可空 |
| 和包支付的时候 | 返回以下数据 | |||
| cmpay_res_info ->out_trade_no | 支付交易请求流水 | String(64) | 交易成功时候,必填 | 可空 |
| cmpay_res_info ->total_fee | 总金额 | String(64) | 交易成功时候,必填 | 可空 |
| cmpay_res_info ->coupon_fee | 电子券消费金额 | String(64) | 交易成功时候,必填 | 可空 |
| cmpay_res_info ->vch_fee | 代金券消费金额 | String(64) | 交易成功时候,必填 | 可空 |
| cmpay_res_info ->cash_fee | 现金消费金额 | String(64) | 交易成功时候,必填 | 可空 |
| cmpay_res_info ->time_end | 支付完成日期 | String(8) | 交易成功时候,必填 | 可空 |
| cmpay_res_info ->buyer_pay_amount | 买家实付金额 | String(16) | 交易成功时候,必填,单位为分 | 可空 |
| 和包验证码支付的时候 | 返回以下数据 | |||
| umpay_res_info ->out_trade_no | 支付交易请求流水 | String(64) | 交易成功时候,必填 | 可空 |
| 银联二维码的时候 | 返回以下数据 | |||
| 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) | 支付宝/微信/银联商户订单号 客户手机支付凭证上的商户订单号 | 可空 |
| upay_res_info ->total_fee | 订单总金额 | String(9) | 单位为分 标准银联/合利宝/星POS通道,交易成功时候,必填 | 可空 |
| 招行掌上生活的时候 | 返回以下数据 | |||
| cmb_res_info ->trade_no | 支付平台处理流水 | String(64) | 交易成功时候,必填 | 可空 |
| cmb_res_info ->out_trade_no | 商户订单号 | String(64) | 交易成功时候,必填 | 可空 |
| cmb_res_info ->buyer_pay_amount | 买家实付金额 | String(16) | 交易成功时候,必填,单位为分 | 可空 |
| cmb_res_info ->totalamt | 订单总金额 | String(20) | 交易成功时候,必填,单位分 | 可空 |
| cmb_res_info ->bonuspoint | 订单积分 | String(20) | 交易成功时候,必填 | 可空 |
| cmb_res_info ->receivableamt | 商户应收金额 | String(20) | 交易成功时候,必填,单位分 | 可空 |
| cmb_res_info ->commissionamt | 佣金 | String(20) | 交易成功时候,必填,单位分 | 可空 |
| cmb_res_info ->invoiceamt | 发票金额 | String(20) | 交易成功时候,必填,单位分 | 可空 |
| cmb_res_info ->couponamt | 代金券抵扣金额 | String(20) | 交易成功时候,必填,单位分 | 可空 |
| cmb_res_info ->couponcmbsubsidyamt | 代金券招行补贴金额 | String(20) | 交易成功时候,必填,单位分 | 可空 |
| cmb_res_info ->couponmersubsidyamt | 代金券商户补贴金额 | String(20) | 交易成功时候,必填,单位分 | 可空 |
| cmb_res_info ->coupons | 优惠券 | String(200) | 交易成功时候,必填,多张券码逗号分隔 | 可空 |
| cmb_res_info ->actualamt | 客户实际支付金额 | String(20) | 交易成功时候,必填,单位分 | 可空 |
| cmb_res_info ->randomdiscountamt | 随机立减金额 | String(20) | 交易成功时候,必填,单位分 | 可空 |
| cmb_res_info ->fulldiscountamt | 满减优惠金额 | String(20) | 交易成功时候,必填,单位分 | 可空 |
| cmb_res_info ->fulldiscountmersubsidyamt | 满减商户总补贴 | String(20) | 交易成功时候,必填,单位分 | 可空 |
| cmb_res_info ->fulldiscountcmbsubsidyamt | 满减招行总补贴 | String(20) | 交易成功时候,必填,单位分 | 可空 |
| cmb_res_info ->voucheramt | 抵扣券优惠金额 | String(20) | 交易成功时候,必填,单位分 | 可空 |
| cmb_res_info ->vouchercmbsubsidyamt | 抵扣券招行补贴 | String(20) | 交易成功时候,必填,单位分 | 可空 |
| cmb_res_info ->vouchermersubsidyamt | 抵扣券商户补贴 | String(20) | 交易成功时候,必填,单位分 | 可空 |
| cmb_res_info ->coupondetail | 优惠券详情 | String | 交易成功时候,必填,以JSON格式返回 | 可空 |
| 数字人民币的时候 | 返回以下数据 | |||
| ecny_res_info ->trade_no | 支付平台处理流水 | String(64) | 交易成功时候,必填 | 可空 |
| ecny_res_info ->out_trade_no | 商户订单号 | String(64) | 交易成功时候,必填 | 可空 |
| ecny_res_info ->total_fee | 订单总金额 | String(9) | 单位为分 交易成功时候,必填 | 可空 |
| 会员余额支付的时候 | 返回以下数据 | |||
| balpay_res_info ->trade_no | 支付平台订单号 | String(64) | 可空 | |
| balpay_res_info ->out_trade_no | 支付商户订单号 | String(64) | 可空 | |
| balpay_res_info ->total_fee | 订单总金额 | String(9) | 单位为分 | 可空 |
标准接口会因业务升级需要而新增节点,请在解析返回报文时避免新增未知节点产生的程序出错!
交易返回参数附表
voucher_detail_list优惠券信息 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 | String | 单品信息 | 必填 | |
| 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 |
json样例:
[{"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体参数:
| 参数 | 类型 | 说明 | 是否必填 | 范例 |
|---|---|---|---|---|
| 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 | String | 单品列表 | 可空 | |
| 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 |
json样例:
{"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}]}]}


