elsayed85/banquemisr

This is my package banquemisr

dev-main 2023-03-06 20:15 UTC

Requires

• php: ^8.1
• illuminate/contracts: ^10.0
• spatie/laravel-package-tools: ^1.14.0

Requires (Dev)

• laravel/pint: ^1.0
• nunomaduro/collision: ^7.9
• orchestra/testbench: ^8.0
• pestphp/pest: ^2.0
• pestphp/pest-plugin-arch: ^2.0
• pestphp/pest-plugin-laravel: ^2.0

MIT

• Elsayed Kamal

• laravel
• elsayed85
• banquemisr

README

misr
TestMERCHANT_CBA
405de7461df50083d3ce803c91c5bf05

meeza
10000001117
100083

QNB Payment Integration Package

banquemisr Payment Integration Package is a Package for Integrated Payment via banquemisr Bank.

Install

To install Package use composer

  composer require elsayed85/banquemisr:dev-master

Add service provider & alias

Add the following service provider to the array in: config/app.php

Elsayed85\Banquemisr\BanquemisrServiceProvider::class

Add the following alias to the array in: config/app.php

'Banquemisr' =>Elsayed85\Banquemisr\Facades\Banquemisr::class

Publish the config file

php artisan vendor:publish

config file have name BankPayment.php it return an array of payment options like apiOperation, currency, ApiUrl

Usage

	// Create Session for Payment SandBox Mode
	Banquemisr::createSessionSandBox();

	// Create Session for Payment Live Mode
	Banquemisr::createSessionLive();

	// Start Payment via MasterCard or Visa in SandBox Mode
	Banquemisr::createPaymentSandBox();

	// Start Payment via MasterCard or Visa in Live Mode
	Banquemisr::createPaymentLive();

	// Get Order Details in SandBox Mode
	Banquemisr::getOrderDetailsSandBox();

	// Get Order Details in Live Mode
	Banquemisr::getOrderDetailsLive();

	// Start Payment via Meeza Digital in SandBox Mode
	Banquemisr::createPaymentMeezaSandBox();

	// Start Payment via Meeza Digital in Live Mode
	Banquemisr::createPaymentMeezaLive();

Example of Payment Method via Master Card or Visa in SandBox Mode

	// Create Session for Payment
	$sessionID = Banquemisr::createSessionSandBox('125550', 'TESTQNBAATEST001', '9c6a123857f1ea50830fa023ad8c8d1b');

	// Start Payment via MasterCard or Visa
	{!! Banquemisr::createPaymentSandBox('success.php', 'fail.php', 'TESTQNBAATEST001', '125550', 20.00, $sessionID, 'Test QNB', 'Cairo', '[e-mail]', 0123456789, 'https://yourdomian.com/images/logo.png') !!}

	// Get Order Details
	dd(Banquemisr::getOrderDetailsSandBox('125550', 'TESTQNBAATEST001', '9c6a123857f1ea50830fa023ad8c8d1b'));

Create Session should have contain:

• Your Order ID in your System, Ex: '125550'.
• Merchant ID in QNB System, Ex: 'TESTQNBAATEST001'.
• Merchant Password in QNB System, Ex: '9c6a123857f1ea50830fa023ad8c8d1b'.

Response of Create Session Method

• Create and Retrieve Session ID.

Create Payment Method should have contain:

• Success URL Upon completion of the Request Success Payment, you will be redirect to this URL.
• Failer URL Upon completion of the Request Failer Payment, you will be redirect to this URL.
• Merchant ID in QNB System, Ex: 'TESTQNBAATEST001'.
• Your Order ID in your System, Ex: '125550'.
• The Total Price for Order, Ex: '20.00'.
• Session ID, your Created in last step can you get it via Create Session Method.
• Site Name, Ex: 'Test QNB'.
• Site Address, Ex: 'Cairo', can you set null.
• Site Email, Ex: '[e-mail]', can you set null.
• Site Phone, Ex: '0123456789', can you set null.
• Site Logo URL, Ex: 'https://yourdomian.com/images/logo.png', can you set null.

Get Order Details should have contain:

• Your Order ID in your System, Ex: '125550'.
• Merchant ID in QNB System, Ex: 'TESTQNBAATEST001'.
• Merchant Password in QNB System, Ex: '9c6a123857f1ea50830fa023ad8c8d1b'.

Response of Get Order Details

• All Information of Payment, Ex: 'Payment Method, Total Price, Card Number, Transaction Date, ...'.

Example of Payment Method via Meeza Digital in SandBox Mode

	// Start Payment via Meeza Digital
	{!! createPaymentMeezaSandBox('success.php', 'fail.php', 10000001117, 100083, 123456, 80) !!}

Create Payment Method should have contain:

• Success URL Upon completion of the Request Success Payment, you will be redirect to this URL.
• Failer URL Upon completion of the Request Failer Payment, you will be redirect to this URL.
• The Configured Merchant ID from UPG, Ex: '10000001117'.
• The Configured Terminal ID from UPG for the Merchant, Ex: '100083'.
• Your Order ID in your System, Ex: '123456'.
• The Total Price for Order, Ex: '80.00'.

Response of Complete Payment

• Send information of Payment To Success URL via Ajax Post Data.

Response of Failer Payment

• Redirect to Failer URL.

Contributing

• For major changes, please open an issue first to discuss what you would like to change.
• Please make sure to update tests as appropriate.

License

GNU General Public License