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

易企通1.0

添加个人收款方

开发中

测试环境

POST

/AG_MerchantManagementSystem_Core/jzt/api/pri

最后修改时间：2024-02-18 08:51:45

责任人：谭得红

添加个人收款方
请求方式：
-请求方式：POST multipart/form-data 方式
接口说明：
该接口为同步接口，实时返回应答结果；

请求参数

Body 参数multipart/form-data

version

string

必需

版本号默认值1.0

示例值:

1.0

clientCode

string

必需

机构号该字段由易生配置

示例值:

61165070

MAC

string

MAC值

必需

示例值:

accName

string

必需

账号姓名最大长度100

示例值:

许世浩

cfValidity

string

必需

账号证件有效期格式：[“起始日期”,”截止日期”],JSON格式字符串

示例值:

["20150304","20350304"]

cfType

string

必需

账号证件类型证件类型：0-居民身份证或临时身份证;1-外国公民护照;2-港澳居民来往大陆通行证或其他有效旅游证件；3-其他类个人身份有效证件；4-单位证件；5-军人或武警身份证件

示例值:

cfNo

string

账号证件号

必需

示例值:

411424199511216630

bankName

string

必需

银行卡开户行最大长度100

示例值:

中国银行

accNo

string

银行卡银行账号

必需

示例值:

6226193000554962

phoneNo

string

银行卡手机号

必需

示例值:

13526552767

accType

string

必需

账号类型枚举 00-个人；10-对公

示例值:

bankCode

string

开户行行号

必需

示例值:

104492062713

payMode

string

可选

结算周期可选结算周期 1：T+1 ；2：D+1 默认：T+1

示例值:

picInfo

string

必需

图片信息 json数字格式 [{“picMode”: “01 “,”fileid”: “22222”}，{“picMode”: “02”,”fileid”: “22222323”}] picMode，fileid参考图片上传

示例值:

[{"picMode":"01","fileId":"61bfe0601faf202cd074a4ad"},{"picMode":"02","fileId":"61bfe0613e10af4ed7e6f38f"}]

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://mtest.eycard.cn:4443/AG_MerchantManagementSystem_Core/jzt/api/pri' \
--form 'version="1.0"' \
--form 'clientCode="61165070"' \
--form 'MAC=""' \
--form 'accName="许世浩"' \
--form 'cfValidity="[\"20150304\",\"20350304\"]"' \
--form 'cfType="0"' \
--form 'cfNo="411424199511216630"' \
--form 'bankName="中国银行"' \
--form 'accNo="6226193000554962"' \
--form 'phoneNo="13526552767"' \
--form 'accType="00"' \
--form 'bankCode="104492062713"' \
--form 'payMode="1"' \
--form 'picInfo="[{\"picMode\":\"01\",\"fileId\":\"61bfe0601faf202cd074a4ad\"},{\"picMode\":\"02\",\"fileId\":\"61bfe0613e10af4ed7e6f38f\"}]"'

返回响应

🟢200成功

application/json

Body

version

string

版本号

必需

版本号默认值 1.0

默认值:

1.0

示例值:

1.0

clientCode

string

机构号

必需

机构号该字段由易生配置

<= 20 字符

MAC

string

MAC值

必需

MAC值

<= 50 字符

accName

string

账号姓名

必需

账号姓名

<= 100 字符

cfValidity

string

账号证件有效期

必需

证件有效期格式：[“起始日期”,”截止日期”],JSON格式字符串

<= 40 字符

cfType

enum<string>

账号证件类型

必需

证件类型：0-居民身份证或临时身份证;1-外国公民护照;2-港澳居民来往大陆通行证或其他有效旅游证件；3-其他类个人身份有效证件；4-单位证件；5-军人或武警身份证件

>= 1 字符<= 1 字符

枚举值:

012345

cfNo

string

账号证件号

必需

账号证件号

<= 20 字符

bankName

string

银行卡开户行

必需

银行卡开户行

<= 100 字符

accNo

string

银行卡银行账号

必需

银行卡银行账号

<= 20 字符

phoneNo

string

银行卡手机号

必需

银行卡手机号

>= 11 字符<= 11 字符

accType

enum<string>

账号类型

必需

00-个人；10-对公

<= 2 字符

枚举值:

0010

bankCode

string

开户行行号

必需

开户行行号

<= 20 字符

payMode

enum<string>

结算周期

可选

可选结算周期 1：T+1 ；2：D+1 默认：T+1

枚举值:

默认值:

T+1

示例值:

T+1

picInfo

string

图片信息

必需

json数字格式 [{“picMode”: “01 “,”fileid”: “22222”}，{“picMode”: “02”,”fileid”: “22222323”}] picMode，fileid参考图片上传

merCode

string

商户号

必需

商户号

<= 50 字符

termCode

string

终端号

必需

终端号

<= 20 字符

示例

{
  "merCode": "K31000013027289",
  "bankCode": "104492062713",
  "picInfo": "[{\"picMode\":\"01\",\"fileId\":\"61bfe0601faf202cd074a4ad\"},{\"picMode\":\"02\",\"fileId\":\"61bfe0613e10af4ed7e6f38f\"}]",
  "accNo": "6226193000554962",
  "accName": "许世浩",
  "cfType": "0",
  "cfNo": "411424199511216630",
  "bankName": "中国银行",
  "retCode": "0000",
  "retMsg": "操作成功",
  "version": "1.0",
  "phoneNo": "13526552767",
  "MAC": "4003DBC8613CCDF54B3426D5560760A4",
  "clientCode": "61165070",
  "cfValidity": "[\"20150304\",\"20350304\"]",
  "accType": "00",
  "termCode": "W1493660"
}

修改于 2024-02-18 08:51:45

获取签名密钥

添加企业收款方