Airtime Recharge (E-pins)

📘

This service is only available in Nigeria

E pins (Voucher service)

E-pins also known as voucher service is an airtime recharge service that enables merchants resell airtime to their customers in the form of a 16-20 digit code. Merchants make profit on a transaction basis and by integrating this endpoint, merchants will be able to create and redeem vouchers on any network across Nigeria.

Process flow

Step 1: Make a call to Create Voucher (E pins). This generates a set of random numbers to be used to recharge.
Step 2: Make a call to Redeem Voucher (E pins). The generated numbers in step 1 above, the phone number to be recharged and the payment code of the provider of the voucher are required for this call. The voucher can only be redeemed if the current date falls between the startDate and the expiryDate defined during the creation of the voucher .
NOTE: Payment code can be gotten by making a Get Biller Payment Items call.
Step 3: If the transaction is successful, the virtual card tied to the partner is debited at redemption. However, if it fails, there will be no debit to the virtual card.

The diagram below breaks the process flow down:

curl https://sandbox.interswitchng.com/api/v2/quickteller/vouchers/create \
-H "Authorization: InterswitchAuth <your_authorization_string>" \
-H "Content-Type: application/json" \
-H "Signature: <your_computed_signature>" \
-H "Timestamp: <current_timestamp>" \
-H "Nonce: <your_computed_nonce>" \
-H "SignatureMethod: SHA1" \
-H "TerminalID: <your_terminal_id>" \
-D '{
    "customerId": "081242267646",
    "amount": "5000",
    "type": "recharge",
    "startDate": "2021-01-22",
    "expiryDate": "2023-11-29"
}'
-X POST
curl https://sandbox.interswitchng.com/api/v2/quickteller/vouchers/redeem \
-H "Authorization: InterswitchAuth <your_authorization_string>" \
-H "Content-Type: application/json" \
-H "Signature: <your_computed_signature>" \
-H "Timestamp: <current_timestamp>" \
-H "Nonce: <your_computed_nonce>" \
-H "SignatureMethod: SHA1" \
-H "TerminalID: <your_terminal_id>" \
-D '{
    "customerId": "07039260209",
    "customerEmail" :"[email protected]",
    "customerMobile" :"2349124888776",
    "paymentCode": "10803",
    "amount": "50000",
    "voucherCode":"180627935701032"
}'
-X POST

Response

{

"TransactionRef": "PBL|Web|3PBL0001|VOS|261119122709|3BYAHU7EB3",
"RechargePIN": "180627935701032",
"ApprovedAmount": "5000",
"MiscData": "u865tO9ycr",
"ResponseCode": "90000",
"ResponseDescription": "Success",
"ResponseCodeGrouping": "SUCCESSFUL"

}
{
responseDescription: "Success",
transactionRef: "DMO|Web|3DMO|ZainPIN|040821124619|44DVH8VKT7",
responseCodeGrouping: "SUCCESSFUL",
approvedAmount: "5000",
responseCode: "90000"
}


Did this page help you?