> ## Documentation Index
> Fetch the complete documentation index at: https://docs.daya.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Update merchant NGN settlement destination

> Choose whether merchant NGN funding deposits remain in NGN or convert to USD

## Overview

Sets how future deposits to your merchant's permanent NGN funding account are credited.

| Value         | Result                                                                                                  |
| ------------- | ------------------------------------------------------------------------------------------------------- |
| `USD_BALANCE` | Converts the NGN deposit at the current rate and credits `withdrawal_balance_usd`. This is the default. |
| `NGN_BALANCE` | Retains the deposit in Naira and credits `withdrawal_balance_ngn` without FX conversion.                |

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.

<Note>
  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.
</Note>

<Warning>
  Your merchant funding setup must be `ACTIVE` and include an NGN bank account before you can select `NGN_BALANCE`.
</Warning>

## Authentication

<ParamField header="X-Api-Key" type="string" required>
  Your merchant API key.
</ParamField>

## Request Body

<ParamField body="ngn_settlement_destination" type="string" required>
  The settlement mode for future merchant NGN funding deposits. Allowed values are `USD_BALANCE` and `NGN_BALANCE`.
</ParamField>

## Request Examples

<CodeGroup>
  ```bash Retain deposits in NGN theme={"dark"}
  curl --request PATCH \
    --url https://api.daya.co/v1/merchant/funding/settlement-destination \
    --header 'X-Api-Key: YOUR_API_KEY' \
    --header 'Content-Type: application/json' \
    --data '{
      "ngn_settlement_destination": "NGN_BALANCE"
    }'
  ```

  ```bash Restore automatic USD conversion theme={"dark"}
  curl --request PATCH \
    --url https://api.daya.co/v1/merchant/funding/settlement-destination \
    --header 'X-Api-Key: YOUR_API_KEY' \
    --header 'Content-Type: application/json' \
    --data '{
      "ngn_settlement_destination": "USD_BALANCE"
    }'
  ```
</CodeGroup>

## Response

Returns the merchant funding configuration with the selected `ngn_settlement_destination`.

<ResponseExample>
  ```json 200 OK theme={"dark"}
  {
    "data": {
      "id": "750e8400-e29b-41d4-a716-446655440000",
      "setup_status": "ACTIVE",
      "ngn_settlement_destination": "NGN_BALANCE",
      "ngn_account": {
        "account_number": "0123456789",
        "account_name": "Acme Ltd",
        "bank_name": "Wema Bank",
        "bank_code": "035"
      },
      "crypto_wallet": {
        "wallet_id": "wallet_abc123",
        "addresses": []
      }
    }
  }
  ```
</ResponseExample>

Call [`GET /v1/merchant/funding`](/api-reference/merchant-funding/get-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.