交易请求报文

  1. <?xml version="1.0" encoding="GBK"?>
  2. <business_trans>
  3. <request_type>barcode_query_request</request_type>
  4. <isspid>39493002</isspid>
  5. <pos_id>1511300001</pos_id>
  6. <store_id>1511300001</store_id>
  7. <pos_seq>1511300000003</pos_seq>
  8. <user_id>user01</user_id>
  9. <system_id>8888</system_id>
  10. <barcode_query_request>
  11. <pay_type>502</pay_type>
  12. <org_pos_seq>1511300000001</org_pos_seq>
  13. </barcode_query_request>
  14. </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位必填

交易返回报文

  1. <?xml version="1.0" encoding="GBK"?>
  2. <business_trans>
  3. <response_type>barcode_query_response</response_type>
  4. <isspid>39493002</isspid>
  5. <pos_id>123456789</pos_id>
  6. <pos_seq>000000000001</pos_seq>
  7. <sys_seq>000000000244</sys_seq>
  8. <trans_time>20090405010104</trans_time>
  9. <pay_type>502</pay_type>
  10. <buss_discount_amt>2</buss_discount_amt>
  11. <platform_discount_amt>2</platform_discount_amt>
  12. <discount_amt>0</discount_amt>
  13. <mdiscount_amt>0</mdiscount_amt>
  14. <coupon_amt>0</coupon_amt>
  15. <mcard_amt>0</mcard_amt>
  16. <mcoupon_amt>0</mcoupon_amt>
  17. <point_amt>0</point_amt>
  18. <alipay_res_info>
  19. <trade_no>2018111522001429701012895360</trade_no>
  20. <out_trade_no>1811150000001</out_trade_no>
  21. <atu_trade_no>2018111522001429701012895360</atu_trade_no>
  22. <atu_out_trade_no>1811150000001</atu_out_trade_no>
  23. <buy_user_id>2088123456789012</buy_user_id>
  24. <buy_logon_id>502***@qq.com</buy_logon_id>
  25. <total_fee>1</total_fee>
  26. <receipt_amount>1</receipt_amount>
  27. <invoice_amount>1</invoice_amount>
  28. <buyer_pay_amount>1</buyer_pay_amount>
  29. <fund_bill_list>
  30. <trade_fund_bill>
  31. <amount>1</amount>
  32. <fund_channel>00</fund_channel>
  33. </trade_fund_bill>
  34. </fund_bill_list>
  35. <gmt_payment></gmt_payment>
  36. <detail_error_code></detail_error_code>
  37. <detail_error_desc></detail_error_desc>
  38. <voucher_detail_list>[{单品优惠信息(JOSN)}]</voucher_detail_list>
  39. </alipay_res_info>
  40. <wxpay_res_info>
  41. <trade_no>4001172001201604144821605495</trade_no>
  42. <out_trade_no>1811150000002</out_trade_no>
  43. <atu_trade_no>4001172001201604144821605495</atu_trade_no>
  44. <atu_out_trade_no>1811150000002</atu_out_trade_no>
  45. <app_id>wx5acb63e448b4fc22</app_id>
  46. <mch_id>1241109502</mch_id>
  47. <open_id>oVTJstwEIDlO3EsHScxc_cfqpFDE</open_id>
  48. <is_subscribe>N</is_subscribe>
  49. <sub_openid>oVTJstwEIDlO3EsHScxc_cfqpFDE</sub_openid>
  50. <sub_is_subscribe>N</sub_is_subscribe>
  51. <trade_type>MICROPAY</trade_type>
  52. <bank_type>CCB_DEBIT</bank_type>
  53. <total_fee>1</total_fee>
  54. <coupon_fee>0</coupon_fee>
  55. <gmt_payment>20181115090351</gmt_payment>
  56. <detail_error_code>SUCCESS</detail_error_code>
  57. <detail_error_desc>OK</detail_error_desc>
  58. <promotion_detail>[{单品优惠信息(JOSN)}]</promotion_detail>
  59. </wxpay_res_info>
  60. <wxapp_res_info>
  61. <trade_no>4001172001201604144821605495</trade_no>
  62. <out_trade_no>1811150000002</out_trade_no>
  63. <atu_trade_no>4001172001201604144821605495</atu_trade_no>
  64. <atu_out_trade_no>1811150000002</atu_out_trade_no>
  65. <app_id>wx5acb63e448b4fc22</app_id>
  66. <mch_id>1241109502</mch_id>
  67. <open_id>oVTJstwEIDlO3EsHScxc_cfqpFDE</open_id>
  68. <is_subscribe>N</is_subscribe>
  69. <sub_openid>oXI_E5KN-FJi1Hf65mWeiBF8fUlU</sub_openid>
  70. <sub_is_subscribe>N</sub_is_subscribe>
  71. <trade_type>MICROPAY</trade_type>
  72. <bank_type>CCB_DEBIT</bank_type>
  73. <total_fee>1</total_fee>
  74. <coupon_fee>0</coupon_fee>
  75. <gmt_payment>20181115090351</gmt_payment>
  76. <detail_error_code>SUCCESS</detail_error_code>
  77. <detail_error_desc>OK</detail_error_desc>
  78. <promotion_detail>[{单品优惠信息(JOSN)}]</promotion_detail>
  79. </wxapp_res_info>
  80. <yzf_res_info>
  81. <transNo></transNo>
  82. <orderSeq></orderSeq>
  83. <orderReqSeq></orderReqSeq>
  84. <orderDate></orderDate>
  85. <channel></channel>
  86. <transAmt></transAmt>
  87. <transStatus></transStatus>
  88. <settleDate></settleDate>
  89. <payAccount></payAccount>
  90. <bankName></bankName>
  91. <openBranch></openBranch>
  92. <openProvince></openProvince>
  93. <merchantName></merchantName>
  94. </yzf_res_info>
  95. <cmpay_res_info>
  96. <trade_no></trade_no>
  97. <out_trade_no>0001034843100000001963</out_trade_no>
  98. <bank_type></bank_type>
  99. <total_fee>2</total_fee>
  100. <coupon_fee>0</coupon_fee>
  101. <vch_fee>0</vch_fee>
  102. <cash_fee>2</cash_fee>
  103. <time_end>20160726</time_end>
  104. <detail_error_code></detail_error_code>
  105. <detail_error_desc></detail_error_desc>
  106. <buyer_pay_amount>1</buyer_pay_amount>
  107. </cmpay_res_info>
  108. <umpay_res_info>
  109. <trade_no></trade_no>
  110. <out_trade_no>0001034843100000001964</out_trade_no>
  111. <total_fee></total_fee>
  112. <coupon_fee></coupon_fee>
  113. <detail_error_code></detail_error_code>
  114. <detail_error_desc></detail_error_desc>
  115. <refund_fee>0</refund_fee>
  116. </umpay_res_info>
  117. <upay_res_info>
  118. <trade_no>20180504050741694554</trade_no>
  119. <out_trade_no>1805040000021</out_trade_no>
  120. <atu_trade_no>20180504050741694554</atu_trade_no>
  121. <atu_out_trade_no>1805040000021</atu_out_trade_no>
  122. <total_fee>1</total_fee>
  123. </upay_res_info>
  124. <cmb_res_info>
  125. <trade_no>190418134820292638937088</trade_no>
  126. <out_trade_no>201904151090222222</out_trade_no>
  127. <buyer_pay_amount>900</buyer_pay_amount>
  128. <totalamt>4000</totalamt>
  129. <bonuspoint>0</bonuspoint>
  130. <receivableamt>3200</receivableamt>
  131. <commissionamt>0</commissionamt>
  132. <invoiceamt>1900</invoiceamt>
  133. <couponamt>2000</couponamt>
  134. <couponcmbsubsidyamt>600</couponcmbsubsidyamt>
  135. <couponmersubsidyamt>400</couponmersubsidyamt>
  136. <coupons>543641756355,591770022507</coupons>
  137. <actualamt>900</actualamt>
  138. <randomdiscountamt>0</randomdiscountamt>
  139. <fulldiscountamt>600</fulldiscountamt>
  140. <fulldiscountmersubsidyamt>400</fulldiscountmersubsidyamt>
  141. <fulldiscountcmbsubsidyamt>200</fulldiscountcmbsubsidyamt>
  142. <voucheramt>500</voucheramt>
  143. <vouchercmbsubsidyamt>500</vouchercmbsubsidyamt>
  144. <vouchermersubsidyamt>0</vouchermersubsidyamt>
  145. <coupondetail>[{优惠券详情(JOSN)}]</coupondetail>
  146. </cmb_res_info>
  147. <ecny_res_info>
  148. <trade_no>20180504050741694554</trade_no>
  149. <out_trade_no>1805040000021</out_trade_no>
  150. <total_fee></total_fee>
  151. </ecny_res_info>
  152. <balpay_res_info>
  153. <trade_no>20180504050741694554</trade_no>
  154. <out_trade_no>1805040000021</out_trade_no>
  155. <total_fee></total_fee>
  156. </balpay_res_info>
  157. <result>
  158. <id>0000</id>
  159. <comment>成功</comment>
  160. </result>
  161. </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)仅支付宝时返回,单位为分可空
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
商户总订单日期n14YYYYMMDDHHmmss可空
yzf_res_info
->channel
接入渠道n201:WEB
02:WAP
04:语音
05:客户端
可空
yzf_res_info
->transAmt
交易金额n30单位:分可空
yzf_res_info
->transStatus
交易状态nA:请求
B:成功
C:失败
G:作废
可空
yzf_res_info
->settleDate
清算日期n8YYYYMMDD可空
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体参数:

