Payouts to Nigeria

Review these Nigeria-specific requirements before initiating NGN payouts. For the general cross-border payment flow, see Sending Cross-Border Payments.

C2C restriction

Nigeria payouts support consumer-to-consumer (C2C) only. Business customers and business counterparties are not supported. Both the customer (originator) and counterparty (receiver) must be individuals.

Trading account requirement

Nigeria payouts require a USDC_SOL trading account as the source. Other trading account types (such as USDC or USDC_NPL) are not supported for NGN payouts.

Verify NGN payout availability

Confirm your bank supports NGN payouts for C2C and the bank_account route.

ℹ️

Bank configuration required

Contact Cybrid support to enable NGN payouts and configure Nigeria as a supported corridor for your bank.

GET /api/banks/{bank_guid}
Authorization: Bearer YOUR_TOKEN

Look for an entry in supported_payout_symbols where:

• symbol: NGN-USD or NGN-USDC_SOL
• country_code: NG
• participants_type: C2C
• route: bank_account

You can also query prices for Nigeria:

GET /api/prices?payout_country_code=NG
Authorization: Bearer YOUR_TOKEN

Identity verification requirements

When you create a plan, the API validates that all required KYC fields are present. Nigeria requires additional originator fields compared to other C2C corridors.

Originator (Customer)

Required fields for the customer (individual):

• name.first, name.last
• date_of_birth
• phone_number
• email_address
• address.street, address.country_code
• identification_numbers

⚠️

Additional originator fields

Unlike other C2C corridors, Nigeria requires phone_number, email_address, and identification_numbers on the originator.

Receiver (Counterparty)

Required fields for the counterparty (individual):

• name.first, name.last

The counterparty must be in verified state (watchlist screening passed) before you can create the external bank account and plan.

Purpose of transaction

For Nigeria C2C payouts, purpose_of_transaction is required. All standard purpose values are accepted.

External bank account setup

Nigeria payouts use NGBANK routing through Nigeria's banking infrastructure. Two routing formats are supported: a CBN bank code or a SWIFT/BIC code, both with a NUBAN account number.

Send a POST request to /api/external_bank_accounts with one of the following formats:

Option 1: CBN bank code (preferred)

Uses bank_code_type: "CBN" with a 3-digit CBN bank code (bank_code) and a 10-digit NUBAN account number (account_identifier).

{
  "account_kind": "raw_routing_details",
  "name": "Nigerian beneficiary account",
  "counterparty_bank_account_details": [{
    "bank_code_type": "CBN",
    "bank_code": "044",
    "account_identifier": "0123456789",
    "payment_rail": "NGBANK"
  }],
  "counterparty_guid": "counterparty_guid",
  "customer_guid": "customer_guid",
  "asset": "NGN"
}

Option 2: SWIFT/BIC code

Uses bank_code_type: "SWIFT_BIC" with a SWIFT/BIC code (bank_code) and a 10-digit NUBAN account number (account_identifier).

{
  "account_kind": "raw_routing_details",
  "name": "Nigerian beneficiary account (SWIFT)",
  "counterparty_bank_account_details": [{
    "bank_code_type": "SWIFT_BIC",
    "bank_code": "ABNGNGLA",
    "account_identifier": "0123456789",
    "payment_rail": "NGBANK"
  }],
  "counterparty_guid": "counterparty_guid",
  "customer_guid": "customer_guid",
  "asset": "NGN"
}

ℹ️

Routing preference

When both CBN and SWIFT/BIC routing details exist on the same NGN external bank account, the system prefers CBN routing. Configure only one routing method per external bank account to avoid relying on this implicit preference.

ℹ️

API versioning

Creating external bank accounts with foreign raw routing details requires Accept-Version: 2025-10-01 or later.

For the full account model and field reference, see Create Foreign Fiat External Bank Accounts.

Validation rules

• CBN bank code: Exactly 3 numeric digits
• NUBAN account number: Exactly 10 numeric digits (check digit validated per CBN Revised Standards 2019)
• SWIFT/BIC: Standard 8 or 11 alphanumeric characters
• Payment rail: Must be NGBANK for NGN payouts to Nigeria

Supported banks

The following 17 banks are available for NGN payouts to Nigeria. Use the CBN bank code (preferred) or SWIFT/BIC code when setting up the external bank account.

Common validation errors

Related resources

• Sending Cross-Border Payments
• Create Foreign Fiat External Bank Accounts
• Creating a Counterparty
• Verifying a Counterparty
• Create Plan API Reference