charlesassets/laravel-perfectmoney

Laravel Package for Perfect Money Payments

Laravel Perfect Money

![Software License][ico-license] , _(*1)

Install

Via Composer, _(*2)

``` bash $ composer require charlesassets/laravel-perfectmoney, <sub>(*3)</sub>

Add Provider

``` php
charlesassets\LaravelPerfectMoney\LaravelPerfectMoneyServiceProvider::class,

Add Aliases, <sub>(*4)</sub>

``` php 'PerfectMoney' => charlesassets\LaravelPerfectMoney\PerfectMoney::class,, <sub>(*5)</sub>

### Configuration

Publish Configuration file

php artisan vendor:publish --provider="charlesassets\LaravelPerfectMoney\LaravelPerfectMoneyServiceProvider" --tag="config", <sub>(*6)</sub>

Edit .env

Add these lines at .env file, follow config/perfectmoney.php for configuration descriptions.
``` php
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

Customizing views (Optional)

If you want to customize form, follow these steps., <sub>(*7)</sub>

1.Publish view

php artisan vendor:publish --provider="charlesassets\LaravelPerfectMoney\LaravelPerfectMoneyServiceProvider" --tag="views"

2.Edit your view at /resources/views/vendor/perfectmoney/perfectmoney.php

Usage

Render Shopping Cart Form

``` php PerfectMoney::render();, <sub>(*8)</sub>

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

``` php
PerfectMoney::render(['PAYMENT_UNITS' => 'EUR'], 'custom_view');

API MODULES

Get Balance

``` php $pm = new PerfectMoney; $balance = $pm->getBalance();, <sub>(*9)</sub>

if($balance['status'] == 'success') { return $balance['USD']; }, <sub>(*10)</sub>

### Send Money
``` php
// 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->getBalance($amount, $sendTo, $description, $payment_id);
if($sendMoney['status'] == 'success')
{
    // Some code here
}

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

Change log

Please see CHANGELOG for more information what has changed recently., <sub>(*11)</sub>

Contributing

Please see CONTRIBUTING and CONDUCT for details., <sub>(*12)</sub>

Security

If you discover any security related issues, please email charlesassets.com@gmail.com instead of using the issue tracker., <sub>(*13)</sub>

Credits

• charlesassets
• All Contributors

License

The MIT License (MIT). Please see License File for more information., <sub>(*14)</sub>