Airtime Recharge (E-pins)

E pins (Voucher service)

Through E pins, we have created an electronic voucher service that creates a 16 - 20 digit code where users can recharge their mobile phones. This is an electronic version of the legacy recharge cards with long pins. However, by integrating this endpoint, you will be enabled to create and redeem vouchers.

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": "u865tO9ycr",
"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?