post https://api.cashfree.com/pg/settlements/split/vendors
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.
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