This method is used to notify the biller of the payment

HTTP Method: POST

Resource Url
https://sandbox.interswitchng.com/api/v2/quickteller/customers/validations

Headers

Please refer to attached document to learn how to compute the required headers for authentication.

ISA01000I Interswitch Services API Specification

Authentication Headers

Content Type:application/json Authorization:InterswitchAuth SUifhfjdbxbkfhj132hdfhjshfjhsv Signature: kuTwggg/3gdgdghs= Timestamp: 1434455667788 Nonce:7333394444423754333 SignatureMethod:SHA1 TerminalID: 3DMO0001

Request Parameters

Field	M/O	Length	Description
Customers	M		Contains the array for customer to be validated
PaymentCode	M	<=20	Unique payment code for a biller
CustomerId	M	<=50	Customer’s Unique Identifier

Bill Payment Request

{
“customers”:

[
{
“customerId”: “0434556574”,
“paymentCode”: “13701”
}
]
}

Bill Payment Response

A HTTP response code 200 is sent back for a success
Response Parameters

Response Parameters

Field	Length	Description
Customers		Contains the array for customer to be validated
paymentCode	<=20	Unique payment code for a biller
customerId	<=50	Customer’s Unique Identifier
fullName		Customers Name
responseCode		Response code for the request made
amount		Amount returned
amountType		amountType returned
amountTypeDescription		Description of the amountType returned concerning the amount payable

{

Sample Response
200

{

“Customers”: [

{

“paymentCode”: “10401”,

“customerId”: “0000000001”,

“responseCode”: “90000”,

“fullName”: “Test Test”,

“amount”: “1460000”,

“amountType”: “1”,

“amountTypeDescription”: “Biller requires minumum amount: NGN 14,600.00 or more.”

}

]

}

How to Determine Payable Amount in SVA

This is the response data that shows the expected amount to be paid by the customer. on customer validation, you are expected to validate the allowed amount to be paid by the customer.

For example:

“amount”: “1500000”,

“amountType”: “5”

Customer is expected to pay exact amount (N1500000) as returned.

“amount”: “1500000”,

“amountType”: “4”

Customer can pay any amount below 1500000

Find below details for amount types in the table below.

Value	Label	Meaning
0	None	Any amount can be paid
1	Minimum	If the returned amount is 1000, customer can pay any amount from 1000
2	Greater than minimum	If the returned amount is 1000, customer can pay any amount greater than 1000
3	Maximum	If the amount returned is 1000, customer can pay any amount below or equal to 1000
4	Less than Maximum	If the amount returned is 1000, customer can pay any amount below to 1000
5	Exact	The exact amount returned must be paid

Communication
Requests will be sent over the REST protocol

HTTP Method: POST

Authentication Headers

Bill Payment Request

How to Determine Payable Amount in SVA

How can we help?