Moyasar PHP wrapper library
See the PHP API docs
- PHP: ^7.4|^8.0
- guzzlehttp/guzzle: ^6.3|^7.0
- laravel/framework: ^9.0
- To use the PHP stream handler, allow_url_fopen must be enabled in your system's php.ini.
- To use the cURL handler, you must have a recent version of cURL >= 7.19.4 compiled with OpenSSL and zlib.
You can install it via composer
$ composer require ahmed3bead/moyasar-laravel
After that, moyasar services need to be configured, so let us publish the configuration file:
$ php artisan vendor:publish --provider="AhmedEbead\Moyasar\Providers\LaravelServiceProvider"
Now edit config/moyasar.php
and add your API key, by default the API key is read from
an environment variable called MOYASAR_API_PUBLISHABLE_KEY
, thus .env
can be used to add the key.
MOYASAR_API_PUBLISHABLE_KEY=<Your_Key>
MOYASAR_API_SECRET_KEY=<Your_Key>
FINISH_PAYMENT_URL=<url-here>
If everything goes to plan, you should be able to get PaymentService
and InvoiceService
from laravel service container by simply called app
helper function
app(PaymentService::class)
app(InvoiceService::class)
Or inside your controller, you can simply type-hint one of the services in the constructor:
public function __construct(PaymentService $paymentService)
{
$this->paymentService = $paymentService;
}
Note: Moyasar does not allow creating payments using the API (with some exceptions), instead you can use the payment form. That is why, wrapper libraries does not support it.
To fetch a payment, just simply do the following:
$paymentService = new \AhmedEbead\Moyasar\Providers\PaymentService();
$data = [
"amount" => 100,
"currency" => "SAR",
"description" => "Payment for order #",
"callback_url" => "https://example.com/thankyou",
"source" => [
"type" => "creditcard",
"name" => "Mohammed Ali",
"number" => "4111111111111111",
"cvc" => "123",
"month" => "12",
"year" => "26"
]
];
$payment = $paymentService->create($data);
$payment = $paymentService->fetch('ae5e8c6a-1622-45a5-b7ca-9ead69be722e');
$payment = $paymentService->all();
An instance of Payment
will be returned, that has the data in addition to being able
to perform operations like update
, refund
, capture
, void
on that payment instance,
which we will get back to later.
To list payments associated with your account, simply do the following:
$paymentService = new \AhmedEbead\Moyasar\Providers\PaymentService();
$paginationResult = $paymentService->all();
$payments = $paginationResult->result;
The all
method will return an instance of PaginationResult
this contains meta data
about our result, like currentPage
, totalPages
etc...
To get the payments from this object, we just read the result
property of that object.
The all
method accepts an instance of Search
or an array, this allows us to filter
results and move along pages. It is quite simple to use:
$search = \AhmedEbead\Moyasar\Search::query()->status('paid')->page(2);
$paginationResult = $paymentService->all($search);
The following methods are supported:
id($id)
status($status)
source($source)
page($page)
createdAfter($date)
createdBefore($date)
Once we fetch the desired payment, we can either update
the description, refund
it,
capture
it, or void
it.
$payment->update('new description here');
// OR
$payment->refund(1000); // 10.00 SAR
// OR
$payment->capture(1000);
// OR
$payment->void();
For invoices, fetching and listing them is the same as payments, instead we use InvoiceService
.
Although, we can use the API to create a new invoice, by doing the following:
$invoiceService = new \AhmedEbead\Moyasar\Providers\InvoiceService();
$invoiceService->create([
'amount' => 1000000, // 10000.00 SAR
'currency' => 'SAR',
'description' => 'iPhone XII Purchase',
'callback_url' => 'http://www.example.com/invoice-status-changed', // Optional
'expired_at' => '2020-01-20' // Optional
]);
With an instance of Invoice
, we can either update
, or cancel
a given instance.
$invoice->update([
'amount' => 900000, // 9000.00 SAR
'currency' => 'SAR',
'description' => 'iPhone XII Purchase (Updated)',
'callback_url' => 'http://www.example.com/invoice-status-changed', // Optional
'expired_at' => '2020-01-25' // Optional
]);
// OR
$invoice->cancel();
Or if you want a quick way to use these services, you can use the Payment
and Invoice
facades:
AhmedEbead\Moyasar\Facades\Payment
AhmedEbead\Moyasar\Facades\Invoice
For example:
$payment = \AhmedEbead\Moyasar\Facades\Payment::fetch('id');
- Payout Payment
- Token Payment
- Webhooks
The package is available as open source under the terms of the MIT License.