线下打款接口

pay030 线下打款预下单接口

功能说明

适用产品企账通/app+，首先线下打款至众邦的电子户，然后商户调用本接口自动匹配线下打款入账

注意项：订单日期必须是当天，允许线下打款到账日期在订单日期的前一天/同一天/后一天（两个日期相差太大无法回款成功）；需要确保商户请求的参数中银行卡号、银行卡帐户名、交易金额必须与线下打款的相关信息严格对应，否则无法回款成功；本接口只支持工作日调用。

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

调用地址：

请求参数

参数中文名称 参数名称 数据格式 是否必须 说明
版本号 version 定长2位String 必须 目前固定为10
商户客户号 mer_cust_id 定长16位String 必须 由汇付生成，商户的唯一性标识
订单日期 order_date 定长8位String 必须 格式yyyyMMdd，案例：20180101
订单号 order_id 变长50位String 必须 商户自动生产，确保唯一
线下打款到账日期 pay_date 定长8位String 必须 格式yyyyMMdd，允许线下打款前一天打款到账，商户后一天调用本接口申请回款
线下打款银行卡号 card_num 变长9-32位String 必须 线下打款银行卡号
线下打款银行账户名称 card_name 变长50位String 必须 线下打款银行账户名称
交易金额 trans_amt 变长14位String 必须 单位元，带2位小数，格式：12.00
商户后台应答地址 bg_ret_url 变长128位String 可选 如果不填，则收不到异步通知，只能通过qry008接口反查订单状态。1、URL中请不要包含特殊字符；2、必须是外网地址。
商户私有域 mer_priv 变长120位String 可选  
商户扩展域 extension 变长512位String 可选  
设备信息 dev_info_json 变长1024位String 必填 json格式如：{“ipAddr”:”10.99.195.11”,”devType”:”2”,”MAC”:”D4-81-D7-F0-42-F8”,”IMEI”:”3553200846666033”}；注：ipAddr和devType必填，MAC和IMEI 二选一必填，见下文
交易发生地 transaction_addr 变长64位String 必填 例如：上海
用途 purpose 变长256位String 必填 例如：其他
对手方ip user_ip_addr 变长20位String 必填 用户终端ip

设备信息：

字段 字段描述 是否必须
devType 设备类型 1.电脑；2.手机 必填
ipAddr IP地址 必填
MAC MAC地址 选填
IMEI IMEI码 选填
devSysType 设备系统类型 1.IOS；2.安卓；3.windows 选填
UUID UUID 选填
IMSI IMSI码 选填
ICCID ICCID码 选填
MEID MEID码 选填
SEID SEID 选填
ipType IP地址类型代理、家庭、办公环境、网吧、学校等，直接给中文名称 选填
ipProvName IP省 选填
ipCityName IP市 选填
ipAreaName IP地区 选填
ipProvCode IP省编码 选填
ipCityCode IP市编码 选填
ipAreaCode IP地区编码 选填
cenX 定位（经度） 选填
cenY 定位（纬度） 选填
provName 定位地址（省） 选填
cityName 定位地址（市） 选填
areaName 定位地址（区） 选填
provCode 定位（省编码） 选填
cityCode 定位（市编码） 选填
areaCode 定位（区编码） 选填
unDevCode 用户交易设备（唯一识别码） 选填
serviceProviderIp 商户服务IP地址 选填
merUrl 商户网址 选填

返回参数

参数中文名称 参数名称 数据格式 是否必须 说明
应答返回码 resp_code 定长6位String 必须  
应答返回描述 resp_desc 变长String 必须 返回码的对应中文描述
商户客户号 mer_cust_id 定长16位String 必须 由汇付生成，商户的唯一性标识
订单号 order_id 变长50位String 必须  
订单日期 order_date 定长8位String 必须  
交易金额 trans_amt 变长14位String 可选  
商户后台应答地址 bg_ret_url 变长128String 可选  
商户私有域 mer_priv 变长120String 可选  
扩展域 extension 定长512位String 可选  

返回码

返回码 返回描述
公共返回码  
H10004 数据加密失败
H10118 众邦电子户配置异常

pay031 垫资（线下打款）接口

功能说明

适用美团、凯德联合营销项目。用于在凯德分账资金不足的情况下调用该接口进行户到户转账。

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

调用地址：

请求参数

参数中文名称 参数名称 数据格式 是否必须 说明
版本号 version 定长2位String 必须 目前固定为10
商户客户号 mer_cust_id 定长16位String 必须 由汇付生成，商户的唯一性标识
订单日期 order_date 定长8位String 必须 格式yyyyMMdd，案例：20220101
订单号 order_id 变长50位String 必须 商户自动生产，确保唯一
出账子账户号 out_acct_id 变长9位String 可选 默认从基本户出款
交易金额 trans_amt 变长14位String 必须 单位元，带2位小数，格式：12.00
商户私有域 mer_priv 变长120位String 可选  
商户扩展域 extension 变长512位String 可选  
设备信息 dev_info_json 变长1024位String 必须 json格式如：{“ipAddr”:”10.99.195.11”,”devType”:”2”,”MAC”:”D4-81-D7-F0-42-F8”,”IMEI”:”3553200846666033”}；注：ipAddr和devType必填，MAC和IMEI 二选一必填，见下文
交易发生地 transaction_addr 变长64位String 必须 例如：上海
用途 purpose 变长256位String 必须 例如：其他
对手方ip user_ip_addr 变长20位String 必须 用户终端ip

