JGME Pay
Core Concepts

Wallets

Understand JGME Pay wallet types, balances, and operational actions for collections and disbursements.

JGME Pay assigns wallets per merchant and market to separate collection inflows from disbursement outflows.

Wallet Types

Collection Wallet (Deposit)

Incoming payment funds are settled here first. Use this wallet as your primary collection balance.

Disbursement Wallet (Disbursement)

Disbursement and transfers are deducted from this wallet when you run disbursements.

Wallet Status

Wallets can appear in these states:

StatusMeaning
activeWallet can receive and send funds based on configured operations.
post-no-debitWallet can receive funds, but outgoing debits are blocked.

post-no-debit is commonly used as a safety control when credentials or disbursement controls may be compromised.

Wallet Operations

Fetch Wallet Balances via API

Use the wallet endpoint to query current balances by country and currency.

curl --location 'https://api.jgmepay.com/billing/v1/wallets?country=NG&currency=NGN' \
  --header 'client-id: <your-client-id>' \
  --header 'client-secret: <your-client-secret>'

Sample response shape:

{
  "data": [
    {
      "type": "deposit",
      "amount": 1250000,
      "currency": "NGN",
      "country": "NG",
      "status": "active"
    },
    {
      "type": "disbursement",
      "amount": 500000,
      "currency": "NGN",
      "country": "NG",
      "status": "active"
    }
  ]
}

Monitor collection inflow

Track funds entering your deposit/collection wallet after successful transactions.

Fund disbursement wallet proactively

Transfer enough balance to disbursement wallet before high-volume disbursement runs.

Alert on low disbursement balance

Set internal alerts so disbursement operations do not fail due to insufficient wallet funds.

Apply security controls quickly

If compromise is suspected, suspend outgoing wallet operations and rotate credentials immediately.

On this page