转账/退款接口

trac01 转账

功能说明

适用产品企账通/app+，实现从用户子账户间转账。

调用方式：后台返回

调用地址：

请求参数

参数中文名称 参数名称 数据格式 是否必须 说明
版本号 version 定长2位String 必须 目前固定为10
商户客户号 mer_cust_id 定长16位String 必须 由汇付生成，商户的唯一性标识 出账方商户客户号
订单号 order_id 变长50位String 必须  
订单日期 order_date 定长8位String 必须  
出账客户号 out_cust_id 定长16位String 必须 出账客户号必须是商户客户号下对应的用户或商户本身
出账子账户号 out_acct_id 变长9位String 必须  
入账商户客户号 in_mer_cust_id 定长16位String 可选  
入账客户号 in_cust_id 定长16位String 必须  
入账子账户号 in_acct_id 变长9位String 必须  
转账金额 trans_amt 变长14位String 必须 金额格式必须是###.00
设备信息 dev_info_json 变长1024位String 可选 json格式如：{“ipAddr”:”10.99.195.11”,”devType”:”2”,”MAC”:”D4-81-D7-F0-42-F8”,”IMEI”:”3553200846666033”}； 详细说明请见下面表格。
商户私有域 mer_priv 变长120位String 可选  
扩展域 extension 变长512位String 可选  

返回参数

参数中文名称 参数名称 数据格式 是否必须 说明
应答返回码 resp_code 定长6位String 必须  
应答返回描述 resp_desc 变长String 必须 返回码的对应中文描述
商户客户号 mer_cust_id 定长16位String 必须 由汇付生成，商户的唯一性标识
订单号 order_id 变长50位String 必须  
订单日期 order_date 定长8位String 必须  
出账客户号 out_cust_id 定长16位String 必须  
出账子账户号 out_acct_id 变长9位String 必须  
入账客户号 in_cust_id 定长16位String 必须  
入账子账户号 in_acct_id 变长9位String 必须  
转账金额 trans_amt 变长14位String 必须 金额格式必须是###.00
商户私有域 mer_priv 变长120位String 可选  
扩展域 extension 变长512位String 可选  

返回码

返回码 返回描述
公共返回码  
A30002 入账方商户状态异常
A30004 入账商户号不存在
A30005 出账客户号不存在
A30006 入账客户号不存在
A30007 出账用户状态异常
A30008 入账用户状态异常
A30009 出账账户号不存在
A30010 入账账户号不存在
A30011 出账账户状态异常
A30012 入账账户状态异常
A30013 账户余额不足
A30014 个人用户账户不能出账

pay006 延时分账确认

功能说明

适用产品企账通/app+,针对延时分账交易，请求本接口完成分账确认流程，支持多次分账确认。延时分账确认后的交易如果撤销需要调用退货接口

调用方式：后台返（同步）

调用地址：

请求参数

