tokenKey). From then on, you charge the card by sending that token.
This section uses the Nomba checkout page for the first payment: you send the customer to a payment link, and Nomba collects their card details. To collect card details on your own page instead, see Recurring payments with the API.
Use recurring payments for:
- Subscriptions and memberships
- Instalment plans
- Automatic top-ups, such as wallet or airtime reloads
- One-click repeat purchases (“Pay with saved card”)
How it works
1
Create a checkout order
Create the first order with
tokenizeCard: true and send the customer to the checkoutLink to pay. Create a checkout order →2
Store the card token
Read the
tokenKey from the payment_success webhook and save it with your customer’s record. Store the card token →3
Charge a saved card
When a payment is due, send the
tokenKey and the amount to Nomba. Charge a saved card →4
Complete an OTP challenge, if the bank asks for one
Some banks ask the customer to approve a charge with an OTP. Collect it and submit it. Complete an OTP challenge →
5
Confirm the charge
Verify the final status before you give the customer value. Confirm the charge →
What Nomba does and what you do
If you don’t want to run your own billing schedule, use a payment link with a recurring frequency instead. Nomba then saves the customer’s card on the first payment and charges it daily, weekly, monthly or on another schedule you choose. This guide is for merchants who want to control billing from their own server through the API.
Before you begin
- API keys and an access token. See Obtain API keys and Authenticate.
- A webhook URL. The card token arrives in a webhook. See Setting up webhooks.
- Card payments enabled on your account. Saving a card doesn’t need to be switched on separately, but every charge on a saved card is a card payment. If card payments aren’t enabled for your business, the charge is rejected with “Card payment is not supported for this order”. Contact Nomba support to enable them.
Key terms
Next: Create a checkout order
Create the order that saves the customer’s card.