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

9.4 商户异步通知回调

开发中

测试环境

POST

最后修改时间：2025-03-31 01:29:39

责任人：谭得红

场景说明
请求地址为 backUrl
所有异步接口，包括商户入件、补件、变更、终端新增、变更等，都可通过该接口获取商户处理结果；
该接口会回一些主要的字段：funcInfo信息是所有的功能字段；sysInfo:包括内部商户号（merCode）,终端名称（username）,终端商户号（termMercode）,终端终端号（termTermcode）,渠道商户号（bangdingcommercode）,渠道终端号（bangdingtermno）
接口说明：
该接口在没有收到代理商应答结果时，会重新发送回调结果，最多发送3次；

回调地址如果不送，则不会触发该回调接口，需要代理商主动调取查询接口获取结果；
回调地址上送有两种途径：
(1)上送每个接口的回调地址（backUrl）字段；
(2)由易生将回调地址配置到对应的机构参数中（优先取接口里送的回调地址，如果接口中没有送，则取机构参数中配置的）。

请求参数

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

version

string

版本号默认1.0

必需

示例值:

1.0

clientCode

string

必需

机构号该字段由易生配置

示例值:

61165070

MAC

string

MAC值

必需

示例值:

265300A2E97B1D73926418E573FF107E

auditStatus

string

必需

审核状态 9-待处理；3-待审核；0-审核通过；X-审核失败；1-审核驳回

示例值:

recentMessType

string

必需

原报文类型与请求保持一致

示例值:

AGMERAPPLY

auditMsg

string

审核说明

必需

示例值:

审核说明

sysInfo

string

可选

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

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字符

示例值:

16399647872558BG3

merTrace

string

商户唯一标识

必需

示例值:

61bfe0743e10af4ed7e6f3b0

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://mtest.eycard.cn:4443' \
--data-urlencode 'version=1.0' \
--data-urlencode 'clientCode=61165070' \
--data-urlencode 'MAC=265300A2E97B1D73926418E573FF107E' \
--data-urlencode 'auditStatus=0' \
--data-urlencode 'recentMessType=AGMERAPPLY' \
--data-urlencode 'auditMsg=审核说明' \
--data-urlencode 'sysInfo=' \
--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=16399647872558BG3' \
--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

错误描述

必需

错误描述

示例

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

修改于 2025-03-31 01:29:39

9.3 商户信息补件

9.5 商户审核结果查询