Customer Account Validation API

Why use this API?

Clients can use the Customer Account Validation API to validate an end-user's bill payment account number (e.g., DSTV Smart Card or electricity meter number) before submitting the bill payment purchase request to the vendor.

Participating parties

See here for definitions.

  • Buyer/Customer

  • Clickatell

  • Client

  • Supplier

  • Recipient

Getting started with the Customer Account Validation API

To interface with Clickatell, the following needs to be set up, configured and tested:

1

Integrate with Security Service API

  • Follow the instructions in the Security Service API quick-start guide to request a token with your client_secret and client_id.

  • Use the API_key and access_token in the following request (Step 2).

2

Call Customer Account Verification API (this API)

  • Add the API_key and access_token to the request header.

  • Use the client_id supplied during integration.

  • The following fields are required for the Customer Account Validation:

    • clientId

    • purchaseAmount

    • productId

    • targetIdentifier

A high-level view of this interface.