capabilities.work

Validate Customer And Pay Bill

A 3-step recipe with Interswitch. We can help you get access.

Recipe · 3 steps

Validate Customer And Pay Bill

Resolve a payment item, validate the customer, and pay a Nigerian biller.

  1. Read the supported payment items (packages, amounts, denominations) for the biller to confirm the paymentCode being charged is valid.
  2. Verify the customer reference with the biller before charging. The biller returns the customer's full name when the reference is recognised.
  3. Submit the payment advice for the validated customer. responseCode 90000 indicates the payment was accepted.
What you'll need to have ready
  • accessToken: Bearer access token from the Passport OAuth token endpoint.
  • billerId: The biller whose payment items are being resolved (e.g. DSTV).
  • paymentCode: The biller payment code to charge (from the biller's payment items).
  • customerId: The customer reference at the biller (smartcard, meter, account, or phone).
  • customerEmail: Customer email for the payment receipt.
  • customerMobile: Customer mobile number.
  • amount: Amount in minor currency units (kobo).
  • requestReference: Unique merchant request reference, prefixed with the merchant prefix.
For your developer

Arazzo workflow interswitch:validate-and-pay-bill, 3 operations: listBillerPaymentItems → validateCustomer → submitBillPaymentAdvice. Specs on APIs.io.