测试环境商家账户是用来进行支付业务体验的账号，交易中产生的一切信息均为生产环境数据，由于体验业务特点，不会产生清算资金划拔，所以使用测试商家账号时请务必使用小额支付（建议：小于0.1元）。

易企通1.0

9.11 商户功能变更

开发中

测试环境

https://mtest.eycard.cn:4443

POST

/AG_MerchantManagementSystem_Core/agent/api/gen

最后修改时间：2025-03-05 07:53:12

责任人：谭得红

场景说明
该接口用于变更商户功能信息；
-说明：当新开通银行卡收单（funcId=23）时，同时需要上送终端信息

请求参数

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

version

string

版本号默认1.0

必需

示例值:

1.0

clientCode

string

必需

机构号该字段由易生配置

示例值:

63754675

MAC

string

MAC值

必需

示例值:

265300A2E97B1D73926418E573FF107E

customInfo

string

可选

自定义域 json 格式字符串

messageType

string

必需

报文类型使用值：ALTERFUNC

示例值:

ALTERFUNC

merTrace

string

商户唯一标识

可选

示例值:

61bfe1051faf202cd074a52e

sysInfo

string

可选

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

示例值:

[{ "termMode": "6", "username": "终端名-z", "areaNo": "5843", "termArea": "5843", "installaddress": "广东省深圳市龙华区凯滨新村81栋一楼家园深圳市桶装水配送中心", "linkMan": "联系人---a", "linkPhone": "13121178851", "termModel": "400", "termModelLic": "9999999998"}]

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"}]

operaTrace

string

可选

操作流水最长20字符

示例值:

16399647872558BG11

示例代码

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=63754675' \
--data-urlencode 'MAC=265300A2E97B1D73926418E573FF107E' \
--data-urlencode 'customInfo=' \
--data-urlencode 'messageType=ALTERFUNC' \
--data-urlencode 'merTrace=61bfe1051faf202cd074a52e' \
--data-urlencode 'sysInfo=[{	"termMode": "6",	"username": "终端名-z",	"areaNo": "5843",	"termArea": "5843",	"installaddress": "广东省深圳市龙华区凯滨新村81栋一楼家园深圳市桶装水配送中心",	"linkMan": "联系人---a",	"linkPhone": "13121178851",	"termModel": "400",	"termModelLic": "9999999998"}]' \
--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 'operaTrace=16399647872558BG11'

返回响应

🟢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 格式字符串

示例

{
    "version": "string",
    "clientCode": "string",
    "MAC": "string",
    "retCode": "0000",
    "retMsg": "string",
    "customInfo": "string"
}

9.10 结算账户变更

9.12 参数查询