README

Paymob integration for laravel.

Currently Supported

Card Payments

Mobile Wallets

Installation

install the package
```
composer require ctf0/laravel-paymob
```

publish the package assets with

php artisan vendor:publish --provider="ctf0\PayMob\PayMobServiceProvider"

Config

config/paymob.php

Setup

add the package routes to your routes/web.php ex.

Route::group([
    'prefix'     => 'orders',
    'as'         => 'order.',
    'middleware' => 'auth',
], function () {
    ctf0\PayMob\PayMobRoutes::routes();
});

add Billable to the model you will be billing.

next add getBillingData() which should return all the required fields for the order creation, check paymob requirements for more info.

all the optional fields has already been taken care of.

use Illuminate\Database\Eloquent\Model;
use ctf0\PayMob\Integrations\Contracts\Billable;

class Client extends Model implements Billable
{
    // ...

    public function getBillingData(): array
    {
        return [
            'email'        => $this->email,
            'first_name'   => $this->first_name,
            'last_name'    => $this->last_name,
            'street'       => $this->address,
            'phone_number' => $this->phone_number,
        ];
    }
}

Usage

# Normal

update paymob.controller with your own controller, which should have 3 methods

you can check DummyController for a more detailed overview.

type	@method	return
GET	`checkOut`	returns the view where the user will press the checkout btn
POST	`process`	get the selected payment type & make a request to paymob server
GET	`complete`	check for the transaction hmac & save it to your server, for more info check.

# Refund

all you need to is to call PayMob::refund and pass to it the transaction_id & amount_in_pounds that will be refunded, ex.

for more info check
```
PayMob::refund(655, 10);
```

Security

If you discover any security-related issues, please email ctf0-dev@protonmail.com.

ctf0 / laravel-paymob

Maintainers

Details