Value Added Services (VAS) Documentation

Overview

Leveraging our Quickteller Service, Interswitch provides an easy and fast way to automate bill payments and airtime recharges for your customers. This solution enables your business to generate profit through commissions on every transaction.

Commission Structure

Bills Payment & Airtime Services: Different commission structures apply
E-Pins: Separate commission structure
All structures are designed to ensure profitability for every business

Available Services

1. Bills Payment

Gain access to 7,000+ billers on the Quickteller network with guaranteed instant value on all successful payments.

Examples:

Cable TV: DSTV, GOtv, Startimes
Utilities: Electricity (e.g., Eko Disco), Water bills
Internet services
And many more...

2. Airtime & Data Top-up

Access various telecom providers for airtime vending and data bundle activation across major networks:

Network	Airtime	Data Bundles
MTN	✓	✓
Airtel	✓	✓
Glo	✓	✓
9mobile	✓	✓

3. Electronic Pins (E-Pins)

An extension of our airtime service offering, E-Pins cater to customers who prefer the traditional PIN recharge format.

Use Cases:

Gifts: Share airtime with friends and family
Proof of Purchase: Physical evidence of transaction
Flexibility: Redeemable at any time

API Endpoints

Core Endpoints

Endpoint	Description	HTTP Method
`GetBillers`	Fetches the list of available billers on Quickteller (e.g., DSTV, MTN for airtime)	GET
`GetBillerCategories`	Fetches available biller categories (e.g., cable TV, utilities, telecom)	GET
`GetBillersByCategory`	Fetches billers available under a specific category	GET
`SendBillPaymentAdvice`	Performs the actual transaction/payment	POST
`CustomerValidation`	Validates customers for certain bill types (e.g., Eko Disco, Glo)	POST
`QueryTransaction`	Validates the status of a transaction	GET

Voucher Endpoints

Endpoint	Description	HTTP Method
`CreateVoucher`	Creates a 16-20 digit airtime recharge PIN	POST
`RedeemVoucher`	Redeems a generated PIN	POST

Payment Instruments

The following payment methods are supported for bill payments:

Retailpay Wallet - Pre-funded wallet for seamless transactions
SVA Card - Stored Value Account card
Postpaid - Credit-based payment option

Quick Start Guide

Step 1: Get Available Billers

GET /api/v1/billers

Step 2: Validate Customer (if required)

POST /api/v1/customer/validation

Step 3: Process Payment

POST /api/v1/payment/advice

Step 4: Query Transaction Status

GET /api/v1/transaction/{transactionRef}

Support

For technical support or integration assistance, please contact our developer support team.

Last Updated: May 2026