public.merchant-funding

Update Merchant NGN Funding Settlement Destination

Selects how future deposits to the merchant's permanent NGN funding account settle. USD_BALANCE preserves automatic NGN-to-USD conversion; NGN_BALANCE retains NGN in withdrawal_balance_ngn. Existing settled deposits are not changed.

patch/v1/merchant/funding/settlement-destination

Request body

ngn_settlement_destination'USD_BALANCE' | 'NGN_BALANCE' required

Example request

{
  "ngn_settlement_destination": "NGN_BALANCE"
}

Response

OK

Example response

{
  "data": {
    "crypto_wallet": {
      "addresses": [
        {
          "address": "0x1234",
          "chain": "POLYGON"
        }
      ],
      "wallet_id": "wallet_123"
    },
    "id": "750e8400-e29b-41d4-a716-446655440000",
    "ngn_account": {
      "account_name": "Acme Ltd",
      "account_number": "0123456789",
      "bank_code": "035",
      "bank_name": "Wema Bank"
    },
    "ngn_settlement_destination": "USD_BALANCE",
    "setup_status": "ACTIVE"
  }
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.