Payouts to Nigeria

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

Supported configurations

Nigeria payouts support the following participant types:

• C2C (consumer-to-consumer) — individual customer to individual counterparty
• B2C (business-to-consumer) — business customer to individual counterparty
• B2B (business-to-business) — business customer to business counterparty

All three use the bank_account route.

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 your participant type 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, B2C, or B2B
• route: bank_account

You can also query prices for Nigeria:

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

Identity verification requirements

The platform validates all required KYC fields when you create a plan for NGN payouts. Requirements differ by participant type.

Originator (Customer)

Individual originator (C2C):

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

⚠️

Extra fields required for individual originators

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

Business originator (B2C, B2B):

• name.full
• address.street, address.country_code
• identification_numbers with one of:
  • tax_identification_number
  • employer_identification_number
  • business_registration_number

Receiver (Counterparty)

Create the counterparty with the standard required fields for the appropriate type (individual or business). The counterparty must be in verified state before you can create the external bank account and plan.

Individual counterparty (C2C, B2C): This corridor requires no additional counterparty fields beyond the platform defaults.

Business counterparty (B2B): This corridor requires no additional counterparty fields beyond the platform defaults.

Purpose of transaction

For Nigeria payouts, purpose_of_transaction is required for all participant types. 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 31 banks are available for NGN payouts to Nigeria across all supported participant types. Use the CBN bank code (preferred) or SWIFT/BIC code when setting up the external bank account. Not all banks are available in the sandbox environment; check the Sandbox column for availability.

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