参数中文名称 参数名称 数据格式 是否必须 说明
版本号 version 定长2位String 必须 目前固定为10
商户客户号 mer_cust_id 定长16位String 必须 由汇付生成，商户的唯一性标识
订单号 order_id 变长50位String 必须 由商户生成，必须保证唯一， 50位内的字母或数字组合
订单日期 order_date 定长8位String 必须 格式为YYYYMMDD，例如：20160307
原订单号 org_order_id 变长50位String 必须 原支付时传入的订单号
原订单日期 org_order_date 定长8位String 必须 原支付时传入的订单日期
原交易类型 org_trans_type 变长2位String 必须 10:个人网银,11:企业网银,12:快捷,13:代扣,14:微信正扫,15:支付宝正扫,16:银联正扫,17:微信反扫,18:支付宝反扫,19:银联反扫,20:微信app支付,21:支付宝app支付,22:支付宝统一下单,23:微信公众号支付,24:applepay,25:微信H5支付,26:支付宝H5支付,27:小程序支付,28:人脸支付,30:余额支付,33:微信正扫(直连),34:微信app支付(直连),35:银联app支付,36:微信H5支付(直连),37:银联H5支付,38:支付宝app支付(直连),39:支付宝H5支付(直连),40:众邦虚拟账户余额支付,41聚合正扫,42凯德美团线下打款预下单,43垫资(线下打款)
订单确认金额 trans_amt 变长20位String 必须 share_fee_mode=0(非手续费分摊模式)时，以各支付接口返回值的real_trans_amt为准；share_fee_mode=1(手续费分摊模式)时，以各支付接口请求参数的trans_amt为准
入账客户号 in_cust_id 定长16位String 可选 入账客户号与分账账户串二选一传入
入账账户号 in_acct_id 变长9位String 可选 入账客户号不为空时，不传默认入客户默认子账户
分账账户串 div_details 变长9位String 可选 入账客户号与分账账户串二选一传入 数据格式： [{‘divCustId’:‘6666000000025350’,’divAcctId’:‘78276’,’divAmt’:‘50.00’},{‘divCustId’:‘6666000000025666’,’divAcctId’:‘78841’,’divAmt’:‘50.00’ }] 内容说明见下文分账串内容定义 注：分账串金额之和需等于总金额 最多支持5条分账指令
设备信息 dev_info_json 变长1000位String 可选 json格式如：{“ipAddr”:”10.99.195.11”,”devType”:”2”,”MAC”:”D4-81-D7-F0-42-F8”,”IMEI”:”3553200846666033”}； 详细说明请见下面表格。
商户私有域 mer_priv 变长120位的String 可选 为商户的自定义字段，该字段在交易完成后由本平台原样返回
扩展域 extension 变长512位的String 可选 用于扩展请求参数
手续费分摊模式标志 share_fee_mode 定长1位String 可选 0：非手续费分摊模式 1：手续费分摊模式默认：0（只有手续费内扣时，才需要计算分摊手续费，具体见案例说明

分账账户串（div_details）

注：分账串最大支持5个

参数中文名称 参数名称 数据格式 是否必须 说明
分账客户号 divCustId 定长16位String 必须  
分账账户号 divAcctId 变长9位String 必须  
分账金额 divAmt 变长14位String 必须 分账金额，保留两位小数
分摊手续费 shareFeeAmt 变长14位String 可选 该字段不能作为请求参数传入，仅当请求参数传入div_details，并且share_fee_mode=1时，在返回参数的div_details中会返回该字段

案例说明： 假定前提场景1：支付交易属于延时分账、手续费内扣（外扣不考虑分摊手续费），总交易金额100元(trans_amt)，手续费5元，接口返回值的可分账金额为95元(real_trans_amt) 非手续费分摊模式(share_fee_mode=0)时： 总分账金额最大只能传入95元（以交易接口返回值的real_trans_amt为准），比如[{divAcctId:A,divAmt:30},{divAcctId:B,divAmt:32},{divAcctId:C,divAmt:33}]，则A账户实际入账30元，B账户实际入账32元，C账户实际入账33元。该模式不涉及到手续费相关的计算 手续费分摊模式(share_fee_mode=1)时： 总分账金额最大只能传入100元（以交易接口请求参数的trans_amt为准），比如[{divAcctId:A,divAmt:20},{divAcctId:B,divAmt:30},{divAcctId:C,divAmt:50}]，则A账户实际入账19元（扣除1元的分摊手续费），B账户实际入账28.5元（扣除1.5元的分摊手续费），C账户实际入账47.5元（扣除2.5元的分摊手续费）。

返回参数

