交易请求报文

JSON:

  1. {
  2. "request_type": "account_pay_request",
  3. "isspid": "39493002",
  4. "pos_id": "6666666666",
  5. "store_id": "6666666666",
  6. "pos_seq": "AP2018121400000004",
  7. "user_id": "user01",
  8. "system_id": "8888",
  9. "memo": "订单备注",
  10. "account_pay_request": {
  11. "out_seller_account": "6666000116230107",
  12. "out_merchant_id": "",
  13. "tx_amt": "200",
  14. "extend_params": {
  15. "split_flag": "R",
  16. "split_info": {
  17. "split_list": [
  18. {
  19. "merchant_id": "10000000000001",
  20. "div_amt": "50"
  21. },
  22. {
  23. "seller_account": "6666000116230109",
  24. "div_amt": "150"
  25. }
  26. ]
  27. }
  28. }
  29. },
  30. "sign": "314DA43E7E244105ECBD45F797264854"
  31. }

XML:

  1. <?xml version="1.0" encoding="GBK"?>
  2. <business_trans>
  3. <request_type>account_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. <memo>订单备注</memo>
  11. <account_pay_request>
  12. <out_seller_account>6666000116230107</out_seller_account>
  13. <out_merchant_id></out_merchant_id>
  14. <tx_amt>200</tx_amt>
  15. <extend_params><![CDATA[扩展参数(JSON)]]></extend_params>
  16. </account_pay_request>
  17. </business_trans>

交易请求报文说明

节点名称中文名称类型说明是否必填
sign报文签名String(32)请求报文格式为JSON时必填
计算签名方式请看2.1章节
可选
request_type请求类型String(32)固定值:account_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)由翼码提供必填
memo订单备注String(128)可空
account_pay_request
->out_seller_account
出资收款账户编号String(64)出资收款账户编号与出资用户id二选一必填可选
account_pay_request
->out_merchant_id
出资用户idString出资收款账户编号与出资用户id二选一必填可选
account_pay_request
->tx_amt
支付总金额Number(9)单位为分必填
account_pay_request
->extend_params
扩展参数JSON用于扩展一些特殊的支付参数字段,详细参数见下表
使用XML格式报文时,建议使用CDATA标签包裹内容
必填

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

extend_params 扩展参数 (JSON)

JSON节点类型说明是否必填范例
split_flagString分账标识
R:实时分账
必填R
split_infoJSON分账信息
仅支持请求实时分账split_flag=R使用且必填
可空 

分账业务相关的特别说明:
1. split_flag=R 实时分账时,split_info必传,其中div_amt叠加必须全额分完整笔订单;

split_info 分账信息

JSON节点类型说明是否必填范例
is_clean_splitStringN:不使用净值分账
Y:使用净值分账
不传默认为N,即不使用净值分账
净值分账目前仅对部分通道开放,使用此能力前请先与技术支持确认
净值分账仅在交易手续费内扣时才起作用
当使用净值分账时,分账明细必须要传分账比例,且所有分账比例(div_percentage)之和必须要为100%
可空Y
split_listArray分账明细,即收款方的明细必填 
split_list 分账明细
JSON节点类型说明是否必填范例
merchant_idString分账接收方的分账商户号
分账商户号与收款账户编号二选一必填
可选10000000000001
seller_accountString分账接收方的收款账户编号
分账商户号与收款账户编号二选一必填
可选6666000116230109
div_amtString分账金额,单位为分,必须大于0
不使用净值分账(is_clean_split=N)时,该节点必填,分账比例(div_percentage)节点无效
可空1000
div_percentageString分账比例,单位为%,最多支持小数点后两位,必须大于0
使用净值分账(is_clean_split=Y)时,该节点必填,分账金额(div_amt)节点无效
可空23.55

extend_params 样例:

  1. {
  2. "split_flag": "R",
  3. "split_info": {
  4. "split_list": [
  5. {
  6. "merchant_id": "10000000000001",
  7. "div_amt": "50"
  8. },
  9. {
  10. "seller_account": "6666000116230109",
  11. "div_amt": "150"
  12. }
  13. ]
  14. }
  15. }

交易返回报文

JSON:

  1. {
  2. "response_type": "account_pay_response",
  3. "isspid": "39493002",
  4. "pos_id": "6666666666",
  5. "pos_seq": "AP2018121400000004",
  6. "trans_time": "20181214152755",
  7. "sys_seq": "f135e20440ea261b",
  8. "result": {
  9. "id": "0000",
  10. "comment": "交易成功"
  11. },
  12. "sign": "F3417D5E9CEF3AE32110C7EFBF5AB400"
  13. }

XML:

  1. <?xml version="1.0" encoding="GBK"?>
  2. <business_trans>
  3. <response_type>account_pay_response</response_type>
  4. <isspid>39493002</isspid>
  5. <pos_id>6666666666</pos_id>
  6. <pos_seq>AP2018121400000004</pos_seq>
  7. <sys_seq>f135e20440ea261b</sys_seq>
  8. <trans_time>20181214152755</trans_time>
  9. <result>
  10. <id>0000</id>
  11. <comment>交易成功</comment>
  12. </result>
  13. </business_trans>

交易返回报文说明

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

节点名称中文名称类型说明是否必填
sign报文签名String(32)返回报文格式为JSON时必填
计算签名方式请看2.1章节
可选
response_type返回类型String(32)固定值:account_pay_response必填
isspid商户号String(8)翼码商户号,由翼码提供必填
pos_id终端号String(20)商户自定义终端号必填
pos_seq支付请求流水号String(32)支付请求流水号,和请求报文相同必填
sys_seq随机串号String(16)随机生成串号,仅用于日志跟踪用,不保存必填
trans_time接口返回时间String(14)接口返回时间,格式:yyyyMMddHHmmss必填
result
->id
响应码String(4)0000:成功
9998:处理中,需账户支付查询接口查询
其它值代表失败,错误信息说明见“响应码解释”字段
必填
result
->comment
响应码解释String(64)响应码对应中文注解,用于显示提示必填

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