How to integrate Nomba API in 5 minutes

Introduction

Nomba provides different API services for collecting payments, paying bills, purchasing airtime, and terminal custom app integrations. When selecting a payment gateway, developers focus on tools that have abstracted away the complications that come with integrations. "Something that allows them to provide values with little or no time to waste." Nomba provides all of these tools at your fingertips.

In this article, our focus would be to learn how to quickly get started with integrating the Nomba API in 5 minutes, if not less. There are multiple API services to call. However, we will create a checkout order with the checkout API for testing purposes.

Highlight what we need to do in less than 5 minutes

1. Obtain Your API keys

2. Authenticate with your Keys

3. Initialize Payment

To get started, you would want to make this request from the backend by using a framework like Express Js, Nest, and so on.

Get Your API Credentials

To get your API credentials, you will need to create a cooperate account with us. Also, check here to learn more about the KYC requirement. When you are done with this step, log in to your dashboard and click on settings on the left pane. Click on Webhook and API Keys and copy your Test or Live keys.

Authenticate with your Keys

The sole purpose of authenticating with the Nomba API is to obtain your access token, as it will be subsequently used for all API requests. When you obtain a token, it's important to know that this token will expire in 25 minutes. So keep in mind to always refresh your token.

make a post request to this endpoint to obtain your access token

curl --request POST \
  --url https://api.nomba.com/v1/auth/token/issue \
  --header 'Content-Type: application/json' \
  --header 'accountId: <accountid>' \
  --data '{
  "grant_type": "client_credentials",
  "client_id": "2242b79d-f2cf-4ccc-ada1-e890bd1a9f0d",
  "client_secret": "JFJ8yq3G4+DvjivJMsji0YkZBkkKdSdjifR+TgT9RLM="
}'

This endpoint takes in grant_type, client_id, and client_secret with the accountId passed in the header.

To refresh your access token, make a POST request to this endpoint.

curl --request POST \
  --url https://api.nomba.com/v1/auth/token/refresh \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'accountId: <accountid>' \
  --data '{
  "grant_type": "refresh_token",
  "refresh_token": "01h4gdx2tctxfjgacbdwrcvs5d1688473602892"
}'

Here, you passed the refresh_token that was returned as a response to your first request. To learn more about the auth flow. check here

curl --request POST \
  --url https://api.nomba.com/v1/checkout/order \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'accountId: <accountid>' \
  --data '{
"order": {
    "orderReference": "90e81e8a-bc14-4ebf-89c0-57da752cca58",
    "customerId": "762878332454",
    "callbackUrl": "https://ip:port/merchant.com/callback",
    "customerEmail": "abcde@gmail.com",
    "amount": "10000.00",
    "currency": "NGN",
    "accountId": "01a10aeb-d989-460a-bbde-9842f2b4320f",
    "splitRequest": {
      "splitType": "PERCENTAGE",
      "splitList": [
        {
          "accountId": "01a10aeb-d989-460a-bbde-9842f2b4320f",
          "value": "65.45"
        }
      ]
    }
  },
  "tokenizeCard": "true"
}'

When creating a checkout order request, you can set the tokenizeCard to false or true depending on whether you intend to charge the same card later. You also need to pass your orderReference, callbackUrl, splitRequest, customer information, and so on.

There is so much to do when integrating into the Nomba service. However, this guide is created to help you make your first request in 5 minutes or less. So we have focused on what matters.

When you make an order, you will be redirected to a checkout page to complete your payment, and from there, it gets easier. After completing the payment. if you subscribe for a webhook event from us. We will send you a detailed event type that occurs when payment is made. You can also choose to verify the transaction with the verify transaction status endpoint.

Conclusion

Integrating Nomba's API is a straightforward process that enables seamless payment processing within your application. By following the outlined steps—obtaining your API keys, authenticating, and initializing payments—you can swiftly set up and begin accepting payments.

For a comprehensive understanding and further customization, go to Nomba's developer documentation. This resource provides in-depth guides and support to enhance your integration experience.