Jaa


Africa's Talking Airtime (Preview)

Provides actions to distribute airtime to your users instantly via Africa's Talking's Airtime service and to watch for status notifications regarding these airtime requests

This connector is available in the following products and regions:

Service Class Regions
Logic Apps Standard All Logic Apps regions except the following:
     -   Azure Government regions
     -   Azure China regions
     -   US Department of Defense (DoD)
Power Automate Premium All Power Automate regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Power Apps Premium All Power Apps regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Contact
Name Advice and answers from the Africa's Talking Team
URL https://help.africastalking.com/en/
Email airtime@africastalking.com
Connector Metadata
Publisher Africa's Talking
Website https://africastalking.com/airtime
Privacy policy https://africastalking.com/privacy_policy
Categories Communication;Finance

Africa's Talking Airtime provides an API that allows you to distribute pinless airtime to mobile subscribers, receiving discounts for each transaction you make. This connector exposes operations that enable one to send airtime to mobile subscribers as well as to watch for notifications indicating whether the delivery was successful or failed.

Pre-requisites

In order to use this connector, you will need the following:

  • An account with Africa's Talking; you can sign up here.
  • A live production application; you can create one after registering.

Once you've signed up and you've created a live application, generate a new API Key for that application; you will use this key to authenticate your requests from this connector.

You will also need to contact us to activate the airtime product for your application; do so by sending an email to airtime@africastalking.com.

How to get credentials?

This connector uses API Key authentication. Once you've signed up and you've created a production ready application, click on this application to switch to its dashboard. Navigate to Settings > API Key to generate a new API Key for this application.

Known issues and limitations

This connector currently only works with production ready applications, so DO NOT use the default sandbox application's API key.

Creating a connection

The connector supports the following authentication types:

Default Parameters for creating connection. All regions Not shareable

Default

Applicable: All regions

Parameters for creating connection.

This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.

Name Type Description Required
API Key securestring The API Key for this api True

Throttling Limits

Name Calls Renewal Period
API calls per connection 100 60 seconds

Actions

Find transaction status

Find a particular airtime transaction's status

Send Airtime

Send airtime to multiple recipients

Find transaction status

Find a particular airtime transaction's status

Parameters

Name Key Required Type Description
Username
username True string

Your application's username

Transaction ID
transactionId True string

ID of the transaction you'd like to find.

Returns

Name Path Type Description
status
status string

status

Send Airtime

Send airtime to multiple recipients

Parameters

Name Key Required Type Description
Username
username True string

Your application's username.

Phone Number
phoneNumber True string

Phone number to be topped up in international format (e.g +234811222333)

Amount
amount True string

The value of airtime to send together with the currency code (e.g. KES 10.00).

Returns

Name Path Type Description
errorMessage
errorMessage string

errorMessage

numSent
numSent integer

numSent

responses
responses array of object

responses

amount
responses.amount string

amount

discount
responses.discount string

discount

errorMessage
responses.errorMessage string

errorMessage

phoneNumber
responses.phoneNumber string

phoneNumber

requestId
responses.requestId string

requestId

status
responses.status string

status

totalAmount
totalAmount string

totalAmount

totalDiscount
totalDiscount string

totalDiscount

Triggers

When you receive an Airtime Status Notification

Triggered when you receive an delivery status notification for an initial request to send airtime.

When you receive an Airtime Status Notification

Triggered when you receive an delivery status notification for an initial request to send airtime.

Parameters

Name Key Required Type Description
Username
username True string

Your application's username

Returns

response
object

Definitions

object

This is the type 'object'.