Skip to content
Create account or Sign in
The Stripe Docs logo
/
Create accountSign in
OverviewAccept a paymentUpgrade your integration
Online payments
OverviewFind your use caseUse Managed PaymentsRecurring payments
In-person payments
Payment Methods
Payment operations
Balances and settlement timeReceiptsRefunds and cancellations
Advanced integrations
Beyond payments

Accept a payment using local cards in NigeriaPrivate preview

Caution

Stripe can automatically present the relevant payment methods to your customers by evaluating currency, payment method restrictions, and other parameters.

  • Follow the Accept a payment guide to build a Checkout integration that uses dynamic payment methods.
  • If you don’t want to use dynamic payment methods, follow the steps below to manually configure the payment methods in your Checkout integration.

Integrating with Naira card enables Nigerian customers to pay using Nigerian-issued cards.

Local cards offer a redirect-based payment flow. When a customer makes a payment, Stripe redirects them to the local merchant of record service provider’s checkout page to authenticate and authorise the payment. After the customer authorises the payment, Stripe redirects them back to your site.

Determine compatibility

A Checkout Session must satisfy all the following conditions to support Nigerian payment methods:

  • Prices for all line items must be expressed in Nigerian naira (currency code ngn).
  • The minimum amount accepted is 500 NGN, and the maximum amount accepted is 100,000,000 NGN.

Accept a Naira card payment

Enable Naira card by making the following updates to your integration.

When creating a Checkout Session, you must do the following:

  • Add ng_card to the list of payment_method_types.
  • Make sure all line_items use the ngn currency.
Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price_data][currency]"=ngn \
  -d "line_items[0][price_data][product_data][name]"=T-shirt \
  -d "line_items[0][price_data][unit_amount]"=2000 \
  -d "line_items[0][quantity]"=1 \
  -d mode=payment \
  -d "payment_method_types[0]"=card \
  -d "payment_method_types[1]"=ng_card \
  --data-urlencode success_url="https://example.com/success"

Test your integration

When testing your Checkout integration, select Naira payment methods as the payment method and click Pay.