交易请求报文

JSON:

  1. {
  2.     "request_type": "scanpay_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.     "device_ip": "127.0.0.1",
  10.     "memo": "订单备注",
  11.     "scanpay_request": {
  12.         "pay_type": "502",
  13.         "tx_amt": "1",
  14.         "bank_code": "",
  15.         "payment_process": "01",
  16.         "body": "商品描述",
  17.         "notify_url": "http://www.baidu.com/",
  18.         "goods_detail": [
  19.             {
  20.                 "goods_id": "apple-01",
  21.                 "payment_goods_id": "20010001",
  22.                 "goods_name": "ipad",
  23.                 "quantity": 1,
  24.                 "price": 200000,
  25.                 "goods_category": "34543238",
  26.                 "body": "特价手机",
  27.                 "show_url": "http://www.alipay.com/xxx.jpg"
  28.             },
  29.             {
  30.                 "goods_id": "apple-02",
  31.                 "payment_goods_id": "20010002",
  32.                 "goods_name": "ipad2",
  33.                 "quantity": 1,
  34.                 "price": 200000,
  35.                 "goods_category": "34543239",
  36.                 "body": "特价手机2",
  37.                 "show_url": "http://www.alipay.com/xxx2.jpg"
  38.             }
  39.         ],
  40.         "extend_params": {
  41.             "hb_fq_num": "3",
  42.             "hb_fq_seller_percent": "100",
  43.             "split_flag": "R",
  44.             "plan_split_date": "20230418",
  45.             "split_info": {
  46.                 "keep_amt": "800",
  47.                 "split_list": [
  48.                     {
  49.                         "merchant_id": "10000000000001",
  50.                         "div_amt": "150"
  51.                     },
  52.                     {
  53.                         "merchant_id": "10000000000002",
  54.                         "div_amt": "50"
  55.                     }
  56.                 ]
  57.             }
  58.         }
  59.     },
  60.     "sign": "314DA43E7E244105ECBD45F797264854"
  61. }

XML:

  1. <?xml version="1.0" encoding="GBK"?>
  2. <business_trans>
  3.     <request_type>scanpay_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.     <memo>订单备注</memo>
  12.     <scanpay_request>
  13.         <pay_type>502</pay_type>
  14.         <tx_amt>1</tx_amt>
  15.         <bank_code></bank_code>
  16.         <payment_process>01</payment_process>
  17.         <body>商品描述</body>
  18.         <notify_url><![CDATA[http://www.baidu.com/]]></notify_url>
  19.         <goods_detail><![CDATA[商品信息(JSON)]]></goods_detail>
  20.         <extend_params><![CDATA[扩展参数(JSON)]]></extend_params>
  21.     </scanpay_request>
  22. </business_trans>

交易请求报文说明

节点名称中文名称类型说明是否必填
sign报文签名String(32)请求报文格式为JSON时必填
计算签名方式请看2.1章节		可选
request_type请求类型String(32)固定值：scanpay_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(仅支持IPv4)
根据央行要求必须传真实公网IP
否则商家会被风控！！！		可空
memo订单备注String(128)可空
scanpay_request
->pay_type		支付方式String(3)502：支付宝
503：微信支付
512：银联二维码
521：聚分期		必填
scanpay_request
->tx_amt		交易金额Number(9)支付金额，单位为分，不支持小数点必填
scanpay_request
->bank_code		指定银行编码String(16)当支付方式为聚分期(pay_type=521)时生效
需指定聚分期分期银行时，则将银行编码传入该值
仅支持指定单一银行，银行编码详见下表		可空
scanpay_request
->payment_process		支付流程String(2)01：直接支付（说明：用户扫码后无需确认支付信息，直接拉起微信收银台进行支付）
02：确认支付（说明：用户扫码后会先打开支付确认页，用户点击支付确认页面中的支付按钮，在拉起微信收银台完成支付）
说明：此支付流程仅对微信支付有效，其它支付方式无效。
不传此节点系统默认按02：确认支付进行处理。		可空
scanpay_request
->body		商品描述String(100)建议中文按3个字节计算，最大不超过33个中文
不传则默认为“商户简称(门店名称)”		可空
scanpay_request
->notify_url		异步通知地址String(256)4.20.交易结果通知
使用XML格式报文时，建议使用CDATA标签包裹内容		可空
scanpay_request
->goods_detail		商品信息JSONArray订单包含的商品信息列表，详细参数见下表
使用XML格式报文时，建议使用CDATA标签包裹内容		可空
scanpay_request
->extend_params		扩展参数JSON用于扩展一些特殊的支付参数字段，详细参数见下表
使用XML格式报文时，建议使用CDATA标签包裹内容		可空

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

bank_code 指定银行编码

银行名称银行简码银行编码
民生银行CMBC3050001
兴业银行CIB3090010
广发银行GDB3060000
平安银行PAB5105840
浦发银行SPDB63100000
邮储银行PSBC61000000
上海银行BOS4012902
宁波银行BON64083300
农业银行ABC1030000
云南农信社YNNXS65097300
招商银行CMB3080000
广州银行GZCB64135810
秦农银行QNNS64680000
中信银行CITIC63020000
武汉农商行WHAC65595210
桂林银行GLB64916170
光大银行CEB63030000
华夏银行HXBANK63040000

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_response",
  3.     "isspid": "39493002",
  4.     "pos_id": "6666666666",
  5.     "pos_seq": "2018121400000004",
  6.     "trans_time": "20181214143516",
  7.     "sys_seq": "0741136885a748c1",
  8.     "pay_type": "502",
  9.     "code_url": "https://qr.alipay.com/bax03342mgh8qcnbqymn20f0",
  10.     "extend": "",
  11.     "result": {
  12.         "id": "9998",
  13.         "comment": "下单成功，等待用户支付"
  14.     },
  15.     "sign": "F6106656C20AB23B547B0C30DD819793"
  16. }

XML:

  1. <?xml version="1.0" encoding="GBK"?>
  2. <business_trans>
  3.     <response_type>scanpay_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.     <pay_type>502</pay_type>
  10.     <code_url><![CDATA[weixin://wxpay/bizpayurl?pr=wkEAWjS]]></code_url>
  11.     <extend><![CDATA[扩展字段(json格式)]]></extend>
  12.     <result>
  13.         <id>9998</id>
  14.         <comment>下单成功，等待用户支付</comment>
  15.     </result>
  16. </business_trans>

交易返回报文说明

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

节点名称中文名称类型说明是否必填
sign报文签名String(32)返回报文格式为JSON时必填
计算签名方式请看2.1章节		可选
response_type返回类型String(32)固定值：scanpay_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：银联二维码
521：聚分期		必填
code_url支付二维码信息String(100)支付平台返回的扫码支付二维码信息
使用CDATA标签包裹		可选
extend扩展信息String扩展信息字段内容为json格式
预留字段后续业务扩展使用		可空
result
->id		响应码String(4)9998：下单成功，等待用户支付
其它表示失败，错误信息说明见“响应码解释”字段		必填
result
->comment		响应码解释String(64)响应码对应中文注解，用于显示提示必填

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