In order to begin your integration, you will first need to create an order from your server as shown in the diagram below. This section will cover this step of the integration.

The following will explain in detail how to go about creating an order:

Obtaining a Token

All Nimbbl APIs are authorized using Bearer Token. In order to generate the token, you need to pass the keys available with you (access_key,access_secret). While you are testing, please use your Test Keys and in the Live environment, please use the Live Keys.

The token has a validity of 20 minutes and you need not create another token till this token has expired.

Method	End Point
POST	/v3/generate-token

To read in detail about the request, response, sample payloads and error scenarios for this API, please click here.

Creating an Order

Creating an order is very simple as you need to pass all the information required by the Nimbbl API. The order API needs information about the following:

1. Total Amount - This is the total amount inclusive of taxes for your entire cart amount
2. Order Line Items - This contains the cart items so that they can be displayed on the checkout or cart based offers can be calculated. Showing cart items on checkout helps build trust for the customer
3. User Details - Nimbbl helps to personalise the checkout for each user so sharing this information will help populate the UPI and BNPL apps that are used by the customer
4. Invoice ID - This is your internal unique reference identifier for this order

Nimbbl enables you to create orders so multiple payments can be attempted by your customers for a single order in the case, the earlier attempts fail or stay pending.

After the order is created, an order_id is generated, this order_id will need to be provided by your server to your client so that payments can be collected for the order on the Standard Checkout.

The following endpoint creates an order:

Method	End Point
POST	/v3/create-order

To read in detail about the request, response, sample payloads and error scenarios for this API, please click here.

WARNING

• These API calls need to be made only from your server to the Nimbbl server.
• While developing your changes, use your Test Keys