Ecocash Python Library

Simple, intuitive Python client for Ecocash Open API.

Installation

pip install ecocash

Quick Start

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)

result = wallet.initiate_payment(
	customer_msisdn = "263774222475", # the customer number 
	amount = 10.5, 
	reason = "Payment test"
	)
print(result)

Refund example

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

print(result)

Transaction lookup example

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