README

Installation

To install the MoneyMan package, follow these steps:

Require the package via Composer:
```
composer require vp-trading/moneyman
```
Publish the configuration, route, and migration files:
```
php artisan vendor:publish --provider="Vptrading\MoneyMan\MoneyManServiceProvider"
```
The package comes with a config files to help you get started quickly.

Configure your .env file:

Add your Providers API keys:

MONEYMAN_REF_PREFIX=

MONEYMAN_CHAPA_SECRET_KEY=
MONEYMAN_CHAPA_BASE_URL=
MONEYMAN_CHAPA_CALLBACK_URL=

MONEYMAN_SANTIMPAY_BASE_URL=
MONEYMAN_SANTIMPAY_PUBLIC_KEY=
MONEYMAN_SANTIMPAY_PRIVATE_KEY=
MONEYMAN_SANTIMPAY_MERCHANT_ID=
MONEYMAN_SANTIMPAY_TOKEN=
MONEYMAN_SANTIMPAY_CALLBACK_URL=

MONEYMAN_TELEBIRR_MERCHANT_APP_ID=
MONEYMAN_TELEBIRR_FABRIC_APP_ID=
MONEYMAN_TELEBIRR_SHORT_CODE=
MONEYMAN_TELEBIRR_APP_SECRET=
MONEYMAN_TELEBIRR_PRIVATE_KEY=
MONEYMAN_TELEBIRR_BASE_URL=
MONEYMAN_TELEBIRR_TIMEOUT=
MONEYMAN_TELEBIRR_CALLBACK_URL=
MONEYMAN_TELEBIRR_WEB_BASE_URL=

Ready to use!

You can now use the package in your Laravel application.

Support

Provider	Payment Initialize	Payment Verify	Payment Refund
Chapa	✅	✅	✅
Telebirr	✅	✅	✅
SantimPay	✅	✅	❌

Usage

Before you start using this package you should know all amount must be put in cent values. The development of this package took standards from Stripe. So for example if you want the amount be 100 Birr you will put 10000.

Here are some basic usage examples:

Initialize Payment

use Vptrading\MoneyMan\MoneyMan;
use Vptrading\MoneyMan\Enums\Provider;
use Vptrading\MoneyMan\ValueObjects\User;
use Money\Money;

$response = MoneyMan::provider(Provider::Chapa)->initiate([
    Money::ETB(10000),
    new User(
        firstName: 'John',
        lastName: 'Doe',
        email: 'johndoe@example.com',
        phoneNumber: '0912345678'
    ),
    route('return-url')
]);

// Redirect user to payment page
return redirect($response->checkoutUrl);

The initiate response is a DTO that consists of the status of of the request, message if the provider has one, transactionId, and checkoutUrl if the request was successful.

For telebirr you will need to wrap the checkoutUrl provided in an <a> tag for it to work or else you will see an error: "Payment cannot be completed. The required parameter of the request is empty, or the parameter is incorrectly filled."

Verify Payment

use Vptrading\MoneyMan\MoneyMan;
use Vptrading\MoneyMan\Enums\Provider;
use Money\Money;

$response = MoneyMan::provider(Provider::Chapa)->verify($transactionId);

The verify response is a DTO that consists of the status of of the request, message if the provider has one, transactionId, and data which is the response from the provider.

Refund Payment

use Vptrading\MoneyMan\MoneyMan;
use Vptrading\MoneyMan\Enums\Provider;
use Money\Money;

$response = MoneyMan::provider(Provider::Chapa)->refund($transactionId, Money::ETB(1000));

The refund response is a DTO that consists of the status of of the request, message if the provider has one, transactionId, and data which is the response from the provider.

Note: Chapa's refund does not use the transactionId you provided but instead the reference Id they assign to the transaction.

vp-trading / moneyman

Maintainers

Details