交易请求报文

  1. <?xml version="1.0" encoding="GBK"?>
  2. <business_trans>
  3. <request_type>barcode_pay_request</request_type>
  4. <isspid>39493002</isspid>
  5. <pos_id>1511300001</pos_id>
  6. <store_id>1511300001</store_id>
  7. <pos_seq>1511300000002</pos_seq>
  8. <user_id>user01</user_id>
  9. <system_id>8888</system_id>
  10. <device_ip>127.0.0.1</device_ip>
  11. <barcode_pay_request>
  12. <barcode_info>1234567890123456</barcode_info>
  13. <pay_type>502</pay_type>
  14. <tx_amt>10</tx_amt>
  15. <goods_detail><![CDATA[商品信息(JSON)]]></goods_detail>
  16. <extend_params><![CDATA[扩展参数]]></extend_params>
  17. <use_coupon>1</use_coupon>
  18. </barcode_pay_request>
  19. </business_trans>

交易请求报文说明

节点名称中文名称类型说明是否必填
request_type请求类型String(32)标识请求报文的类型,固定为barcode_pay_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)由翼码提供必填
device_ip设备IPString(15)发起交易的门店公网IP
根据央行要求必须传门店真实公网IP
否则商家会被风控!!!
可空
barcode_pay_request
->barcode_info
条码支付动态码String(64)条码支付动态码必填
barcode_pay_request
->pay_type
支付类型String(3)502:支付宝支付
503:微信支付
504:翼支付
507:和包支付
512:银联二维码
514:招行掌上生活
516:数字人民币
519:会员余额支付
传空时自动识别
可空
barcode_pay_request
->tx_amt
交易金额Number(9)条码支付金额,单位为分,不支持小数点必填
barcode_pay_request
->goods_detail
商品信息String(6000)订单包含的商品信息列表,以JSON格式传入
若传入信息带特殊字符请使用CDATA标签包裹内容
详细参数见下表
可空
barcode_pay_request
->extend_params
扩展参数String用于扩展一些特殊的支付参数字段,以JSON格式传入
若传入信息带特殊字符请使用CDATA标签包裹内容
详细参数见下表
可空
barcode_pay_request
->use_coupon
是否使用优惠券String(1)0:不使用优惠
1:可使用优惠
传空默认为1
具体应用:
a.微信可使用优惠时,翼码传送已配置的订单优惠标记(goods_tag)给微信
b.支付宝不可使用优惠时,翼码将不参与优惠计算的金额(undiscountable_amount)取订单金额传送给支付宝
可空

goods_detail 商品信息 (JSONArray)

JSON节点类型说明是否必填范例
goods_idString(32)商品的编号必填apple-01
payment_goods_idString(32)支付平台商品编号可空20010001
goods_nameString(256)商品名称必填ipad
quantityNumber(9)商品数量必填1
priceNumber(8)商品单价,单位为分必填200000
goods_categoryString(24)商品类目
仅支付宝、银联二维码时生效
可空34543238
bodyString(1000)商品描述信息
仅支付宝时生效
可空特价手机
show_urlString(400)商品的展示地址
仅支付宝时生效
可空http://www.alipay.com/xxx.jpg

goods_detail 样例:

  1. [
  2. {
  3. "goods_id" : "apple-01",
  4. "payment_goods_id" : "20010001",
  5. "goods_name" : "ipad",
  6. "quantity" : 1,
  7. "price" : 200000,
  8. "goods_category" : "34543238",
  9. "body" : "特价手机",
  10. "show_url" : "http://www.alipay.com/xxx.jpg"
  11. },
  12. {
  13. "goods_id" : "apple-02",
  14. "payment_goods_id" : "20010002",
  15. "goods_name" : "ipad2",
  16. "quantity" : 1,
  17. "price" : 200000,
  18. "goods_category" : "34543239",
  19. "body" : "特价手机2",
  20. "show_url" : "http://www.alipay.com/xxx2.jpg"
  21. }
  22. ]

extend_params 扩展参数 (JSON)

JSON节点类型说明是否必填范例
hb_fq_numString花呗分期数,仅支持传入3、6、12,其他期数暂不支持
仅支付宝时生效
hb_fq_num与hb_fq_seller_percent必须同时传入且使用花呗分期商品明细必传
可空3
hb_fq_seller_percentString花呗卖家承担收费比例,商家承担手续费传入100,用户承担手续费传入0,仅支持传入100、0两种,其他比例暂不支持
仅支付宝时生效
hb_fq_num与hb_fq_seller_percent必须同时传入且使用花呗分期商品明细必传
可空100
split_flagString分账标识
N:不分账
R:实时分账
D:延时分账
不传该节点时,将按控制台配置处理
该节点与分账功能相关具体联系业务确认开通功能
可空R
split_infoJSON分账信息
仅支持请求实时分账split_flag=R
该节点与分账功能相关具体联系业务确认开通功能
可空 

分账业务相关的特别说明:
1. split_flag=N 不分账时,split_info不允许传入;
2. split_flag=R 实时分账时,split_info必传,其中keep_amt与div_amt叠加必须全额分完整笔订单;
3. split_flag=D 延时分账时,split_info不允许传入,在后续流程中调用延迟交易确认接口完成分账,或使用翼码分账系统界面进行分账。

