中国银联开放平台

支持中心

接口列表

营销商户报名接口

营销商户报名接口

查看产品

更新时间：2024-10-12

提交门店信息

接口描述

1、提交门店信息。必须先提交商户信息submitMchnt。 2、更新门店信息（根据银联商户编号、营销活动编码、门店序列号更新）。

请求方式

POST

生产调用地址

https://openapi.unionpay.com/upapi/pnr/submitStore

测试调用地址

敬请期待

URL请求参数

中文名称	英文名称	域类型	请求要求	备注
产品token	token	string	M-必填	详情请参考“获取token”接口中应答参数“token”的具体数据。
签名信息	sign	string	M-必填	详细签名算法可参考附录“签名样例代码”部分或参考网站“技术指南”板块第3条。
时间戳	ts	long	M-必填	单位毫秒，对于Java一般使用System.currentTimeMillis();获取

HTTP报文体参数

中文名称	英文名称	域类型	域长度	请求要求	备注
银联商户编号	mchntCode	string	15	M-必填	填写银联二维码交易上送银联系统的商户编号一致
营销活动编码	activityId	string	3	M-必填	由银联提供该标识
门店序列号	storeId	string	16	O-选填	填写机构自行定义的门店编号，用于区分一个商编下的多个门店
商户（门店）经营名称	storeName	string	128	M-必填	要求细化到门店维度，需为实际门店名称
商户（门店）经营地址	storeAddress	string	256	M-必填	要求细化到门店维度，需为实际门店名称及门店实际经营场所地址，地址以三段式体现
现场照片	storePhoto	array	10	M-必填	商户门头照、经营场所照、收银台照等。最多可传十张。照片数据通过fileUp接口上传，本参数仅传
终端序列号	terminalSerialNo	string	512	O-选填	终端设备的硬件序列号，多个以英文逗号相隔

同步应答参数

	中文名称	英文名称	域类型	域长度	默认值	请求要求	备注
	应答码	respCd	string	4		M-必填	参考左侧菜单“应答码参照”
	应答消息	respMsg	string			M-必填	如果respCd不是0000，该字段解释了具体的出错原因。

示例代码

{

"mchntCode": "XXXXXXXXXXXXXXX",

"activityId": "111",

"storeId": "",

"storeName": "小杨生煎（唐镇阳光天地店）",

"storeAddress": "上海市浦东新区唐镇阳关天地B1层B147号",

"storePhoto": ["fileId1", "fileId2", "fileId3"],

"terminalSerialNo": ""

}

复制