Metadata-Version: 2.4
Name: ecocash
Version: 0.0.5
Summary: Unofficial Python Wrapper Library for the EcoCash API by Tarmica Sean Chiwara, A computer engineering student.
Author-email: Tarmica Sean Chiwara <tarimicac@gmail.com>
Project-URL: Homepage, https://github.com/lordskyzw/ecocash
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.8
Description-Content-Type: text/markdown

# Ecocash Python Library

Simple, intuitive Python client for Ecocash Open API.

## Installation

```bash
pip install ecocash
```

## Quick Start

```python

from ecocash import Ecocash
wallet = EcoCash(
    app_id="app123", # provided by ecocash in the portal
    api_key="key123", # provided by ecocash in the portal
    merchant_code="850236", # for merchant payments
    app_name="MyApp" # provided by ecocash in the portal
)
```

# Make a payment

this is used to initiate transaction from ***Merchant-Side to Customer-Side** *(customer only has to approve transaction by inputting their pin)

```python
result = wallet.initiate_payment("263774222475", 10.5, "Payment test")
print(result)
```

# Refund example

```python
result = wallet.refund("uuid_here", "012345l61975", "263774222475", 10.5, "Vaya Africa", "USD", "Test refund")p
```

```python
print(result)
```

# Transaction lookup example

```python
result = wallet.check_transaction_status("263774222475", "uuid_here")print(result)
```
