Be2Bill Offsite

In this chapter we are going to talk about the most common task: purchase of a product using be2bill. We assume you already read basic get it started. Here we just show you modifications you have to put to the files shown there.


The preferred way to install the library is using composer. Run composer require to add dependencies to composer.json:

php composer.phar require payum/be2bill php-http/guzzle7-adapter


Use this when you need a redirect to be2bill site. We have to only add the gateway factory. All the rest remain the same:


use Payum\Core\PayumBuilder;
use Payum\Core\Payum;

/** @var Payum $payum */
$payum = (new PayumBuilder())
    ->addGateway('be2bill_offsite', [
        'factory' => 'be2bill_offsite',
        'identifier' => 'REPLACE WITH YOURS',
        'password' => 'REPLACE WITH YOURS',
        'sandbox' => true,


You have to also go to be2bill admin panel and configure return and notification urls. The urls you can generate with these code:


include __DIR__.'/config.php';

use Payum\Core\Payum;

/** @var Payum $payum */

$captureToken = $payum->getTokenFactory()->createCaptureToken(
    ['noinvalidate' => 1], 

echo 'Capture url: ', $captureToken->getTargetUrl(), PHP_EOL;

$notifyToken = $payum->getTokenFactory()->createNotifyToken('be2bill_offsite', null);
echo 'Notify url: ', $notifyToken->getTargetUrl(), PHP_EOL;

Note: This step could be skipped if you are not using be2bill offsite.


Here you have to modify a gatewayName value. Set it to be2bill or be2bill_offsite. The rest remain the same as described in basic get it started documentation.

Supporting Payum

Payum is an MIT-licensed open source project with its ongoing development made possible entirely by the support of community and our customers. If you'd like to join them, please consider:

Last updated