API Explorer

Utility Payments

Utility Payments

The UTILITY transaction request type pays a bill or buys a prepaid service, for example a prepaid electricity meter token. The biller is identified by a routing scheme of the category UTILITY or BILL, such as a meter number or a bill control number.

  1. Look the payee up first, to confirm who will be paid (Confirmation of Payee). The lookup returns a lookup_id.
  2. Create the transaction request, passing the lookup_id as verified_payee_lookup_id, and optionally a callback_url.
  3. The result, such as the electricity token, does not exist yet when the request is created. It arrives later from the payment rail and is recorded as the vend result. The registered callback is then called once.

data_fields carries name and value pairs that adapters pass on to the payment rail unchanged.

Endpoints