交易请求报文

JSON:

  1. {
  2. "request_type": "scanpay_qrcode_request",
  3. "isspid": "39493002",
  4. "pos_id": "1511300001",
  5. "store_id": "1511300001",
  6. "pos_seq": "2018121400000004",
  7. "user_id": "user01",
  8. "system_id": "8888",
  9. "memo": "订单备注",
  10. "scanpay_qrcode_request": {
  11. "tx_amt": "1",
  12. "notify_url": "http://www.baidu.com/",
  13. "goods_detail": [
  14. {
  15. "goods_id": "apple-01",
  16. "payment_goods_id": "20010001",
  17. "goods_name": "ipad",
  18. "quantity": 1,
  19. "price": 200000,
  20. "goods_category": "34543238",
  21. "body": "特价手机",
  22. "show_url": "http://www.alipay.com/xxx.jpg"
  23. },
  24. {
  25. "goods_id": "apple-02",
  26. "payment_goods_id": "20010002",
  27. "goods_name": "ipad2",
  28. "quantity": 1,
  29. "price": 200000,
  30. "goods_category": "34543239",
  31. "body": "特价手机2",
  32. "show_url": "http://www.alipay.com/xxx2.jpg"
  33. }
  34. ],
  35. "extend_params": {
  36. "hb_fq_num": "3",
  37. "hb_fq_seller_percent": "100",
  38. "split_flag": "R",
  39. "plan_split_date": "20230418",
  40. "split_info": {
  41. "keep_amt": "800",
  42. "split_list": [
  43. {
  44. "merchant_id": "10000000000001",
  45. "div_amt": "150"
  46. },
  47. {
  48. "merchant_id": "10000000000002",
  49. "div_amt": "50"
  50. }
  51. ]
  52. }
  53. }
  54. },
  55. "sign": "314DA43E7E244105ECBD45F797264854"
  56. }

