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

易企通1.0

9.28 终端码牌、小白盒绑定解绑

开发中

测试环境

https://mtest.eycard.cn:4443

POST

https://mtest.eycard.cn:4443/AG_MerchantManagementSystem_Core/agent/api/gen

最后修改时间：2025-05-20 07:28:09

责任人：谭得红

场景说明
该接口用于更新代理商编号（特定使用），使用改接口变更合作方编号为实时更新，且更新后改商户需使用新合作方进件参数进行维护

请求参数

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

messageType

string

必需

报文类型 ALTERDIMEN

示例值:

ALTERDIMEN

clientCode

string

必需

机构号该字段由易生配置

示例值:

63754675

version

string

版本号 1.0

必需

示例值:

1.0

MAC

string

MAC值

必需

示例值:

72767BDCFE9AD9EFAFB3579D039F0410

merTrace

string

商户唯一标识

必需

示例值:

61bfe1051faf202cd074a52e

termCode

string

终端号

必需

示例值:

00000123

playType

string

必需

操作类型 1 绑定 2 解绑

示例值:

termModelLic

string

码牌编号

必需

示例值:

Q000000

operaTrace

string

操作流水

必需

示例值:

xxxx

backUrl

string

回调地址

可选

示例代码

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 'messageType=ALTERDIMEN' \
--data-urlencode 'clientCode=63754675' \
--data-urlencode 'version=1.0' \
--data-urlencode 'MAC=72767BDCFE9AD9EFAFB3579D039F0410' \
--data-urlencode 'merTrace=61bfe1051faf202cd074a52e' \
--data-urlencode 'termCode=00000123' \
--data-urlencode 'playType=1' \
--data-urlencode 'termModelLic=Q000000' \
--data-urlencode 'operaTrace=xxxx' \
--data-urlencode 'backUrl='

返回响应

🟢200成功

application/json

Body

messageType

string

报文类型

必需

clientCode

string

机构号

必需

机构号该字段由易生配置

retCode

string

应答码

必需

retMsg

string

错误解释

必需

version

string

版本号

必需

MAC

string

MAC

必需

示例

{
    "operaTrace": "20250212508855392590",
    "messageType": "SENDZFBORWX",
    "clientCode": "48310123",
    "retCode": "0000",
    "retMsg": "操作成功",
    "version": "1.0",
    "MAC": "B5765C111CD871CD0035011013E325FB"
}

9.27 商户、终端操作通知

个人分账方入网