e2k/payment-bundle

Symfony payment gateway abstraction bundle (CentralBill, extensible).

1.0.2 2026-08-11 06:46 UTC

Requires

• php: >=8.2
• psr/log: ^3.0
• symfony/config: ^6.4 || ^7.4
• symfony/dependency-injection: ^6.4 || ^7.4
• symfony/http-foundation: ^6.4 || ^7.4
• symfony/http-kernel: ^6.4 || ^7.4

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3.95
• phpstan/phpstan: ^2.2
• phpunit/phpunit: ^11.0
• symfony/framework-bundle: ^6.4 || ^7.4
• symfony/phpunit-bridge: ^7.4
• symfony/translation: ^8.1

MIT

• Ernest KOUASSI

• symfony
• payment
• bundle
• gateway
• centralbill

Published on Packagist.org on 2026-08-11 06:47 UTC

README

Symfony bundle for payment gateway abstraction. Natively supports CentralBill and extends its functionality by implementing an interface.

Installation

Via Composer (with Symfony Flex)

composer require e2k/payment-bundle

Sans Symfony Flex

composer require e2k/payment-bundle

Save the bundle manually:

// config/bundles.php
return [
    E2K\PaymentBundle\E2KPaymentBundle::class => ['all' => true],
];

Configuration

Create the configuration file:

# config/packages/e2k_payment.yaml
e2k_payment:
    default_gateway: '%env(PAYMENT_DEFAULT_GATEWAY)%'
    payment_route_prefix: '%env(PAYMENT_ROUTE_PREFIX)%'
    gateways:
        centralbill:
            enabled:            true
            application_id:     '%env(CENTRALBILL_APPLICATION_ID)%'
            application_secret: '%env(CENTRALBILL_APPLICATION_SECRET)%'
            web_pay_base_url:   '%env(CENTRALBILL_WEB_PAY_BASE_URL)%'
            callback_url:       '%env(CENTRALBILL_CALLBACK_URL)%'
            redirect_url:       '%env(CENTRALBILL_REDIRECT_URL)%'

Add the environment variables:

PAYMENT_DEFAULT_GATEWAY=centralbill
PAYMENT_ROUTE_PREFIX=/payments

CENTRALBILL_APPLICATION_ID=your-app-id
CENTRALBILL_APPLICATION_SECRET=your-secret
CENTRALBILL_WEB_PAY_BASE_URL=https://your-app.com/payment/webpay
CENTRALBILL_CALLBACK_URL=https://your-app.com/payment/callback/centralbill
CENTRALBILL_REDIRECT_URL=https://your-app.com/payment/return

Documentation

See docs/index.md.

Licence

MIT