PHPackages                             mykholy/paymentgateway - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Payment Processing](/categories/payments)
4. /
5. mykholy/paymentgateway

ActiveLibrary[Payment Processing](/categories/payments)

mykholy/paymentgateway
======================

a laravel package to manage multiple payment gateway

1.0.0(1y ago)13MITPHPPHP ^8.1

Since Nov 7Pushed 1y ago1 watchersCompare

[ Source](https://github.com/mykholy/paymentgateway)[ Packagist](https://packagist.org/packages/mykholy/paymentgateway)[ Docs](https://github.com/mykholy/paymentgateway)[ RSS](/packages/mykholy-paymentgateway/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (1)Dependencies (23)Versions (2)Used By (0)

paymentgateway
==============

[](#paymentgateway)

> General information about this package.

Installation For laravel 10x,9x
-------------------------------

[](#installation-for-laravel-10x9x)

##### Configure Your Composer.json file to install this package

[](#configure-your-composerjson-file-to-install-this-package)

add below code to your `composer.json` file

run below command to install this package from your command promt or terminal

```
composer require mykholy/paymentgateway
```

if this payment package asked you for username and password here is it or generate your own token.

```
```

Information about the installation procedure for this package. it's recommended to everyone to use the 4x version and upgrade laravel version to 10x

> use Version 4.1.0 for laravel 10x, use Version 3.x for laravel 9x

Supported Payment Gateway List
------------------------------

[](#supported-payment-gateway-list)

1. Paytm
2. PayPal
3. Stripe
4. Midtrans
5. Razorpay
6. Mollie
7. FlutterwaveRave
8. Paystack
9. Payfast
10. Cashfree
11. Instamojo
12. Mercado pago
13. Squareup
14. Cinetpay
15. PayTabs
16. BillPlz
17. Zitopay
18. Toyyibpay
19. Pagali
20. Autorize.Net
21. SitesWay
22. TransactionCloud
23. WiPay
24. KineticPay
25. Senangpay
26. SaltPay
27. Iyzipay
28. Paymob
29. PowertranzPay
30. Awdpay
31. YooMoney
32. CoinPayments
33. Sslcommerz

Setup For Paytm
---------------

[](#setup-for-paytm)

route and middleware code will be same as version ^1.0, version ^2.0 will change only customer\_charge and ipn\_response method

#### charge\_customer method example

[](#charge_customer-method-example)

```
$paytm = XgPaymentGateway::paytm();
$paytm->setMerchantId('Digita57697814558795');
$paytm->setMerchantKey('dv0XtmsPYpewNag&');
$paytm->setMerchantWebsite('WEBSTAGING');
$paytm->setChannel('WEB');
$paytm->setIndustryType('Retail');
$paytm->setCurrency("EUR");
$paytm->setEnv(true); // this must be type of boolean , string will not work
$paytm->setExchangeRate(74); // if INR not set as currency

$response =  $paytm->charge_customer([
    'amount' => 10,
    'title' => 'this is test title',
    'description' => 'this is test description',
    'ipn_url' => route('payment.paytm.ipn'), //get route
    'order_id' => 56,
    'track' => 'asdfasdfsdf',
    'cancel_url' => route('payment.failed'),
    'success_url' => route('payment.success'),
    'email' => 'dvrobin4@gmail.com',
    'name' => 'Ahmed Elkholy',
    'payment_type' => 'order',
]);
return $response;
```

#### ipn\_response method example

[](#ipn_response-method-example)

```
$paytm = XgPaymentGateway::paytm();
$paytm->setMerchantId('Digita57697814558795');
$paytm->setMerchantKey('dv0XtmsPYpewNag&');
$paytm->setMerchantWebsite('WEBSTAGING');
$paytm->setChannel('WEB');
$paytm->setIndustryType('Retail');
$paytm->setEnv(true); //env must set as boolean, string will not work
dd($paytm->ipn_response());
```

CinetPay
--------

[](#cinetpay)

[Checkout CinetPay Setup Documentation](#)

#### Paytm ipn route example

[](#paytm-ipn-route-example)

```
Route::post('/cinetpay-ipn', [\App\Http\Controllers\PaymentLogController::class,'cinetpay_ipn'] )->name('payment.cinetpay.ipn');
```

you must have to excluded cinetpay ipn route from csrf token verify, go to `app/Http/Middleware` `VerifyCsrfToken` Middleware add your route path here in `$except` array

```
namespace App\Http\Middleware;

use Illuminate\Foundation\Http\Middleware\VerifyCsrfToken as Middleware;

class VerifyCsrfToken extends Middleware
{
    /**
     * The URIs that should be excluded from CSRF verification.
     *
     * @var array
     */
    protected $except = [
        'cinetpay-ipn'
    ];
}
```

2.0 Setup For Cinetpay
----------------------

[](#20-setup-for-cinetpay)

Cinetpay payment gateway is only supported in version > v2.x

#### charge\_customer method example

[](#charge_customer-method-example-1)

```
$cinetpay = XgPaymentGateway::cinetpay();
$cinetpay->setAppKey('LE9C12TNM5HAS');
$cinetpay->setSiteId('EAAAEOuLQObrVwJvCvoio3H13b8Ssqz1ighmTBKZvIENW9qxirHGHkqsGcPBC1uN');
$cinetpay->setCurrency("USD");
$cinetpay->setEnv(true);
$cinetpay->setExchangeRate(74); // if ['XOF', 'XAF', 'CDF', 'GNF', 'USD'] not set as currency

$response =  $paytm->charge_customer([
    'amount' => 10, // minimum 100 amount is required to process payment if usd not set as currency
    'title' => 'this is test title',
    'description' => 'this is test description',
    'ipn_url' => route('payment.cinetpay.ipn'), //get route
    'order_id' => 56,
    'track' => 'asdfasdfsdf',
    'cancel_url' => route('payment.failed'),
    'success_url' => route('payment.success'),
    'email' => 'dvrobin4@gmail.com',
    'name' => 'Ahmed Elkholy',
    'payment_type' => 'order',
]);
return $response;
```

#### ipn\_response method example

[](#ipn_response-method-example-1)

```
$cinetpay = XgPaymentGateway::cinetpay();
$cinetpay->setAppKey('LE9C12TNM5HAS');
$cinetpay->setSiteId('EAAAEOuLQObrVwJvCvoio3H13b8Ssqz1ighmTBKZvIENW9qxirHGHkqsGcPBC1uN');
$cinetpay->setEnv(true); //env must set as boolean, string will not work
dd($cinetpay->ipn_response());
```

#### CinetPay test credentials

[](#cinetpay-test-credentials)

```
apiKey = "12912847765bc0db748fdd44.40081707";
site_id = "445160";
```

2.0 Setup For Paypal
--------------------

[](#20-setup-for-paypal)

route and middleware code will be same as version ^1.0, version ^2.0 will change only customer\_charge and ipn\_response method

#### charge\_customer method example

[](#charge_customer-method-example-2)

```
$paypal = XgPaymentGateway::paypal();
$paypal->setClientId('client_id'); // provide sandbox id if payment env set to true, otherwise provide live credentials
$paypal->setClientSecret('client_secret'); // provide sandbox id if payment env set to true, otherwise provide live credentials
$paypal->setAppId('app_id'); // provide sandbox id if payment env set to true, otherwise provide live credentials
$paypal->setCurrency("EUR");
$paypal->setEnv(true); //env must set as boolean, string will not work
$paypal->setExchangeRate(74); // if INR not set as currency

$response =  $paypal->charge_customer([
    'amount' => 10,
    'title' => 'this is test title',
    'description' => 'this is test description',
    'ipn_url' => route('payment.instamojo.ipn'), //get route
    'order_id' => 56,
    'track' => 'asdfasdfsdf',
    'cancel_url' => route('payment.failed'),
    'success_url' => route('payment.success'),
    'email' => 'dvrobin4@gmail.com',
    'name' => 'Ahmed Elkholy',
    'payment_type' => 'order',
]);
return $response;
```

#### ipn\_response method example

[](#ipn_response-method-example-2)

```
$paypal = XgPaymentGateway::paypal();
$paypal->setClientId('AUP7AuZMwJbkee-2OmsSZrU-ID1XUJYE-YB-2JOrxeKV-q9ZJZYmsr-UoKuJn4kwyCv5ak26lrZyb-gb');
$paypal->setClientSecret('EEIxCuVnbgING9EyzcF2q-gpacLneVbngQtJ1mbx-42Lbq-6Uf6PEjgzF7HEayNsI4IFmB9_CZkECc3y');
$paypal->setEnv(true); //env must set as boolean, string will not work
$paypal->setAppId('641651651958');
dd($paypal->ipn_response());
```

2.0 Setup For Stripe
--------------------

[](#20-setup-for-stripe)

route and middleware code will be same as version ^1.0, version ^2.0 will change only customer\_charge and ipn\_response method

#### charge\_customer method example

[](#charge_customer-method-example-3)

```
$stripe = XgPaymentGateway::stripe();
$stripe->setSecretKey('sk_test_51GwS1SEmGOuJLTMs2vhSliTwAGkOt4fKJMBrxzTXeCJoLrRu8HFf4I0C5QuyE3l3bQHBJm3c0qFmeVjd0V9nFb6Z00VrWDJ9Uw');
$stripe->setPublicKey('pk_test_51GwS1SEmGOuJLTMsIeYKFtfAT3o3Fc6IOC7wyFmmxA2FIFQ3ZigJ2z1s4ZOweKQKlhaQr1blTH9y6HR2PMjtq1Rx00vqE8LO0x');
$stripe->setCurrency("EUR");
$stripe->setEnv(true); //env must set as boolean, string will not work
$stripe->setExchangeRate(74); // if INR not set as currency

$response =  $stripe->charge_customer([
    'amount' => 10,
    'title' => 'this is test title',
    'description' => 'this is test description',
    'ipn_url' => route('payment.instamojo.ipn'), //get route
    'order_id' => 56,
    'track' => 'asdfasdfsdf',
    'cancel_url' => route('payment.failed'),
    'success_url' => route('payment.success'),
    'email' => 'dvrobin4@gmail.com',
    'name' => 'Ahmed Elkholy',
    'payment_type' => 'order',
]);
return $response;
```

#### ipn\_response method example

[](#ipn_response-method-example-3)

```
$stripe = XgPaymentGateway::stripe();
$stripe->setSecretKey('sk_test_51GwS1SEmGOuJLTMs2vhSliTwAGkOt4fKJMBrxzTXeCJoLrRu8HFf4I0C5QuyE3l3bQHBJm3c0qFmeVjd0V9nFb6Z00VrWDJ9Uw');
$stripe->setPublicKey('pk_test_51GwS1SEmGOuJLTMsIeYKFtfAT3o3Fc6IOC7wyFmmxA2FIFQ3ZigJ2z1s4ZOweKQKlhaQr1blTH9y6HR2PMjtq1Rx00vqE8LO0x');
$stripe->setEnv(true); //env must set as boolean, string will not work
dd($stripe->ipn_response());
```

2.0 Setup For Midtrans
----------------------

[](#20-setup-for-midtrans)

route and middleware code will be same as version ^1.0, version ^2.0 will change only customer\_charge and ipn\_response method

#### charge\_customer method example

[](#charge_customer-method-example-4)

```
$midtrans = XgPaymentGateway::midtrans();
$midtrans->setClientKey('SB-Mid-client-iDuy-jKdZHkLjL_I');
$midtrans->setServerKey('SB-Mid-server-9z5jztsHyYxEdSs7DgkNg2on');
$midtrans->setCurrency("IDR");
$midtrans->setEnv(true); //true mean sandbox mode , false means live mode
$midtrans->setExchangeRate(74); // if IDR not set as currency

$response =  $midtrans->charge_customer([
    'amount' => 10,
    'title' => 'this is test title',
    'description' => 'this is test description',
    'ipn_url' => route('payment.instamojo.ipn'), //get route
    'order_id' => 56,
    'track' => 'asdfasdfsdf',
    'cancel_url' => route('payment.failed'),
    'success_url' => route('payment.success'),
    'email' => 'dvrobin4@gmail.com',
    'name' => 'Ahmed Elkholy',
    'payment_type' => 'order',
]);
return $response;
```

#### ipn\_response method example

[](#ipn_response-method-example-4)

```
$midtrans->setClientKey('client_key');
$midtrans->setServerKey('server_key');
$midtrans->setEnv(true); //true mean sandbox mode , false means live mode
dd($midtrans->ipn_response());
```

#### Midtrans ipn route example

[](#midtrans-ipn-route-example)

```
Route::get('/midtrans-ipn', [\App\Http\Controllers\PaymentLogController::class,'midtrans_ipn'] )->name('payment.midtrans.ipn');
```

#### Midtrans Test Cards

[](#midtrans-test-cards)

```
VISA                                        Description
4811 1111 1111 1114                         3DS Enabled
4911 1111 1111 1113                         3DS Enabled. Transaction Denied by Bank

4411 1111 1111 1118                         3DS Disabled
4511 1111 1111 1117                         3DS Disabled. Challenged by Fraud Detection
4611 1111 1111 1116                         3DS Disabled. Denied by Fraud Detection
4711 1111 1111 1115                         3DS Disabled. Transaction Denied by Bank

MASTERCARD                                  Description
5211 1111 1111 1117                         3DS Enabled
5111 1111 1111 1118                         3DS Enabled. Transaction Denied by Bank

5410 1111 1111 1116                         3DS Disabled
5510 1111 1111 1115                         3DS Disabled. Challenged by Fraud Detection
5411 1111 1111 1115                         3DS Disabled. Denied by Fraud Detection
5511 1111 1111 1114                         3DS Disabled. Transaction Denied by Bank

```

2.0 Setup For Razorpay
----------------------

[](#20-setup-for-razorpay)

[Checkout Razorpay Setup Documentation](#)route and middleware code will be same as version ^1.0, version ^2.0 will change only customer\_charge and ipn\_response method

#### charge\_customer method example

[](#charge_customer-method-example-5)

```
$razorpay = XgPaymentGateway::razorpay();
$razorpay->setApiKey('rzp_test_SXk7LZqsBPpAkj');
$razorpay->setApiSecret('Nenvq0aYArtYBDOGgmMH7JNv');
$razorpay->setCurrency("EUR");
$razorpay->setEnv(true); //env must set as boolean, string will not work
$razorpay->setExchangeRate(74); // if INR not set as currency

$response =  $razorpay->charge_customer([
    'amount' => 10,
    'title' => 'this is test title',
    'description' => 'this is test description',
    'ipn_url' => route('payment.instamojo.ipn'), //get route
    'order_id' => 56,
    'track' => 'asdfasdfsdf',
    'cancel_url' => route('payment.failed'),
    'success_url' => route('payment.success'),
    'email' => 'dvrobin4@gmail.com',
    'name' => 'Ahmed Elkholy',
    'payment_type' => 'order',
]);
return $response;
```

#### ipn\_response method example

[](#ipn_response-method-example-5)

```
$razorpay = XgPaymentGateway::razorpay();
$razorpay->setApiKey('rzp_test_SXk7LZqsBPpAkj');
$razorpay->setApiSecret('Nenvq0aYArtYBDOGgmMH7JNv');
$razorpay->setEnv(true); //env must set as boolean, string will not work
dd($razorpay->ipn_response());
```

2.0 Setup For Mollie
--------------------

[](#20-setup-for-mollie)

[Checkout Mollie Setup Documentation](#)route and middleware code will be same as version ^1.0, version ^2.0 will change only customer\_charge and ipn\_response method

#### Mollie ipn route example

[](#mollie-ipn-route-example)

```
Route::get('/mollie-ipn', [\App\Http\Controllers\PaymentLogController::class,'mollie_ipn'] )->name('payment.razorpay.ipn');
```

#### charge\_customer method example

[](#charge_customer-method-example-6)

```
$mollie = XgPaymentGateway::mollie();
$mollie->setApiKey('api_key');
$mollie->setCurrency("EUR");
$mollie->setEnv(true); //env must set as boolean, string will not work
$mollie->setExchangeRate(74); // if INR not set as currency

$response =  $mollie->charge_customer([
    'amount' => 10,
    'title' => 'this is test title',
    'description' => 'this is test description',
    'ipn_url' => route('payment.mollie.ipn'), //get route
    'order_id' => 56,
    'track' => 'asdfasdfsdf',
    'cancel_url' => route('payment.failed'),
    'success_url' => route('payment.success'),
    'email' => 'dvrobin4@gmail.com',
    'name' => 'Ahmed Elkholy',
    'payment_type' => 'order',
]);
return $response;
```

#### ipn\_response method example

[](#ipn_response-method-example-6)

```
$mollie = XgPaymentGateway::mollie();
$mollie->setApiKey('api_key');
$mollie->setCurrency("EUR");
$mollie->setEnv(true); //env must set as boolean, string will not work
$mollie->setExchangeRate(74); // if INR not set as currency
dd($mollie->ipn_response());
```

FlutterwaveRave
---------------

[](#flutterwaverave)

Checkout Flutterwave Setup Documentation

#### FlutterwaveRave ipn route example

[](#flutterwaverave-ipn-route-example)

```
Route::get('/flutterwave-ipn', [\App\Http\Controllers\PaymentLogController::class,'flutterwave_ipn'] )->name('payment.flutterwave.ipn');
```

###### Test Cards

[](#test-cards)

```
Test MasterCard PIN authentication
 Card number: 5531 8866 5214 2950
 cvv: 564
 Expiry: 09/32
 Pin: 3310
 OTP: 12345

Card number: 4556052704172643
  cvv: 899
  Expiry: 09/32
  Pin: 3310
  OTP: 12345
```

2.0 Setup For Flutterwave
-------------------------

[](#20-setup-for-flutterwave)

route and middleware code will be same as version ^1.0, version ^2.0 will change only customer\_charge and ipn\_response method

#### charge\_customer method example

[](#charge_customer-method-example-7)

```
$flutterwave = XgPaymentGateway::flutterwave();
$flutterwave->setPublicKey('FLWPUBK_TEST-86cce2ec43c63e09a517290a8347fcab-X');
$flutterwave->setSecretKey('FLWSECK_TEST-d37a42d8917db84f1b2f47c125252d0a-X');
$flutterwave->setCurrency("USD");
$flutterwave->setEnv(true); //env must set as boolean, string will not work
$flutterwave->setExchangeRate(74); // if NGN not set as currency

$response =  $flutterwave->charge_customer([
    'amount' => 10,
    'title' => 'this is test title',
    'description' => 'this is test description',
    'ipn_url' => route('payment.instamojo.ipn'), //get route
    'order_id' => 56,
    'track' => 'asdfasdfsdf',
    'cancel_url' => route('payment.failed'),
    'success_url' => route('payment.success'),
    'email' => 'dvrobin4@gmail.com',
    'name' => 'Ahmed Elkholy',
    'payment_type' => 'order',
]);
return $response;
```

#### ipn\_response method example

[](#ipn_response-method-example-7)

```
$flutterwave = XgPaymentGateway::flutterwave();
$flutterwave->setPublicKey('FLWPUBK_TEST-86cce2ec43c63e09a517290a8347fcab-X');
$flutterwave->setSecretKey('FLWSECK_TEST-d37a42d8917db84f1b2f47c125252d0a-X');
$flutterwave->setCurrency("USD");
$flutterwave->setEnv(true);  //env must set as boolean, string will not work
dd($flutterwave->ipn_response());
```

Paystack
--------

[](#paystack)

Checkout Paystack Setup Documentation

Here is Test Credentials For Paystack

#### Paystack ipn route example

[](#paystack-ipn-route-example)

```
Route::get('/paystack-ipn', [\App\Http\Controllers\PaymentLogController::class,'paystack_ipn'] )->name('payment.paystack.ipn');
```

> Note: paystack does not support multiple ipn route, it supports only one webhook you can add in paystack dashboard. you can use $arg\['payment\_type'\] data for check which kind of payment processed

route and middleware code will be same as version ^1.0, version ^2.0 will change only customer\_charge and ipn\_response method

#### charge\_customer method example

[](#charge_customer-method-example-8)

```
$paystack = XgPaymentGateway::paystack();
$paystack->setPublicKey('pk_test_a7e58f850adce9a73750e61668d4f492f67abcd9');
$paystack->setSecretKey('sk_test_2a458001d806c878aba51955b962b3c8ed78f04b');
$paystack->setMerchantEmail('sopnilsohan03@gmail.com');
$paystack->setCurrency("EUR");
$paystack->setEnv(true); //env must set as boolean, string will not work
$paystack->setExchangeRate(74); // if NGN not set as currency

$response =  $paystack->charge_customer([
    'amount' => 10,
    'title' => 'this is test title',
    'description' => 'this is test description',
    'ipn_url' => route('payment.instamojo.ipn'), //get route
    'order_id' => 56,
    'track' => 'asdfasdfsdf',
    'cancel_url' => route('payment.failed'),
    'success_url' => route('payment.success'),
    'email' => 'dvrobin4@gmail.com',
    'name' => 'Ahmed Elkholy',
    'payment_type' => 'order',
]);
return $response;
```

#### ipn\_response method example

[](#ipn_response-method-example-8)

```
$paystack = XgPaymentGateway::paystack();
$paystack->setPublicKey('pk_test_a7e58f850adce9a73750e61668d4f492f67abcd9');
$paystack->setSecretKey('sk_test_2a458001d806c878aba51955b962b3c8ed78f04b');
$paystack->setMerchantEmail('sopnilsohan03@gmail.com');
$paystack->setEnv(true);  //env must set as boolean, string will not work
dd($paystack->ipn_response());
```

Payfast
-------

[](#payfast)

Checkout Payfast Setup Documentation

Here is Test Credentials For Payfast

#### Payfast ipn route example

[](#payfast-ipn-route-example)

```
Route::post('/payfast-ipn', [\App\Http\Controllers\PaymentLogController::class,'payfast_ipn'] )->name('payment.payfast.ipn');
```

you must have to excluded Payfast ipn route from csrf token verify, go to `app/Http/Middleware` `VerifyCsrfToken` Middleware add your route path here in `$except` array

```
namespace App\Http\Middleware;

use Illuminate\Foundation\Http\Middleware\VerifyCsrfToken as Middleware;

class VerifyCsrfToken extends Middleware
{
    /**
     * The URIs that should be excluded from CSRF verification.
     *
     * @var array
     */
    protected $except = [
        'payfast-ipn'
    ];
}
```

route and middleware code will be same as version ^1.0, version ^2.0 will change only customer\_charge and ipn\_response method

#### charge\_customer method example

[](#charge_customer-method-example-9)

```
$payfast = XgPaymentGateway::payfast();
$payfast->setMerchantId('10024000');
$payfast->setMerchantKey('77jcu5v4ufdod');
$payfast->setPassphrase('testpayfastsohan');
$payfast->setCurrency("ZAR");
$payfast->setEnv(true); //env must set as boolean, string will not work
$payfast->setExchangeRate(74); // if INR not set as currency

$response =  $payfast->charge_customer([
    'amount' => 10,
    'title' => 'this is test title',
    'description' => 'this is test description',
    'ipn_url' => route('payment.instamojo.ipn'), //get route
    'order_id' => 56,
    'track' => 'asdfasdfsdf',
    'cancel_url' => route('payment.failed'),
    'success_url' => route('payment.success'),
    'email' => 'dvrobin4@gmail.com',
    'name' => 'Ahmed Elkholy',
    'payment_type' => 'order',
]);
return $response;
```

#### ipn\_response method example

[](#ipn_response-method-example-9)

```
$payfast = XgPaymentGateway::payfast();
$payfast->setMerchantId('10024000');
$payfast->setMerchantKey('77jcu5v4ufdod');
$payfast->setPassphrase('testpayfastsohan');
$payfast->setCurrency("ZAR");
$payfast->setEnv(true); //env must set as boolean, string will not work
dd($payfast->ipn_response());
```

Cashfree
--------

[](#cashfree)

[Checkout Cashfree Setup Documentation](#)

#### Cashfree ipn route example

[](#cashfree-ipn-route-example)

```
Route::get('/cashfree-ipn', [\App\Http\Controllers\PaymentLogController::class,'cashfree_ipn'] )->name('payment.cashfree.ipn');
```

route and middleware code will be same as version ^1.0, version ^2.0 will change only customer\_charge and ipn\_response method

#### charge\_customer method example

[](#charge_customer-method-example-10)

```
$cashfree = XgPaymentGateway::cashfree();
$cashfree->setAppId('app_id');
$cashfree->setSecretKey('secret_key');
$cashfree->setCurrency("USD");
$cashfree->setEnv(true); //true means sandbox, false means live , //env must set as boolean, string will not work
$cashfree->setExchangeRate(74); // if INR not set as currency

$response =  $cashfree->charge_customer([
    'amount' => 10,
    'title' => 'this is test title',
    'description' => 'this is test description',
    'ipn_url' => route('payment.cashfree.ipn'),
    'order_id' => 56,
    'track' => 'asdfasdfsdf',
    'cancel_url' => route('payment.failed'),
    'success_url' => route('payment.success'),
    'email' => 'dvrobin4@gmail.com',
    'name' => 'Ahmed Elkholy',
    'payment_type' => 'order',
]);
return $response;
```

#### ipn\_response method example

[](#ipn_response-method-example-10)

```
$cashfree = XgPaymentGateway::cashfree();
$cashfree->setAppId('app_id');
$cashfree->setSecretKey('secret_key');
$cashfree->setEnv(true); //true means sandbox, false means live  //env must set as boolean, string will not work
dd($cashfree->ipn_response());
```

Instamojo
---------

[](#instamojo)

Checkout Instamojo Setup Documentation

> > Instamojo Pago only works with INR currency

#### Instamojo ipn route example

[](#instamojo-ipn-route-example)

```
Route::get('/instamojo-ipn', [\App\Http\Controllers\PaymentLogController::class,'instamojo_ipn'] )->name('payment.instamojo.ipn');
```

##### Test Credentials for Instamojo

[](#test-credentials-for-instamojo)

```
mobile number 919090213229
For payments use the following card details:
Number: 4242 4242 4242 4242
Date: Any valid future date
CVV: 111
Name: abc
3D-secure password: 1221

```

2.0 Setup For Instamojo
-----------------------

[](#20-setup-for-instamojo)

route and middleware code will be same as version ^1.0, version ^2.0 will change only customer\_charge and ipn\_response method

#### charge\_customer method example

[](#charge_customer-method-example-11)

```
$instamojo = XgPaymentGateway::instamojo();
$instamojo->setClientId('client_id');
$instamojo->setSecretKey('secret_key');
$instamojo->setCurrency("INR");
$instamojo->setEnv(true); //true mean sandbox mode , false means live mode //env must set as boolean, string will not work
$instamojo->setExchangeRate(74); // if INR not set as currency

$response =  $instamojo->charge_customer([
    'amount' => 10,
    'title' => 'this is test title',
    'description' => 'this is test description',
    'ipn_url' => route('payment.instamojo.ipn'), //get route
    'order_id' => 56,
    'track' => 'asdfasdfsdf',
    'cancel_url' => route('payment.failed'),
    'success_url' => route('payment.success'),
    'email' => 'dvrobin4@gmail.com',
    'name' => 'Ahmed Elkholy',
    'payment_type' => 'order',
]);
return $response;
```

#### ipn\_response method example

[](#ipn_response-method-example-11)

```
$instamojo = XgPaymentGateway::instamojo();
$instamojo->setClientId('client_id');
$instamojo->setSecretKey('secret_key');
$instamojo->setEnv(true); //env must set as boolean, string will not work
dd($instamojo->ipn_response());
```

Mercadopago
-----------

[](#mercadopago)

[Checkout Mercadopago Setup Documentation](#)

> > Mercado Pago only works with BRL currency

#### Mercado ipn route example

[](#mercado-ipn-route-example)

```
Route::get('/mercadopago-ipn', [\App\Http\Controllers\PaymentLogController::class,'mercadopago_ipn'] )->name('payment.mercadopago.ipn');
```

##### Test Credentials for Mercadopago

[](#test-credentials-for-mercadopago)

```
For payments use the following card details:
Number: 5031 4332 1540 6351
Date: 11/25
CVV: 123
Name: abc

```

2.0 Setup For Instamojo
-----------------------

[](#20-setup-for-instamojo-1)

route and middleware code will be same as version ^1.0, version ^2.0, will change only customer\_charge and ipn\_response method

#### charge\_customer method example

[](#charge_customer-method-example-12)

```
$mercadopago = XgPaymentGateway::mercadopago();
$mercadopago->setClientId('client_id');
$mercadopago->setClientSecret('client_secret');
$mercadopago->setCurrency("USD");
$mercadopago->setExchangeRate(82); // if BRL not set as currency, you must have to provide exchange rate for it
$mercadopago->setEnv(true); ////true mean sandbox mode , false means live mode
$response =  $mercadopago->charge_customer([
    'amount' => 10,
    'title' => 'this is test title',
    'description' => 'this is test description',
	@@ -804,11 +804,11 @@ return $response;
#### ipn_response method example

```php
$mercadopago = XgPaymentGateway::mercadopago();
$mercadopago->setClientId('client_id');
$mercadopago->setClientSecret('client_secret');
$mercadopago->setEnv(true);
dd($mercadopago->ipn_response());
```

#### ipn\_response method example

[](#ipn_response-method-example-12)

```
$mercadopago = XgPaymentGateway::mercadopago();
$mercadopago->setClientId('client_id');
$mercadopago->setClientSecret('client_secret');
$mercadopago->setEnv(true);
dd($mercadopago->ipn_response());
```

Squareup
--------

[](#squareup)

Checkout Squareup Setup Documentation

Here is Test Credentials For Squareup

> > Squareup supported currency list

#### Squareup ipn route example

[](#squareup-ipn-route-example)

```
Route::get('/Squareup-ipn', [\App\Http\Controllers\PaymentLogController::class,'Squareup_ipn'] )->name('payment.mercadopago.ipn');
```

##### Api Credentials for Squareup

[](#api-credentials-for-squareup)

```
access_token = 'EAAAEOuLQObrVwJvCvoio3H13b8Ssqz1ighmTBKZvIENW9qxirHGHkqsGcPBC1uN'
location_id = 'LE9C12TNM5HAS'
```

##### Test Credentials for Squareup

[](#test-credentials-for-squareup)

```
Mastercard	5105 1051 0510 5100
CVC: 111
Date: any future date

Discover
6011 0000 0000 0004
CVC: 111
Date: any future date

Diners Club	3000 000000 0004
CVC: 111
Date: any future date

JCB	3569 9900 1009 5841
CVC: 111
Date: any future date

Name: Test
Email: test@gmail.com

```

2.0 Setup For Squareup
----------------------

[](#20-setup-for-squareup)

#### charge\_customer method example

[](#charge_customer-method-example-13)

```
$squareup = XgPaymentGateway::squareup();
$squareup->setLocationId('location_id');
$squareup->setAccessToken('access_token');
$squareup->setApplicationId('');
$squareup->setCurrency("USD");
$squareup->setEnv(true);
$squareup->setExchangeRate(74); // if INR not set as currency
$response =  $squareup->charge_customer([
    'amount' => 10,
    'title' => 'this is test title',
    'description' => 'this is test description',
    'ipn_url' => route('payment.get.ipn'),
    'order_id' => 56,
    'track' => 'asdfasdfsdf',
    'cancel_url' => route('payment.failed'),
    'success_url' => route('payment.success'),
    'email' => 'dvrobin4@gmail.com',
    'name' => 'Ahmed Elkholy',
    'payment_type' => 'order',
]);
 return $response;
```

#### ipn\_response method example

[](#ipn_response-method-example-13)

```
$squareup = XgPaymentGateway::squareup();
$squareup->setLocationId('location_id');
$squareup->setAccessToken('access_token');
$squareup->setApplicationId('');
$squareup->setCurrency("USD");
$squareup->setEnv(true);
dd($squareup->ipn_response());
```

PayTabs
-------

[](#paytabs)

Checkout PayTabs Setup Documentation

Here is Test Credentials For PayTabs

> > PayTabs supported currency list

#### PayTabs ipn route example

[](#paytabs-ipn-route-example)

```
Route::post('/paytabs-ipn', [\App\Http\Controllers\PaymentLogController::class,'paytabs_ipn'] )->name('payment.mercadopago.ipn');
```

#### Add This class to config/app.php (Its Mendatory)

[](#add-this-class-to-configappphp-its-mendatory)

```
\Paytabscom\Laravel_paytabs\PaypageServiceProvider::class
```

##### Api Credentials for PayTabs

[](#api-credentials-for-paytabs)

```
[
'currency' => 'USD', //['AED','EGP','SAR','OMR','JOD','USD']
'profile_id' => '96698',
'region' => 'GLOBAL', // ['ARE','EGY','SAU','OMN','JOR','GLOBAL']
'server_key' => 'SKJNDNRHM2-JDKTZDDH2N-H9HLMJNJ2L'
]

```

##### Test Credentials for PayTabs

[](#test-credentials-for-paytabs)

```
Number	            Scheme	CVV	3D enrolled

4000000000000002	Visa	123	Yes
4111111111111111	Visa	123	No
4012001036983332	Visa	530	Yes
5498383801606532	MasterCard	977	Yes
5200000000000007	MasterCard	977	Yes
5200000000000114	MasterCard	977	No

```

2.0 Setup For PayTabs
---------------------

[](#20-setup-for-paytabs)

#### charge\_customer method example

[](#charge_customer-method-example-14)

```
$paytabs = XgPaymentGateway::paytabs();
$paytabs->setProfileId('96698');
$paytabs->setRegion('GLOBAL');
$paytabs->setServerKey('SKJNDNRHM2-JDKTZDDH2N-H9HLMJNJ2L');
$paytabs->setCurrency("USD");
$paytabs->setEnv(true);
$paytabs->setExchangeRate(74); // if ['AED','EGP','SAR','OMR','JOD','USD'] not set as currency
$response =  $paytabs->charge_customer([
    'amount' => 10,
    'title' => 'this is test title',
    'description' => 'this is test description',
    'ipn_url' => route('payment.post.ipn'),
    'order_id' => 56,
    'track' => 'asdfasdfsdf',
    'cancel_url' => route('payment.failed'),
    'success_url' => route('payment.success'),
    'email' => 'dvrobin4@gmail.com',
    'name' => 'Ahmed Elkholy',
    'payment_type' => 'order',
]);
return $response;
```

#### ipn\_response method example for PayTabs

[](#ipn_response-method-example-for-paytabs)

```
$paytabs = XgPaymentGateway::paytabs();
$paytabs->setProfileId('96698');
$paytabs->setRegion('GLOBAL');
$paytabs->setServerKey('SKJNDNRHM2-JDKTZDDH2N-H9HLMJNJ2L');
$paytabs->setCurrency("USD");
dd($paytabs->ipn_response());
```

2.0 Setup For BillPlz
---------------------

[](#20-setup-for-billplz)

[Checkout BillPlz Setup Documentation](#)

> > Billplz supported currency list \['MYR\]

#### Billplz ipn route example

[](#billplz-ipn-route-example)

```
Route::post('/billplz-ipn', [\App\Http\Controllers\PaymentLogController::class,'billplz_ipn'] )->name('payment.billplz.ipn');
```

##### Api Credentials for Billplz

[](#api-credentials-for-billplz)

```
[
'key' => 'b2ead199-e6f3-4420-ae5c-c94f1b1e8ed6',
'version' => 'v4',
'x_signature' => 'S-HDXHxRJB-J7rNtoktZkKJg',
'collection_name' => 'kjj5ya006'
]

```

#### charge\_customer method example

[](#charge_customer-method-example-15)

```
$billplz = XgPaymentGateway::billplz();
$billplz->setKey('b2ead199-e6f3-4420-ae5c-c94f1b1e8ed6');
$billplz->setVersion('v4');
$billplz->setXsignature('S-HDXHxRJB-J7rNtoktZkKJg');
$billplz->setCollectionName('kjj5ya006');
$billplz->setCurrency("MYR");
$billplz->setEnv(true);
$billplz->setExchangeRate(50); // if ['MYR'] not set as currency
$response =  $billplz->charge_customer([
    'amount' => 10,
    'title' => 'this is test title',
    'description' => 'this is test description',
    'ipn_url' => route('payment.post.ipn'),
    'order_id' => 56,
    'track' => 'asdfasdfsdf',
    'cancel_url' => route('payment.failed'),
    'success_url' => route('payment.success'),
    'email' => 'dvrobin4@gmail.com',
    'name' => 'Ahmed Elkholy',
    'payment_type' => 'order',
]);
return $response;
```

#### ipn\_response method example for Billplz

[](#ipn_response-method-example-for-billplz)

```
$billplz = XgPaymentGateway::billplz();
$billplz->setKey('b2ead199-e6f3-4420-ae5c-c94f1b1e8ed6');
$billplz->setVersion('v4');
$billplz->setXsignature('S-HDXHxRJB-J7rNtoktZkKJg');
$billplz->setCollectionName('kjj5ya006');
$billplz->setCurrency("MYR");
$billplz->setEnv(true);
dd($billplz->ipn_response());
```

2.0 Setup For Zitopay
---------------------

[](#20-setup-for-zitopay)

[Checkout Zitopay Setup Documentation](#)

> > Zitopay supported currency list \[ "USD", "EUR", "GBP", "AED", "AFN", "ALL", "AMD", "ANG", "AOA", "ARS", "AUD", "AWG", "AZN", "BAM", "BBD", "BDT", "BGN", "BHD", "BIF", "BMD", "BND", "BOB", "BRL", "BSD", "BTN", "BWP", "BYN", "BZD", "CAD", "CDF", "CHF", "CLP", "CNY", "COP", "CRC", "CUP", "CVE", "CZK", "DJF", "DKK", "DOP", "DZD", "EGP", "ERN", "ETB", "FJD", "GEL", "GHS", "GMD", "GNF", "GTQ", "GYD", "HNL", "HRK", "HTG", "HUF", "IDR", "ILS", "INR", "IQD", "IRR", "ISK", "JMD", "JOD", "JPY", "KES", "KGS", "KHR", "KMF", "KPW", "KRW", "KWD", "KZT", "LAK", "LBP", "LKR", "LRD", "LSL", "LTL", "LVL", "LYD", "MAD", "MDL", "MGA", "MKD", "MMK", "MNT", "MRO", "MUR", "MVR", "MWK", "MXN", "MYR", "MZN", "NAD", "NGN", "NIO", "NOK", "NPR", "NZD", "OMR", "PAB", "PEN", "PGK", "PHP", "PKR", "PLN", "PYG", "QAR", "RON", "RSD", "RUB", "RWF", "SAR", "SCR", "SDG", "SEK", "SGD", "SLL", "SOS", "SRD", "STD", "SVC", "SYP", "SZL", "THB", "TJS", "TMT", "TND", "TOP", "TRY", "TTD", "TWD", "TZS", "UAH", "UGX", "UYU", "UZS", "VEF", "VND", "VUV", "WST", "XCD", "XOF", "YER", "ZAR", "ZMW", "ZWD", "XAF", \]

#### Zitopay ipn route example

[](#zitopay-ipn-route-example)

```
Route::post('/zitopay-ipn', [\App\Http\Controllers\PaymentLogController::class,'zitopay_ipn'] )->name('payment.zitopay.ipn'); //need to exclude from csrf token varification
```

you must have to excluded Zitopay ipn route from csrf token verify, go to `app/Http/Middleware` `VerifyCsrfToken` Middleware add your route path here in `$except` array

```
namespace App\Http\Middleware;
use Illuminate\Foundation\Http\Middleware\VerifyCsrfToken as Middleware;
class VerifyCsrfToken extends Middleware
{
    /**
     * The URIs that should be excluded from CSRF verification.
     *
     * @var array
     */
    protected $except = [
        'zitopay-ipn'
    ];
}
```

#### charge\_customer method example

[](#charge_customer-method-example-16)

```
$zitopay = XgPaymentGateway::zitopay();
$zitopay->setUsername('dvrobin4');
$zitopay->setCurrency("USD");
$zitopay->setEnv(true);
$zitopay->setExchangeRate(50); // if INR not set as currency
$args = [
    'amount' => 250,
    'title' => 'this is test title',
    'description' => 'description',
    'ipn_url' => route('payment.post.ipn'),
    'order_id' => 56,
    'track' => 'asdfasdfsdf',
    'cancel_url' => route('payment.failed'),
    'success_url' => route('payment.success'),
    'email' => 'email@mgil.com',
    'name' => 'sharifur',
    'payment_type' => 'order',
];
$response =  $zitopay->charge_customer($args);
return $response;
```

#### ipn\_response method example for Zitopay

[](#ipn_response-method-example-for-zitopay)

```
$zitopay = XgPaymentGateway::zitopay();
$zitopay->setUsername('dvrobin4');
$zitopay->setCurrency("USD");
$zitopay->setEnv(true);
$zitopay->setExchangeRate(50); // if INR not set as currency
dd($zitopay->ipn_response());
```

3.0 Setup For Toyyibpay
-----------------------

[](#30-setup-for-toyyibpay)

[Checkout Toyyibpay Setup Documentation](#)

```
>> Toyyibpay supported currency list ["MYR"]
```

#### Toyyibpay ipn route example

[](#toyyibpay-ipn-route-example)

```
Route::post('/toyyibpay-ipn', [\App\Http\Controllers\PaymentLogController::class,'toyyibpay_ipn'] )->name('payment.toyyibpay.ipn'); //need to exclude from csrf token varification
```

you must have to excluded Toyyibpay ipn route from csrf token verify, go to `app/Http/Middleware` `VerifyCsrfToken` Middleware add your route path here in `$except` array

```
namespace App\Http\Middleware;
use Illuminate\Foundation\Http\Middleware\VerifyCsrfToken as Middleware;
class VerifyCsrfToken extends Middleware
{
    /**
     * The URIs that should be excluded from CSRF verification.
     *
     * @var array
     */
    protected $except = [
        'toyyibpay-ipn'
    ];
}
```

#### charge\_customer method example

[](#charge_customer-method-example-17)

```
$toyyibpay = XgPaymentGateway::toyyibpay();
$toyyibpay->setUserSecretKey('wnbtrqle-9t9l-m02j-e2bz-iaj2tkp52sfo');
$toyyibpay->setCategoryCode('0m0j9yc4');
$toyyibpay->setEnv(true);
$toyyibpay->setCurrency("MYR");
$toyyibpay->setExchangeRate(74); //only support MYR Currency
return $toyyibpay->charge_customer([
    'amount' => 10,
    'title' => 'this is test title',
    'description' => 'this is test description',
    'ipn_url' => route('post.ipn'), //post route
    'order_id' => 56,
    'track' => 'asdfasdfsdf',
    'cancel_url' => route('payment.failed'),
    'success_url' => route('payment.success'),
    'email' => 'dvrobin4@gmail.com',
    'name' => 'Ahmed Elkholy',
    'payment_type' => 'order',
    'phone' => 12345678
]);
```

#### ipn\_response method example for Toyyibpay

[](#ipn_response-method-example-for-toyyibpay)

```
$toyyibpay = XgPaymentGateway::toyyibpay();
$toyyibpay->setUserSecretKey('wnbtrqle-9t9l-m02j-e2bz-iaj2tkp52sfo');
$toyyibpay->setCategoryCode('0m0j9yc4');
$toyyibpay->setEnv(true);
$toyyibpay->ipn_response();
```

Setup For Pagali
----------------

[](#setup-for-pagali)

Checkout Pagali Setup Documentation

```
>> Pagali supported currency list ['MYR','USD','EUR','CVE']
```

#### Pagali ipn route example

[](#pagali-ipn-route-example)

```
Route::post('/pagali-ipn', [\App\Http\Controllers\PaymentLogController::class,'pagali_ipn'] )->name('payment.pagali.ipn'); //need to exclude from csrf token varification
```

you must have to excluded Pagali ipn route from csrf token verify, go to `app/Http/Middleware` `VerifyCsrfToken` Middleware add your route path here in `$except` array

```
namespace App\Http\Middleware;
use Illuminate\Foundation\Http\Middleware\VerifyCsrfToken as Middleware;
class VerifyCsrfToken extends Middleware
{
    /**
     * The URIs that should be excluded from CSRF verification.
     *
     * @var array
     */
    protected $except = [
        'pagali-ipn'
    ];
}
```

#### charge\_customer method example

[](#charge_customer-method-example-18)

```
$pagali = XgPaymentGateway::pagalipay();
$pagali->setPageId('');
$pagali->setEntityId('');
$pagali->setCurrency("MYR");
$pagali->setEnv(true); // this must be type of boolean , string will not work
$pagali->setExchangeRate(74); // if INR not set as currency

$response =  $pagali->charge_customer([
    'amount' => 10,
    'title' => 'this is test title',
    'description' => 'this is test description',
    'ipn_url' => route('post.ipn'), //get route
    'order_id' => 56,
    'track' => 'asdfasdfsdf',
    'cancel_url' => route('payment.failed'),
    'success_url' => route('payment.success'),
    'email' => 'dvrobin4@gmail.com',
    'name' => 'Ahmed Elkholy',
    'payment_type' => 'order',
]);
```

#### ipn\_response method example for Pagali

[](#ipn_response-method-example-for-pagali)

```
$pagali = XgPaymentGateway::pagalipay();
$pagali->setPageId('');
$pagali->setEntityId('');
$pagali->setCurrency("MYR");
$pagali->setEnv(true); // this must be type of boolean , string will not work
dd($pagali->ipn_response());
```

Setup For Authorize.Net
-----------------------

[](#setup-for-authorizenet)

[Checkout Authorize.nnt Setup Documentation](#)

```
>>  Authorize.Net supported currency list ['AUD', 'CAD', 'CHF', 'DKK', 'EUR', 'GBP', 'JPY', 'NOK', 'NZD', 'SEK', 'USD', 'ZAR'];
```

#### Authorize.Net ipn route example

[](#authorizenet-ipn-route-example)

```
Route::get('/authorize-ipn', [\App\Http\Controllers\PaymentLogController::class,'authorize_ipn'] )->name('payment.authorize.ipn'); //need to exclude from csrf token varification
```

#### charge\_customer method example

[](#charge_customer-method-example-19)

```
$authorize = XgPaymentGateway::authorizenet();
$authorize->setMerchantLoginId('2e8yjNL89kV2');
$authorize->setMerchantTransactionId('65968Gb3DU2ntX2v');
$authorize->setCurrency("USD");
$authorize->setEnv(true); // this must be type of boolean , string will not work
$authorize->setExchangeRate(74); // if INR not set as currency

$response =  $authorize->charge_customer([
    'amount' => 10,
    'title' => 'this is test title',
    'description' => 'this is test description',
    'ipn_url' => route('get.ipn'), //get route
    'order_id' => 56,
    'track' => 'asdfasdfsdf',
    'cancel_url' => route('payment.failed'),
    'success_url' => route('payment.success'),
    'email' => 'dvrobin4@gmail.com',
    'name' => 'Ahmed Elkholy',
    'payment_type' => 'order',
]);
```

#### ipn\_response method example

[](#ipn_response-method-example-14)

```
    $authorizenet = XgPaymentGateway::authorizenet();
    $authorizenet->setMerchantLoginId('2e8yjNL89kV2');
    $authorizenet->setMerchantTransactionId('65968Gb3DU2ntX2v');
    $authorizenet->setEnv(true); // this must be type of boolean , string will not work
    dd($authorizenet->ipn_response());
```

Setup For SitesWay
------------------

[](#setup-for-sitesway)

no documentation available

```
>> it support all currency
```

#### SitesWay ipn route example

[](#sitesway-ipn-route-example)

```
Route::post('/siteways-ipn', [\App\Http\Controllers\PaymentLogController::class,'siteways_ipn'] )->name('payment.siteways.ipn'); //need to exclude from csrf token verification
```

you must have to excluded SitesWay ipn route from csrf token verify, go to `app/Http/Middleware` `VerifyCsrfToken` Middleware add your route path here in `$except` array

```
namespace App\Http\Middleware;
use Illuminate\Foundation\Http\Middleware\VerifyCsrfToken as Middleware;
class VerifyCsrfToken extends Middleware
{
    /**
     * The URIs that should be excluded from CSRF verification.
     *
     * @var array
     */
    protected $except = [
        'siteways-ipn'
    ];
}
```

#### charge\_customer method example

[](#charge_customer-method-example-20)

```
$sitesway = XgPaymentGateway::sitesway();
        $sitesway->setBrandId("-enter-brand-id-");
        $sitesway->setApiKey("--enter-api-key--");
        $sitesway->setCurrency("USD");
        $sitesway->setEnv(true); // this must be type of boolean , string will not work

        $response =  $sitesway->charge_customer([
            'amount' => 10,
            'title' => 'this is test title',
            'description' => 'this is test description',
            'ipn_url' => route('post.siteways.ipn'), //post route
            'order_id' => 56,
            'track' => 'asdfasdfsdf',
            'cancel_url' => route('payment.failed'),
            'success_url' => route('payment.success'),
            'email' => 'dvrobin4@gmail.com',
            'name' => 'Ahmed Elkholy',
            'payment_type' => 'order',
        ]);
        return $response;
```

#### ipn\_response method example for Siteways

[](#ipn_response-method-example-for-siteways)

```
    $sitesway = XgPaymentGateway::sitesway();
    $sitesway->setBrandId("-enter-brand-id-");
    $sitesway->setApiKey("--enter-api-key--");
    $sitesway->setCurrency("USD");
    $payment_data = $sitesway->ipn_response();
```

Setup For WiPay
---------------

[](#setup-for-wipay)

```
>>  Wipay supported currency list  ['JMD', 'TTD', 'USD']
```

#### Wipay ipn route example

[](#wipay-ipn-route-example)

```
Route::get('/wipay-ipn', [\App\Http\Controllers\PaymentLogController::class,'wipay_ipn'] )->name('payment.wipay.ipn');
```

#### charge\_customer method example

[](#charge_customer-method-example-21)

```
    $wipay = XgPaymentGateway::wipay();
    $wipay->setAccountNumber("1234567890");
    $wipay->setAccountApi("123");
    $wipay->setFeeStructure("customer_pay");
    $wipay->setCountryCode("TT");
    $wipay->setCurrency("USD");
    $wipay->setEnv(true); // this must be type of boolean , string will not work
    $wipay->setExchangeRate(74); // if INR not set as currency

    $response =  $wipay->charge_customer([
        'amount' => 10.5,
        'title' => 'this is test title',
        'description' => 'this is test description',
        'ipn_url' => route('get.ipn'), //post route
        'order_id' => 56,
        'track' => 'asdfasdfsdf',
        'cancel_url' => route('payment.failed'),
        'success_url' => route('payment.success'),
        'email' => 'dvrobin4@gmail.com',
        'name' => 'sharifur rahman',
        'payment_type' => 'order',
    ]);
    return $response;
```

#### ipn\_response method example for WiPay

[](#ipn_response-method-example-for-wipay)

```
    $wipay = XgPaymentGateway::wipay();
    $wipay->setAccountNumber("1234567890");
    $wipay->setAccountApi("123");
    $wipay->setFeeStructure("customer_pay");
    $wipay->setCountryCode("TT");
    $wipay->setCurrency("USD");
    $wipay->setEnv(true); // this must be type of boolean , string will not work
    $wipay->setExchangeRate(74); // if INR not set as currency
    $payment_data = $wipay->ipn_response();
    dd($payment_data);
```

Setup For TransactionCloud
--------------------------

[](#setup-for-transactioncloud)

Checkout TransactionCloud Setup Documentation

```
>>  TransactionCloud supported currency list  ['USD','EUR','PLN','INR','CAD','CNY','AUD','JPY','NOK','GBP','CHF','SGD','BRL','RUB','BGN','CZK','DKK','HUF','RON','SEK','GEL']
```

#### TransactionCloud ipn route example

[](#transactioncloud-ipn-route-example)

```
Route::get('/transactioncloud-ipn', [\App\Http\Controllers\PaymentLogController::class,'siteways_ipn'] )->name('payment.transactioncloud.ipn');
```

please note, TransactionCloud send all the ipn response to one single route which need to configure in TransactionCloud merchant panel as prodcut return url. you have to manage all the payment success process from one single route you will get a product\_type param to get idea which kind of product payment ipn response it is

#### charge\_customer method example

[](#charge_customer-method-example-22)

```
    $transactionclud = XgPaymentGateway::transactionclud();
    $transactionclud->setApiLogin("API_QWGW6TO2N1I5A2L40W");
    $transactionclud->setApiPassword("EPKUZU6L7HR8BU5WHH");
    $transactionclud->setProductID("TC-PR_APo7g7R");
    $transactionclud->setCurrency("USD");
    $transactionclud->setEnv(true); // this must be type of boolean , string will not work
    $transactionclud->setExchangeRate(74); // if INR not set as currency

    $response =  $transactionclud->charge_customer([
        'amount' => 10.5,
        'title' => 'this is test title',
        'description' => 'this is test description',
        'ipn_url' => route('get.ipn'), //post route
        'order_id' => 56,
        'track' => 'asdfasdfsdf',
        'cancel_url' => route('payment.failed'),
        'success_url' => route('payment.success'),
        'email' => 'dvrobin4@gmail.com',
        'name' => 'sharifur rahman',
        'payment_type' => 'order',
    ]);
    return $response;
```

#### ipn\_response method example for TransactionCloud

[](#ipn_response-method-example-for-transactioncloud)

```
    $transactionclud = XgPaymentGateway::transactionclud();
    $transactionclud->setApiLogin("API_QWGW6TO2N1I5A2L40W");
    $transactionclud->setApiPassword("EPKUZU6L7HR8BU5WHH");
    $transactionclud->setProductID("TC-PR_APo7g7R");
    $transactionclud->setEnv(true); // this must be type of boolean , string will not work
    $transactionclud->ipn_response();
```

Setup For KineticPay
--------------------

[](#setup-for-kineticpay)

```
>>  KineticPay supported currency list  ['MYR']
```

#### KineticPay ipn route example

[](#kineticpay-ipn-route-example)

```
Route::post('/kineticpay-ipn', [\App\Http\Controllers\PaymentLogController::class,'KineticPay_ipn'] )->name('payment.KineticPay.ipn');
```

you must have to excluded KineticPay ipn route from csrf token verify, go to `app/Http/Middleware` `VerifyCsrfToken` Middleware add your route path here in `$except` array

```
namespace App\Http\Middleware;
use Illuminate\Foundation\Http\Middleware\VerifyCsrfToken as Middleware;
class VerifyCsrfToken extends Middleware
{
    /**
     * The URIs that should be excluded from CSRF verification.
     *
     * @var array
     */
    protected $except = [
        'kineticpay-ipn'
    ];
}
```

#### charge\_customer method example

[](#charge_customer-method-example-23)

```
    $kineticpay = XgPaymentGateway::kineticpay();
    $kineticpay->setMerchantKey("ede1c5e9f81c9d12bf418629f56a7870");
    $kineticpay->setBank("ABMB0212");
    $kineticpay->setCurrency("MYR");
    $kineticpay->setEnv(true); // this must be type of boolean , string will not work
    $kineticpay->setExchangeRate(74); // if INR not set as currency

    $response =  $kineticpay->charge_customer([
        'amount' => 10.5,
        'title' => 'this is test title',
        'description' => 'this is test description',
        'ipn_url' => route('post.ipn'), //post route
        'order_id' => 56,
        'track' => 'asdfasdfsdf',
        'cancel_url' => route('payment.failed'),
        'success_url' => route('payment.success'),
        'email' => 'dvrobin4@gmail.com',
        'name' => 'sharifur rahman',
        'payment_type' => 'order',
    ]);
    return $response;
```

#### ipn\_response method example for kineticpay

[](#ipn_response-method-example-for-kineticpay)

```
    $kineticpay = XgPaymentGateway::kineticpay();
    $kineticpay->setMerchantKey("ede1c5e9f81c9d12bf418629f56a7870");
    $kineticpay->setCurrency("MYR");
    $kineticpay->setEnv(true); // this must be type of boolean , string will not work
    $kineticpay->setExchangeRate(74); // if INR not set as currency
    $payment_data = $kineticpay->ipn_response();
```

Setup For Senangpay
-------------------

[](#setup-for-senangpay)

[Senangpay Documentation](#)

```
>>  Senangpay supported currency list  ['MYR']
```

#### Senangpay ipn route example

[](#senangpay-ipn-route-example)

```
Route::get('/senangpay-ipn', [\App\Http\Controllers\PaymentLogController::class,'senangpay_ipn'] )->name('payment.senangpay.ipn');
```

you must have to add this url to senangpay merchant panel as return url, you can use only one ipn because, senangpay does not support return url, or ipn url, you can manage multiple payment by pass payment\_type, then filter it in single ipn route and manage it.

#### charge\_customer method example

[](#charge_customer-method-example-24)

```
    $senangpay = XgPaymentGateway::senangpay();
    $senangpay->setMerchantId('');
    $senangpay->setSecretKey('');
    $senangpay->setEnv(true);
    $senangpay->setHashMethod('sha256');
    $senangpay->setCurrency('MYR');
    $response =   $senangpay->charge_customer([
        'amount' => 10.5,
        'title' => 'this is test title',
        'description' => 'this is test description',
        'ipn_url' => route('get.ipn'), //post route
        'order_id' => 56,
        'track' => 'asdfasdfsdf',
        'cancel_url' => route('payment.failed'),
        'success_url' => route('payment.success'),
        'email' => 'dvrobin4@gmail.com',
        'name' => 'sharifur rahman',
        'payment_type' => 'order',
    ]);

    return $response;
```

#### ipn\_response method example for Senangpay

[](#ipn_response-method-example-for-senangpay)

```
    $senangpay = XgPaymentGateway::senangpay();
    $senangpay->setMerchantId('');
    $senangpay->setSecretKey('');
    $senangpay->setEnv(true);
    $senangpay->setHashMethod('sha256');
    $senangpay->setCurrency('MYR');
    $payment_data = $senangpay->ipn_response();

    dd($payment_data);
```

#### charge\_customer\_recurring method example

[](#charge_customer_recurring-method-example)

```
    $senangpay = XgPaymentGateway::senangpay();
    $senangpay->setMerchantId('');
    $senangpay->setSecretKey('');
    $senangpay->setRecurringId('169217592513'); //need to create product first in senangpay merchant panel and have to enable customer amount change option
    $senangpay->setEnv(true);
    $senangpay->setHashMethod('sha256');
    $senangpay->setCurrency('MYR');
    $response =   $senangpay->charge_customer_recurring([
    'amount' => 10.5,
    'title' => 'this is test title',
    'description' => 'this is test description',
    'ipn_url' => route('get.ipn'), //post route
    'order_id' => 56,
    'track' => 'asdfasdfsdf',
    'cancel_url' => route('payment.failed'),
    'success_url' => route('payment.success'),
    'email' => 'dvrobin4@gmail.com',
    'name' => 'sharifur rahman',
    'payment_type' => 'order',
]);

return $response;
```

#### ipn\_response\_recurring method example for Senangpay

[](#ipn_response_recurring-method-example-for-senangpay)

```
    $senangpay = XgPaymentGateway::senangpay();
    $senangpay->setMerchantId('');
    $senangpay->setSecretKey('');
    $senangpay->setEnv(true);
    $senangpay->setHashMethod('sha256'); //need to set hash method in senangpay merchant panel
    $senangpay->setCurrency('MYR');
    $payment_data = $senangpay->ipn_response_recurring();
    dd($payment_data);
```

#### Test Card for Senangpay

[](#test-card-for-senangpay)

```
Number:	5111111111111118
Expiry Month:	May
Expiry Year:	2025
CVV:	100
Card Name: anything

```

Setup For SaltPay
-----------------

[](#setup-for-saltpay)

```
>>  Salt supported currency list  ['ISK', 'USD', 'EUR', 'GBP', 'DKK', 'NOK', 'SEK', 'CHF', 'JPY', 'CAD', 'HUF']
```

#### Salt ipn route example

[](#salt-ipn-route-example)

```
Route::post('/salt-ipn', [\App\Http\Controllers\PaymentLogController::class,'salt_ipn'] )->name('payment.saltpay.ipn');
```

you must have to excluded Salt ipn route from csrf token verify, go to `app/Http/Middleware` `VerifyCsrfToken` Middleware add your route path here in `$except` array

```
namespace App\Http\Middleware;
use Illuminate\Foundation\Http\Middleware\VerifyCsrfToken as Middleware;
class VerifyCsrfToken extends Middleware
{
    /**
     * The URIs that should be excluded from CSRF verification.
     *
     * @var array
     */
    protected $except = [
        'salt-ipn'
    ];
}
```

#### charge\_customer method example

[](#charge_customer-method-example-25)

```
    $saltpay = XgPaymentGateway::saltpay();
    $saltpay->setMerchantId('');
    $saltpay->setSecretKey('');
    $saltpay->setPaymentGatewayId(16);
    $saltpay->setEnv(true);
    $saltpay->setCurrency('USD');
    $response =   $saltpay->charge_customer([
        'amount' => 5,
        'title' => 'this is test title',
        'description' => 'this is test description',
        'ipn_url' => route('post.ipn'), //post route
        'order_id' => 56,
        'track' => 'asdfasdfsdf',
        'cancel_url' => route('payment.failed'),
        'success_url' => route('payment.success'),
        'email' => 'dvrobin4@gmail.com',
        'name' => 'sharifur rahman',
        'payment_type' => 'order',
    ]);
    return $response;
```

#### ipn\_response method example for Saltpay

[](#ipn_response-method-example-for-saltpay)

```
$saltpay = XgPaymentGateway::saltpay();
$saltpay->setMerchantId('');
$saltpay->setSecretKey('');
$saltpay->setPaymentGatewayId(16);
$saltpay->setEnv(true);
$saltpay->setCurrency('USD');
$payment_data = $saltpay->ipn_response();

dd($payment_data);
```

Setup For Iyzipay
-----------------

[](#setup-for-iyzipay)

```
>>  Salt supported currency list  ['TRY', 'USD', 'EUR', 'GBP','IRR','NOK','RUB','CHF']
```

#### Iyzipay ipn route example

[](#iyzipay-ipn-route-example)

```
Route::post('/iyzipay-ipn', [\App\Http\Controllers\PaymentLogController::class,'iyzipay_ipn'] )->name('payment.iyzipay.ipn');
```

you must have to excluded Iyzipay ipn route from csrf token verify, go to `app/Http/Middleware` `VerifyCsrfToken` Middleware add your route path here in `$except` array

```
namespace App\Http\Middleware;
use Illuminate\Foundation\Http\Middleware\VerifyCsrfToken as Middleware;
class VerifyCsrfToken extends Middleware
{
    /**
     * The URIs that should be excluded from CSRF verification.
     *
     * @var array
     */
    protected $except = [
        'iyzipay-ipn'
    ];
}
```

#### charge\_customer method example

[](#charge_customer-method-example-26)

```
    $iyzipay = XgPaymentGateway::iyzipay();
    $iyzipay->setSecretKey('sandbox-QsgXTUpizlCZzHaypMJwkL8YTMGsYMBM');
    $iyzipay->setApiKey('sandbox-wtyih1LNnlN1FtCei29rVjbZRKfqVeUC');
    $iyzipay->setEnv(false);
    $iyzipay->setCurrency('TRY');
    $response =   $iyzipay->charge_customer([
        'amount' => 5,
        'title' => 'this is test title',
        'description' => 'this is test description',
        'ipn_url' => route('post.ipn'), //post route
        'order_id' => 56,
        'track' => 'asdfasdfsdf',
        'cancel_url' => route('payment.failed'),
        'success_url' => route('payment.success'),
        'email' => 'dvrobin4@gmail.com',
        'name' => 'sharifur rahman',
        'payment_type' => 'order',
    ]);
    return $response;
```

#### ipn\_response method example for Iyzipay

[](#ipn_response-method-example-for-iyzipay)

```
$iyzipay = XgPaymentGateway::iyzipay();
$iyzipay->setSecretKey('sandbox-QsgXTUpizlCZzHaypMJwkL8YTMGsYMBM');
$iyzipay->setApiKey('sandbox-wtyih1LNnlN1FtCei29rVjbZRKfqVeUC');
$iyzipay->setEnv(true);
$iyzipay->setCurrency('TRY');
$payment_data = $iyzipay->ipn_response();

dd($payment_data);
```

Setup For Paymob
----------------

[](#setup-for-paymob)

```
>>  paymob supported currency list  ['EGP', 'USD', 'EUR', 'GBP']
```

#### Paymob ipn route example

[](#paymob-ipn-route-example)

```
Route::match(['get','post'],'/paymob-ipn', [\App\Http\Controllers\PaymentLogController::class,'paymob_ipn'] )->name('payment.paymob.ipn');
```

you must have to excluded Paymob ipn route from csrf token verify, go to `app/Http/Middleware` `VerifyCsrfToken` Middleware add your route path here in `$except` array

```
namespace App\Http\Middleware;
use Illuminate\Foundation\Http\Middleware\VerifyCsrfToken as Middleware;
class VerifyCsrfToken extends Middleware
{
    /**
     * The URIs that should be excluded from CSRF verification.
     *
     * @var array
     */
    protected $except = [
        'paymob-ipn'
    ];
}
```

#### charge\_customer method example

[](#charge_customer-method-example-27)

```
        $paymob = XgPaymentGateway::paymob();
        $paymob->setApiKey('=');
        $paymob->setIntegrationId('');
        $paymob->setIframeId('');
        //this payment gateway support mulple payment option. here is example of 4,
//        $paymob->setGatewayType('accept-valu');
        $paymob->setGatewayType('accept-online');
//        $paymob->setGatewayType('accept-kiosk');
//        $paymob->setGatewayType('accept-wallet');
//        $paymob->setWalletMobileNumber('01010101010'); //require wallet mobile number, is you set gateway type "accept-wallet", this is user wallet number;

        $paymob->setSecretKey('');
        $paymob->setPublicKey('');
        $paymob->setHmacSecret('');
        $paymob->setEnv(true);
        $paymob->setCurrency('EGP');
        $response =   $paymob->charge_customer([
            'amount' => 5,
            'title' => 'this is test title',
            'description' => 'this is test description',
            'ipn_url' => route('post.ipn'), //post route
            'order_id' => 56,
            'track' => 'asdfasdfsdf',
            'cancel_url' => route('payment.failed'),
            'success_url' => route('payment.success'),
            'email' => 'dvrobin4@gmail.com',
            'name' => 'sharifur rahman',
            'payment_type' => 'order',
        ]);
        return $response;
```

#### ipn\_response method example for Paymob

[](#ipn_response-method-example-for-paymob)

```
    $paymob = XgPaymentGateway::paymob();
    $paymob->setApiKey('ZXlKaGJHY2lPaUpJVXpVeE1pSXNJblI1Y0NJNklrcFhWQ0o5LmV5SmpiR0Z6Y3lJNklrMWxjbU5vWVc1MElpd2ljSEp2Wm1sc1pWOXdheUk2T0RVNU5UY3pMQ0p1WVcxbElqb2lhVzVwZEdsaGJDSjkuSzZ3WUliNDN3MzdfNVpLVm9yQjdkYXo5bmh3UGtiVGNUUnlfNGhoVXVzWmYyYzJyMnpEb2VMWVRuMXZDSmtPcE1NWkdpNURmYU5mdHBmc3ZtdGlUeEE=');
    $paymob->setIntegrationId('4036562');
    $paymob->setIframeId('775086');
//        $paymob->setGatewayType('accept-valu');
    $paymob->setGatewayType('accept-online');
//        $paymob->setGatewayType('accept-kiosk');
//        $paymob->setGatewayType('accept-wallet');
//        $paymob->setWalletMobileNumber('01010101010'); //require wallet mobile number, is you set gateway type "accept-wallet", this is user wallet number;

    $paymob->setSecretKey('egy_sk_live_fccc02d55ad9719c077a8344b83d87a45a2babfadd750fd64ecc22e023196f9b');
    $paymob->setPublicKey('egy_pk_live_9ojAlERxBdcEuO7bZDyzx00xJNvi12Q5');
    $paymob->setHmacSecret('02D16CFDC2F224AE0E12416CC7FFEF9F');
    $paymob->setEnv(true);
    $paymob->setCurrency('EGP');
    $payment_data = $paymob->ipn_response();
    dd($payment_data);
```

Setup For Powertranz
--------------------

[](#setup-for-powertranz)

```
>>  Powertranz supported currency list  ['EGP', 'USD', 'EUR', 'GBP']
```

#### Powertranz ipn route example

[](#powertranz-ipn-route-example)

```
Route::post('/powertranz-ipn', [\App\Http\Controllers\PaymentLogController::class,'powertranz_ipn'] )->name('payment.powertranz.ipn');
```

you must have to excluded Powertranz ipn route from csrf token verify, go to `app/Http/Middleware` `VerifyCsrfToken` Middleware add your route path here in `$except` array

```
namespace App\Http\Middleware;
use Illuminate\Foundation\Http\Middleware\VerifyCsrfToken as Middleware;
class VerifyCsrfToken extends Middleware
{
    /**
     * The URIs that should be excluded from CSRF verification.
     *
     * @var array
     */
    protected $except = [
        'powertranz-ipn'
    ];
}
```

#### charge\_customer method example for Powertranz

[](#charge_customer-method-example-for-powertranz)

```
    $powertranz = XgPaymentGateway::powertranz();
    $powertranz->setMerchantId('88803448');
    $powertranz->setMerchantProcessingPassword('SqroVVlPemN4gvlAKCbl7l5tvHzjOypnfqdYXMYv9ze4GsW3OaCABO');
    $powertranz->setGatewayKey('');
    $powertranz->setEnv(true);
    $powertranz->setCurrency('USD');
    $response =   $powertranz->charge_customer([
        'amount' => 5.2,
        'title' => 'this is test title',
        'description' => 'this is test description',
        'ipn_url' => route('post.ipn'), //post route
        'order_id' => 56,
        'track' => 'asdfasdfsdf',
        'cancel_url' => route('payment.failed'),
        'success_url' => route('payment.success'),
        'email' => 'dvrobin4@gmail.com',
        'name' => 'sharifur rahman',
        'payment_type' => 'order',
    ]);

    return $response;
```

#### ipn\_response method example for Powertranz

[](#ipn_response-method-example-for-powertranz)

```
    $powertranz = XgPaymentGateway::powertranz();
    $powertranz->setMerchantId('88803448');
    $powertranz->setMerchantProcessingPassword('SqroVVlPemN4gvlAKCbl7l5tvHzjOypnfqdYXMYv9ze4GsW3OaCABO');
    $powertranz->setGatewayKey('');
    $powertranz->setEnv(true);
    $powertranz->setCurrency('USD');
    $payment_data = $powertranz->ipn_response();
    dd($payment_data);
```

Setup For Awdpay
----------------

[](#setup-for-awdpay)

```
>>  Awdpay supported currency list  ['USD', 'EUR', 'XOF']
```

#### Awdpay ipn route example

[](#awdpay-ipn-route-example)

```
Route::post('/awdpay-ipn', [\App\Http\Controllers\PaymentLogController::class,'awdpay_ipn'] )->name('payment.awdpay.ipn');
```

you must have to excluded Awdpay ipn route from csrf token verify, go to `app/Http/Middleware` `VerifyCsrfToken` Middleware add your route path here in `$except` array

```
namespace App\Http\Middleware;
use Illuminate\Foundation\Http\Middleware\VerifyCsrfToken as Middleware;
class VerifyCsrfToken extends Middleware
{
    /**
     * The URIs that should be excluded from CSRF verification.
     *
     * @var array
     */
    protected $except = [
        'awdpay-ipn'
    ];
}
```

#### charge\_customer method example for awdpay

[](#charge_customer-method-example-for-awdpay)

```
    $awdpay = XgPaymentGateway::awdpay();
    $awdpay->setPrivateKey('---');
    $awdpay->setLogoUrl('---');
    $awdpay->setEnv(true);
    $awdpay->setCurrency('USD');
    $response =   $awdpay->charge_customer([
        'amount' => 5.2,
        'title' => 'this is test title',
        'description' => 'this is test description',
        'ipn_url' => route('post.ipn'), //post route
        'order_id' => 56,
        'track' => 'asdfasdfsdf',
        'cancel_url' => route('payment.failed'),
        'success_url' => route('payment.success'),
        'email' => 'dvrobin4@gmail.com',
        'name' => 'sharifur rahman',
        'payment_type' => 'order',
    ]);

    return $response;
```

#### ipn\_response method example for Awdpay

[](#ipn_response-method-example-for-awdpay)

```
    $awdpay = XgPaymentGateway::awdpay();
    $awdpay->setPrivateKey('---');
    $awdpay->setLogoUrl('---');
    $awdpay->setEnv(true);
    $awdpay->setCurrency('USD');
    $payment_data = $awdpay->ipn_response();
    dd($payment_data);
```

Setup For YooMoney
------------------

[](#setup-for-yoomoney)

```
>>  YooMoney supported currency list  ['RUB']
```

#### YooMoney ipn route example

[](#yoomoney-ipn-route-example)

```
Route::post('/yoomoney-ipn', [\App\Http\Controllers\PaymentLogController::class,'yoomoney_ipn'] )->name('payment.yoomoney.ipn');
```

> Note: YooMoney does not support multiple ipn route, it supports only one webhook you can add in YooMoney dashboard. you can use $arg\['payment\_type'\] data for check which kind of payment processed

you must have to excluded YooMoney ipn route from csrf token verify, go to `app/Http/Middleware` `VerifyCsrfToken` Middleware add your route path here in `$except` array

```
namespace App\Http\Middleware;
use Illuminate\Foundation\Http\Middleware\VerifyCsrfToken as Middleware;
class VerifyCsrfToken extends Middleware
{
    /**
     * The URIs that should be excluded from CSRF verification.
     *
     * @var array
     */
    protected $except = [
        'yoomoney-ipn'
    ];
}
```

#### charge\_customer method example for YooMoney

[](#charge_customer-method-example-for-yoomoney)

```
    $yoomoney = XgPaymentGateway::yoomoney();
    $yoomoney->setShopId('');
    $yoomoney->setSecretKey('');
    $yoomoney->setCurrency("RUB");
    $yoomoney->setEnv(true); // this must be type of boolean , string will not work
    $yoomoney->setExchangeRate(74); // if RUB not set as currency
    $response =  $yoomoney->charge_customer([
        'amount' => 10,
        'title' => 'this is test title',
        'description' => 'this is test description',
        'ipn_url' => route('post.ipn'), //post route
        'order_id' => Str::random(6),
        'track' => 'asdfasdfsdf',
        'cancel_url' => route('payment.failed'),
        'success_url' => route('payment.success'),
        'email' => 'dvrobin4@gmail.com',
        'name' => 'Ahmed Elkholy',
        'payment_type' => 'order',
    ]);
     return $response;
```

#### ipn\_response method example for YooMoney

[](#ipn_response-method-example-for-yoomoney)

```
  $yoomoney = XgPaymentGateway::yoomoney();
  $yoomoney->setShopId('');
  $yoomoney->setSecretKey('');
  $yoomoney->setCurrency("RUB");
  $yoomoney->setEnv(true); // this must be type of boolean , string will not work
  $yoomoney->setExchangeRate(74); // if INR not set as currency
  \Log::info(print_r($yoomoney->ipn_response(),true));
```

Setup For CoinPayments
----------------------

[](#setup-for-coinpayments)

```
>>  CoinPayments supported currency list  [
            "USD",'LTCT','ZEN','ZEC','XVG','XMR','XEM','USDT.TRC20',
            'USDT.SOL','USDT','USDC.TRC20','USDC.SOL','TUSD.TRC20',
            'TRX','SYS','SOL','RVN','QTUM','PIVX','OMNI','MSOL.SOL',
            'MNDE.SOL','MATIC.POLY','MAID','MAD','JST.TRC20','ISLM.EVM',
            'FTN.BAHAMUT','FIRO','ETH','ETC','DOGE','DGB','DASH','CNHT.TRC20',
            'BXN','BUSD.TRC20','BTT.TRC20','BNB.BSC','BNB','VLX.Native','VLX',
            'LTC','BCH','BTC.LN','BTC'
        ]
```

#### CoinPayments ipn route example

[](#coinpayments-ipn-route-example)

```
Route::post('/coinpayments-ipn', [\App\Http\Controllers\PaymentLogController::class,'coinpayments_ipn'] )->name('payment.coinpayments.ipn');
```

you must have to excluded CoinPayments ipn route from csrf token verify, go to `app/Http/Middleware` `VerifyCsrfToken` Middleware add your route path here in `$except` array

```
namespace App\Http\Middleware;
use Illuminate\Foundation\Http\Middleware\VerifyCsrfToken as Middleware;
class VerifyCsrfToken extends Middleware
{
    /**
     * The URIs that should be excluded from CSRF verification.
     *
     * @var array
     */
    protected $except = [
        'coinpayments-ipn'
    ];
}
```

#### charge\_customer method example for CoinPayments

[](#charge_customer-method-example-for-coinpayments)

```
    $coinpayment = XgPaymentGateway::coinpayments();
    $coinpayment->setMerchant('');
    $coinpayment->setCurrency("USD");
    $coinpayment->setAllowCurrencies("LTCT,BTC,ETH"); // you can set multiple currencies
    $coinpayment->setIpnPin("");
    $coinpayment->setEnv(true); // this must be type of boolean , string will not work
    $coinpayment->setExchangeRate(74);
    $response =  $coinpayment->charge_customer([
        'amount' => 10,
        'title' => 'this is test title',
        'description' => 'this is test description',
        'ipn_url' => route('post.ipn'), //post route
        'order_id' => Str::random(6),
        'track' => 'asdfasdfsdf',
        'cancel_url' => route('payment.failed'),
        'success_url' => route('payment.success'),
        'email' => 'dvrobin4@gmail.com',
        'name' => 'Ahmed Elkholy',
        'payment_type' => 'order',
    ]);
  return $response;
```

#### ipn\_response method example for CoinPayments

[](#ipn_response-method-example-for-coinpayments)

```
    $coinpayment = XgPaymentGateway::coinpayments();
    $coinpayment->setMerchant('');
    $coinpayment->setCurrency("USD");
    $coinpayment->setAllowCurrencies("LTCT,BTC,ETH"); // you can set multiple currencies
    $coinpayment->setIpnPin("");
    $coinpayment->setEnv(true); // this must be type of boolean , string will not work
    $coinpayment->setExchangeRate(74); // if INR not set as currency
   \Log::info(print_r($coinpayment->ipn_response(),true));
```

Setup For Sslcommerz
--------------------

[](#setup-for-sslcommerz)

```
>>  Sslcommerz supported currency list  ["USD",'BDT','EUR']
```

#### Sslcommerz ipn route example

[](#sslcommerz-ipn-route-example)

```
Route::post('/sslcommerz-ipn', [\App\Http\Controllers\PaymentLogController::class,'sslcommerz_ipn'] )->name('payment.sslcommerz.ipn');
```

you must have to excluded Sslcommerz ipn route from csrf token verify, go to `app/Http/Middleware` `VerifyCsrfToken` Middleware add your route path here in `$except` array

```
namespace App\Http\Middleware;
use Illuminate\Foundation\Http\Middleware\VerifyCsrfToken as Middleware;
class VerifyCsrfToken extends Middleware
{
    /**
     * The URIs that should be excluded from CSRF verification.
     *
     * @var array
     */
    protected $except = [
        'sslcommerz-ipn'
    ];
}
```

#### charge\_customer method example for Sslcommerz

[](#charge_customer-method-example-for-sslcommerz)

```
    $sslcommerz = XgPaymentGateway::sslcommerz();
    $sslcommerz->setStoreId('xgeni65bceeafdfb1e');
    $sslcommerz->setStorePasswd('xgeni65bceeafdfb1e@ssl');
    $sslcommerz->setCurrency("BDT");
    $sslcommerz->setEnv(true); // this must be type of boolean , string will not work
    $sslcommerz->setExchangeRate(74); // if BDT not set as currency
    $response =  $sslcommerz->charge_customer([
        'amount' => 10,
        'title' => 'this is test title',
        'description' => 'this is test description',
        'ipn_url' => route('post.ipn'), //post route
        'order_id' => Str::random(6),
        'track' => 'asdfasdfsdf',
        'cancel_url' => route('payment.failed'),
        'success_url' => route('payment.success'),
        'email' => 'dvrobin4@gmail.com',
        'name' => 'Ahmed Elkholy',
        'payment_type' => 'order',
    ]);
    return $response;
```

#### ipn\_response method example for Sslcommerz

[](#ipn_response-method-example-for-sslcommerz)

```
    $sslcommerz = XgPaymentGateway::sslcommerz();
    $sslcommerz->setStoreId('xgeni65bceeafdfb1e');
    $sslcommerz->setStorePasswd('xgeni65bceeafdfb1e@ssl');
    $sslcommerz->setCurrency("BDT");
    $sslcommerz->setEnv(true); // this must be type of boolean , string will not work
    $sslcommerz->setExchangeRate(74); // if BDT not set as currency
   \Log::info(print_r($sslcommerz->ipn_response(),true));
```

Using this package
------------------

[](#using-this-package)

Information about using this package

Contributing
------------

[](#contributing)

Information about contributing to this package. Owner Of Package @sharifur Bug Fix and minor Contributor

###  Health Score

26

—

LowBetter than 43% of packages

Maintenance38

Infrequent updates — may be unmaintained

Popularity5

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity47

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

557d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/289bcafad4768e7d0d9302dd45236925dae2ad46b2af6607c041f4ad655e1b99?d=identicon)[mykholy](/maintainers/mykholy)

---

Top Contributors

[![mykholy](https://avatars.githubusercontent.com/u/50089023?v=4)](https://github.com/mykholy "mykholy (2 commits)")

---

Tags

laravelpaymentgatewaymykholy

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Type Coverage Yes

### Embed Badge

![Health badge](/badges/mykholy-paymentgateway/health.svg)

```
[![Health](https://phpackages.com/badges/mykholy-paymentgateway/health.svg)](https://phpackages.com/packages/mykholy-paymentgateway)
```

###  Alternatives

[tsaiyihua/laravel-linepay

linepay library for laravel

102.9k](/packages/tsaiyihua-laravel-linepay)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)