shizhongqi/huahuibao_document @ 429ab7b4282e9dac6c064cf9fc8c231106b6fa9e

请求地址

测试环境：https://test.wsmsd.cn/sit
生产环境：https://s2.lakala.com
接口：/api/v3/tkbs/open_merchant_info
请求加密：SM4
返回解密：SM4

请求接口业务参数说明(reqData)

参数名称	参数说明	请求类型	是否必须	数据类型	schema
merchant_no	外部商户编号	body	FALSE	string	银联822商户号，外部商户编号与内部商户号二者至少选其一
customer_no	内部商户编号	body	FALSE	string	拓客系统商户号，外部商户编号与内部商户号二者至少选其一。（指的是 [[新增商户进件]] 返回的 merchant_no）
org_code	开放平台鉴权机构	body	TRUE	string

返回参数(respData)

OpenMerchantVO

参数名称	参数说明	类型	schema
customer	商户基础信息	Customer对象	Customer对象
customer_fee	商户费率信息	array	Customer_fee对象
external_no	外部编号	String	varchar(32)
pos	商户终端信息，绑定才有	Pos	Pos
product_vos	已有产品信息	array	Customer_product_vo对象
settle_card	商户结算信息	Customer_settle_card对象	Customer_settle_card对象
shop_info_list	网点信息	array	Shop_info对象
terminal_info	终端信息集合	array	terminal_info对象

Customer

参数名称	参数说明	类型	schema
active_no	激活码	string
activity_time	激活时间	string(date-time)
agency_no	机构号	integer(int64)
agent_no	服务商编号	integer(int64)
agreement_status	协议签署状态	string
biz_content	商户经营范围	string
bz_pos	POS类型	string
channel_type	商户类型 TP_MERCHANT:企业，TP_PERSONAL:小微,可用值:TP_MERCHANT,TP_PERSONAL	string
close_time	撤机时间	string(date-time)
contact_man_name	联系人改名	string
create_time		string(date-time)
customer_name	商户名称	string
customer_no	内部商户编号	integer(int64)	拓客系统商户号
customer_status	商户状态 OPEN:开通，CLOSE:关闭，LOSS:流失,WAIT_AUDI:审核中,REJECT:审核拒绝,REVIEW_FAIL:复核失败,REVIEW_AUDIT:复核审核中,ACTIVITY:激活	string
audit_remark	拒绝原因商户状态为REJECT返回
merchant_no	外部商户编号	string	银联822商户号
identity_no	商户身份证号	string
identity_no_expire	商户身份证号有效期	string
is_standard	是否达标 TRUE：是 FALSE：否	string
legal_name	法人姓名	string
license_no	营业执照号	string
mailbox	邮箱	string
mcc_code	商户类别码	string
mer_license_expire	营业执照号有效期	string
mer_name	企业名称	string
merchant_source	商户来源 AGENT:服务商平台，APP:APP平台，H5:H5平台	string
open_time	入网时间	string(date-time)
optimistic		integer(int32)
phone_no	商户手机号	string
platform	平台标识,可用值:LKL	string
pos_sn	机具序列号	string
position		string
reward_mode	刷够返奖励模式,可用值:TO_MERCHANT,TO_AGENT	string
standard_fee	提现费等固定费用	number(double)
standard_time	达标时间	string(date-time)
term_no	虚拟终端号	string
term_num	终端数量	integer(int32)
update_time		string(date-time)
ysf_discount	云闪付小额优惠[FALSE:否,TRUE:是]	string
province_name	省份名称	string
city_name	城市名称	string
county_name	区名称	string
receive_detail	详细地址	string

CustomerFee

参数名称	参数说明	类型	schema
card_type	卡类型,可用值:CREDIT_CARD,QR_CORD,DEBIT_CARD,YSF_LE_1000_CREDIT,YSF_LE_1000_DEBIT	string
create_time		string(date-time)
customer_no	商户编号	integer(int64)
day_limit	日限额	number(double)
merchant_no		string
fee_rate	费率	number(double)
id		integer(int64)
max_amt	手续费最多值	number(double)
min_amt	手续费最小值	number(double)
month_limit	月限额	number(double)
optimistic		integer(int32)
per_limi	单笔限额	number(double)
second_fee	秒到手续费	number(double)
trans_settle_type	结算类型,可用值:D0,D1,T1	string
trans_type	交易类型	string
trem_no	终端号	string	根据trans_type判断是刷卡还是扫码的终端号信息
update_time		string(date-time)
customer_management_fee	商户管理费费率	number(double)
customer_managementd_fee	商户管理费d	number(double)
customer_managemente_fee	商户管理费e	number(double)
customer_managementf_fee	商户管理费f	number(double)