XML:

  1. <?xml version="1.0" encoding="GBK"?>
  2. <business_trans>
  3. <request_type>scanpay_qrcode_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. <memo>订单备注</memo>
  11. <scanpay_qrcode_request>
  12. <tx_amt>1</tx_amt>
  13. <notify_url><![CDATA[http://www.baidu.com/]]></notify_url>
  14. <goods_detail><![CDATA[商品信息(JSON)]]></goods_detail>
  15. <extend_params><![CDATA[扩展参数(JSON)]]></extend_params>
  16. </scanpay_qrcode_request>
  17. </business_trans>

交易请求报文说明

节点名称中文名称类型说明是否必填
sign报文签名String(32)请求报文格式为JSON时必填
计算签名方式请看2.1章节
可选
request_type请求类型String(32)固定值:scanpay_qrcode_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)由翼码提供必填
memo订单备注String(128)可空
scanpay_qrcode_request
->tx_amt
交易金额Number(9)单位为分必填
scanpay_qrcode_request
->notify_url
异步通知地址String(256)异步通知文档见4.20
使用XML格式报文时,建议使用CDATA标签包裹内容
可空
scanpay_qrcode_request
->goods_detail
商品信息JSONArray订单包含的商品信息列表,详细参数见下表
使用XML格式报文时,建议使用CDATA标签包裹内容
可空
scanpay_qrcode_request
->extend_params
扩展参数JSON用于扩展一些特殊的支付参数字段,详细参数见下表
使用XML格式报文时,建议使用CDATA标签包裹内容
可空

自定义门店号(store_id)和自定义终端号(pos_id)需经过4.1终端绑定交易接口绑定成功过的值才可以调用,绑定一次即可不需要重复绑定。

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
plan_split_dateString预分账日期,格式:yyyymmdd
仅延时分账类型(split_flag=D)时支持传入
可空20230418
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节点类型说明是否必填范例
is_clean_splitStringN:不使用净值分账
Y:使用净值分账
不传默认为N,即不使用净值分账
净值分账目前仅对部分通道开放,使用此能力前请先与技术支持确认
净值分账仅在交易手续费内扣时才起作用
当使用净值分账时,分账信息和分账明细必须要传分账比例,且分账方自留比例(keep_percentage)与所有分账比例(div_percentage)之和必须要为100%
可空Y
keep_amtString分账方自留金额,单位为分,可传0表示不自留
不使用净值分账(is_clean_split=N)时,该节点必填,分账方自留比例(keep_percentage)节点无效
可空1000
keep_percentageString分账方自留比例,单位为%,最多支持小数点后两位,可传0表示不自留
使用净值分账(is_clean_split=Y)时,该节点必填,分账方自留金额(keep_amt)节点无效
可空50.26
split_listArray分账明细必填 
split_list 分账明细
JSON节点类型说明是否必填范例
merchant_idString分账接收方的分账商户号必填10000000000001
div_amtString分账金额,单位为分,必须大于0
不使用净值分账(is_clean_split=N)时,该节点必填,分账比例(div_percentage)节点无效
可空1000
div_percentageString分账比例,单位为%,最多支持小数点后两位,必须大于0
使用净值分账(is_clean_split=Y)时,该节点必填,分账金额(div_amt)节点无效
可空23.55

若业务涉及100%分账给接收方,请于业务对接人联系申请使用净值分账功能。

extend_params 样例:

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

交易返回报文

JSON:

  1. {
  2. "response_type": "scanpay_qrcode_response",
  3. "isspid": "39493002",
  4. "pos_id": "6666666666",
  5. "pos_seq": "2018121400000004",
  6. "trans_time": "20181214143516",
  7. "sys_seq": "0741136885a748c1",
  8. "code_url": "http://ipos-sa.imageco.cn/qrcode?state=1FGL3T1B7057T",
  9. "extend": "",
  10. "result": {
  11. "id": "9998",
  12. "comment": "下单成功,等待用户支付"
  13. },
  14. "sign": "F6106656C20AB23B547B0C30DD819793"
  15. }

XML:

  1. <?xml version="1.0" encoding="GBK"?>
  2. <business_trans>
  3. <response_type>scanpay_qrcode_response</response_type>
  4. <isspid>39493002</isspid>
  5. <pos_id>1511300001</pos_id>
  6. <pos_seq>1511300000002</pos_seq>
  7. <sys_seq>0311095321465179</sys_seq>
  8. <trans_time>20160311095321</trans_time>
  9. <code_url><![CDATA[http://ipos-sa.imageco.cn/qrcode?state=1FGL3T1B7057T]]></code_url>
  10. <extend><![CDATA[扩展字段(json格式)]]></extend>
  11. <result>
  12. <id>9998</id>
  13. <comment>下单成功,等待用户支付</comment>
  14. </result>
  15. </business_trans>

交易返回报文说明

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

节点名称中文名称类型说明是否必填
sign报文签名String(32)返回报文格式为JSON时必填
计算签名方式请看2.1章节
可选
response_type返回类型String(32)固定值:scanpay_qrcode_response必填
isspid商户号String(8)翼码商户号,由翼码提供必填
pos_id终端号String(20)商户自定义终端号必填
pos_seq支付请求流水号String(32)支付请求流水号,和请求报文相同必填
sys_seq随机串号String(16)随机生成串号,仅用于日志跟踪用,不保存必填
trans_time接口返回时间String(14)接口返回时间,格式:yyyyMMddHHmmss必填
code_url聚合二维码信息String(100)聚合二维码的信息
商户系统生成二维码提供给支付方扫码
支持支付宝、微信、云闪付APP
XML报文时使用CDATA标签包裹
可选
extend扩展信息String扩展信息字段内容为json格式
预留字段后续业务扩展使用
XML报文时使用CDATA标签包裹
可空
result
->id
响应码String(4)9998:下单成功,等待用户扫码(交易结果需调用查询接口确认)
其它失败,错误信息说明见“响应码解释”字段
必填
result
->comment
响应码解释String(64)响应码对应中文注解,用于显示提示必填

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

code_url 聚合二维码信息

返回的URL生成二维码给用户扫码,支持微信、支付宝、云闪付扫码。

测试环境URL为http协议,域名为ipos-sa.imageco.cn,例:http://ipos-sa.imageco.cn/qrcode?state=1FGL3T1B7057T

生产环境URL为https协议
a.域名为ipos-sa-std.wangcaio2o.com,例:https://ipos-sa-std.wangcaio2o.com/qrcode?state=1FGL3T1B7057T
b.域名为ipos-sa-kylin.wangcaio2o.com,例:https://ipos-sa-kylin.wangcaio2o.com/qrcode?state=1FGL3T1B7057T
不同域名以实际返回为准