9.3 商户信息补件 - 易企通1.0

场景说明
当商户信息被驳回或审核失败时，代理商可发起补件请求；
注：代理商将原商户唯一标识（merTrace）上送，易生会回一个新的商户唯一标识；
接口说明：
该接口为异步接口，应答结果仅代表接收成功；最终结果会根据回调地址返回；或者通过查询接口获取
业务说明：此接口中的字段：merTrace（商户唯一标识）必须与接口【9.2 商户信息录入】返回的保持一致，否则会报【商户唯一标识错误】

请求参数

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

version

string

版本号默认1.0

必需

示例值:

1.0

clientCode

string

必需

机构号该字段由易生配置

示例值:

61165070

MAC

string

MAC值

必需

示例值:

265300A2E97B1D73926418E573FF107E

customInfo

string

可选

自定义域 json 格式字符串

messageType

string

必需

报文类型使用值：AGENTPATCH

示例值:

AGENTPATCH

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": "15900001111", "merLegal": "剧卓", "legalType": "0", "linkmanCode": "130182199303011118", "linkmanValidity": ["2021.04 .25 ","2041.04 .25 "], "legalCode": "13018219930301111", "linkmanType": "0", "legalValidity": ["2021.04 .25 ","2041.04 .25 "], "linkmanPhone": "15900001111", "linkMan": "剧卓"}

sysInfo

string

可选

终端信息 json 格式字符串（list）,开通银行卡收单功能必传

licInfo

string

必需

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

示例值:

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

accInfo

string

必需

结算账户信息 json 格式字符串

示例值:

{ "bankCode": "105100021060", "legalType": "0", "accName": "剧卓", "legalCode": "130182199303073558", "bankName": "中国建设银行股份有限公司北京西三旗支行", "accType": "00", "account": "6217000010144854901", "accPhone": "15933211111"}

accInfoBak

string

可选

结算账户信息2 当商户类型（merMode）为企业商户并且结算账户为对私账户时，该字段必传；json 格式字符串

funcInfo

string

必需

功能信息 json 格式字符串 (list)

示例值:

[{"funcId":2,"calcVal":"0.36"}, {"funcId":3,"calcVal":"0.36"}, {"funcId":25,"tradeType":"0","DCalcType":"1","DCalcVal":"0.00","CCalcType":"1","CCalcVal":"0.00"}, {"funcId":12,"DStlmType":"1","DCalcVal":"0.55","DStlmMaxAmt":"30","DFeeLowLimit":"0","CCalcVal":"0.55","CFeeLowLimit":"0"}, {"funcId":14,"DStlmType":"0","DCalcVal":"0.36","DStlmMaxAmt":"30","DFeeLowLimit":"0","CCalcVal":"0.36","CFeeLowLimit":"0"}]

picInfoList

string

必需

图片信息 json 格式字符串

示例值:

[{"picMode":"01","fileId":"61bfe0f01faf202cd074a51f"},{"picMode":"02","fileId":"61bfe0f11faf202cd074a521"},{"picMode":"03","fileId":"61bfe0f21faf202cd074a522"},{"picMode":"04","fileId":"61bfe0f41faf202cd074a523"},{"picMode":"06","fileId":"61bfe0f63e10af4ed7e6f3f3"},{"picMode":"07","fileId":"61bfe0f83e10af4ed7e6f3f5"},{"picMode":"08","fileId":"61bfe0fa3e10af4ed7e6f3f6"},{"picMode":"09","fileId":"61bfe0fd1faf202cd074a526"},{"picMode":"10","fileId":"61bfe0ff3e10af4ed7e6f3f7"},{"picMode":"11","fileId":"61bfe1001faf202cd074a529"},{"picMode":"14","fileId":"61bfe1011faf202cd074a52a"},{"picMode":"15","fileId":"61bfe1021faf202cd074a52b"}]

operaTrace

string

必需

操作流水最长20字符

示例值:

16399647872558BG3

isContract

string

可选

约定域 json 格式字符串，需和易生约定特殊使用

merTrace

string

商户唯一标识

可选

示例值:

61bfe0743e10af4ed7e6f3b0

示例代码

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=AGENTPATCH' \
--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": "15900001111",	"merLegal": "剧卓",	"legalType": "0",	"linkmanCode": "130182199303011118",	"linkmanValidity": ["2021.04 .25 ","2041.04 .25 "],	"legalCode": "13018219930301111",	"linkmanType": "0",	"legalValidity": ["2021.04 .25 ","2041.04 .25 "],	"linkmanPhone": "15900001111",	"linkMan": "剧卓"}' \
--data-urlencode 'sysInfo=' \
--data-urlencode 'licInfo={	"businScope": "收钱",	"controlerLegalType": "0",	"capital": "10",	"capitalCurrency": "人民币",	"controlerName": "剧卓",	"licAddr": "北京市北京市朝阳区****",	"controlerLegalValidity": ["2021.04 .25 ","2041.04 .25 "],	"controlerLegalCode": "130182199303073558"}' \
--data-urlencode 'accInfo={	"bankCode": "105100021060",	"legalType": "0",	"accName": "剧卓",	"legalCode": "130182199303073558",	"bankName": "中国建设银行股份有限公司北京西三旗支行",	"accType": "00",	"account": "6217000010144854901",	"accPhone": "15933211111"}' \
--data-urlencode 'accInfoBak=' \
--data-urlencode 'funcInfo=[{"funcId":2,"calcVal":"0.36"}, {"funcId":3,"calcVal":"0.36"}, {"funcId":25,"tradeType":"0","DCalcType":"1","DCalcVal":"0.00","CCalcType":"1","CCalcVal":"0.00"}, {"funcId":12,"DStlmType":"1","DCalcVal":"0.55","DStlmMaxAmt":"30","DFeeLowLimit":"0","CCalcVal":"0.55","CFeeLowLimit":"0"}, {"funcId":14,"DStlmType":"0","DCalcVal":"0.36","DStlmMaxAmt":"30","DFeeLowLimit":"0","CCalcVal":"0.36","CFeeLowLimit":"0"}]' \
--data-urlencode 'picInfoList=[{"picMode":"01","fileId":"61bfe0f01faf202cd074a51f"},{"picMode":"02","fileId":"61bfe0f11faf202cd074a521"},{"picMode":"03","fileId":"61bfe0f21faf202cd074a522"},{"picMode":"04","fileId":"61bfe0f41faf202cd074a523"},{"picMode":"06","fileId":"61bfe0f63e10af4ed7e6f3f3"},{"picMode":"07","fileId":"61bfe0f83e10af4ed7e6f3f5"},{"picMode":"08","fileId":"61bfe0fa3e10af4ed7e6f3f6"},{"picMode":"09","fileId":"61bfe0fd1faf202cd074a526"},{"picMode":"10","fileId":"61bfe0ff3e10af4ed7e6f3f7"},{"picMode":"11","fileId":"61bfe1001faf202cd074a529"},{"picMode":"14","fileId":"61bfe1011faf202cd074a52a"},{"picMode":"15","fileId":"61bfe1021faf202cd074a52b"}]' \
--data-urlencode 'operaTrace=16399647872558BG3' \
--data-urlencode 'isContract=' \
--data-urlencode 'merTrace=61bfe0743e10af4ed7e6f3b0'

返回响应

🟢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": "16399647872558BG3",
  "messageType": "AGENTPATCH",
  "clientCode": "61165070",
  "merTrace": "64585dd63e10af09ab5b2524",
  "retCode": "0000",
  "retMsg": "操作成功",
  "version": "1.0",
  "MAC": "36238AAE91B0A1650AF0A7399C64D2E4"
}