Pos

参数名称	参数说明	类型
active_no	激活码	string
activity_flag	活动标识	string
open_time	开通时间	string
pos_sn	终端序列号	string
pos_type	终端类型	string
term_no	拉卡拉虚拟终端号	string

CustomerSettleCard

参数名称	参数说明	类型
able_status	可用状态 ,可用值:ENABLE,DISABLE	string
account_kind	账户性质。57：对公 58：对私	string
account_name	开户名	string
account_no	开户账号	string
audit_status	审核状态	string
bank_name	开户行名称	string
bank_no	开户行编号	string
city_code	城市编号	string
city_name	城市名称	string
clearing_bank_no	清算行号	string
county_code	区编号	string
county_name	区名称	string
create_time		string(date-time)
merchant_no		string
id		integer(int64)
id_card	身份证号	string
optimistic		integer(int32)
own_no	所有者	string
province_code	省份编号	string
province_name	省份名称	string
update_time		string(date-time)
validate		string

TerminalInfo

参数名称	参数说明	类型
core_term_id	三代终端编号	Long
term_type_code	终端分类	Integer
term_type_name	终端分类名称	string
term_no_list	终端号	String（List）
active_no_vo_list	激活码	ActiveNoVo（List）

ShopInfo

参数名称	参数说明	类型
shop_id	网点编号	Long
shop_name	门店名称	String
shop_address	门店地址	String
province_code	省份编号	String
province_name	省份名称	String
city_code	城市编号	String
city_name	城市名称	String
shop_dist_code	区编号	String
shop_dist_name	区名称	String
shop_contact_name	联系人	String
shop_contact_mobile	联系人手机	String

ActiveNoVo

参数名称	参数说明	类型
busi_type_code	业务类别码	String
term_no	终端号	String
active_no	终端激活码	String

业务类别码

字段名称	字段描述
BANK_CARD	银行卡
QR_CODE_CARD	扫码

CustomerProductVo

参数名称	参数说明	类型
product	商户产品	String
product_name	商户产品名称	String

请求报文参考

{

"ver": "1.0",
"timestamp": "1724842957000",
"req_id": "req123456789",
"req_data": {
    "merchant_no": "822121070110BC2",
    "customer_no": null,
    "open_org_code": "231464"
}

}

复制

响应报文参考

