Introduction

The xBillion API is built on HTTP and is RESTful. It has predictable resource URLs and returns HTTP response codes to indicate errors. It also accepts and returns JSON in the HTTP body. Use your favorite HTTP/REST library in your programming language when using this API.

Flow of transaction processing

The standard flow of a transaction is as follows:

The user selects the transaction method and specifies the transaction amount.

Merchant forms a request to the xBillion API and forms a signature for the request as described in the “Authentication” section

Merchant sends the request to the Create Payment API.

The xBillion service processes the request from the Merchant and returns a response to the merchant. The response can be of two types:
4.1. The response contains an instruction to redirect the user and a URL to redirect the user to confirm payment.
4.2. The response contains an instruction to display the information from the details field to the user for further payment processing steps.

Merchant starts waiting for webhook notification from xBillion service about the final status of the transaction.

Upon merchant received the final status, the merchant performs actions to account for the completed transaction on the merchant's side.

A visual representation of the described flow is given below:

Introduction

Introduction#

Flow of transaction processing#

Introduction

Flow of transaction processing