接口描述
1、提交商户信息并报名活动。同时至少提交一个门店的信息。 2、更新商户信息（根据银联商户编号、营销活动编码更新）。
请求方式
POST
生产调用地址
https://openapi.unionpay.com/upapi/pnr/submitMchnt
测试调用地址
敬请期待
URL请求参数
| 中文名称 | 英文名称 | 域类型 | 域长度 | 默认值 | 请求要求 | 备注 | |
|---|---|---|---|---|---|---|---|
| 产品token | token | string | M-必填 | 详情请参考“获取token”接口中应答参数“token”的具体数据。 | |||
| 签名信息 | sign | string | M-必填 | 详细签名算法可参考“技术指南”板块第3条。 | |||
| 时间戳 | ts | long | M-必填 | 单位：毫秒，对于Java一般使用System.currentTimeMillis();获取。 |
HTTP报文体参数
| 中文名称 | 英文名称 | 域类型 | 域长度 | 默认值 | 请求要求 | 备注 | |
|---|---|---|---|---|---|---|---|
| 收单机构代码 | instId | string | 8 | M-必填 | 填写8位收单机构代码（后四位体现32域）
|
||
| 银联商户编号 | mchntCode | string | 15 | M-必填 | 填写银联二维码交易上送银联系统的商户编号一致
|
||
| 营销活动编码 | activityId | string | 3 | M-必填 | 由银联提供该标识
|
||
| 商户名称 | mchntName | string | 128 | M-必填 | 商户编号对应的商户名称
|
||
| MCC | mcc | string | 4 | M-必填 |
|
||
| 商户侧服务费划付时效 | acqFeeReturnTime | string | 2 | M-必填 | 填写“T0”或“T1”（指收单机构向商户进行手续费返还的时效）；如收单机构在交易当天向商户进行手续费返还，则填写为T0
|
||
| 营业证明文件类型 | certType | string | 1 | M-必填 | 如果是普通商户，填写“营业执照”；如是小微商户，填写“身份证”。B表示营业执照，P表示身份证。
|
||
| 统一社会信用代码 | certBlId | string | 64 | C-按条件必填 | 当营业证明文件类型取值为“营业执照”时，必填。如营业执照上无“统一社会信用代码”，则填写营业执照上的“注册号”或“证照编号”
|
||
| 工商注册名称 | certBlName | string | 64 | C-按条件必填 | 如果营业证明文件类型是营业执照，必填，填写营业执照上的工商注册名称
|
||
| 负责人身份证号 | certPersonId | string | 18 | M-必填 | 如营业证明文件类型是营业执照时，填写营业执照上的法人身份证件号；如营业证明文件类型是身份证时，填写身份证上的证件号。此字段需要通过AES加解密
该参数已配置加密规则：AES 查看详情 |
||
| 负责人姓名 | certPersonName | string | 64 | M-必填 | 如营业证明文件类型是营业执照时，填写营业执照上的法人代表姓名；如营业证明文件类型是身份证时，填写身份证上的姓名。此字段需要通过AES加解密
该参数已配置加密规则：AES 查看详情 |
||
| 结算账户号 | stlAccountId | string | 64 | M-必填 | 填写对公账户或个人银行卡账户。此字段需要通过AES加解密
该参数已配置加密规则：AES 查看详情 |
||
| 结算账户名称 | stlAccountName | string | 64 | M-必填 | 如结算账户为个人银行卡账户，填写持卡人姓名。此字段需要通过AES加解密
该参数已配置加密规则：AES 查看详情 |
||
| 开户行联行号 | stlBankId | string | 64 | O-选填 | 如结算账户为个人银行卡账户，可不填
|
||
| 开户行名称 | stlBankName | string | 64 | O-选填 | 如结算账户为个人银行卡账户，可不填
|
||
| A商户编码 | mchntCodeA | string | 32 | M-必填 | 填写该商户A交易所用的商户编码，与交易上送银联系统的商户编号一致。
|
||
| T商户编码 | mchntCodeT | string | 32 | M-必填 | 填写该商户T交易所用的商户编码，与交易上送银联系统的商户编号一致。
|
||
| 门店序列号 | storeId | string | 16 | O-选填 | 填写机构自行定义的门店编号，用于区分一个商编下的多个门店
|
||
| 商户（门店）经营名称 | storeName | string | 128 | M-必填 | 要求细化到门店维度，需为实际门店名称
|
||
| 商户（门店）经营地址 | storeAddress | string | 256 | M-必填 | 要求细化到门店维度，需为实际门店名称及门店实际经营场所地址，地址以三段式体现
|
||
| 现场照片 | storePhoto | array | 10 | M-必填 | 商户门头照、经营场所照、收银台照等。最多可传十张。照片数据通过fileUp接口上传，本参数仅传fileUp接口返回的fileId。
|
||
| 终端序列号 | terminalSerialNo | string | 512 | O-选填 | 终端设备的硬件序列号，多个以英文逗号相隔
|
同步应答参数
| 中文名称 | 英文名称 | 域类型 | 域长度 | 默认值 | 请求要求 | 备注 | |
|---|---|---|---|---|---|---|---|
| 应答码 | respCd | string | 4 | M-必填 | 参考左侧菜单“应答码参照”
|
||
| 应答消息 | respMsg | string | M-必填 | 如果respCd不是0000，该字段解释了具体的出错原因。
|
示例代码
{
"instId": "00010000",
"mchntCode": "XXXXXXXXXXXXXXX",
"activityId": "111",
"mchntName": "小杨生煎",
"mcc": "1234",
"acqFeeReturnTime": "T1",
"certType": "B",
"certBlId": "",
"certBlName": "",
"certPersonId": "",
"certPersonName": "",
"stlAccountId": "",
"stlAccountName": "",
"stlBankId": "",
"stlBankName": "",
"mchntCodeA": "XXXX",
"mchntCodeT": "XXXX",
"storeId": "",
"storeName": "小杨生煎（唐镇阳光天地店）",
"storeAddress": "上海市浦东新区唐镇阳关天地B1层B147号",
"storePhoto": ["fileId1", "fileId2", "fileId3"],
"terminalSerialNo": ""
}
中国银联版权所有© 沪ICP备07032180号-2 沪公网安备31011502002335号