{

"code": "000000",
"resp_data": {
    "shop_info_list": [{
        "shop_contact_mobile": "139******63",
        "city_name": "石家庄市",
        "shop_dist_code": "1211",
        "city_code": "1210",
        "province_code": "1200",
        "shop_dist_name": "井陉县",
        "shop_name": "好拓客测试微智能六三政策测试进件二",
        "province_name": "河北省",
        "shop_id": 25324,
        "shop_address": "撒发发发啊",
        "shop_contact_name": "宋**"
    }],
    "pos": {
        "pos_sn": "wzn20241029222",
        "activity_flag": "23NHTKWZNYJ299YHD",
        "agent_no": 22203211,
        "pos_type": "MICRO_SUPER_POS"
    },
    "product_vos": [],
    "customer_fee": [{
            "settlement_type": "AUTOMATIC",
            "month_limit": 3000000.0,
            "card_type": "CREDIT_CARD",
            "max_amt": 9999.0,
            "customer_management_fee": 0.0,
            "per_limi": 50000.0,
            "min_amt": 0.1,
            "fee_rate": 0.0063,
            "optimistic": 0,
            "day_limit": 300000.0,
            "trans_type": "POS",
            "create_time": 1730185967000,
            "second_fee": 300.0,
            "trans_settle_type": "D0",
            "id": 113766321,
            "customer_managementd_fee": 0.0,
            "customer_no": 100131515,
            "customer_managemente_fee": 0.0,
            "customer_managementf_fee": 0.0
        },
        {
            "settlement_type": "AUTOMATIC",
            "month_limit": 3000000.0,
            "card_type": "DEBIT_CARD",
            "max_amt": 30.0,
            "customer_management_fee": 0.0,
            "per_limi": 100000.0,
            "min_amt": 0.1,
            "fee_rate": 0.006,
            "optimistic": 0,
            "day_limit": 300000.0,
            "trans_type": "POS",
            "create_time": 1730185967000,
            "trans_settle_type": "D0",
            "id": 113766322,
            "customer_managementd_fee": 0.0,
            "customer_no": 100131515,
            "customer_managemente_fee": 0.0,
            "customer_managementf_fee": 0.0
        },
        {
            "settlement_type": "AUTOMATIC",
            "month_limit": 200000.0,
            "card_type": "QR_CORD",
            "max_amt": 9999.0,
            "customer_management_fee": 0.0,
            "per_limi": 5000.0,
            "min_amt": 0.1,
            "fee_rate": 0.004,
            "optimistic": 0,
            "day_limit": 10000.0,
            "trans_type": "POS",
            "create_time": 1730185967000,
            "trans_settle_type": "D0",
            "id": 113766323,
            "customer_managementd_fee": 0.0,
            "customer_no": 100131515,
            "customer_managemente_fee": 0.0,
            "customer_managementf_fee": 0.0
        }
    ],
    "settle_card": {
        "able_status": "ENABLE",
        "bank_code": "01050000",
        "account_name": "宋**",
        "city_code": "1000",
        "id_card": "2****************5",
        "province_code": "11",
        "is_legal_person": true,
        "bank_name": "中国建设银行苏黎世分行",
        "clearing_bank_no": "105100000017",
        "optimistic": 0,
        "city_name": "北京市",
        "own_no": "100131515",
        "create_time": 1730185967000,
        "account_no": "4367****9725",
        "bank_no": "105100011584",
        "audit_status": "SUCCESS",
        "id": 25817,
        "province_name": "北京市",
        "account_kind": "58"
    },
    "terminal_info": [],
    "customer": {
        "bz_pos": "MICRO_SUPER_POS",
        "identity_no_st_dt": "2024-05-23",
        "license_no": "",
        "phone_no_hash": "6b3e15f96c79d11a7abc7b268621428a",
        "agreement_status": "TRUE",
        "mer_license_expire": "",
        "mer_name": "好拓客测试微智能六三政策测试进件二",
        "channel_type": "TP_PERSONAL",
        "phone_no": "139******63",
        "platform": "LKL",
        "receive_detail": "撒发发发啊",
        "customer_status": "ACTIVITY",
        "identity_no": "211302********0865",
        "legal_name": "宋**",
        "mcc_code": "7011",
        "optimistic": 10,
        "ysf_discount": "FALSE",
        "pos_sn": "",
        "contact_man_name": "宋**",
        "city_name": "石家庄市",
        "standard_fee": 0.0,
        "mer_license_st_dt": "",
        "open_time": 1730186006000,
        "phone_no_enc": "Vke_xk_cXh_yHQSZ72Q6y_ho_ug==",
        "identity_no_expire": "2999-12-31",
        "county_name": "井陉县",
        "term_num": 1,
        "agent_no": 22203211,
        "activity_type_name": "好拓客微智能0.63政策",
        "activity_time": 1730186078000,
        "update_time": 1730186079000,
        "active_no": "689325719656",
        "agency_no": 30324920,
        "merchant_no": "822121070110BC2",
        "customer_name": "好拓客测试微智能六三政策测试进件二",
        "is_standard": "FALSE",
        "mailbox": "c*@126.com",
        "create_time": 1730185912000,
        "mer_reg_name": "好拓客测试微智能六三政策测试进件二",
        "reward_mode": "TO_AGENT",
        "merchant_source": "APP",
        "province_name": "河北省",
        "term_no": "D9325719",
        "activity_type": "HTKWZN63ZC",
        "customer_no": 100131515
    }
},
"msg": "SUCCESS",
"timestamp": 1730450984322

}

获取商户信息.md 19 KB History Raw

请求地址

请求接口业务参数说明(reqData)

返回参数(respData)

OpenMerchantVO

Customer

CustomerFee

Pos

CustomerSettleCard

TerminalInfo

ShopInfo

ActiveNoVo

业务类别码

CustomerProductVo

请求报文参考

响应报文参考

获取商户信息.md 19 KB

History Raw