Skip to content

Conversation

@sathwikshetty33
Copy link
Contributor

@sathwikshetty33 sathwikshetty33 commented Oct 13, 2025

PR Title: Add Airtel Money Integration Documentation to EasySwitch addresses issue #50

Description

This PR adds comprehensive documentation for integrating Airtel Money with the EasySwitch payment library. The documentation provides developers with all the necessary information to configure, authenticate, and perform transactions using Airtel Money.

Key Additions

  • Overview: Introduction to Airtel Money and its coverage across African countries.
  • Prerequisites: Required credentials and setup for integrating Airtel Money.
  • Supported Countries & Currencies: Table listing countries and available payment methods.
  • Setup & Configuration:
    • Python-based configuration examples using EasySwitch.from_dict, environment variables, JSON, YAML, and multi-source configurations.
    • OAuth 2.0 authentication handling.
  • Core EasySwitch Methods: Overview of send_payment, check_status, refund, and get_transaction_detail.
  • API Examples: Step-by-step usage examples for:
    1. Creating a payment
    2. Checking payment status
    3. Processing refunds (full and partial)
    4. Retrieving transaction details
  • Status Mapping: Airtel Money status codes mapped to EasySwitch TransactionStatus enums.
  • Limitations: Notes on unsupported operations such as transaction cancellation.
  • Best Practices: Guidance on generating unique transaction IDs and storing both EasySwitch and Airtel Money IDs for reconciliation.

Motivation

This documentation will help developers quickly integrate Airtel Money payments via EasySwitch, reducing setup friction and providing clear, actionable examples for both sandbox and production environments.

Type of Change

  • Documentation Update
  • Feature
  • Bug Fix

@Borisw123
Copy link
Contributor

Hi @sathwikshetty33 !

Thanks for your contrubutions. Can you please provide a preview link?

@sathwikshetty33
Copy link
Contributor Author

hey @Borisw123 you can preview it here preview, this is an extend issue for docs for the integrator i created in the pr #49

@Einswilli
Copy link
Collaborator

hey @Borisw123 you can preview it here preview, this is an extend issue for docs for the integrator i created in the pr #49

Great thanks!

@Borisw123
Copy link
Contributor

Thanks! 👍

@sathwikshetty33
Copy link
Contributor Author

Hey @Einswilli , the pr is not accepted yet, do let me know if there are any changes to be made.

@sathwikshetty33
Copy link
Contributor Author

Hey @Einswilli, any issues in the pr? It's been a week still the pr ins't accepted...!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants