Skip to content

API specification for Glomo (1.0.0)

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.

Download OpenAPI description
Languages
Servers
Production server

https://api.glomopay.com/api/v1/

Balance

This resource represents your Glomo balance. You can retrieve it to see the current balance on your Glomo account in all currencies enabled for your account.

SchemasOperations

Balance Conversions

Balance Conversion resource represents the details of the balance conversion. The balance conversion is the conversion of the balance from one supported currency to another supported currency.

SchemasOperations

Orders

This resource represents the order details. The order is the request to receive payment from your customer.

SchemasOperations

Request

Retrieve details of an order.

Security
JWT
Path
idstringrequired

The ID of the order

Example: order_678a4c88hpAjf
curl -i -X GET \
  https://api.glomopay.com/api/v1/orders/order_678a4c88hpAjf \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

Payment link retrieved successfully

Bodyapplication/json
idstring(string)read-only

The unique identifier for the order.

Example: "order_678a4c88hpAjf"
customer_idstring

The unique identifier of customer linked to order.

Example: "cust_E602dMzgjpDC"
document_idstring

The unique identifier of document linked to order. This document entity should contain the required documents to process incoming payments. Refer this Document entity for more details.

Example: "doc_nYUqLpuYQ0M8"
statusstringread-only

The status of the Order.

Enum"active""paid""failed""action_required""cancelled""under_review"
Example: "success"
currencystring(iso-4217)

The currency code in ISO 4217 format. Supported currencies: USD,EUR and GBP.

Example: "USD"
amountnumber>= 1

The amount you want to receive, a positive integer representing the smallest currency unit. For example, if the amount is $299.00, then pass 29900 in this field. In the case of three decimal currencies, such as KWD, BHD and OMR, to represent an amount of 295.991, pass the value as 295990. And in the case of zero decimal currencies such as JPY, for amount ï¿¥295, pass the value as 295.

Example: 1000
purpose_codestring

Purpose code for why you want to receive this payment

Example: "P1401"
invoice_numberstring

Number/Id of the invoice submitted with order.

Example: "RG12FF590"
invoice_descriptionstring

Description about the invoice submitted with order

Example: "Payment requested for services provided"
invoice_amountnumber

The amount in cents for which invoice was generated. It can be more than the amount requested in this order

Example: 1000
reference_numberstring

optional identifier to be sent for reconciliations

Example: "R0001"
productobject(Product)
notesobject

Any additional notes for the order

Example: {"key1":"value1","key2":"value2"}
bank_account_detailsobjectread-only

Bank account details associated with the customer for this order. If provided in the request, all fields will be returned. If bic_primary or bic_secondary was not provided in the request, they will be null in the response.

Example: {"account_number":"1234567890","bic_primary":"HDFCINBBDEL","bic_secondary":null,"bank_customer_id":"7189204715"}
payment_methodsArray of stringsread-only

Array of payment methods that should be available for the customer on the checkout page. This field allows you to control which payment options your customers can use to complete the payment. You can specify one or multiple payment methods in the array.

Items Enum"bank_transfer""pay_via_bank""card"
Example: ["card"]
created_atstring(timestamp)read-only

Timestamp representing when the order was created

Example: "2021-06-01T12:00:00Z"
updated_atstring(timestamp)read-only

Timestamp representing when the order was last updated

Example: "2021-06-01T12:00:00Z"
rfi_documentsArray of objectsread-only

List of required documents for RFI (Request for Information). This field is only present when the order status is 'action_required', indicating that sanction screening has been triggered and additional documents are required to proceed with the payment.