参数类型说明是否必填范例
idString(32)券id必填2015102600073002039000002D5O
nameString(64)券名称必填xx超市5折优惠
typeString(32)当前有三种类型:
ALIPAY_FIX_VOUCHER - 全场代金券
ALIPAY_DISCOUNT_VOUCHER - 折扣券
ALIPAY_ITEM_VOUCHER - 单品优惠
注:不排除将来新增其他类型的可能,商家接入时注意兼容性避免硬编码
必填ALIPAY_FIX_VOUCHER
amountString(16)优惠券面额,它应该会等于商家出资加上其他出资方出资,单位为分必填1000
merchant_contributeString(16)商家出资(特指发起交易的商家出资金额,单位为分)可空900
other_contributeString(16)其他出资方出资金额,可能是支付宝,可能是品牌商,或者其他方,也可能是他们的一起出资,单位为分可空100
memoString(256)优惠券备注信息可空学生专用优惠
discount_goods_detailString单品信息必填
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样例:

  1. [
  2. {
  3. "amount":"1000",
  4. "id":"2015102600073002039000002D5O",
  5. "memo":"学生专用优惠",
  6. "merchant_contribute":"900",
  7. "name":"XX超市5折优惠",
  8. "other_contribute":"100",
  9. "type":"ALIPAY_FIX_VOUCHER",
  10. "discount_goods_detail":[
  11. {
  12. "goods_id":"STANDARD1026181538",
  13. "goods_name":"雪碧",
  14. "discount_amount":"10000",
  15. "voucher_id":"2015102600073002039000002D5O"
  16. }
  17. ]
  18. },
  19. {
  20. "amount":"1000",
  21. "id":"2015102600073002039000002D5O",
  22. "memo":"学生专用优惠",
  23. "merchant_contribute":"900",
  24. "name":"XX超市5折优惠",
  25. "other_contribute":"100"",
  26. "type":"ALIPAY_FIX_VOUCHER",
  27. "discount_goods_detail":[
  28. {
  29. "goods_id":"STANDARD1026181538",
  30. "goods_name":"雪碧",
  31. "discount_amount":"10000",
  32. "voucher_id":"2015102600073002039000002D5O"
  33. }
  34. ]
  35. }
  36. ]

