B2C-Billers-Java

Support chat

This repository contains Java SDK and samples for Business to Consumer bill payments.

Prerequisites

• Java JDK 6 or higher
• An environment which supports TLS 1.2
• Interswitch Base Library Click here

Welcome

Read our FAQs here

Biller

A biller is any Organization/Institution/Business that is able to exchange services for a fee. e.g Telecoms provider(Airtel, Glo, MTN), Government Body(Lagos State) etc.

Category

Billers are grouped under categories. For instance, all cable providers(DSTV, GOTV) can e grouped under a cable Category.

Customer

An individual that has an intent and/or pays for any of the services offered by a Biller.

PaymentItem

A biller(e.g DSTV) can offer different services and hence different prices for them. Each of those services, falls under a payment-item and has a unique payment-item-code. We say that a user has intent to pay for a payment-item offered by a Biller. An example of a payment-item under DSTV is the DSTV Premium Bouquet

What this SDK provides for you

Get All Billers

Get a list of all billers supported on our platform.

Get All Categorys

Get a list of all categorys and associated billers supported on our platform.

Get All Billers under a Category

Get a list of all biilers under a particular category.

Get Biller Payment Items

Get a list of all payment-items under aparticular Biller.

Validate Customer

Validates a customer-id under a particular biller.

Make payment for a customer

Makes a payment for a payment-item for a particular customer.

Query the status of a transaction

Query the status of a transaction made in the past based on the Request Reference

Quick start

Maven

<dependency>
    <groupId>com.interswitch</groupId>
    <artifactId>interswitch-java</artifactId>
    <version>0.0.1</version>
</dependency>

Samples

Check out the samples folder for sample code on all the features above.

Support Team

Still experiencing issues, quickly talk to our Engineers at Support chat or Support chat and get your issues fixed in a giffy.