交易请求报文

JSON:

  1. {
  2.     "request_type": "merchant_open_request",
  3.     "isspid": "00058301",
  4.     "pos_seq": "2022112500001",
  5.     "system_id": "8888",
  6.     "merchant_open_request": {
  7.         "merchant_id": "100010511",
  8.         "settle_type": "1",
  9.         "settlement_way": 0,
  10.         "withdraw_way": 2,
  11.         "withdraw_type": 1,
  12.         "nature_day_num": 1,
  13.         "settle_cycle": "T1",
  14.         "settle_fee_flag": 2,
  15.         "settle_fee_account": "666000000000000001",
  16.         "settle_fee_acct_type": "01",
  17.         "card_no": "1402201409600044xx",
  18.         "parent_bank_name": "中国工商银行",
  19.         "parent_bank_code": "01020000",
  20.         "province": "350000",
  21.         "city": "350100",
  22.         "branch_bank_code": "102391052409",
  23.         "branch_bank_name": "中国工商银行股份有限公司福州铜盘支行",
  24.         "settle_photo_a": "6847",
  25.         "settle_photo_b": "6848",
  26.         "remained_amt": 100,
  27.         "settle_abstract": "业务收款"
  28.     },
  29.     "sign": "712036C2324D76F2934C44C95A80CEBA"
  30. }

XML:

  1. <?xml version="1.0" encoding="GBK"?>
  2. <business_trans>
  3.     <request_type>merchant_open_request</request_type>
  4.     <isspid>00058301</isspid>
  5.     <pos_seq>2022112500001</pos_seq>
  6.     <system_id>8888</system_id>
  7.     <merchant_open_request>
  8.         <merchant_id>100010511</merchant_id>
  9.         <settle_type>1</settle_type>
  10.         <settlement_way>0</settlement_way>
  11.         <withdraw_way>2</withdraw_way>
  12.         <withdraw_type>1</withdraw_type>
  13.         <nature_day_num>1</nature_day_num>
  14.         <settle_cycle>T1</settle_cycle>
  15.         <settle_fee_flag>2</settle_fee_flag>
  16.         <settle_fee_account>666000000000000001</settle_fee_account>
  17.         <settle_fee_acct_type>01</settle_fee_acct_type>
  18.         <card_no>1402201409600044xx</card_no>
  19.         <parent_bank_name>中国工商银行</parent_bank_name>
  20.         <parent_bank_code>01020000</parent_bank_code>
  21.         <province>350000</province>
  22.         <city>350100</city>
  23.         <branch_bank_code>102391052409</branch_bank_code>
  24.         <branch_bank_name>中国工商银行股份有限公司福州铜盘支行</branch_bank_name>
  25.         <settle_photo_a>6847</settle_photo_a>
  26.         <settle_photo_b>6849</settle_photo_b>
  27.         <remained_amt>100</remained_amt>
  28.         <settle_abstract>业务收款</settle_abstract>
  29.     </merchant_open_request>
  30. </business_trans>

交易请求报文说明

