交易请求报文

JSON:

  1. {
  2.     "request_type": "merchant_openmodify_request",
  3.     "isspid": "00058301",
  4.     "pos_seq": "2022112500001",
  5.     "system_id": "8888",
  6.     "merchant_openmodify_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.         "card_no": "140220140960004xxx",
  14.         "parent_bank_name": "中国工商银行",
  15.         "parent_bank_code": "01020000",
  16.         "province": "350000",
  17.         "city": "350100",
  18.         "branch_bank_code": "102391052409",
  19.         "branch_bank_name": "中国工商银行股份有限公司福州铜盘支行",
  20.         "settle_photo_a": "111",
  21.         "settle_photo_b": "222",
  22.         "remained_amt": 100,
  23.         "settle_abstract": "业务收款"
  24.     },
  25.     "sign": "712036C2324D76F2934C44C95A80CEBA"
  26. }

XML:

  1. <?xml version="1.0" encoding="GBK"?>
  2. <business_trans>
  3.     <request_type>merchant_openmodify_request</request_type>
  4.     <isspid>00058301</isspid>
  5.     <pos_seq>2022112500001</pos_seq>
  6.     <system_id>8888</system_id>
  7.     <merchant_openmodify_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.         <card_no>140220140960004xxx</card_no>
  15.         <parent_bank_name>中国工商银行</parent_bank_name>
  16.         <parent_bank_code>01020000</parent_bank_code>
  17.         <province>350000</province>
  18.         <city>350100</city>
  19.         <branch_bank_code>102391052409</branch_bank_code>
  20.         <branch_bank_name>中国工商银行股份有限公司福州铜盘支行</branch_bank_name>
  21.         <settle_photo_a>6847</settle_photo_a>
  22.         <settle_photo_b>6848</settle_photo_b>
  23.         <remained_amt>100</remained_amt>
  24.         <settle_abstract>业务收款</settle_abstract>
  25.     </merchant_openmodify_request>
  26. </business_trans>

交易请求报文说明

节点名称中文名称类型说明是否必填
sign报文签名String(32)请求报文格式为JSON时必填
计算签名方式请看2.1章节		可选
request_type请求类型String(32)固定值：merchant_openmodify_request必填
system_id系统平台号String(4)由翼码提供必填
isspid商户号String(8)翼码商户号，由翼码提供必填
pos_seq请求流水号String(32)同一个翼码商户号下唯一，不可重复使用，且大于12位必填
merchant_openmodify_request
->merchant_id		分账商户idString分账商户id必填
merchant_openmodify_request
->settle_type		结算卡类型String(1)1：对公，2：对私法人，3：对私非法人；
个人用户仅支持传2		必填
merchant_openmodify_request
->settlement_way		结算方式Number0：提现，1：自动结算必填
merchant_openmodify_request
->withdraw_way		提现方式Number1：手动提现，2：自动提现；当结算方式填0时，才需填写此项，不填默认为1可选
merchant_openmodify_request
->withdraw_type		提现类型Number1：周期提现，2：账期提现；当提现方式填2时，此项为必填可选
merchant_openmodify_request
->nature_day_num		提现间隔时间Number当有填写提现类型时此项必填，到达该时间后系统会进行自动提现，单位为自然日，取值范围[1,120]; 示例值: 1可选
merchant_openmodify_request
->card_no		银行卡号String(20)银行卡号必填
merchant_openmodify_request
->parent_bank_name		结算开户银行名称String(32)需严格按照银行列表上送， 部分银行支持多种上送方式，选其一上送即可。 注：测试环境建议使用工农中建交。必填
merchant_openmodify_request
->parent_bank_code		结算开户银行号String(20)结算开户银行号，编码参考《银行编码》必填
merchant_openmodify_request
->province		开户行所在省String(6)开户行所在省，开户行所在市必须同时上送，地区编码参考《地区编码》必填
merchant_openmodify_request
->city		开户行所在市String(6)开户行所在市，开户行所在市必须同时上送，地区编码参考《地区编码》必填
merchant_openmodify_request
->branch_bank_code		支付行号String(12)对公时支付行号、开户支行名称二选一必填，参考《支行编码》中完整支行编码可选
merchant_openmodify_request
->branch_bank_name		开户支行名称String(32)对公时支付行号、开户支行名称二选一必填，参考《支行编码》中完整支行编码可选
merchant_openmodify_request
->settle_photo_a		结算卡正面，参考《图片上传接口》String图片id必填
merchant_openmodify_request
->settle_photo_b		结算卡背面，参考《图片上传接口》String图片id必填
merchant_open_request
->remained_amt		留存金额Number(10)小于等于该金额不会结算，单位为分，取值范围[0,9999999999]；手动提现时无需填写可选
merchant_open_request
->settle_abstract		结算摘要String(60)如果需要自定义结算打款备注，请使用此字段传入，默认为空。示例值：业务收款；手动提现时无需填写可选

交易返回报文

JSON:

  1. {
  2.     "response_type": "merchant_openmodify_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_openmodify_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_openmodify_response必填
isspid商户号String(8)翼码商户号，由翼码提供必填
pos_seq请求流水号String(32)请求流水号可选
trans_time交易时间String(14)交易时间，格式：yyyyMMddHHmmss必填
result
->id		响应码String(4)翼码平台返回的处理结果,0000-成功，其它失败，错误信息说明见“响应码解释”字段必填
result
->comment		响应码解释String(64)响应码对应中文注解，用于显示提示必填

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