ecraspay-py 0.1.0

A Python wrapper for the ECRAS API.

ECRASPAY Python SDK [Alpha]

ECRASPAY SDK provides a convenient and Pythonic way to interact with the ECRASPAY API for managing payments and transactions. This package simplifies initiating and managing payments, such as card payments, USSD, bank transfers, and transaction verification.

---

Features

• Direct integration with the ECRASPAY API:

  • Transaction Management:

    • Fetch transaction details and status.
    • Cancel transactions.
    • Verify transactions.

  • Card Payments:

    • Initiate card payments.
    • Submit and resend OTPs.
    • Fetch card transaction details.
    • Verify card payments.

  • USSD Payments:

    • Initiate USSD payments.
    • Retrieve a list of supported banks for USSD payments.

  • Bank Transfers:

    • Initialize bank transfers by requesting bank account details.

• Checkout Payments:

  • Initiate checkout transactions.
  • Verify checkout transactions.

---

Installation

Prerequisites

• Python 3.6 or later.

Installation via pip

pip install ecraspay-py

---

Usage

Initialize the EcrasPay client

- Checkouts Payments

</code></pre>
<h2>Contributing</h2>
<p>We welcome contributions to the ECRASPAY Python SDK! Whether you're fixing bugs, adding new features, or improving documentation, your contributions are highly appreciated.</p>
<h3>How to Contribute</h3>
<ol>
<li>
<p><strong>Fork the Repository</strong>:</p>
<ul>
<li>Navigate to the repository's GitHub page and click the <strong>Fork</strong> button.</li>
</ul>
</li>
<li>
<p><strong>Clone Your Fork</strong>:</p>
<ul>
<li>Clone your fork to your local machine:
<pre lang="bash"><code>git clone https://github.com/thelimeskies/ecraspay-sdk.git

Create a Branch:

• Create a new branch for your feature or bugfix:

  git checkout -b feature-or-bugfix-name
  

Make Your Changes:

• Implement your changes in the appropriate files.
• Follow the project's coding standards and ensure your changes align with the rest of the codebase.

Write Tests:

• Add tests for your changes to ensure functionality is maintained.
• Use pytest to run the test suite:

  pytest
  

Commit Your Changes:

• Commit your changes with a descriptive commit message:

  git commit -m "Add <feature-or-bugfix-name>"
  

Push Your Branch:

• Push your branch to your forked repository:

  git push origin feature-or-bugfix-name
  

Create a Pull Request:

• Go to the original repository on GitHub.
• Click the Pull Requests tab, then click New Pull Request.
• Select your branch and provide a detailed description of your changes.

---

Contribution Guidelines

• Ensure your code follows the PEP 8 Python style guide.
• Write meaningful commit messages.
• Add or update documentation when necessary.
• Run all tests to verify your changes don't break existing functionality.

---

Reporting Issues

If you encounter any issues or bugs, please create an issue on the GitHub Issues page with the following details:

• A clear and descriptive title.
• Steps to reproduce the issue.
• Expected and actual behavior.
• Any relevant logs or screenshots.

---

Thank you for contributing to ECRASPAY Python SDK!

TODO

• Finish Documentation
• Add examples
• Finish Tests
• Write and Document all Utility functions for the SDK(Django, Flask, FastAPI, Pure Python) - e.g. get_device_details, encrypt_card, clean_phone_number, clean_amount, clean_email, clean_name, clean_transaction_id.