参数中文名称 参数名称 数据格式 是否必须 说明
应答返回码 resp_code 定长6位String 必须 –调用成功，其他见返回码附件表
应答返回描述 resp_desc 变长String 必须 返回码的对应中文描述
商户客户号 mer_cust_id 定长16位String 必须 由汇付生成，商户的唯一性标识
订单号 order_id 变长20位String 必须 由商户生成，必须保证唯一， 20位内的字母或数字组合
订单日期 order_date 定长8位String 必须 格式为YYYYMMDD，例如：20160307
本平台交易唯一标识号 platform_seq_id 变长20位String 必须  
原订单号 org_order_id 变长20位String 必须 原支付时传入的订单号
原订单日期 org_order_date 定长8位String 必须 原支付时传入的订单日期
原交易类型 org_trans_type 变长2位String 必须 原支付交易类型
订单确认金额 trans_amt 变长20位String 必须 总确认金额以账户实际到账金额为准
入账客户号 in_cust_id 定长16位String 可选  
入账账户号 in_acct_id 变长9位String 可选  
入账明细 div_details 变长String 可选 原样返回请求参数的div_details，当请求参数传入div_details，并且share_fee_mode=1时，返回参数div_details中会额外返回字段shareFeeAmt
商户私有域 mer_priv 变长120位的String 可选 为商户的自定义字段，该字段在交易完成后由本平台原样返回
扩展域 extension 变长512位的String 可选 用于扩展请求参数
分摊手续费 share_fee_amt 变长20位String 可选 仅当请求参数传入in_cust_id与in_acct_id，并且share_fee_mode=1时，该返回值有效

返回码

返回码 返回描述
公共返回码  
H10033 原订单不存在
H10034 原订单状态异常
H10035 原交易不支持订单确认
H10036 原订单可确认金额不足

pay011 余额支付（页面版）

功能说明

适用产品企账通，提供商户账户支付功能，调用后跳转支付密码输入页面。

调用方式：页面调用

调用地址

请求参数

参数中文名称 参数名称 数据格式 是否必须 说明
版本号 version 定长2位String 必须 目前固定为10
商户客户号 mer_cust_id 定长16位String 必须 由汇付生成，商户的唯一性标识
用户客户号 user_cust_id 定长16位String 必须 由汇付生成，，付款方唯一性标识
订单号 order_id 变长50位String 必须 由商户生成，必须保证唯一， 50位内的字母或数字组合
订单日期 order_date 定长8位String 必须 格式为YYYYMMDD，例如：20160307
出账账户号 out_acct_id 变长9位String 可选 付款方出账账户，不传默认用户基本账户
延时分账 div_type 定长1位String 可选 0：实时分账 1：延时分账 注：延时分账时，in_cust_id、in_acct_id、div_details必须为空
入账客户号 in_cust_id 定长16位String 可选 in_cust_id，in_acct_id和div_details二选一； 不分账时，可直接填写in_cust_id，in_acct_id
入账账户号 in_acct_id 变长9位String 可选 in_cust_id，in_acct_id和div_details二选一； 不分账时，可直接填写in_cust_id，in_acct_id
分账串 div_details 变长String 可选 in_cust_id，in_acct_id和div_details二选一
交易金额 trans_amt 变长20位String 必须 总确认金额以账户实际到账金额为准
手续费账户 fee_acct_id 变长9位String 可选  
手续费客户号 fee_cust_id 定长16位String 可选  
设备信息 dev_info_json 变长1000位String 可选 json格式如：{“ipAddr”:”10.99.195.11”,”devType”:”2”,”MAC”:”D4-81-D7-F0-42-F8”,”IMEI”:”3553200846666033”}； 详细说明请见下面表格。
请求类型 request_type 定长1位String 可选 P：PC端; M：移动端; 默认PC端
页面跳转地址 ret_url 变长128位的String 可选 页面调用方式使用，不传默认跳转汇付默认结果页
商户私有域 mer_priv 变长120位的String 可选 为商户的自定义字段，该字段在交易完成后由本平台原样返回
扩展域 extension 变长512位的String 可选 用于扩展请求参数
订单超时时间 order_expire_time 定长14位String 可选 格式为 yyyyMMddHHmmss
后台返回地址 bg_ret_url 变长128位的String 可选 注意： 1) URL中请不要包含特殊字符 2) 必须是外网地址 3) 如果不填，将接收不到异步通知

分账账户串（div_detail）

注：分账串最大支持5个

