Set up future payments with Naira cardPrivate preview

Learn how to save Naira card to charge customers later.

Save Naira card payment details using Checkout, our fully hosted checkout page.

Learn how to set up a subscription with Naira card to create recurring payments after saving a payment method in Checkout.

Set up Stripe
Server-side

First, you need a Stripe account. Register now.

Access the Stripe API from your application using our official libraries:

Getting permission to save a payment method
Server-side

You need the customer’s permission to save their payment method for future use. Creating an agreement (sometimes called a mandate) up front allows you to save the customer’s payment details and charge them when they’re not actively using your website or app.

Add terms to your website or app that state how you plan to save the customer’s payment method details, and let them opt in. If you plan to charge the customer when they’re offline, make sure that your terms also include the following:

The customer’s permission for you to initiate a payment or a series of payments on their behalf for specified transactions
The anticipated frequency (one-off or recurring) and timing of payments
How you determine the payment amount
Your cancellation policy, if you’re setting up the payment method for a subscription service

Make sure that you keep a record of the customer’s written agreement to these terms.

Create or retrieve a Customer
Server-side

To save a Naira card payment method for future payments, attach it to a Customer.

Create a Customer object when the customer creates an account with your business, and associate the ID of the Customer object with your own internal representation of that customer. Alternatively, you can create a new Customer before saving a payment method for future payments.

Create a new Customer or retrieve an existing Customer to associate with this payment. Include the following code on your server to create a new Customer:

Create a Checkout Session
Server-side

The customer must authorise the use of the local merchant of record service provider for future payments.

Add a checkout button to your website that calls a server-side endpoint to create a Checkout Session.

index.html
<html>
  <head>
    <title>Checkout</title>
  </head>
  <body>
    <form action="/create-checkout-session" method="POST">
      <button type="submit">Checkout</button>
    </form>
  </body>
</html>

Create a Checkout Session in setup mode to collect the required information. After creating the Checkout Session, redirect the customer to the Checkout session URL that the response returns.

Test your integration

Select Naira card as the payment method, then click Continue to Naira card. Test the setup by authenticating the SetupIntent on the redirect page. If the SetupIntent transitions from requires_action to succeeded, the setup is correct.

Set up future payments with Naira cardPrivate preview

Learn how to save Naira card to charge customers later.

Set up StripeServer-side

Getting permission to save a payment methodServer-side

Create or retrieve a CustomerServer-side

Create a Checkout SessionServer-side

Test your integration

Set up Stripe
Server-side

Getting permission to save a payment method
Server-side

Create or retrieve a Customer
Server-side

Create a Checkout Session
Server-side