Do you deploy payment processing solutions for other businesses? Check out our Technology Partner Program today.

XBD Checkout Integration Guide

This guide outlines the essential steps for integrating the XBD API into your eCommerce store. Follow these instructions to Request your integration keys, and seamlessly incorporate XBD into your system.

Prerequisites

• Your onboarding must be approved by XBD.
• Once approved, you will receive an Email invitation to our Merchant Dashboard, where you need to complete the sign-up process.

Step 1: Generate Integration Keys.

Go to Settings > Integration Keys section on the Merchant Dashboard

Click on Create Button to generate Your Client Id and Client Secret like below

Once created, Client Id and Client Secret will be generated like below

Step 2: Navigate to the Merchant Id on top of the Settings page under Business/Store Settings section like below

Step 3: Email the Client Id, Client Secret and Merchant ID to tech@xbdgroup.com.

Integrating XBD Checkout into Your eCommerce Store

To integrate XBD Checkout into your store, follow these steps.

Prerequisites

• XBD will provide you with the following details necessary for order creation to function, which must be kept confidential on your side:
  1. Pos Client ID
  2. Pos Client Secret

Sandbox URL – https://pay-sandbox.xbase.digital/

Production URL – https://pay.xbase.digital/

Integration Steps

Step 1. Call the Token API to obtain access token to authenticate the further apis

Endpoint – identity/api/Authentication/connect/token

Method – POST

Payload –

{ 
  "grant_type" : "client_credentials", 
  "client_id" : <POS Client Id which you received from XBD >, 
  "client_secret" : <POS Client Secret which you received from XBD >
}

The above api will return access token which is needed for further api to function

Step 2. Call the Authorise API to create an order on XBD System

Endpoint – api/orders/authorize

Method – PUT

Payload –

header : {
  "Content-Type" : "application/json"
  "Authorization" : "Bearer <access_token from Step 1>"
}

body : { 
  "merchantLocationId" : <Merchant Location Id which will be provided by XBD>, 
  "merchantOrderId" : <Order ID which you will generate from your side>, 
  "title" : <Your Business Name>,
  "description" : <Description of the Cart>,
  "amount" : <Cart Amount>,
  "currency" : <Currency of the Cart>,
  "email" : <Customer Email ID>,
  "acceptUrl" : <Your Accept Url>,
  "cancelUrl" : <Your Cancel Url>,
  "callbackUrl" : <Your Callback Url>,
}

You will receive a paymentRedirectUrl in the response, which you need to redirect the user to.

With this paymentRedirectUrl, your store will be navigated to our Checkout solution which will further process the order and receive the payment.

Our Sample Website For Demo:

https://xkicks.store

Repo: https://github.com/xBaseDigital/xkicks