参数中文名称 参数名称 数据格式 是否必须 说明
分账客户号 divCustId 定长16位的String 必须  
分账账户号 divAcctId 变长9位String 必须  
分账金额 divAmt 变长14位String 必须 分账金额，保留两位小数

返回参数

参数中文名称 参数名称 数据格式 是否必须 说明
应答返回码 resp_code 定长6位String 必须 –调用成功，其他见返回码附件表
应答返回描述 resp_desc 变长String 必须 返回码的对应中文描述
商户客户号 mer_cust_id 定长16位String 必须 由汇付生成，商户的唯一性标识
用户客户号 user_cust_id 定长16位String 必须 由汇付生成，用户的唯一性标识
订单号 order_id 变长50位String 必须 由商户生成，必须保证唯一， 20位内的字母或数字组合
订单日期 order_date 定长8位String 必须 格式为YYYYMMDD，例如：20160307
本平台交易唯一标识号 platform_seq_id 变长20位String 可选  
出账账户号 out_acct_id 变长9位String 可选 付款方出账账户，不传默认用户基本账户
交易金额 trans_amt 变长20位String 必须 交易金额以账户实际到账金额为准
手续费 fee_amt 变长20位String 可选  
手续费账户 fee_acct_id 变长9位String 可选  
手续费客户号 fee_cust_id 定长16位String 可选  
可分账金额 real_trans_amt 变长20位String 可选 延迟分账用，订单交易成功时有效； 该字段配合“延时分账确认”接口的“非手续费分摊模式” 使用，如果“延时分账确认”接口中字段share_fee_mode=1(手续费分摊模式)，则忽略字段real_trans_amt
入账客户号 in_cust_id 定长16位String 可选  
入账账户号 in_acct_id 变长9位String 可选  
入账明细 div_details 变长String 可选  
请求类型 request_type 定长1位String 定长1位String  
页面跳转地址 ret_url 变长128位String 可选 页面调用方式使用，不传默认跳转汇付默认结果页
商户私有域 mer_priv 变长120位String 可选 为商户的自定义字段，该字段在交易完成后由本平台原样返回
扩展域 extension 变长512位String 可选 用于扩展请求参数

返回码

返回码 返回描述
公共返回码  

页面展示

PC版 ——已开户绑卡场景

_static/images/pay011_p.png

手机版 ——已开户绑卡场景

_static/images/pay011_m.png

pay026 余额支付（后台版）

功能说明

适用产品企账通，提供账户支付功能，不支持个人用户。

调用方式：后台返回（同步）

调用地址：

请求参数

参数中文名称 参数名称 数据格式 是否必须 说明
版本号 version 定长2位String 必须 目前固定为10
商户客户号 mer_cust_id 定长16位String 必须 由汇付生成，商户的唯一性标识
用户客户号 user_cust_id 定长16位String 必须 由汇付生成，，付款方唯一性标识
订单号 order_id 变长50位String 必须 由商户生成，必须保证唯一， 50位内的字母或数字组合
订单日期 order_date 定长8位String 必须 格式为YYYYMMDD，例如：20160307
出账账户号 out_acct_id 变长9位String 可选 付款方出账账户，不传默认用户基本账户
延时分账 div_type 定长1位String 可选 0：实时分账 1：延时分账 默认0实时分账 注：延时分账时，in_cust_id、in_acct_id、div_details必须为空
入账客户号 in_cust_id 定长16位String 可选 in_cust_id，in_acct_id和div_details二选一； 不分账时，可直接填写in_cust_id，in_acct_id
入账账户号 in_acct_id 变长9位String 可选 in_cust_id，in_acct_id和div_details二选一； 不分账时，可直接填写in_cust_id，in_acct_id
分账串 div_details 变长String 可选 in_cust_id，in_acct_id和div_details二选一
交易金额 trans_amt 变长20位String 必须 总确认金额以账户实际到账金额为准
手续费账户 fee_acct_id 变长9位String 可选  
手续费客户号 fee_cust_id 定长16位String 可选  
设备信息 dev_info_json 变长1000位String 可选 json格式如：{‘devType’:‘2’,’devSysType’:‘1’,’UUID’:’‘,’MAC’:’‘,’IMEI’:’‘,’IMSI’:’‘,’ICCID’:’‘,’MEID’:’‘,’SEID’:’‘,’ipAddr’:‘10.99.195.11’,’ipType’:’‘,’ipProvName’:’‘,’ipCityName’:’‘,’ipAreaName’:’‘,’ipProvCode’:’‘,’ipCityCode’:’‘,’ipAreaCode’:’‘,’cenX’:’‘,’cenY’:’‘,’provName’:’‘,’cityName’:’‘,’areaName’:’‘,’provCode’:’‘,’cityCode’:’‘,’areaCode’:’‘,’unDevCode’:’‘,’serviceProviderIp’:’‘,’merUrl’:’‘}； 详细说明请见下面表格。
商户私有域 mer_priv 变长120位String 可选 为商户的自定义字段，该字段在交易完成后由本平台原样返回
扩展域 extension 变长512位String 可选 用于扩展请求参数

