Skip to main content
GET
/
gcc
/
v3
/
merchants
/
{merchantId}
/
ffms
/
virtualAccounts
Fetch Virtual Accounts
curl --request GET \
  --url https://gcc.prod.payglocal.in/gcc/v3/merchants/{merchantId}/ffms/virtualAccounts \
  --header 'x-gl-auth: <api-key>'
{
  "gid": "REQ-XXXXX",
  "status": "201 CREATED",
  "timestamp": "08/10/2025 16:25:33",
  "reasonCode": "GL-201-001",
  "data": {
    "general": {
      "USD": {
        "id": "acct_abc123",
        "accountId": null,
        "accountNumber": "XXXXXXXXXX4490",
        "accountNumberType": "Local",
        "accountHolderName": "Acme Exports",
        "bankName": "Citibank, N.A.",
        "bankAddress": "One Penns Way, New Castle, DE 19720",
        "bankCountry": "US",
        "currency": "USD",
        "paymentType": null,
        "routingCode": "31100209",
        "routingCodeType": "ABA Number",
        "createdAt": "1752649980511",
        "updatedAt": null
      },
      "AUD": {
        "id": "acct_def456",
        "accountId": null,
        "accountNumber": "XXXXXX4490",
        "accountNumberType": "Local",
        "accountHolderName": "Acme Exports",
        "bankName": "BC Payments",
        "bankAddress": "Level 11/10 Carrington St, Sydney NSW 2000, Australia",
        "bankCountry": "AU",
        "currency": "AUD",
        "paymentType": null,
        "routingCode": "252000",
        "routingCodeType": "BSB Number",
        "createdAt": "1752649980511",
        "updatedAt": null
      }
    }
  },
  "errors": null
}

Documentation Index

Fetch the complete documentation index at: https://payglocal.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

​
When to Use

Call this after a merchant is fully activated on PayGlocal to retrieve their assigned global virtual accounts. Accounts are grouped by collection label (e.g. general) and within each label by currency code.
Returns data only for activated merchants. Calling for a merchant still in onboarding or pending review returns HTTP 401.

​
Response Structure

The data object is a two-level map: 
data
└── <collection_label>        (e.g. "general")
    └── <currency_code>       (e.g. "USD", "AUD", "GBP")
        └── VirtualAccount    (account number, bank name, routing code, etc.)

​
Error Scenarios

ScenarioHTTP Code
merchantId is not valid400
Merchant is not activated401

Authorizations

​
x-gl-auth
string
header
required

Static API Key generated from the PayGlocal Partner Dashboard.

Path Parameters

​
merchantId
string
required

Identifier of the onboarded merchant.

Response

Virtual accounts retrieved successfully.

​
gid
string
Example:

"REQ-XXXXX"

​
status
string
Example:

"201 CREATED"

​
timestamp
string
Example:

"08/10/2025 16:25:33"

​
reasonCode
string
Example:

"GL-201-001"

​
data
object

Keyed by collection label, then by currency code.

​
errors
object