1. Home
  2. Quickteller SVA
  3. Customer Validation

Customer Validation

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

Was this article helpful to you? Yes 1 No 2

How can we help?