Glomo APIs apply comprehensive business logic validations to ensure that every request aligns with product rules, regulatory standards, and expected workflows. These validations go beyond simple formatting checks and focus on the correctness, consistency, and legitimacy of the transaction itself. By enforcing these rules, Glomo guarantees that only valid operations are processed, while any invalid request is immediately rejected with a clear and standardized error response.
| Field | What Can Go Wrong | Error Message You'll See |
|---|---|---|
| Name | Missing or blank | Customer name cannot be blank. |
| Customer Type | Anything other than Individual or Business | Customer type must be either Individual or Business. |
| Wrong format | Email address is not valid. | |
| Already used in your business | This email address is already registered under your business. | |
| Phone | Wrong format (if provided) | Phone number format is invalid. |
| Address | Missing | Address cannot be blank. |
| City | Missing | City cannot be blank. |
| State | Missing | State cannot be blank. |
| Country | Wrong code (not 3-letter, lowercase, or unsupported) | Country code must be a valid 3-letter ISO code (e.g., IND, USA). |
| Pincode | Missing for countries where it is mandatory | Pincode is required for the selected country. |
| Nationality | Wrong code (not valid 3-letter ISO) | Nationality code must be valid 3-letter ISO. |
| Date of Birth | Future date or wrong format | Date of birth must be in the past. |
| Duplicate Customer | Email already exists in the system | A customer with this email already exists. |
| Field | What Can Go Wrong | Error Message You'll See |
|---|---|---|
| Customer ID | Missing, empty, or wrong format (must start with cust_) | Customer ID must start with cust_ and be valid. |
| Amount | Zero, negative, or non-integer | Amount must be a positive whole number in the smallest currency unit (e.g., cents). |
| Currency | Not supported or not uppercase 3-letter code | Currency code must be valid (USD, EUR, GBP, AED, SGD). |
| Document ID | Wrong format (must start with doc_) | Document ID must start with doc_ and be valid. |
| Purpose Code | Invalid or not found in the system | Purpose code is not valid. |
| Invoice Amount | Zero or negative | Invoice amount must be greater than 0. |
| Invoice Number | Contains unsupported characters or too long (>50 chars) | Invoice number contains invalid characters or is too long. |
| Invoice Description | Contains unsupported characters or too long (>512 chars) | Invoice description contains invalid characters or is too long. |
| Product (Name/Description) | Name missing, invalid characters, or too long | Product name is required, valid characters only, max 128 chars. |
| Notes / Reference Number | Wrong format (rare) | Notes or reference number is invalid. |
| Duplicate Order | Order already exists | An order with these details already exists. |
| Customer Not Found | Customer ID doesn't exist in your account | Customer not found. |
| Field | What Can Go Wrong | Error Message You'll See |
|---|---|---|
| Customer ID | Missing, empty, or wrong format (must start with cust_) | Customer ID must start with cust_ and be valid. |
| Amount | Zero, negative, or non-integer | The amount must be a positive whole number in the smallest currency unit (e.g., cents). |
| Currency | Not supported or not uppercase 3-letter code | Currency code must be valid (USD, EUR, GBP, AED, SGD). |
| Purpose Code | Invalid or missing | Purpose code is not valid. |
| Expires At | Past date, wrong format, or more than 6 months ahead | Expiry date must be in the future and within 6 months. |
| Document ID | Wrong format (must start with doc_) | Document ID must start with doc_ and be valid. |
| Invoice Amount | Zero or negative | Invoice amount must be greater than 0. |
| Invoice Number | Contains unsupported characters or too long (>50 chars) | Invoice number contains invalid characters or is too long. |
| Invoice Description | Contains unsupported characters or too long (>512 chars) | Invoice description contains invalid characters or is too long. |
| Reminder Frequency | Value not in [1, 2, 7, 14] | Reminder frequency must be 1, 2, 7, or 14 days. |
| Product (Name/Description) | Name missing, invalid characters, or too long | Product name is required, valid characters only, max 128 chars. |
| Reference Number | Wrong format (rare) | Reference number is invalid. |
| Customer Not Found | Customer ID doesn't exist in your account | Customer not found. |
| Document Not Found | Document ID doesn't exist in your account | Document not found. |
| Duplicate Payment Link | Link already exists | A payment link with these details already exists. |
| Field | What Can Go Wrong | Error Message You'll See |
|---|---|---|
| Category | Missing or blank | Category can't be blank |
| Category | Not "lrs" or "payout" | Category must be one of: lrs, payout |
| Beneficiary | Missing or blank | Beneficiary can't be blank |
| Beneficiary | Not an object | Beneficiary must be an object |
| Beneficiary Name | Missing or blank | Beneficiary name is required |
| Beneficiary Address | Missing or blank | Beneficiary address is required |
| Bank Account | Missing or blank | Bank account can't be blank |
| Bank Account | Not an object | Bank account must be an object |
| Account Number | Missing or blank | Bank account account_number is required |
| Bank Name | Missing or blank | Bank account name is required |
| SWIFT Code | Missing or blank | Bank account swift_code is required |
| SWIFT Code | Not 8-11 characters (payout category) | Swift code must be 8 to 11 characters long |
| SWIFT Code | Not exactly 8 characters (LRS category) | Swift code must be 8 characters long |
| SWIFT Code | First 6 characters not alphabets | Swift code First 6 characters must be alphabets |
| SWIFT Code | Country code doesn't match bank address country | Swift code Country code in BIC does not match selected country |
| Currency | Missing or blank | Bank account currency is required |
| Bank Address | Missing or blank | Bank account address is required |
| Local Routing Number | Missing for LRS category | Local routing number can't be blank |
| Intermediate Bank | Provided but not an object | Bank account intermediate_bank must be an object |
| Duplicate Account | Account already exists for this business | Business already had this Account Number, Account Type and Transfer Method |