Skip to main content

Introduction

The purpose of this document is to provide a comprehensive guide to offers detailed insights into our API, providing you with essential information on seamlessly integrating a wallet into your system. Discover how to facilitate payments, receive funds, and unlock a ton of additional features for an enhanced user experience. Explore the possibilities and elevate your system's capabilities with the Xprizo API. To consume the API you need to have a Processor account that has access to your Merchant wallet.

Base URL for Live https://wallet.xprizo.com/api

2. Authentication

Xprizo employs JWT tokens and API keys as authentication methods for accessing API functions. You have the flexibility to choose either authentication method when interacting with the endpoints. You need to pass a JWT token or API key in the header of each request.

**Note: You need to use a processing profile to create a token or key to use the API endpoints.

2.1. JSON Web Tokens (JWT)​

2.1.1. Creating a Token​

Creating a token is done by calling the GetToken endpoint with your username and password. If you are not a registered user you can register by going to the test or production server.​

Login to the system using a username and password. You will receive back a JWT Bearer token that you will need to make secure api requests.

Request:

curl --location '{baseurl}/Security/GetToken' \
--header 'accept: text/plain; x-api-version=1.0' \
--header 'x-api-version: 1.0' \
--header 'Content-Type: application/json; x-api-version=1.0' \
--header 'Cookie: ARRAffinity=6eb3a21e3964ba0d808cc889e0f3c32756124416431e84310f27826bd56fae62; ARRAffinitySameSite=6eb3a21e3964ba0d808cc889e0f3c32756124416431e84310f27826bd56fae62' \
--data-raw '{
  "userName": "use username, mobile number to email",
  "password": "your password"
}'

Response:

{
  "id": <a unique Id>,
  "token": <use this token for furture calls>,
  "expires": <the time the token expires>
}

2.1.2. Usages of Token

Use this token in the header of all secure requests to other endpoint

curl -X 'GET' \
  '{baseurl}/Wallet/Info?contact=1' \
  -H 'accept: text/plain' \
  -H 'Authorization: bearer <token>

2.2. API Keys​

2.2.1. Creating an API Key

To configure your API key, access your User Account, navigate to 'settings' by clicking the profile icon, and locate 'security' in the list. Within the security settings, you will find an option to set the API key. It's important to note that if the API key is removed, a new key must be issued and utilized for transactions.

Screenshot 2024-01-22 213458.png

2.2.2. Usages of API Key

Use the API key in the header in the following way.

curl -X 'GET' \
  '{baseurl}/Profile' \
  -H 'accept: text/plain' \
  -H 'x-api-key: <apiKey>


2.3. Know your account ID

To submit deposits for processing, you will need your accountId (wallet id) from your account. You can find this by the following process, login to your account and open settings, find ‘wallet’ on the list and you will find an ID associated with the wallet. If a wallet doesn’t exist, you will be required to create one by clicking the Add.png button.