分账账户串（div_details）

参数中文名称 参数名称 数据格式 是否必须 说明
分账客户号 divCustId 定长16位String 必须  
分账账户号 divAcctId 变长9位String 必须  
分账金额 divAmt 变长14位String 必须 分账金额，保留两位小数

返回参数

参数中文名称 参数名称 数据格式 是否必须 说明
应答返回码 resp_code 定长6位String 必须 –调用成功，其他见返回码附件表
应答返回描述 resp_desc 变长String 必须 返回码的对应中文描述
商户客户号 mer_cust_id 定长16位String 必须 由汇付生成，商户的唯一性标识
用户客户号 user_cust_id 定长16位String 必须 由汇付生成，用户的唯一性标识
订单号 order_id 变长50位String 必须 由商户生成，必须保证唯一， 50位内的字母或数字组合
订单日期 order_date 定长8位String 必须 格式为YYYYMMDD，例如：20160307
本平台交易唯一标识号 platform_seq_id 变长20位String 可选  
出账账户号 out_acct_id 变长9位String 可选 付款方出账账户，不传默认用户基本账户
交易金额 trans_amt 变长20位String 必须 交易金额以账户实际到账金额为准
手续费 fee_amt 变长20位String 可选  
手续费账户 fee_acct_id 变长9位String 可选  
手续费客户号 fee_cust_id 定长16位String 可选  
可分账金额 real_trans_amt 变长20位String 可选 延迟分账用，订单交易成功时有效； 该字段配合“延时分账确认”接口的“非手续费分摊模式” 使用，如果“延时分账确认”接口中字段share_fee_mode=1(手续费分摊模式)，则忽略字段real_trans_amt
入账客户号 in_cust_id 定长16位String 可选  
入账账户号 in_acct_id 变长9位String 可选  
入账明细 div_details 变长String 可选  
商户私有域 mer_priv 变长120位String 可选 为商户的自定义字段，该字段在交易完成后由本平台原样返回
扩展域 extension 变长512位String 可选 用于扩展请求参数

返回码

返回码 返回描述
公共返回码  
H10101 不支持个人用户支付

reb001 退款

功能说明

适用产品企账通/app+，用于商户发起退款功能。未做延时分账的请使用该接口退款，如果做过延时分账确认则需要调用退货接口。

调用方式：后台返回（同步，异步）

调用地址：

请求参数