Example: [{"rfi_doc_id":"rfidoc_123","name":"Passport"},{"rfi_doc_id":"rfidoc_456","name":"Proof of Address"}]
Response
application/json
{ "id": "order_678a4c88hpAjf", "customer_id": "cust_E602dMzgjpDC", "document_id": "doc_nYUqLpuYQ0M8", "status": "success", "currency": "USD", "amount": 1000, "purpose_code": "P1401", "invoice_number": "RG12FF590", "invoice_description": "Payment requested for services provided", "invoice_amount": 1000, "reference_number": "R0001", "product": { "name": "ShieldGuard Insurance", "description": "Flexible insurance for belongings, travel, and digital assets; easy to manage" }, "notes": { "key1": "value1", "key2": "value2" }, "bank_account_details": { "account_number": "1234567890", "bic_primary": "HDFCINBBDEL", "bank_customer_id": "7189204715", "bic_secondary": null }, "payment_methods": [ "card" ], "created_at": "2021-06-01T12:00:00Z", "updated_at": "2021-06-01T12:00:00Z", "rfi_documents": [ { … }, { … } ] }

Request

Updates the RFI (Request for Information) document status for an order. This endpoint is used to submit required documents when an order is in 'action_required' status due to sanction screening.

Security
JWT
Path
idstringrequired

The ID of the order to update RFI for

Example: order_678a4c88hpAjf
Bodyapplication/jsonrequired
documentsArray of objectsrequired

Array of documents to be submitted for RFI requirements

documents[].​idstringrequired

The unique identifier of the document being uploaded for this RFI requirement

Example: "doc_67fc2f42468Bw"
documents[].​rfi_doc_idstringrequired

The unique identifier of the RFI document being submitted

Example: "rfidoc_68c8dffedhMHD"
curl -i -X PATCH \
  https://api.glomopay.com/api/v1/orders/order_678a4c88hpAjf/update_rfi \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "documents": [
      {
        "id": "doc_67fc2f42468Bw",
        "rfi_doc_id": "rfidoc_68c8dffedhMHD"
      }
    ]
  }'

Responses

RFI document updated successfully

Bodyapplication/json
idstring(string)read-only

The unique identifier for the order.

Example: "order_678a4c88hpAjf"
customer_idstring

The unique identifier of customer linked to order.

Example: "cust_E602dMzgjpDC"
document_idstring

The unique identifier of document linked to order. This document entity should contain the required documents to process incoming payments. Refer this Document entity for more details.

Example: "doc_nYUqLpuYQ0M8"
statusstringread-only

The status of the Order.

Enum"active""paid""failed""action_required""cancelled""under_review"
Example: "success"
currencystring(iso-4217)

The currency code in ISO 4217 format. Supported currencies: USD,EUR and GBP.

Example: "USD"
amountnumber>= 1

The amount you want to receive, a positive integer representing the smallest currency unit. For example, if the amount is $299.00, then pass 29900 in this field. In the case of three decimal currencies, such as KWD, BHD and OMR, to represent an amount of 295.991, pass the value as 295990. And in the case of zero decimal currencies such as JPY, for amount ï¿¥295, pass the value as 295.

Example: 1000
purpose_codestring

Purpose code for why you want to receive this payment

Example: "P1401"
invoice_numberstring

Number/Id of the invoice submitted with order.

Example: "RG12FF590"
invoice_descriptionstring

Description about the invoice submitted with order

Example: "Payment requested for services provided"
invoice_amountnumber

The amount in cents for which invoice was generated. It can be more than the amount requested in this order

Example: 1000
reference_numberstring

optional identifier to be sent for reconciliations

Example: "R0001"
productobject(Product)
notesobject

Any additional notes for the order

Example: {"key1":"value1","key2":"value2"}
bank_account_detailsobjectread-only

Bank account details associated with the customer for this order. If provided in the request, all fields will be returned. If bic_primary or bic_secondary was not provided in the request, they will be null in the response.

Example: {"account_number":"1234567890","bic_primary":"HDFCINBBDEL","bic_secondary":null,"bank_customer_id":"7189204715"}
payment_methodsArray of stringsread-only