promotion_detail优惠活动信息 json体参数:

参数类型说明是否必填范例
promotion_idString(32)券或者立减优惠id必填109519
nameString(64)优惠名称可空单品惠-6
scopeString(32)优惠范围
GLOBAL - 全场代金券
SINGLE - 单品优惠
可空SINGLE
typeString(32)优惠类型
COUPON - 代金券,需要走结算资金的充值型代金券,(境外商户券币种与支付币种一致)
DISCOUNT - 优惠券,不走结算资金的免充值型优惠券,(境外商户券币种与标价币种一致)
可空DISCOUNT
amountNumber(16)优惠券面额,用户享受的优惠的金额必填5
activity_idString(32)活动ID
在微信商户后台配置的批次ID
必填931386
wxpay_contributeNumber(16)微信出资(特指由微信支付商户平台创建的优惠,出资金额等于本项优惠总金额,单位为分)可空0
merchant_contributeNumber(16)商家出资(特指商户自己创建的优惠,出资金额等于本项优惠总金额,单位为分)可空0
other_contributeNumber(16)其他出资方出资金额,单位为分可空5
goods_detailString单品列表可空
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样例:

  1. {
  2. "promotion_detail": [
  3. {
  4. "promotion_id": "109519",
  5. "name": "单品惠-6",
  6. "scope": "SINGLE",
  7. "type": "DISCOUNT",
  8. "amount": 5,
  9. "activity_id": "931386",
  10. "wxpay_contribute": 0,
  11. "merchant_contribute": 0,
  12. "other_contribute": 5,
  13. "goods_detail": [
  14. {
  15. "goods_id": "a_goods1",
  16. "goods_remark": "商品备注",
  17. "quantity": 7,
  18. "price": 1,
  19. "discount_amount": 4
  20. },
  21. {
  22. "goods_id": "a_goods2",
  23. "goods_remark": "商品备注",
  24. "quantity": 1,
  25. "price": 2,
  26. "discount_amount": 1
  27. }
  28. ]
  29. }
  30. ]
  31. }