Skip to main content
PATCH
Update merchant NGN settlement destination

Overview

Sets how future deposits to your merchant’s permanent NGN funding account are credited. This is a merchant-level preference, not a per-deposit option. Set it once before accepting deposits and change it only when your settlement model changes.
Changing the preference affects future deposits only. It does not convert or move existing balances, and it does not change deposits that have already settled.
Your merchant funding setup must be ACTIVE and include an NGN bank account before you can select NGN_BALANCE.

Authentication

string
required
Your merchant API key.

Request Body

string
required
The settlement mode for future merchant NGN funding deposits. Allowed values are USD_BALANCE and NGN_BALANCE.

Request Examples

Response

Returns the merchant funding configuration with the selected ngn_settlement_destination.
Call GET /v1/merchant/funding at any time to confirm the current setting.

Errors

  • 400: Unsupported destination, or NGN_BALANCE was requested without an active NGN merchant funding account.
  • 401: Missing or invalid API key.
  • 404: Merchant funding configuration not found.
  • 500: Internal server error.