Skip to main content
POST
Request business NGN wallet withdrawal
Initiates a withdrawal/payout of funds from the merchant’s NGN wallet to their verified settlement bank account.

Payout Webhooks

Successful withdrawals emit a withdrawal.completed webhook event. Failed withdrawals emit withdrawal.failed. See Webhooks for payload schemas and signature details.

Authorizations

x-api-key
string
header
required

Merchant API Key (e.g., nexa-prod-... or nexa-test-...)

Headers

x-business-env
enum<string>
default:prod

Target environment selector (live production vs. simulated sandbox).

Available options:
prod,
test

Body

application/json
businessId
string
required

The unique ID of the business profile.

amount
number
required

The amount to withdraw (minimum ₦1,000).

Required range: x >= 1000

Response

Withdrawal payout transaction processed successfully (e.g. in test mode).