Skip to main content
GET
List funding accounts

Overview

Retrieve a paginated list of funding accounts for the authenticated merchant.

Authentication

string
required
Your merchant API key

Query Parameters

string
Filter by customer ID.
string
Filter by TEMPORARY or PERMANENT.
string
Filter by NGN_VIRTUAL_ACCOUNT or CRYPTO_ADDRESS.
string
Filter by PENDING, ACTIVE, FAILED, or DISABLED.
integer
Page number. Default: 1.
integer
Results per page. Default: 50. Max: 200.

Request Example

Response

Returns a paginated list of funding account objects. Each object includes developer_fee.percentage, which is the fee percentage used for deposits received through that funding account. The active settlement_destination.type identifies whether deposits settle to a merchant balance, customer NGN balance, external bank account, or on-chain address. See Funding Accounts for the supported matrix. Provider-backed instructions include provider_availability, which reports the provider’s current service condition. See Provider availability for the state definitions and recommended handling.