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. |