Array of payment methods that should be available for the customer on the checkout page. This field allows you to control which payment options your customers can use to complete the payment. You can specify one or multiple payment methods in the array.

Items Enum"bank_transfer""pay_via_bank""card"
Example: ["card"]
created_atstring(timestamp)read-only

Timestamp representing when the order was created

Example: "2021-06-01T12:00:00Z"
updated_atstring(timestamp)read-only

Timestamp representing when the order was last updated

Example: "2021-06-01T12:00:00Z"
rfi_documentsArray of objectsread-only

List of required documents for RFI (Request for Information). This field is only present when the order status is 'action_required', indicating that sanction screening has been triggered and additional documents are required to proceed with the payment.

Example: [{"rfi_doc_id":"rfidoc_123","name":"Passport"},{"rfi_doc_id":"rfidoc_456","name":"Proof of Address"}]
Response
application/json
{ "id": "order_678a4c88hpAjf", "customer_id": "cust_E602dMzgjpDC", "document_id": "doc_nYUqLpuYQ0M8", "status": "success", "currency": "USD", "amount": 1000, "purpose_code": "P1401", "invoice_number": "RG12FF590", "invoice_description": "Payment requested for services provided", "invoice_amount": 1000, "reference_number": "R0001", "product": { "name": "ShieldGuard Insurance", "description": "Flexible insurance for belongings, travel, and digital assets; easy to manage" }, "notes": { "key1": "value1", "key2": "value2" }, "bank_account_details": { "account_number": "1234567890", "bic_primary": "HDFCINBBDEL", "bank_customer_id": "7189204715", "bic_secondary": null }, "payment_methods": [ "card" ], "created_at": "2021-06-01T12:00:00Z", "updated_at": "2021-06-01T12:00:00Z", "rfi_documents": [ { … }, { … } ] }

Customer

This resource represents a customer of your business. The customer can be an individual or a business from whom you will receive payments.

SchemasOperations

Document

Document resource represents the documents details uploaded. This document is used in payin, payout, etc.

Operations

Payment

This resource represents a payment attempt made by your customer. The payment can either be successfully completed or failed, depending on various factors.

SchemasOperations

Refund

This resource represents a refund transaction from your Glomo account to your customer. You can retrieve it to see the details of the refund transaction.

SchemasOperations

Price

This resource represents the pricing details of the payin or payout. The pricing details include the fees and the pricing type

SchemasOperations

Subscription

This resource represents a recurring billing agreement for a customer. Subscriptions allow businesses to automatically charge customers on a regular schedule according to a defined billing plan.

SchemasOperations

Payout

This resource represents the disbursement transactions from your Glomo account to your beneficiaries.

SchemasOperations

Beneficiary

This resource represents a payee of a payout initiated by your business. The beneficiary can be an individual or a business to whom you will send funds.

SchemasOperations

Bank Account Validation

Bank Account Validation resource represents the validation details of a bank account.

SchemasOperations

Internal Transfer

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 TypeDescription
P → CFrom a Platform (P) account to one of its Child (C) merchant accounts.
C → PFrom a Child (C) merchant account back to its Platform (P) account.
C → C (same P)Between Child (C) accounts under the same Platform (P).
SchemasOperations

Withdrawal

[DEPRECATED] This resource represents the withdrawal transaction from your Glomo account to your withdrawal account.

SchemasOperations

Withdrawal Account

This resource represents the withdrawal account details. The withdrawal account is the bank account where the withdrawal amount will be credited.

SchemasOperations

Settlement

This resource represents the settlement details. The settlement is the process of transferring funds from your Glomo account to your bank account.

SchemasOperations

Virtual Account

This resource represents virtual account details. A virtual account is a unique account number provisioned for a customer, allowing payments to be received and transactions to be tracked against that customer.

SchemasOperations

Platform

This resource provides platform functionality that enables platforms to onboard merchants onto Glomo, with each merchant having their own dedicated Virtual Accounts (VA).

SchemasOperations