Download the PHP package bnbwebexpertise/laravel-paybox-gateway without Composer

On this page you can find all versions of the php package bnbwebexpertise/laravel-paybox-gateway. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Informations about the package laravel-paybox-gateway

Laravel Paybox Gateway

This module makes integration with Paybox payment gateway much easier. It supports currently 2 ways of making payments using Paybox system.

  1. Full payment via Paybox System - this is the most common way to receive payment - client has to pay for his order and after payment you can process the order
  2. Authorization via Paybox System followed by capture via Paybox Direct - first client makes payment but in fact the real payment is not made, payment is only authorized so far. In maximum period of 7 days you have to confirm you want to/are able to process the order and you capture the payment. After successful payment capture you can process the order.

Installation

  1. Run

    in console to install this module

  2. For Laravel < 5.5, open config/app.php and add

    in section providers

    You also need to publish the migrations :

  3. Run the migrations

  4. In case you need advanced customization, run

    in your console to publish default configuration files and sample views

  5. Open config/paybox.php and configure it according to your needs. By default you should put the following variables into your .env file and fill them with valid values:

    • PAYBOX_TEST - whether Paybox test system should be used (it should be set to true only for tests) ,
    • PAYBOX_SITE - Site number provided by Paybox
    • PAYBOX_RANK - Rank number provided by Paybox
    • PAYBOX_ID - Internal identifier provided by Paybox
    • PAYBOX_BACK_OFFICE_PASSWORD - Paybox back-office password. It's required only if you are going to make Capture requests. Otherwise it's not recommended to fill it (it won't be used)
    • PAYBOX_HMAC_KEY - This is key you should generate in your Paybox back-office
  6. Download Paybox public key and put it in directory and name you specified in config/paybox.php for public_key key

  7. In your routes file register routes with names defined in customer_return_routes_names and transaction_verify_route_name groups of your config/paybox.php

Usage

In order to use the system, you need to do a few things:

  1. You need to launch the authorization request in order to init payment

  2. You need to handle customer returning routes to display message to customer. By default there are 4 different routes depending on final situation on transaction. Be aware you should never use those routes to change status of payment because in fact it's not 100% sure at this stage. You should use handle transaction routes in order to do that

  3. You should handle transaction verify route. Here you should change status of payment after receiving request and make any additional actions.

  4. In case you use want to capture previously authorized payments, you should also handle capturing previous payments.

Authorization request

This is main request you need to launch to init payment.

The most basic sample code for authorization request could look like this:

This code should be run in controller as it's returning view which will by default automatically redirect customer to Paybox website.

In above sample code the full payment is made. If you want to only authorize payment (which you will capture later) you should use AuthorizationWithoutCapture class instead of AuthorizationWithCapture

If you want more customization take a look at public methods of \Bnb\PayboxGateway\Requests\Authorization class.

For setAmount default currency is Euro. If you want to use other currency, you should use currency constant from \Bnb\PayboxGateway\Currency class as 2nd parameter. Also please notice that amount you should give to this function is real amount (with decimal places) and not converted already to Paybox format.

Also for setPaymentNumber you should make sure the number you gave here is unique for each call. That's why you should probably create payments table for each order and depending on your system, you might need to assume there are more than one payment for your order (for example someone first cancelled it, but later if you gave him such option they decided to make the payment again).

You might want in this step adjust also view for sending request because in some cases it might be seen by a client. However you shouldn't change fields you send to Paybox in this step or it won't work.

In case you use AuthorizationWithoutCapture you should make sure, you have \Bnb\PayboxGateway\ResponseField::PAYBOX_CALL_NUMBER and \Bnb\PayboxGateway\ResponseField::TRANSACTION_NUMBER in your return fields because those values will be needed when capturing payment later. You should also always have \Bnb\PayboxGateway\ResponseField::AUTHORIZATION_NUMBER and \Bnb\PayboxGateway\ResponseField::SIGNATURE in your return fields and signature should be always last parameter.

Define customer returning routes

By default 4 sample views were created with sample English texts. You should create routes that will display those views (those routes will be launched using GET HTTP method), adjust those views and in most cases it will be enough because the real status of payment will be verified using transaction verify route.

Handling transaction verify route

To make sure the payment was really successful you should use \Bnb\PayboxGateway\Responses\Verify class. The simplest code could look like this:

This code should be run in controller, because you should return non-empty response when receiving valid Paybox request for transaction verify route. As you see, first you need to find order by number and then you need to make sure that it was successful. If yes, you should make sure it was real payment before you process the order (if you use full payment it will be always true but in case in your application you use also authorization only payments with later capture you should make sure you won't process the order for authorization only payment).

Capturing previously authorized request

In case you use Authorization via Paybox System followed by capture via Paybox Direct you are going to finally capture previously authorized payment (you have up-to 7 days to do that, passed this delay you may loose anti-fraud warranty, contact your Paybox provider to gather appropriate usage informations).

The simplest code could look like this:

For setPayboxCallNumber and setPayboxTransactionNumber you should use values you received in handling Handling transaction verify route step so you should probably save them in this step to use them here.

Licence

This package is licenced under the MIT license


All versions of laravel-paybox-gateway with dependencies

PHP Build Version
Package Version
Requires php Version >=5.5
laravel/framework Version >=5.5
lib-openssl Version *
guzzlehttp/guzzle Version >=5.3
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package bnbwebexpertise/laravel-paybox-gateway contains the following files

Loading the files please wait ....