Send airtime safely
If you just need the essentials, use this fast path:
- Enable DT One in Workspace Settings (login + API token)
- Add a Send Airtime action in your flow
- Set currency, amount, and a clear result name
- Connect Success and Failure exits (confirm + alert/escalate)
- Use Transfer Logs to troubleshoot failures
- If needed, create a DT One account and retrieve API credentials
Done — you can now issue airtime transfers with clean success/failure handling.
Step-by-Step Process
- Log in to your RapidPro.app workspace.
- Open Workspace Settings (gear icon).
- Scroll to the DT One integration section.
- Enter your DT One login and DT One API token (from your DT One developer/account area).
- Save your changes.
[CAPTURE: Workspace Settings page showing the DT One integration section with fields for login + API token and a Save button.]
- Open the Flows section and open the flow you want to edit.
- Add a new node.
- In the action dropdown, select Send Airtime.
[CAPTURE: Flow editor showing the “Create Message” (new node) button and the action dropdown with “Send Airtime” selected.]
- In the Send Airtime settings, select the currency (or the currency options available for the contact’s destination).
- Enter the amount you want to transfer.
- Set a Result name so you can reference the outcome later (example:
airtime_transfer). - Save the node.
[CAPTURE: Send Airtime action settings showing currency selector, amount field, and “Result name” field.]
A Send Airtime node typically includes two exits:
- Success (transfer completed)
- Failure (transfer rejected or errored)
- From Success, add a confirmation message to the contact (e.g., “Your airtime has been sent.”).
-
From Failure, add an internal alert path, such as:
- Send a message to the contact with next steps
- Notify your team (email/notification action if available)
- Add a label for tracking (e.g., “Airtime Failure”)
- Add the contact to a group (e.g., “Needs Manual Airtime Review”)
[CAPTURE: Flow editor showing the Send Airtime node with two branches (Success/Failure), each connected to follow-up actions.]
- Go to Workspace Settings.
- Find the DT One integration section.
- Open Transfer Logs (or your workspace’s equivalent logs entry for airtime transfers).
- Filter by date/time or contact details to investigate failures.
[CAPTURE: DT One section showing a “Transfer Log” button and a log view with success/failure entries.]
- Create a DT One account in their sign-up interface.
- Verify your email.
- Locate your API credentials in their developer/account settings.
- Return to RapidPro.app and complete Step 1.
[CAPTURE: DT One sign-up page (fields visible, no real data) and a follow-up screen showing where API credentials can be found.]
Common Issues & Quick Fixes
Problem: The Send Airtime action isn’t available in my flow.
Fix: Confirm DT One is enabled in Workspace Settings and your credentials are saved. If you still don’t see it, verify your workspace plan/permissions and refresh the editor.
Problem: Transfers fail for some contacts (Failure branch triggers).
Fix: Check Transfer Logs for the exact error. Common causes include operator/number coverage limitations, invalid denominations, or integration credential issues.
Problem: The delivered amount is different than what I entered.
Fix: Some operators/providers require valid denominations. RapidPro.app (via the provider) may adjust the deliverable value to match supported denominations. Review logs to confirm final amounts.
Problem: I can’t debug what happened after a reported failure.
Fix: Add a lightweight internal alert on the Failure branch that includes contact identifiers and context (phone/URN, flow name, timestamp, and the result name you set for the airtime action).