设备信息：

字段 字段描述 是否必须
devType 设备类型 1.电脑；2.手机 必填
ipAddr IP地址 必填
MAC MAC地址 选填
IMEI IMEI码 选填
devSysType 设备系统类型 1.IOS；2.安卓；3.windows 选填
UUID UUID 选填
IMSI IMSI码 选填
ICCID ICCID码 选填
MEID MEID码 选填
SEID SEID 选填
ipType IP地址类型代理、家庭、办公环境、网吧、学校等，直接给中文名称 选填
ipProvName IP省 选填
ipCityName IP市 选填
ipAreaName IP地区 选填
ipProvCode IP省编码 选填
ipCityCode IP市编码 选填
ipAreaCode IP地区编码 选填
cenX 定位（经度） 选填
cenY 定位（纬度） 选填
provName 定位地址（省） 选填
cityName 定位地址（市） 选填
areaName 定位地址（区） 选填
provCode 定位（省编码） 选填
cityCode 定位（市编码） 选填
areaCode 定位（区编码） 选填
unDevCode 用户交易设备（唯一识别码） 选填
serviceProviderIp 商户服务IP地址 选填
merUrl 商户网址 选填

返回参数

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

返回码

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

pay032 还款（线下打款）接口

功能说明

适用美团、凯德联合营销项目。用于凯德将原先垫资的资金通过该接口从临时过渡户还款至其基本户。

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

调用地址：

请求参数

参数中文名称 参数名称 数据格式 是否必须 说明
版本号 version 定长2位String 必须 目前固定为10
商户客户号 mer_cust_id 定长16位String 必须 由汇付生成，商户的唯一性标识
订单日期 order_date 定长8位String 必须 格式yyyyMMdd，案例：20220101
订单号 order_id 变长50位String 必须 商户自动生产，确保唯一
还款金额 trans_amt 变长14位String 必须 单位元，带2位小数，格式：12.00
垫资订单日期 advance_order_date 定长8位String 必须 格式yyyyMMdd，案例：20220101
垫资订单号 advance_order_id 变长50位String 必须  
线下打款预下单订单日期 offline_order_date 定长8位String 必须 格式yyyyMMdd，案例：20220101
线下打款预下单订单号 offline_order_id 变长50位String 必须  
商户私有域 mer_priv 变长120位String 可选  
商户扩展域 extension 变长512位String 可选  
设备信息 dev_info_json 变长1024位String 必须 json格式如：{“ipAddr”:”10.99.195.11”,”devType”:”2”,”MAC”:”D4-81-D7-F0-42-F8”,”IMEI”:”3553200846666033”}；注：ipAddr和devType必填，MAC和IMEI 二选一必填，见下文
交易发生地 transaction_addr 变长64位String 必须 例如：上海
用途 purpose 变长256位String 必须 例如：其他
对手方ip user_ip_addr 变长20位String 必须 用户终端ip

设备信息：

字段 字段描述 是否必须
devType 设备类型 1.电脑；2.手机 必填
ipAddr IP地址 必填
MAC MAC地址 选填
IMEI IMEI码 选填
devSysType 设备系统类型 1.IOS；2.安卓；3.windows 选填
UUID UUID 选填
IMSI IMSI码 选填
ICCID ICCID码 选填
MEID MEID码 选填
SEID SEID 选填
ipType IP地址类型代理、家庭、办公环境、网吧、学校等，直接给中文名称 选填
ipProvName IP省 选填
ipCityName IP市 选填
ipAreaName IP地区 选填
ipProvCode IP省编码 选填
ipCityCode IP市编码 选填
ipAreaCode IP地区编码 选填
cenX 定位（经度） 选填
cenY 定位（纬度） 选填
provName 定位地址（省） 选填
cityName 定位地址（市） 选填
areaName 定位地址（区） 选填
provCode 定位（省编码） 选填
cityCode 定位（市编码） 选填
areaCode 定位（区编码） 选填
unDevCode 用户交易设备（唯一识别码） 选填
serviceProviderIp 商户服务IP地址 选填
merUrl 商户网址 选填

返回参数

参数中文名称 参数名称 数据格式 是否必须 说明
应答返回码 resp_code 定长6位String 必须  
应答返回描述 resp_desc 变长String 必须 返回码的对应中文描述
商户客户号 mer_cust_id 定长16位String 必须 由汇付生成，商户的唯一性标识
订单号 order_id 变长50位String 必须  
订单日期 order_date 定长8位String 必须  
还款金额 trans_amt 变长14位String 必须  
垫资订单日期 advance_order_date 定长8位String 必须 格式yyyyMMdd，案例：20220101
垫资订单号 advance_order_id 变长50位String 必须  
线下打款预下单订单日期 offline_order_date 定长8位String 必须 格式yyyyMMdd，案例：20220101
线下打款预下单订单号 offline_order_id 变长50位String 必须  
商户私有域 mer_priv 变长120位String 可选  
商户扩展域 extension 变长512位String 可选  

返回码

返回码 返回描述
公共返回码  
H10120 垫资订单不存在
H10121 线下打款预下单订单不存在
H10122 当前垫资订单号不支持还款
H10123 当前线下打款预下单订单号不支持还款
H10124 还款金额不能超过剩余可还金额
H10125 线下打款金额不足