The Glomo API follows REST architecture, utilizing resource-oriented URLs for clarity. It handles form-encoded request bodies, delivers responses in JSON format, and operates with standard HTTP methods, authentication, and response codes.
You can download the complete API collection by using the download options on the right.
This resource represents internal fund movements between merchant accounts within the platform–partner model. Internal transfers enable seamless fund movement between merchants who operate under the same platform account. Internal transfers are restricted to accounts linked under the same platform hierarchy. The following transfer directions are supported:
| Transfer Type | Description |
|---|---|
| P → C | From a Platform (P) account to one of its Child (C) merchant accounts. |
| C → P | From a Child (C) merchant account back to its Platform (P) account. |
| C → C (same P) | Between Child (C) accounts under the same Platform (P). |
Creates a new virtual account with the specified payment type and currency. Virtual accounts provide unique account numbers that can be used to receive payments for customers. This endpoint returns HTTP 202 indicating the request has been accepted and is being processed. You will receive a webhook notification when the virtual account is activated.
The type of payments this virtual account will accept. 'local' for domestic payments within the same country, 'swift' for cross-border payments.
curl -i -X POST \
https://api.glomopay.com/api/v2/virtual-accounts \
-H 'Authorization: Bearer <YOUR_JWT_HERE>' \
-H 'Content-Type: application/json' \
-d '{
"payment_type": "local",
"currency": "USD"
}'{ "message": "Virtual account creation request is accepted.", "data": { "merchant_id": "merch_694bb0289P4Cz", "status": "pending" } }
The type of payments this virtual account will accept. 'local' for domestic payments within the same country, 'swift' for cross-border payments.
curl -i -X POST \
https://api.glomopay.com/api/v1/virtual-accounts \
-H 'Authorization: Bearer <YOUR_JWT_HERE>' \
-H 'Content-Type: application/json' \
-d '{
"payment_type": "local",
"currency": "USD"
}'Virtual account created successfully
The unique identifier for the virtual account.
The name associated with the virtual account, typically the business name.
The current status of the virtual account.
The date and time when the virtual account was created.
The date and time when the virtual account was last updated.
The unique identifier for the merchant associated with the virtual account.
The unique account number for the virtual account, formatted according to the country's banking standards. Applicable for AED, GBP, AUD, and USD accounts.
The International Bank Account Number (IBAN) for the virtual account. Applicable for EUR accounts.
The sort code for the virtual account. Applicable for GBP accounts.
The Bank State Branch (BSB) number for the virtual account. Applicable for AUD accounts.
The routing number for the virtual account. Applicable for USD accounts.
{ "account_id": "va_695b907fS58rY", "currency": "AED", "name": "Test Merchant Name", "status": "active", "merchant_id": "merch_694bb0289P4Cz", "created_at": "2026-01-05T10:20:47Z", "updated_at": "2026-01-05T10:20:47Z", "account_number": "AE580863912382801669068" }