节点名称中文名称类型说明是否必填
sign报文签名String(32)请求报文格式为JSON时必填
计算签名方式请看2.1章节		可选
request_type请求类型String(32)固定值：merchant_open_request必填
system_id系统平台号String(4)由翼码提供必填
isspid商户号String(8)翼码商户号，由翼码提供必填
pos_seq请求流水号String(32)同一个翼码商户号下唯一，不可重复使用，且大于12位必填
merchant_open_request
->merchant_id		分账商户idString分账商户id必填
merchant_open_request
->settle_type		结算卡类型String(1)1：对公
2：对私；
个人用户仅支持传2		必填
merchant_open_request
->settlement_way		结算方式Number0：提现
1：自动结算		必填
merchant_open_request
->withdraw_way		提现方式Number1：手动提现
2：自动提现
当结算方式填0时，才需填写此项，不填默认为1		可选
merchant_open_request
->withdraw_type		提现类型Number1：周期提现
2：账期提现
当提现方式填2时，此项为必填		可选
merchant_open_request
->nature_day_num		提现间隔时间Number当有填写提现类型时此项必填，到达该时间后系统会进行自动提现，单位为自然日，取值范围[1,120]; 示例值: 1可选
merchant_open_request
->settle_cycle		到账时间StringT1：下一个工作日到银行账户
D1：下一个自然日到银行账户
D0：当日到银行账户
说明：
1、为空默认为T1；
2、当结算方式为自动结算时，仅支持选择 T1、D1 其中一种；
3、当提现方式为自动提现时，仅支持选择 T1、D1、D0 其中一种；
4、当提现方式为手动提现时，此节点支持选择 T1、D1、D0 中的多个，使用半角逗号分隔。		可选
merchant_open_request
->settle_fee_flag		D1/D0手续费扣收方式Number1：外扣（从指定的账户中扣除手续费）
2：内扣（直接从提现/结算的收款账户中扣除）
说明：
1、为空默认为内扣；
2、当到账时间为D1或者D0时存在手续费，此节点才有效；
3、当选择外扣时，若外扣账户余额不足，会导致资金结算/提现失败；		可选
merchant_open_request
->settle_fee_account		手续费外扣账户String当D1/D0手续费扣收方式为外扣时必填
手续费外扣账户仅能为子商户的所属上级收款账户编号
收款账户编号可在企账通控台的收款账户列表中查看		可选
merchant_open_request
->settle_fee_acct_type		手续费外扣账户类型String01：基本户
05：充值户
不填默认为基本户，如需使用充值户请联系运营人员开通此账户。		可选
merchant_open_request
->card_no		银行卡号String(20)银行卡号必填
merchant_open_request
->parent_bank_name		结算开户银行名称String(32)需严格按照银行列表上送， 部分银行支持多种上送方式，选其一上送即可。 注：测试环境建议使用工农中建交。必填
merchant_open_request
->parent_bank_code		结算开户银行号String(20)结算开户银行号，编码参考《银行编码》必填
merchant_open_request
->province		开户行所在省String(6)开户行所在省，开户行所在市必须同时上送，地区编码参考《地区编码》必填
merchant_open_request
->city		开户行所在市String(6)开户行所在市，开户行所在市必须同时上送，地区编码参考《地区编码》必填
merchant_open_request
->settle_photo_a		结算卡正面/开户许可证图片idString当对私结算时，传法人结算卡正面图片id，必填；
当对公结算时，传开户许可证照片图片id，必填；
需使用《图片上传接口》提前上传图片得到图片id		必填
merchant_open_request
->settle_photo_b		结算卡反面图片idString当对私结算时，传法人结算卡反面图片id，必填；
当对公结算时，为空；
需使用《图片上传接口》提前上传图片得到图片id		可选
merchant_open_request
->branch_bank_code		支行联行号String(12)对公时支行联行号、开户支行联行名称二选一必填，参考《支行编码》中完整“联行号”可选
merchant_open_request
->branch_bank_name		开户支行联行名称String(32)对公时支行联行号、开户支行联行名称二选一必填，参考《支行编码》中完整“联行名称”可选
merchant_open_request
->remained_amt		留存金额Number(10)小于等于该金额不会结算，单位为分，取值范围[1,9999999999]；手动提现时无需填写可选
merchant_open_request
->settle_abstract		结算摘要String(60)如果需要自定义结算打款备注，请使用此字段传入，默认为空。示例值：业务收款；手动提现时无需填写可选

交易返回报文

JSON:

  1. {
  2.     "response_type": "merchant_open_response",
  3.     "isspid": "00058301",
  4.     "pos_seq": "2022112500001",
  5.     "trans_time": "20221207154725",
  6.     "result": {
  7.         "id": "0000",
  8.         "comment": "操作成功"
  9.     },
  10.     "sign": "03B62B8B16844549FFF01F4659B4AE0A"
  11. }

XML:

  1. <?xml version="1.0" encoding="GBK"?>
  2. <business_trans>
  3.     <response_type>merchant_open_response</response_type>
  4.     <isspid>00058301</isspid>
  5.     <pos_seq>2022112500001</pos_seq>
  6.     <trans_time>20090405010104</trans_time>
  7.     <result>
  8.         <id>0000</id>
  9.         <comment>成功</comment>
  10.     </result>
  11. </business_trans>

交易返回报文说明

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

节点名称中文名称类型说明是否必填
sign报文签名String(32)返回报文格式为JSON时必填
计算签名方式请看2.1章节		可选
response_type返回类型String(32)固定值：merchant_open_response必填
isspid商户号String(8)翼码商户号，由翼码提供必填
pos_seq请求流水号String(32)请求流水号可选
trans_time交易时间String(14)交易时间，格式：yyyyMMddHHmmss必填
result
->id		响应码String(4)翼码平台返回的处理结果,0000-成功，其它失败，错误信息说明见“响应码解释”字段必填
result
->comment		响应码解释String(64)响应码对应中文注解，用于显示提示必填

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