参数中文名称 参数名称 数据格式 是否必须 说明
版本号 version 定长2位String 必须 目前固定为10
商户客户号 mer_cust_id 定长16位String 必须 由汇付生成，商户的唯一性标识
订单日期 order_date 定长8位String 必须 格式为“yyyyMMdd”
订单号 order_id 变长50位String 必须  
原交易订单日期 org_order_date 定长8位String 必须  
原交易订单号 org_order_id 变长50位String 可选 原订单号与原流水号必传其一
原交易流水号 org_seq_id 变长64位String 可选 原订单号与原流水号必传其一
原入账客户号 in_cust_id 定长16位String 可选 原交易的“延时分账”为“1：延时分账”时，“原入账客户号”、“原入账账户号”和“退款明细”不填；原交易的“延时分账”为“0：实时分账”时，“原入账客户号、原入账账户号”和“退款明细”二选一 ；
原入账账户号 in_acct_id 定长8位String 可选  
退款明细 div_details 变长String 可选 数据格式： [{‘divCustId’:‘6666000000025350’,’divAcctId’:‘78276’,’divAmt’:‘50.00’},{‘divCustId’:‘6666000000025666’,’divAcctId’:‘78841’,’divAmt’:‘50.00’ }] 内容说明见下文分账串内容定义 注：分账串金额之和需等于退款金额 最多支持5条分账指令
原交易类型 trans_type 变长2位String 可选 10：个人网银 11：企业网银 12：快捷 13：代扣 14：微信正扫 15：支付宝正扫 16：银联正扫 17：微信反扫 18：支付宝反扫 19：银联反扫 20：微信app支付 21：支付宝app支付 22：支付宝统一下单 23：微信公众号支付 24：apple pay 25：微信H5支付 26：支付宝H5支付 27：小程序支付 30：余额支付 33 : 微信正扫(直连) 34: 微信app支付(直连) 35 : 银联app支付 38 : 支付宝app支付(直连) 40：众邦虚拟账户余额支付
退款金额 trans_amt 变长20位String 必须  
备注 remark 变长256位String 可选 退款备注信息
后台返回地址 bg_ret_url 变长128位String 可选 通过后台异步通知商户绑卡结果
商户私有域 mer_priv 变长120位String 可选 为商户的自定义字段，该字段在交易完成后由本平台原样返回
扩展域 extension 变长512位String 可选 用于扩展请求参数
设备静态信息 dev_info_json 变长2000位String 必填 json格式如：{“ipAddr”:”10.99.195.11”,”devType”:”2”,”MAC”:”D4-81-D7-F0-42-F8”,”IMEI”:”3553200846666033”}； 详细说明请见下面表格。

分账账户串（div_details）

参数中文名称 参数名称 数据格式 是否必须 说明
分账客户号 divCustId 定长16位String 必须  
分账账户号 divAcctId 变长9位String 必须  
分账金额 divAmt 变长14位String 必须 分账金额，保留两位小数

返回参数

参数中文名称 参数名称 数据格式 是否必须 说明
应答返回码 resp_code 定长6位String 必须 C00000–调用成功，其他见一级返回码表
应答返回描述 resp_desc 变长String 必须 一级返回码的对应中文描述
商户唯一标识号 mer_cust_id 定长16位 必须 由汇付生成，商户的唯一性标识
订单日期 order_date 定长8位String 必须 格式为“yyyyMMdd”
订单号 order_id 变长50位String 必须  
退款金额 trans_amt 变长20位String 必须  
退款明细 div_details 变长String 必须 数据格式： [{‘divCustId’:‘6666000000025350’,’divAcctId’:‘78276’,’divAmt’:‘50.00’},{‘divCustId’:‘6666000000025666’,’divAcctId’:‘78841’,’divAmt’:‘50.00’ }] 内容说明见下文分账串内容定义 注：分账串金额之和需等于退款金额 最多支持5条分账指令
本平台交易唯一标识号 platform_seq_id 变长20位String 可选 汇付生成唯一流水号
后台返回地址 bg_ret_url 变长128位String 必须  
商户私有域 mer_priv 变长120位String 可选 为商户的自定义字段，该字段在交易完成后由本平台原样返回
扩展域 extension 变长512位String 可选 用于扩展请求参数
实退手续费 fee_amt 变长20位String 必须  
应退手续费 expect_refund_fee_amt 变长20位String 必须  
垫付手续费 advance_refund_fee_amt 变长20位String 必须 原交易入账方退款不退费时,垫付手续费金额

返回码

