简要描述：

  • 本接口用于商户入网接口

请求URL:

请求参数:

参数 参数名称 类型 参数说明 样例 可空
agent_no 服务商编号 String 服务商的编号，由SAAS平台分配，表示当前商户属于该服务商名下 88888888 M
agent_apply_no 服务商申请单号 String 服务商申请单号 由服务商自行生成的且不重复的单号 M
merchant_data 商户信息 JSON 参考下表（商户信息：merchant_data） M
bankcard_data 结算卡信息 JSON 参考下表（结算卡信息：bankcard_data） M
image_data 商户资质图片信息 JSON 参考下表（资质图片信息：image_data） M
商户信息：merchant_data
参数 参数名称 类型 参数说明 样例 可空
merch_name 商户全称 String 中国大餐厅 M
province_code 实际经营地址：省代码 String 取值详见附录：省市区代码 M
city_code 实际经营地址：市代码 String 取值详见附录：省市区代码 M
area_code 实际经营地址：区代码 String 取值详见附录：省市区代码 M
address 实际经营地址：详细地址 String M
legal_name 联系人姓名 String 上送个人姓名 M
legal_cert_type 联系人证件类型 String 1:身份证
小微商户上送个人证件类型		 M
legal_cert_no 联系人证件号 String 小微商户上送个人证件号码 M
contact_phone 联系人手机号 String M
contact_email 联系人邮箱 String M
bus_scope_code 营业范围代码 String 取值详见附录：营业范围 M
trade_notify 交易异步通知地址（碰一碰交易使用） String O
risk_notify 风控异步通知地址（碰一碰交易使用） String O
结算卡信息：bankcard_data
参数 参数名称 类型 参数说明 样例 可空
acc_no 结算账户号 String M
acc_name 结算账户名称 String M
idcard_no 持卡人身份证号 String M
phone 预留手机号 String M
bank_code 结算账户清算行号 String 取值详见附录：银行代码 M
bank_province_code 开户行网点 对应的省代码 String 取值详见附录：省市区代码 M
bank_city_code 开户行网点 对应的市代码 String 取值详见附录：省市区代码 M
settlement_cycle 结算方式 String Ts,D1(二选一),不填默认Ts D1 O
withdrawal_feemin 单笔最低提现手续费 String 单位为：元，比如手续费为 1, 需要传 1 M
product_data 开通产品信息 JSON 参考下表（开通产品信息：product_data） M
开通产品信息：product_data
参数 参数名称 类型 参数说明 样例 可空
union 费率信息（银联二维码） JSON 参考下表（开通产品信息：union_data） M
quick 费率信息（快捷） JSON 参考下表（开通产品信息：union_data） 测试环境 地址(110000、110100、110101)、mcc（5462）需要固定 M
touch 费率信息（碰一碰） JSON 参考下表（开通产品信息：union_data） M
开通产品信息：union_data
参数 参数名称 类型 参数说明 样例 可空
rate 费率 JSON 费率单位：万分之一，例如费率为0.6,需要传60;手续费封顶单位：分;区间范围必须包括0-50000。 {"union_debit_rate":"41","union_debit_max":"2000","union_credit_rate":"43","union_mix_rate":"44"} O(费率与阶梯费率二选一进行传递)
step_rate 阶梯费率 String 费率单位：万分之一，例如费率为0.6,需要传60;手续费封顶单位：分;银联二维码第一个区间必须为0-1000.01;区间范围必须包括0-50000。 [{“min_amt”:0,”max_amt”:1000.01,”union_mix_rate”:”44”},{“min_amt”:1000.01,”max_amt”:10000000,”union_debit_rate”:”41”,”union_debit_max”:”200000”,”union_credit_rate”:”43”}] O(费率与阶梯费率二选一进行传递)
普通费率字段信息说明：rate
参数 参数名称 类型 参数说明 样例 可空
union_debit_rate 银联二维码借记卡费率 String 单位：万分之一，例如费率为0.6,需要传60; M
union_debit_max 银联二维码借记卡手续费封顶 String 单位：分 M
union_credit_rate 银联二维码贷记卡费率 String 单位：万分之一，例如费率为0.6,需要传60; M
union_mix_rate 银联二维码1000以下包括1000费率值 String 单位：万分之一，例如费率为0.6,需要传60; M
阶梯费率信息：step_rate
参数 参数名称 类型 参数说明 样例 可空
min_amt 区间金额开始 String M
max_amt 区间金额结束 String M
union_debit_rate 银联二维码借记卡费率 String M
union_debit_max 银联二维码借记卡手续费封顶 String M
union_credit_rate 银联二维码贷记卡费率 String M
资质图片信息：image_data
参数 参数名称 类型 参数说明 样例 可空
A2 联系人身份证正面图片id String M
A3 联系人身份证反面图片id String M
A4 结算卡正面/开户许可证（基本户）图片id String 结算卡对私：上传结算卡正面照片
结算卡对公：上传开户申请表/开户许可证照片		 M

请求示例:

{
    "agent_no":"11010200097",
    "agent_apply_no":"698378211873",
    "merchant_data":{
        "contact_name":"",
        "address":"北京市海淀区西直门金运大厦A座11楼",
        "legal_cert_type":"1",
        "contact_phone":"18709000001",
        "area_code":"110101",
        "merch_type":"",
        "city_code":"110100",
        "province_code":"110000",
        "contact_email":"saas@hkrt.cn",
        "merch_name":"碰一碰商户入网",
        "legal_cert_no":"110101199104073502",
        "bus_license_no":"",
        "legal_name":"张碰碰",
        "bus_scope_code":"00010007"
    },
    "bankcard_data":{
        "bank_code":"105100000017",
        "acc_type":"10B",
        "product_data":{
            "quick":{
                "rate":{
                    "union_debit_rate":"41",
                    "union_debit_max":"2000",
                    "union_credit_rate":"41",
                    "union_mix_rate":"41"
                },
                "step_rate":""
            }
        },
        "bank_province_code":"110000",
        "acc_name":"艾飞",
        "settlement_cycle":"TS",
        "phone":"18709000001",
        "withdrawal_rate":"0",
        "acc_no":"6214830166958131",
        "withdrawal_feemin":"0",
        "bank_city_code":"110100",
        "idcard_no":"110101199104073502"
    },
    "image_data":{
        "A2":"3d1429b94ee243bc863afc4735355904",
        "A3":"3d1429b94ee243bc863afc4735355904",
        "A4":"3d1429b94ee243bc863afc4735355904"
    },
    "accessid":"cpostest",
    "sign":"841CC6E8E79AA37BEB1A8BE5C9013D73"
}

返回参数说明:

参数 参数名称 类型 参数说明 样例 可空
merch_no SAAS平台商户编号 String 11001088888888 M

返回示例:

正确：
{
    "merch_no": "11010100002012",
    "return_code": 10000,    
    "sign": "E404975210F262C53AEA532C6A790E14"
}
错误：
{
    "return_code": 22027,
    "return_msg": "营业场所室内照2照片未上传正确"
}
文档更新时间: 2020-11-25 17:53   作者：冯海忠