Step 3. Customer Validation
Url: https://estoresms.com/bill_payment_processing/v/2/
Method: POST
Request Format: FORM-DATA
Response Format: JSON
SAMPLE REQUEST
username: user123,
hash: 6a7ba624db21e84c6cb58e9e7f0055c8316bc2c2e3ac1d35e8c3fe,
category: tv,
product: BPD-NGCA-AQA,
validate: 41320018196
SAMPLE RESPONSE
{
"response": "OK",
"result": {
"name": "ARON A VICTOR",
"number": "41320018196"
}
}
In this case the customer is attempting to purchase a dstv plan, validate field holds the SmartCard Number
Step 4. MAKE A PURCHASE
Url: https://estoresms.com/bill_payment_processing/v/2/
Method: POST
Request Format: FORM-DATA
Response Format: JSON
SAMPLE REQUEST 1
username: user123,
hash: 21e84c6cb58e9e7f0055c8316bc2c2e4ac1d35e8c3fe6a7ba624db,
ref: myRef,
category: tv,
product: BPD-NGCA-AQA,
plan: ACSSE36,
number: 41320018196
SAMPLE REQUEST 2 (Example for startimes subscription)
username: user123,
hash: 21e84c6cb58e9e7f0055c8316bc2c2e4ac1d35e8c3fe6a7ba624db,
ref: myRef,
category: tv,
product: BPD-NGCA-AWA,
amount: 1000,
number: 20020018196
SAMPLE REQUEST 3 (Example for electricity subscription)
username: user123,
hash: 21e84c6cb58e9e7f0055c8316bc2c2e4ac1d35e8c3fe6a7ba624db,
ref: myRef,
category: electricity,
product: BPE-NGCABIA-OR,
amount: 1000,
number: 0100040261,
prepaid: 1
SAMPLE REQUEST 4 (Example for waec payment)
username: user123,
hash: 21e84c6cb58e9e7f0055c8316bc2c2e4ac1d35e8c3fe6a7ba624db,
ref: myRef,
category: waec,
product: BPM-NGCA-ASA,
plan: 700
SAMPLE RESPONSE 1
{
"response": "OK",
"transaction_id": "5a3388ac22a",
"discounted_amount": "1980",
"message": "Payment was successful"
}
SAMPLE RESPONSE 2
{
"response": "OK",
"transaction_id": "5a3388ac22a",
"discounted_amount": "980",
"message": "Payment was successful",
"pin_code": "3022399443",
"pin_message": "Operator Message : 2.2KWh at N21.65 per KWh; Account : 0100040261; Receipt No : 4952724; Transaction ID :20171208120600~1013417"
}
SAMPLE RESPONSE 3
{
"response": "OK",
"transaction_id": "5a3388ac22b",
"discounted_amount": "700",
"message": "Payment was successful",
"pins":[
{
"serialNumber":"WRN192775404",
"pin":"740525808961",
"expiresOn":null
}
]
}
SAMPLE RESPONSE 4
{
"response": "B007",
"message": "Insufficient Balance"
}