1.1 Batch Create Bank Transfer Account

request URL

• /api/v1/batch/paymentAccount

request method

• POST

request params

parameter name	Is it mandatory	type of data	length	example	description
appId	mandatory	string	-	-	application APPID
appName	mandatory	string	1-100	-	Merchant application name, format: letter + space, 1-100 characters
mchOrderId	mandatory	string	1-32	CCP20220428011068111	Merchant order id ((unique for customer or bill) format: letter + num, 1-32 characters
channelCode	mandatory	string	-	-	Bank Transfer, channelCode: Multiple chanlcode strings and separated by commas, now only support INSTA_TRANSFER_ACC
customerName	mandatory	string	1-100	-	customer name, format："firstName middleName lastName" (middle name optional)
email	optional	string	1-50	-	customer email
minAmount	optional	int	-	20000	min amount limit
maxAmount	optional	int	-	5000000	max amount limit
mobile	optional	string	11-14	- 0912345678	customer mobile
expireTime	optional	string	-	2022-05-26	expire time，if empay mean always active
description	optional	string	-	-	VA Remark
sign	mandatory	string	-	45eebd745dcf0b5f6d6f9fcde28cd9fe8116a892	sign

response params

parameter name	type of data	example	description
code	int	1000	Status code see reference
message	String	success	The message of status code
data	Object	-	Response Data
- shortLink	String	-	Repayment guidance link
- paymentAccountList	List	-	Bank Transfer Data
-- mchOrderId	String	LT000000216	Merchant order id (unique for customer)
-- channelCode	String	INSTA_TRANSFER_ACC	Bank Transfer Channel Code
-- guideUrl	String	-	The single channel repayment link
-- receivingBank	String	AllBank	PayCools Payment Bank name
-- accountName	String	PayCools	Recipient account name
-- accountNumber	String	999100000198	Recipient account number

successful response example

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

failed response example. code see reference

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