---
title: "Update Funding Account Settlement Destination"
method: PATCH
path: "/v1/funding-accounts/{id}/settlement-destination"
tags: ["public.funding-accounts"]
---

# Update Funding Account Settlement Destination

`PATCH /v1/funding-accounts/{id}/settlement-destination`

Rotates the active settlement destination for a permanent active funding account. This does not create new payment details.

## Path parameters

- `id` string, required

## Headers

- `X-Idempotency-Key` string, required

## Request body

- FundingAccountSettlementDestinationRequest
  - `destination_address` string — Required when type is ONCHAIN.
  - `destination_asset` 'USDC' | 'USDT' — Required when type is ONCHAIN. Supported values are USDC and USDT.
  - `destination_bank` FundingAccountDestinationBankRequest
    - `account_number` string, required — Recipient bank account number.
    - `bank_code` string, required — Recipient bank code.
  - `destination_chain` 'APTOS' | 'BASE' | 'CELO' | 'ETHEREUM' | 'POLYGON' | 'SOLANA' | 'TRON' — Required when type is ONCHAIN.
  - `rate_id` string — Required for TEMPORARY accounts. Rejected for PERMANENT accounts.
  - `type` 'INTERNAL_BALANCE' | 'NGN_BALANCE' | 'CUSTOMER_NGN_BALANCE' | 'ONCHAIN' | 'NGN_PAYOUT', required — Settlement destination type. NGN_BALANCE retains NGN at merchant level. CUSTOMER_NGN_BALANCE retains NGN for the funding account's customer. For permanent stablecoin funding accounts, it converts supported USDC/USDT deposits into that customer's NGN balance.

## Response `200`

OK

- FundingAccountResponse
  - `amount` string
  - `asset` 'USDC' | 'USDT' | 'SOL' | 'BNB'
  - `chain` 'APTOS' | 'BASE' | 'BSC' | 'CELO' | 'ETHEREUM' | 'POLYGON' | 'SOLANA' | 'SUI' | 'TEMPO' | 'TRON'
  - `created_at` string
  - `currency` string
  - `customer_id` string
  - `developer_fee` DeveloperFeeConfigResponse
    - `percentage` string — Percentage configured for deposits received through this account or receive address.
  - `disabled_at` string
  - `expires_at` string
  - `failure_code` string
  - `failure_message` string
  - `id` string
  - `instructions` FundingAccountInstructionResponse[]
    - `account_name` string
    - `account_number` string
    - `address` string
    - `bank_code` string
    - `bank_name` string
    - `chain` 'APTOS' | 'BASE' | 'BSC' | 'CELO' | 'ETHEREUM' | 'POLYGON' | 'SOLANA' | 'SUI' | 'TEMPO' | 'TRON'
    - `currency` string
    - `expires_at` string
    - `failure` FundingAccountInstructionFailureResponse
      - `code` string
      - `message` string
    - `provider` 'FLUTTERWAVE' | 'PAYSTACK' — Provider is returned only for merchant-facing NGN providers.
    - `provider_availability` FundingAccountProviderAvailabilityResponse
      - `message` string — User-facing explanation of a degraded or unavailable state.
      - `status` 'OPERATIONAL' | 'DEGRADED' | 'UNAVAILABLE' — Current provider service state.
    - `required_fields` string[]
    - `status` 'REQUIRES_INFORMATION' | 'PENDING' | 'ACTIVE' | 'FAILED' | 'DISABLED'
    - `type` 'NGN_VIRTUAL_ACCOUNT' | 'CRYPTO_ADDRESS'
  - `object` string
  - `rail` 'NGN_VIRTUAL_ACCOUNT' | 'CRYPTO_ADDRESS'
  - `settlement_destination` FundingAccountSettlementDestinationResponse
    - `destination_address` string
    - `destination_asset` 'USDC' | 'USDT'
    - `destination_bank` DestinationBank
      - `account_name` string
      - `account_number` string, required
      - `bank_code` string, required
    - `destination_chain` 'APTOS' | 'BASE' | 'CELO' | 'ETHEREUM' | 'POLYGON' | 'SOLANA' | 'TRON'
    - `destination_currency` string
    - `expires_at` string
    - `rate_id` string
    - `type` 'INTERNAL_BALANCE' | 'NGN_BALANCE' | 'CUSTOMER_NGN_BALANCE' | 'ONCHAIN' | 'NGN_PAYOUT'
  - `status` 'PENDING' | 'ACTIVE' | 'FAILED' | 'DISABLED'
  - `type` 'TEMPORARY' | 'PERMANENT'
  - `updated_at` string

## Other responses

- `400` — Invalid request
- `401` — Unauthorized
- `404` — Funding account not found
- `409` — Idempotency conflict
- `500` — Internal server error

---

[API](https://skmtc.dev/daya/apis/daya-external-api-public-api.md) · [All operations](https://skmtc.dev/daya/apis/daya-external-api-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/daya/daya-external-api-public-api/revisions/5fc72bf91a48/schema)