9.7 商户信息变更 - 易企通1.0

场景说明
该接口用于修改商户信息（包括图片信息）；
该接口只需送需要变更的字段，不需要变更的字段可以不送；

请求参数

Body 参数application/x-www-form-urlencoded

version

string

版本号默认1.0

必需

示例值:

1.0

clientCode

string

必需

机构号该字段由易生配置

示例值:

61165070

MAC

string

MAC值

必需

示例值:

265300A2E97B1D73926418E573FF107E

customInfo

string

可选

自定义域 json 格式字符串

messageType

string

必需

报文类型使用值：ALTERMER

示例值:

ALTERMER

backUrl

string

回调地址

可选

示例值:

https://zmss.apnpay.com/receiverapi/receviver/customer/notice

merInfo

string

可选

商户信息 json 格式字符串

示例值:

{"merArea":"1023","businEndtime":"2359","stlmType":"1","businBegtime":"0000","employeeNum":"1","merMode":"2","businName":"安贞便利店","merName":"商户_剧卓","merType":"5331","businForm":"02","merAddr":"北京市北京市朝阳区****","standardFlag":"0"}

plusInfo

string

可选

附加信息 json 格式字符串

示例值:

{"legalPhone":"1590000****","merLegal":"剧卓","legalType":"0","linkmanCode":"13018219930307****","linkmanValidity":"["2021.04.25","2041.04.25"]","legalCode":"1301821993030****8","linkmanType":"0","legalValidity":"["2021.04.25","2041.04.25"]","linkmanPhone":"1590000****","linkMan":"剧卓"}

merTrace

string

商户唯一标识

可选

licInfo

string

可选

营业执照信息 json 格式字符串

示例值:

{"businScope":"收钱","controlerLegalType":"0","capital":"10","capitalCurrency":"人民币","controlerName":"剧卓","licAddr":"北京市北京市朝阳区****","controlerLegalValidity":"["2021.04.25","2041.04.25"]","controlerLegalCode":"130182199303073558"}

picInfoList

string

可选

图片信息 json 格式字符串

示例值:

[{"picMode":"01","fileId":"61bfe0601faf202cd074a4ad"},{"picMode":"02","fileId":"61bfe0613e10af4ed7e6f38f"},{"picMode":"03","fileId":"61bfe0633e10af4ed7e6f390"},{"picMode":"04","fileId":"61bfe0641faf202cd074a4b4"},{"picMode":"06","fileId":"61bfe0663e10af4ed7e6f39a"},{"picMode":"07","fileId":"61bfe0681faf202cd074a4bd"},{"picMode":"08","fileId":"61bfe06a3e10af4ed7e6f3a6"},{"picMode":"09","fileId":"61bfe06d1faf202cd074a4bf"},{"picMode":"10","fileId":"61bfe06f3e10af4ed7e6f3a9"},{"picMode":"11","fileId":"61bfe0701faf202cd074a4c8"},{"picMode":"14","fileId":"61bfe0711faf202cd074a4ca"},{"picMode":"15","fileId":"61bfe0723e10af4ed7e6f3ae"}]

operaTrace

string

必需

操作流水最长20字符

示例值:

16399647872558BG3

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://mtest.eycard.cn:4443/AG_MerchantManagementSystem_Core/agent/api/gen' \
--data-urlencode 'version=1.0' \
--data-urlencode 'clientCode=61165070' \
--data-urlencode 'MAC=265300A2E97B1D73926418E573FF107E' \
--data-urlencode 'customInfo=' \
--data-urlencode 'messageType=ALTERMER' \
--data-urlencode 'backUrl=https://zmss.apnpay.com/receiverapi/receviver/customer/notice' \
--data-urlencode 'merInfo={"merArea":"1023","businEndtime":"2359","stlmType":"1","businBegtime":"0000","employeeNum":"1","merMode":"2","businName":"安贞便利店","merName":"商户_剧卓","merType":"5331","businForm":"02","merAddr":"北京市北京市朝阳区****","standardFlag":"0"}' \
--data-urlencode 'plusInfo={"legalPhone":"1590000****","merLegal":"剧卓","legalType":"0","linkmanCode":"13018219930307****","linkmanValidity":"["2021.04.25","2041.04.25"]","legalCode":"1301821993030****8","linkmanType":"0","legalValidity":"["2021.04.25","2041.04.25"]","linkmanPhone":"1590000****","linkMan":"剧卓"}' \
--data-urlencode 'merTrace=' \
--data-urlencode 'licInfo={"businScope":"收钱","controlerLegalType":"0","capital":"10","capitalCurrency":"人民币","controlerName":"剧卓","licAddr":"北京市北京市朝阳区****","controlerLegalValidity":"["2021.04.25","2041.04.25"]","controlerLegalCode":"130182199303073558"}' \
--data-urlencode 'picInfoList=[{"picMode":"01","fileId":"61bfe0601faf202cd074a4ad"},{"picMode":"02","fileId":"61bfe0613e10af4ed7e6f38f"},{"picMode":"03","fileId":"61bfe0633e10af4ed7e6f390"},{"picMode":"04","fileId":"61bfe0641faf202cd074a4b4"},{"picMode":"06","fileId":"61bfe0663e10af4ed7e6f39a"},{"picMode":"07","fileId":"61bfe0681faf202cd074a4bd"},{"picMode":"08","fileId":"61bfe06a3e10af4ed7e6f3a6"},{"picMode":"09","fileId":"61bfe06d1faf202cd074a4bf"},{"picMode":"10","fileId":"61bfe06f3e10af4ed7e6f3a9"},{"picMode":"11","fileId":"61bfe0701faf202cd074a4c8"},{"picMode":"14","fileId":"61bfe0711faf202cd074a4ca"},{"picMode":"15","fileId":"61bfe0723e10af4ed7e6f3ae"}]' \
--data-urlencode 'operaTrace=16399647872558BG3'

返回响应

🟢200成功

application/json

Body

version

string

版本号

必需

默认 1.0

<= 6 字符

clientCode

string

机构号

必需

机构号

<= 14 字符

MAC

string

MAC值

必需

MAC值

retCode

enum<string>

返回码

必需

返回码

枚举值:

0000100110021003100410051006100810091010101110121013101410151016109960016002600360046005600660076008600960106012601360146015601660186019602060216022602360246025602660276028602960306031603260336034603560366037603860396040604160426043604560466047604960506100

retMsg

string

错误描述

必需

错误描述

customInfo

string

自定义域

可选

自定义域 json 格式字符串

示例

{
  "operaTrace": "16399647872558B89",
  "messageType": "ALTERMER",
  "clientCode": "63754675",
  "retCode": "0000",
  "retMsg": "操作成功",
  "version": "1.0",
  "MAC": "EA5575591EFAFABB17378B2EFD3F096D"
}