1.1 批量创建Bank Transfer Account

• 商户 Bank Transfer 还款码 - 批量创建接口

请求URL

• /api/v1/batch/paymentAccount

请求方式

• POST

请求参数

参数名	必选	类型	长度限制	示例	说明
appId	是	string	-	-	应用APPID
appName	是	string	1-100	-	商户对接应用名称, 格式：字母+空格，1-100位
mchOrderId	是	string	1-32	CCP20220428011068111	商户-(用户/账单)唯一识别码, 格式：字母+数字，1-32位
channelCode	是	string	-	-	Bank Transfer渠道Code: 多个channelCode字符串，以逗号做分隔, 目前紧支持 INSTA_TRANSFER_ACC
customerName	否	string	1-100	-	用户名称， 格式：字母+空格，1-100位, 格式："firstName middleName lastName" (middle name 非必填)
email	否	string	1-50	-	用户邮箱 格式：邮箱格式，1-50位
minAmount	否	int	-	20000	还款最低金额
maxAmount	否	int	-	5000000	还款最高金额
mobile	否	string	11-14	0912345678	用户手机号 格式：09 开头，纯数字，11-14位
expireTime	否	string	-	2022-05-26	过期时间，不传代表永不过期 format: yyyy-MM-dd
description	否	string	-	-	还款码表述
sign	是	string	-	45eebd745dcf0b5f6d6f9fcde28cd9fe8116a892	签名

响应参数

参数名	类型	示例	说明
code	int	1000	状态码 参考列表
message	String	success	状态码信息
data	Object	-	返回具体信息
- shortLink	String	https://a.api-dev.paycools.com/1L9zObb	还款码短链
- paymentAccountList	List	-	Bank Transfer信息
-- mchOrderId	String	LT000000216	商户订单号
-- channelCode	String	INSTA_TRANSFER_ACC	渠道code
-- guideUrl	String	-	单个渠道的还款链接
-- receivingBank	String	AllBank	Paycools收款银行
-- accountName	String	PayCools	收款账号名
-- accountNumber	String	999100000198	收款账号

返回示例

{
  "code": 1000,
  "message": "success",
  "data": {
    "paymentAccountList": [
      {
        "mchOrderId": "CCP202306280110680099",
        "channelCode": "INSTA_TRANSFER_ACC",
        "guideUrl": "https://api-dev.paycools.com/transfer/static/guide/dVNpTGxGbUJWcE1DS2RkV2MyU0FPNkJtVktYemFRWmJCSHB3RDFGdmhBWT0=",
        "receivingBank": "Netbank",
        "accountName": "PayCools",
        "accountNumber": "900081000023"
      },
      {
        "mchOrderId": "CCP202306280110680099",
        "channelCode": "PESONET_TRANSFER_ACC",
        "guideUrl": "https://api-dev.paycools.com/transfer/static/guide/SGpBZlFIckRMakFId3NyVVF5TTAzd0FpMjJYVWJsQWNBV3V6U3hrTEFycz0=",
        "receivingBank": "Netbank",
        "accountName": "PayCools",
        "accountNumber": "900081000023"
      }
    ],
    "shortLink": "https://a.api-dev.paycools.com/1L9zQ3q"
  }
}

返回失败案例

{
  "code": 1002,
  "message": "merchant white ip forbidden"
}