交易请求报文
JSON:
{"request_type": "merchant_openmodify_request","isspid": "00058301","pos_seq": "2022112500001","system_id": "8888","merchant_openmodify_request": {"merchant_id": "100010511","settle_type": "1","settlement_way": 0,"withdraw_way": 2,"withdraw_type": 1,"nature_day_num": 1,"settle_cycle": "T1","settle_fee_flag": 2,"settle_fee_account": "666000000000000001","settle_fee_acct_type": "01","card_name": "卡户名","card_no": "140220140960004xxx","parent_bank_name": "中国工商银行","parent_bank_code": "01020000","province": "350000","city": "350100","branch_bank_code": "102391052409","branch_bank_name": "中国工商银行股份有限公司福州铜盘支行","settle_photo_a": "111","settle_photo_b": "222","remained_amt": 100,"settle_abstract": "业务收款""non_identical_settlement_photo": "333",},"sign": "712036C2324D76F2934C44C95A80CEBA"}
XML:
<?xml version="1.0" encoding="GBK"?><business_trans><request_type>merchant_openmodify_request</request_type><isspid>00058301</isspid><pos_seq>2022112500001</pos_seq><system_id>8888</system_id><merchant_openmodify_request><merchant_id>100010511</merchant_id><settle_type>1</settle_type><settlement_way>0</settlement_way><withdraw_way>2</withdraw_way><withdraw_type>1</withdraw_type><nature_day_num>1</nature_day_num><settle_cycle>T1</settle_cycle><settle_fee_flag>2</settle_fee_flag><settle_fee_account>666000000000000001</settle_fee_account><settle_fee_acct_type>01</settle_fee_acct_type><card_name>卡户名</card_name><card_no>140220140960004xxx</card_no><parent_bank_name>中国工商银行</parent_bank_name><parent_bank_code>01020000</parent_bank_code><province>350000</province><city>350100</city><branch_bank_code>102391052409</branch_bank_code><branch_bank_name>中国工商银行股份有限公司福州铜盘支行</branch_bank_name><settle_photo_a>111</settle_photo_a><settle_photo_b>111</settle_photo_b><remained_amt>100</remained_amt><settle_abstract>业务收款</settle_abstract><non_identical_settlement_photo>333</non_identical_settlement_photo></merchant_openmodify_request></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 | 分账商户id | String | 分账商户id | 必填 |
| merchant_openmodify_request ->settle_type | 结算卡类型 | String(1) | 1:对公,2:对私; 个人用户仅支持传2 | 必填 |
| merchant_openmodify_request ->settlement_way | 结算方式 | Number | 0:提现,1:自动结算 | 必填 |
| merchant_openmodify_request ->withdraw_way | 提现方式 | Number | 1:手动提现,2:自动提现;当结算方式填0时,才需填写此项,不填默认为1 | 可选 |
| merchant_openmodify_request ->withdraw_type | 提现类型 | Number | 1:周期提现,2:账期提现;当提现方式填2时,此项为必填 | 可选 |
| merchant_openmodify_request ->nature_day_num | 提现间隔时间 | Number | 当有填写提现类型时此项必填,到达该时间后系统会进行自动提现,单位为自然日,取值范围[1,120]; 示例值: 1 | 可选 |
| merchant_openmodify_request ->settle_cycle | 到账时间 | String | T1:下一个工作日到银行账户 D1:下一个自然日到银行账户 D0:当日到银行账户 说明: 1、为空时不修改; 2、当结算方式为自动结算时,仅支持选择 T1、D1 其中一种; 3、当提现方式为自动提现时,仅支持选择 T1、D1、D0 其中一种; 4、当提现方式为手动提现时,此节点支持选择 T1、D1、D0 中的多个,使用半角逗号分隔。 | 可选 |
| merchant_openmodify_request ->settle_fee_flag | D1/D0手续费扣收方式 | Number | 1:外扣(从指定的账户中扣除手续费) 2:内扣(直接从提现/结算的收款账户中扣除) 说明: 1、为空时不修改; 2、当到账时间为D1或者D0时存在手续费,此节点才有效; 3、当选择外扣时,若外扣账户余额不足,会导致资金结算/提现失败; | 可选 |
| merchant_openmodify_request ->settle_fee_account | 手续费外扣账户 | String | 当D1/D0手续费扣收方式为外扣时必填,为空时不修改 手续费外扣账户仅能为子商户的所属上级收款账户编号 收款账户编号可在企账通控台的收款账户列表中查看 | 可选 |
| merchant_openmodify_request ->settle_fee_acct_type | 手续费外扣账户类型 | String | 01:基本户 05:充值户 为空时不修改,如需使用充值户请联系运营人员开通此账户。 | 可选 |
| merchant_openmodify_request ->card_name | 卡户名 | String(16) | 1、当结算卡类型为对公时,支持同名和非同名结算,但企业非同名时,需要上传【非同名结算证明材料】图片; 2、当结算卡类型为对私时,卡户名必须为法人姓名。 当对公结算时,不传默认使用营业执照名称; 当对私结算时,不传默认使用法人姓名。 | 可选 |
| 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 | 结算卡正面/开户许可证图片id | String | 当对私结算时,传法人结算卡正面图片id,必填; 当对公结算时,传开户许可证照片图片id,必填; 需使用《图片上传接口》提前上传图片得到图片id | 必填 |
| merchant_openmodify_request ->settle_photo_b | 结算卡反面图片id | String | 当对私结算时,传法人结算卡反面图片id,必填; 当对公结算时,为空; 需使用《图片上传接口》提前上传图片得到图片id | 可选 |
| merchant_open_request ->remained_amt | 留存金额 | Number(10) | 小于等于该金额不会结算,单位为分,取值范围[0,9999999999];手动提现时无需填写 | 可选 |
| merchant_open_request ->settle_abstract | 结算摘要 | String(60) | 如果需要自定义结算打款备注,请使用此字段传入,默认为空。示例值:业务收款;手动提现时无需填写 | 可选 |
| merchant_openmodify_request ->non_identical_settlement_photo | 非同名结算证明材料图片id | String | 当对公结算,且结算卡户名与企业非同名时,必填 需使用《图片上传接口》提前上传图片得到图片id | 可选 |
交易返回报文
JSON:
{"response_type": "merchant_openmodify_response","isspid": "00058301","pos_seq": "2022112500001","trans_time": "20221207154725","result": {"id": "0000","comment": "操作成功"},"sign": "03B62B8B16844549FFF01F4659B4AE0A"}
XML:
<?xml version="1.0" encoding="GBK"?><business_trans><response_type>merchant_openmodify_response</response_type><isspid>00058301</isspid><pos_seq>2022112500001</pos_seq><trans_time>20090405010104</trans_time><result><id>0000</id><comment>成功</comment></result></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) | 响应码对应中文注解,用于显示提示 | 必填 |
标准接口会因业务升级需要而新增节点,请在解析返回报文时避免新增未知节点产生的程序出错!