返回码 返回描述
公共返回码  
H51001 退货金额不能大于交易金额
H51003 退货分账金额不足
H51006 原交易实时分账退款分账串不能为空
H51002 分账信息不存在
H51004 退货失败
H51005 退款失败
H51006 退货失败原确认明细异常
H51007 退款通道失败
H51008 不支持该交易类型的退款

reb002 退货

功能说明

适用产品企账通/app+，本接口用于延时分账确认后的交易，做退款。

调用方式：后台返回（同步，异步）

调用地址：

请求参数

参数中文名称 参数名称 数据格式 是否必须 说明
版本号 version 定长2位String 必须 目前固定为10
商户客户号 mer_cust_id 定长16位String 必须 由汇付生成，商户的唯一性标识
订单日期 order_date 定长8位String 必须 格式为“yyyyMMdd”
订单号 order_id 变长50位String 必须  
原确认订单日期 org_order_date 定长8位String 必须  
原确认订单号 org_order_id 变长50位String 必须  
退货金额 trans_amt 变长20位String 必须  
退货明细 div_details 变长String 可选 数据格式： [{‘divCustId’:‘6666000000025350’,’divAcctId’:‘78276’,’divAmt’:‘50.00’},{‘divCustId’:‘6666000000025666’,’divAcctId’:‘78841’,’divAmt’:‘50.00’ }] 内容说明见下文分账串内容定义 注：分账串金额之和需等于退款金额 最多支持5条分账指令
备注 remark 变长256位String 可选 退款备注信息
后台返回地址 bg_ret_url 变长128位String 可选 通过后台异步通知商户绑卡结果
商户私有域 mer_priv 变长120位String 可选 为商户的自定义字段，该字段在交易完成后由本平台原样返回
扩展域 extension 变长512位String 可选 用于扩展请求参数
设备静态信息 dev_info_json 变长2000位String 必填 json格式如：{“ipAddr”:”10.99.195.11”,”devType”:”2”,”MAC”:”D4-81-D7-F0-42-F8”,”IMEI”:”3553200846666033”}； 详细说明请见下面表格。

分账账户串（div_details）

参数中文名称 参数名称 数据格式 是否必须 说明
分账客户号 divCustId 定长16位的String 必须  
分账账户号 divAcctId 变长9位String 必须  
分账金额 divAmt 变长14位String 必须 分账金额，保留两位小数

返回参数

参数中文名称 参数名称 数据格式 是否必须 说明
应答返回码 resp_code 定长6位String 必须 C00000–调用成功，其他见一级返回码表
退货明细 div_details 变长String 必须 数据格式： [{‘divCustId’:‘6666000000025350’,’divAcctId’:‘78276’,’divAmt’:‘50.00’},{‘divCustId’:‘6666000000025666’,’divAcctId’:‘78841’,’divAmt’:‘50.00’ }] 内容说明见下文分账串内容定义 注：分账串金额之和需等于退款金额 最多支持5条分账指令
本平台交易唯一标识号 platform_seq_id 变长20位String 可选 汇付生成唯一流水号
订单日期 order_date 定长8位String 必须 格式为“yyyyMMdd”
订单号 order_id 变长50位String 必须  
后台返回地址 bg_ret_url 变长128位String 必须  
商户私有域 mer_priv 变长120位String 可选 为商户的自定义字段，该字段在交易完成后由本平台原样返回
扩展域 extension 变长512位的String 可选 用于扩展请求参数
实退手续费 fee_amt 变长20位String 必须  
应退手续费 expect_refund_fee_amt 变长20位String 必须  
垫付手续费 advance_refund_fee_amt 变长20位String 必须 原交易入账方退款不退费时,垫付手续费金额

返回码

返回码 返回描述
公共返回码  
H51001 退货金额不能大于交易金额
H51003 退货分账金额不足
H51006 原交易实时分账退款分账串不能为空
H51002 分账信息不存在
H51004 退货失败
H51005 退款失败
H51006 退货失败原确认明细异常
H51007 退款通道失败