split_info 分账信息

JSON节点类型说明是否必填范例
keep_amtString分账方自留金额,单位为分,可传0表示不自留必填1000
split_listArray分账明细必填 
split_list 分账明细
JSON节点类型说明是否必填范例
merchant_idString分账接收方的分账商户号必填10000000000001
div_amtString分账金额,单位为分,必须大于0必填1000

extend_params 样例:

  1. {
  2. "hb_fq_num": "3",
  3. "hb_fq_seller_percent": "100",
  4. "split_flag": "R",
  5. "split_info": {
  6. "keep_amt": "800",
  7. "split_list": [
  8. {
  9. "merchant_id": "10000000000001",
  10. "div_amt": "150"
  11. },
  12. {
  13. "merchant_id": "10000000000002",
  14. "div_amt": "50"
  15. }
  16. ]
  17. }
  18. }

交易返回报文

  1. <?xml version="1.0" encoding="GBK"?>
  2. <business_trans>
  3. <response_type>barcode_pay_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>2019-04-02 14:52:31</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>oXI_E5KN-FJi1Hf65mWeiBF8fUlU</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. <yzf_res_info>
  61. <orderSeq></orderSeq>
  62. </yzf_res_info>
  63. <cmpay_res_info>
  64. <trade_no></trade_no>
  65. <out_trade_no>IPOS0000YZF0040</out_trade_no>
  66. <bank_type></bank_type>
  67. <total_fee>2</total_fee>
  68. <coupon_fee>0</coupon_fee>
  69. <vch_fee>0</vch_fee>
  70. <cash_fee>2</cash_fee>
  71. <gmt_payment></gmt_payment>
  72. <detail_error_code></detail_error_code>
  73. <detail_error_desc></detail_error_desc>
  74. <buyer_pay_amount>1</buyer_pay_amount>
  75. </cmpay_res_info>
  76. <upay_res_info>
  77. <trade_no>20180504050741694554</trade_no>
  78. <out_trade_no>1805040000021</out_trade_no>
  79. <atu_trade_no>20180504050741694554</atu_trade_no>
  80. <atu_out_trade_no>1805040000021</atu_out_trade_no>
  81. <total_fee>1</total_fee>
  82. </upay_res_info>
  83. <cmb_res_info>
  84. <trade_no>190419135176132382298112</trade_no>
  85. <out_trade_no>201904191391123546</out_trade_no>
  86. <buyer_pay_amount>0</buyer_pay_amount>
  87. <totalamt>4000</totalamt>
  88. <bonuspoint>0</bonuspoint>
  89. <receivableamt>0</receivableamt>
  90. <commissionamt>0</commissionamt>
  91. <invoiceamt>0</invoiceamt>
  92. <couponamt>0</couponamt>
  93. <couponcmbsubsidyamt>0</couponcmbsubsidyamt>
  94. <couponmersubsidyamt>0</couponmersubsidyamt>
  95. <coupons></coupons>
  96. <actualamt>0</actualamt>
  97. <randomdiscountamt>0</randomdiscountamt>
  98. <fulldiscountamt>0</fulldiscountamt>
  99. <fulldiscountmersubsidyamt>0</fulldiscountmersubsidyamt>
  100. <fulldiscountcmbsubsidyamt>0</fulldiscountcmbsubsidyamt>
  101. <voucheramt>0</voucheramt>
  102. <vouchercmbsubsidyamt>0</vouchercmbsubsidyamt>
  103. <vouchermersubsidyamt>0</vouchermersubsidyamt>
  104. <coupondetail></coupondetail>
  105. </cmb_res_info>
  106. <ecny_res_info>
  107. <trade_no>20180504050741694554</trade_no>
  108. <out_trade_no>1805040000021</out_trade_no>
  109. <total_fee>2</total_fee>
  110. </ecny_res_info>
  111. <balpay_res_info>
  112. <trade_no>20180504050741694554</trade_no>
  113. <out_trade_no>1805040000021</out_trade_no>
  114. <total_fee>2</total_fee>
  115. </balpay_res_info>
  116. <result>
  117. <id>0000</id>
  118. <comment>成功</comment>
  119. </result>
  120. </business_trans>

交易返回报文说明

标准接口会因业务升级需要而新增节点,请在解析返回报文时避免新增未知节点产生的程序出错!

节点名称中文名称类型说明是否必填
response_type返回类型String(32)标识返回报文的类型,固定为barcode_pay_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:和包支付
512:银联二维码
514:招行掌上生活
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格式返回
详细参数见下表
可空
翼支付的时候返回以下数据
yzf_res_info
->orderseq
支付交易请求流水String(64)交易成功时候,必填可空
和包支付的时候返回以下数据
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
->buyer_pay_amount
买家实付金额String(16)交易成功时候,必填,单位为分可空
银联二维码的时候返回以下数据
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 优惠券信息

参数类型说明是否必填范例
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

voucher_detail_list 样例:

  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 优惠活动信息

参数类型说明是否必填范例
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

promotion_detail 样例:

  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. }