Initiate Payout (Single and bulk payout)

LedgerBlock supports payout initiation through multiple methods, allowing merchants to move funds from a user's subwallet to a supported destination.

Payouts can be initiated as either a single payout or a bulk payout, depending on the number of transactions being processed.

Supported Payout Methods

LedgerBlock supports the following subwallet payout destinations:

• Subwallet to Bank — transfer funds from a user's subwallet to a Nigerian bank account.
• Subwallet to Mobile Money — transfer funds from a user's subwallet to a supported mobile money account.
• Subwallet to Crypto — transfer funds from a user's subwallet to a supported cryptocurrency destination.
• Subwallet to EUSD — transfer funds from a user's subwallet to EUSD.

Payout Types

Single Payout Flow

For a single payout, the merchant initiates an individual payout by providing the required beneficiary and transaction details.

Subwallet → Select Payout Method → Provide Beneficiary Details → Authorize Payout → Payout Completed

Bulk Payout Flow

For bank payouts involving multiple beneficiaries, merchants can use the bulk payout flow.

Upload Bank Accounts → Complete Bulk Payout → Get Bulk Payout → Retry Failed Payouts (if required)

The bulk payout process supports up to 1,000 bank accounts per batch.

Supported Subwallet Destinations

Payout Process

User Subwallet
      ↓
Select Payout Method
      ↓
┌───────────────┬───────────────────┬──────────────────┬─────────────────┐
│     Bank      │   Mobile Money    │      Crypto      │      EUSD       │
└───────────────┴───────────────────┴──────────────────┴─────────────────┘
      ↓
Provide Required Details
      ↓
Authorize Payout
      ↓
Payout Processing
      ↓
Payout Completed

Bulk Payout Endpoints

The bulk bank payout process consists of the following steps:

1. Upload Bank Accounts — Upload a CSV containing multiple bank payout instructions.
2. Complete Bulk Payout — Required after the upload to authorize and complete the batch.
3. Get Bulk Payout — Retrieve the status and results of the batch.
4. Retry Payout — Retry an individual failed payout within the batch.