Pool Accounts

Kora's Pool Account solution allows you to receive local payments through shared Kora-owned bank accounts. Each transaction is tagged with a unique Reference ID, enabling clear identification, reconciliation, and settlement.

Key Benefits of Pool Accounts

• Receive payments via a shared bank account across supported African countries.
• Generate unique Reference IDs for each customer or transaction.
• Get notified when payments are settled and available for withdrawal.
• Export transaction and settlement history for easy reconciliation.

Accepting Payments with Pool Account Reference ID

Here's how to use the Reference ID of a Pool Account to accept payments:

1. Generate a Reference ID

There are two (2) ways to generate a reference ID -- from your Kora dashboard, and via API. Each reference ID generated must be unique to a customer, and is required in the payment narration.

To generate a Reference ID from your Kora dashboard:

1. Log in to your Kora dashboard
2. Navigate to the Accounts tab on the side menu.
3. Click on the Account dropdown on the page and select 'Pool Accounts'.
4. On the Pool Accounts page, click “Generate Reference”.
5. Enter your customer details:
   1. Customer Name (required)
   2. Customer Email (required)
6. A new Reference ID will appear instantly on your dashboard.

To generate a Reference ID via API:

Simply make a POST request to the Pool Account endpoint:

{{baseurl}}/api/v1/pool_accounts

The request should have the following parameters:

The response to the request could look like this:

{
   "status": true,
   "message": "Pool Account Reference has been created successfully",
   "data": {
       "reference": "KPY-MIC-JAN-TNa5",
       "customer_name": "janedoe",
       "customer_email": "[email protected]",
       "date_created": "2025-06-30T11:55:10.889Z"
   }
}

2. Share payment instructions with your customer

To accept a payment, share the following details to your customer:

• Bank Account details (This will be provided to you by your account manager).
• Reference ID (Ensure that the customer includes the exact Reference ID in the transfer narration).

3. Track transactions in real time

Once payment is made, Kora will map the transaction to the correct Reference ID. You’ll see the transaction appear under the Reference ID with status Pending. When funds are reconciled and available for withdrawal, status will update to Settled.

4. Webhook notifications

When a transaction is settled, Kora sends a webhook to your configured endpoint.

Event: Payment Notification

Here's a sample webhook payload:

{
  "event": "charge.success",
  "data": {
    "fee": 0,
    "amount": 1000,
    "status": "success",
    "currency": "KES",
    "reference": "test-transation-991",
    "payment_reference": "test-transation-991"
  }
}

Support

Need help with using Pool Accounts? Reach out to [email protected]
(Please include the Pool Account Reference ID and transaction details in your request for faster resolution.)