Create Vendor v2.0

Settlement Cycles Supported

Settlement Cycle Details

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

Response Codes

Sub Code	Status	Message	Solution
400	ERROR	vendor_id_invalid	Specify a valid alpha numeric vendor ID.
400	ERROR	status_invalid	Provide a valid status. Possible values are: ACTIVE or BLOCKED.
400	ERROR	Invalid Name	Provide a valid name. The name should not have any special character except . / - &,
400	ERROR	Invalid Name	Provide a valid name. Ensure the name size must be between 0 and 100.
400	ERROR	Invalid email ID	Specify a valid Email ID.
400	ERROR	Email ID not specified	Specify a valid Email ID.
400	ERROR	Phone number not specified	Specify a valid phone number.
400	ERROR	Please provide a valid Phone number	Specify a valid phone number without special characters and the length is 10 digits.
400	ERROR	VPA not specified	Specify a valid VPA
500	ERROR	Failed to validate VPA	Retry after sometime
400	ERROR	Account holder name not specified	Specify a valid account holder name
400	ERROR	Invalid account holder name	Specify a account number without any special characters except . / - &,
400	ERROR	Invalid account type	Provide a valid account type without any special characters. Possible values: BUSINESS or INDIVIDUAL.
400	ERROR	Invalid uidai number	Provide a valid uidai (Aadhaar) number without special characters and the length is 12 digits.
400	ERROR	Invalid gst number	Provide a valid gst number without special characters and the length is 15 digits.
400	ERROR	Invalid cin	Provide a valid cin number without special characters and the length is 21 digits.
400	ERROR	Invalid PAN	Provide a valid PAN number without special characters and the length is 10 digits.
400	ERROR	Invalid passport number	Provide a valid passport number without any special characters and the length is 8 digits.
400	ERROR	Merchant is not Active	Ensure 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.

Name	Account Number	IFSC	Remarks
John Doe	026291800001191	YESB0000262	Success
John Doe	00011020001772	HDFC0000001	Success
John Doe	000890289871772	SCBL0036078	Success
John Doe	000100289877623	SBIN0008752	Failed at bank
John Doe	2640101002729	CNRR0002640	Failure – Invaid IFSC code
John Doe	026291800001190	YESB0000262	Failure – Invalid Account number
John Doe	02014457596969	CITI0000001	Success (later to Reversed)
Jon D	026291800001191	YESB0000262	Failure - Account holder name matching failed

UPI

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.

VPA	Remarks
[email protected]	Successful UPI transfer
[email protected] and [email protected]	Failed UPI transfer

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