Create Vendor v2.0

Use this API to create a new vendor to your EasySplit account along with the KYC details. Provide KYC details such as account_type, business_type, gst, cin, pan, passport number and so on. Click here to read more on vendor KYC.

For Auto Collect pass the Authorization token. Use the Authorize API to generate the token for Auto Collect APIs.


Vendor Instant Settlements

Use schedule option "8" or "9" to schedule instant settlements to your vendor account.

Schedule Options Supported

Schedule Options

1T+1 settlement at 11:00 AM
2T+2 settlement at 11:00 AM
3All transactions from 4:30 PM T-1 to 10:30 AM T+0 settled at 11AM T+0, and, 10:30 AM T+0 to 4:30PM T+0 at 5:00PM T+0
4All transactions from 2:00 PM T-1 to 2:00 PM T+0 settled at 3PM T+0
5All transactions till 5.30 at 6
6Instant Settlement Every Hour between 7:00 AM and 5:00 PM on working days
7Instant Settlement Every 3 hours between 8:00 AM and 5:00 PM on working days
8Instant Settlement Every Hour 24*7
9Instant Settlement Every 3 Hours 24*7
11Weekly Every 1st Working day
12Monthly Every 1st Working day

List of Business Types
Business Types
Mutual funds/Broking
NBFCs / Organizations into Lending
Non Profit / NGO
Online Gaming
Open/Partial Open Wallet
Travel and Hospitality
Hemp Products / Herbal Products
Chit Funds
Web host/Domain seller
Professional Services (Doctors, Lawyers, Architects, CAs, and other Professionals)
Food Industry
International Card Acceptance (Goods export)

Response Codes
Sub CodeStatusMessageSolution
400ERRORvendor_id_invalidSpecify a valid alphanumeric vendor ID.
400ERRORstatus_invalidProvide a valid status. Possible values are: ACTIVE or BLOCKED.
400ERRORInvalid NameProvide a valid name. The name should not have any special character except. / - &,
400ERRORInvalid NameProvide a valid name. Ensure the name size must be between 0 and 100.
400ERRORInvalid email IDSpecify a valid Email ID.
400ERROREmail ID not specifiedSpecify a valid Email ID.
400ERRORPhone number not specifiedSpecify a valid phone number.
400ERRORPlease provide a valid Phone numberSpecify a valid phone number without special characters and the length is 10 digits.
400ERRORVPA not specifiedSpecify a valid VPA
500ERRORFailed to validate VPARetry after sometime
400ERRORAccount holder name not specifiedSpecify a valid account holder name
400ERRORInvalid account holder nameSpecify an account number without any special characters except. / - &,
400ERRORInvalid account typeProvide a valid account type without any special characters. Possible values: BUSINESS or INDIVIDUAL.
400ERRORInvalid uidai numberProvide a valid uidai (Aadhaar) number without special characters and the length is 12 digits.
400ERRORInvalid gst numberProvide a valid GST number without special characters and the length is 15 digits.
400ERRORInvalid cinProvide a valid CIN number without special characters and the length is 21 digits.
400ERRORInvalid PANProvide a valid PAN number without special characters and the length is 10 digits.
400ERRORInvalid passport numberProvide a valid passport number without any special characters and the length is 8 digits.
400ERRORMerchant is not ActiveEnsure merchant status is Active

Sample bank account numbers and upi vpas to test the API in the test environment.

Bank Numbers

For banks, the primary parameters for transfer would be the bank account and IFSC number included while adding the vendor. Sample details shared below are to simulate different vendor settlement situations.

NameAccount NumberIFSCRemarks
John Doe026291800001191YESB0000262Success
John Doe00011020001772HDFC0000001Success
John Doe000890289871772SCBL0036078Success
John Doe000100289877623SBIN0008752Failed at bank
John Doe2640101002729CNRR0002640Failure – Invaid IFSC code
John Doe026291800001190YESB0000262Failure – Invalid Account number
John Doe02014457596969CITI0000001Success (later to Reversed)
Jon D026291800001191YESB0000262Failure - Account holder name matching failed


For UPI, the primary parameter for transfer would be the UPI VPA included while adding the vendor. Use these UPI VPA to test transfers to the vendor account.

success@upiSuccessful UPI transfer
incorrect@upi and invalid@upiFailed UPI transfer

Watch this video to learn how to add a new vendor via API

Click Try It! to start a request and see the response here!