tuyenlaptrinh/perfect-money

Laravel Package for Perfect Money Payments

v1.3 2022-02-05 20:40 UTC

This package is auto-updated.

Last update: 2024-09-07 10:59:59 UTC


README

Latest Version on Packagist Software License Total Downloads

Install

Via Composer

$ composer require tuyenlaptrinh/perfect-money

Add Provider

tuyenlaptrinh\PerfectMoney\PerfectMoneyServiceProvider::class,

Add Aliases

'PerfectMoney' => tuyenlaptrinh\PerfectMoney\PerfectMoney::class,

Configuration

Publish Configuration file

php artisan vendor:publish --provider="tuyenlaptrinh\PerfectMoney\PerfectMoneyServiceProvider" --tag="config"

Edit .env

Add these lines at .env file, follow config/perfectmoney.php for configuration descriptions.

PM_ACCOUNTID=100000
PM_PASSPHRASE=your_pm_password
PM_MARCHANTID=U123456
PM_MARCHANT_NAME="My Company"
PM_UNITS=USD
PM_ALT_PASSPHRASE=your_alt_passphrase
PM_PAYMENT_URL=http://example.com/success
PM_PAYMENT_URL_METHOD=null
PM_NOPAYMENT_URL=http://example.com/fail
PM_NOPAYMENT_URL_METHOD=null
PM_STATUS_URL=null
PM_SUGGESTED_MEMO=null

Usage

###Render Shopping Cart Input Form

PerfectMoney::render();

Sometimes you will need to customize the payment form. Just pass the parameters to render method .

PerfectMoney::render(['PAYMENT_UNITS' => 'EUR']);

API MODULES

Get Wallets

$pm = new PerfectMoney;
$wallets = $pm->wallets();

if($wallets['status'] == 'success')
{
    foreach($wallets['wallets'] as $wallet){
        echo $wallet['account'].': '.$wallet['balance']; // U1935xxx: 10.00
    }
}

Send Money

// Required Fields
$amount = 10.00;
$sendTo = 'U1234567';

// Optional Fields
$description = 'Optional Description for send money';
$payment_id = 'Optional_payment_id';

$pm = new PerfectMoney;

// Send Funds with all fields
$sendMoney = $pm->transfer($sendTo, $amount, $description, $payment_id);
if($sendMoney['status'] == 'success')
{
	// Some code here
}

// Send Funds with required fields
$sendMoney = $pm->transfer($sendTo, $amount);
if($sendMoney['status'] == 'error')
{
	// Payment Failed
	return $sendMoney['message'];
}

Change log

Please see CHANGELOG for more information what has changed recently.

Contributing

Please see CONTRIBUTING and CONDUCT for details.

Security

If you discover any security related issues, please email tuyenlaptrinh@gmail.com instead of using the issue tracker.

Credits

License

The MIT License (MIT). Please see License File for more information.