Customer Validation

📘

Headers

Authorization: Bearer TOKEN
Content-type: application/json
Terminal: 3PBL0001

See Documentation on how to Generate Token

📘

Endpoint

POST https://qa.interswitchng.com/quicktellerservice/api/v5/Transactions/validatecustomers

Request Parameter

Sample Request

curl https://qa.interswitchng.com/quicktellerservice/api/v5/Transactions/validatecustomers \
-H "Authorization: Bearer <TOKEN>" \
-H "Content-Type: application/json" \
-H "TerminalID: <your_terminal_id>" \
-D '{
				"customers": [
				{
            "PaymentCode": "0488051528",
            "CustomerId": "08124888436"
			}
				],
			"TerminalId": "3pbl0001"
			} ''
-X POST

Response Parameter

{
    "Customers": [
        {
            "BillerId": 0,
            "PaymentCode": "0488051528",
            "CustomerId": "08124888436",
            "ResponseCode": "90000",
            "FullName": "adubiaro deborah",
            "Amount": 0,
            "AmountType": 0,
            "AmountTypeDescription": "AnyAmount",
            "Surcharge": 0
        }
    ],
    "ResponseCode": "90000",
    "ResponseCodeGrouping": "SUCCESSFUL"
}

How to Determine Expected Amount to be Passed in Send Bill Payment Advice Call for Bill payment

Pay attention to the amount and amount Type fields returned in the validate customer response.

If the amount and amount Type fields are populated, it means the figure passed in the amount field should be used to determine the expected amount to be paid by the customer.

You are expected to validate this on your system. See few samples below.

For example:

“amount”: “1500000”,

“amountType”: “5”

Customer is expected to pay exact amount (N15,000) as returned.

“amount”: “1500000”,

“amountType”: “4”

Customer is expected to pay less than the maximum amount returned which in this case is N15,000, Customer can pay any amount below N15,000

Find below details for amount types in the table below.