The validation API is an additional API for the payout products: Airtime and Data.

This API is useful in preventing unauthorized transactions from being initiated in your account.

We strongly recommend that you integrate this API as you develop your app.

Here is a breakdown of it:

Diagram A

This diagram illustrates the standard API call flow. The process begins with the business (or any app) sending a request to AT. AT forwards the request to the telco for processing, and the telco delivers the airtime or data to the end user.

Diagram B

This diagram highlights the role of the Validation API. When the business initiates an API call to AT, AT sends the request back to the business app for confirmation. Based on the app's response, the API either forwards the request to the telco or terminates the process (indicated by the dotted arrow).

Diagram C

This diagram depicts a suspected fraud scenario. An unrecognized app initiates an API call and sends it to AT. AT then redirects the request to the legitimate business app for verification. Depending on the app's response, the API decides whether to forward the request to the telco or reject it (indicated by the dotted arrow).

To learn more, please check the documentation for Airtime here and Data here

Let us know if you have any questions through airtime@africastalking.co