korozcolt / payments-codeigniter4

v1.0.1 2026-10-02 01:37 UTC

Requires

• php: ^8.2
• ext-pdo: *
• codeigniter4/framework: ^4.5
• guzzlehttp/guzzle: ^7.5
• korozcolt/payments-core: ^1.0

Requires (Dev)

• pestphp/pest: ^2.0|^3.0

MIT

• payments
• mercadopago
• colombia
• epayco
• codeigniter4
• Wompi

Published on Packagist.org on 2026-10-02 01:39 UTC

README

CodeIgniter 4 adapter for korozcolt/payments-core: Wompi, MercadoPago and ePayco with one API. Install, migrate, configure through .env. Everything else is auto-discovered by CodeIgniter.

Verified against a fresh codeigniter4/appstarter (v4.7): migration, route, Spark command, service('payments'), signed webhook over HTTP and Events::on() listeners.

Part of the korozcolt/payments ecosystem

The gateway logic (Wompi, MercadoPago, ePayco) is written once, in payments-core, and each framework gets a thin adapter. Install the adapter for your framework; Composer pulls the core in.

Package	What it is
payments	Laravel adapter (also the monorepo)
payments-core	Framework-agnostic core: drivers, manager, webhooks
payments-codeigniter4 (this package)	CodeIgniter 4 adapter
payments-slim	Slim 4 / PSR-15 adapter
payments-symfony	Symfony bundle

Why it is split this way, how the pieces relate and what is on the roadmap: ecosystem guide.

Install

composer require korozcolt/payments-codeigniter4
php spark migrate -n "Korbytes\Payments\CodeIgniter"

The tables are created in the database group named by payments.dbGroup (default default). MySQLi, Postgre and SQLite3 are supported.

Configure (.env)

payments.default = wompi
payments.urls.return = https://shop.example/payments/return

payments.drivers.wompi.sandbox = true
payments.drivers.wompi.public_key = pub_test_xxx
payments.drivers.wompi.private_key = prv_test_xxx
payments.drivers.wompi.integrity_secret = test_integrity_xxx
payments.drivers.wompi.events_secret = test_events_xxx

MercadoPago: payments.drivers.mercadopago.access_token, .public_key, .webhook_secret. ePayco: payments.drivers.epayco.public_key, .private_key, .p_cust_id_cliente, .p_key.

For anything beyond .env, copy src/Config/Payments.php to app/Config/Payments.php and extend it.

Charge

use Korbytes\Payments\DTOs\PaymentData;

$charge = service('payments')->driver('wompi')->charge(new PaymentData(
    referenceId: 'ORDER-1001',
    amount: 5000000,            // in cents
    customer: ['email' => '[e-mail]'],
));
// $charge->reference, $charge->signature, $charge->widgetUrl ... feed the provider's checkout widget

Webhooks

POST /payments/webhooks/{provider} is registered automatically (payments.registerRoutes, payments.webhookPrefix). Point the provider's dashboard at it.

Exclude it from CSRF protection in app/Config/Filters.php: public array $globals = ['before' => ['csrf' => ['except' => ['payments/webhooks/*']]]];

It answers exactly like the Laravel, Slim and Symfony adapters: 400 unknown/unavailable provider, 401 bad signature, 200 processed (also 200 + success:false for known failures so providers do not retry), 500 unexpected error.

Events

// app/Config/Events.php
use CodeIgniter\Events\Events;

Events::on('payments.approved', static function (\Korbytes\Payments\Core\Events\PaymentApproved $event) {
    // $event->transaction->reference_id, $event->webhookResult ...
});

Names: payments.created, payments.approved, payments.rejected, payments.refunded, payments.webhook_received, payments.subscription_created, payments.subscription_cancelled, payments.subscription_charge_succeeded, payments.subscription_charge_failed.

Subscriptions (Wompi)

Wompi has no recurring-billing engine, so charge due cycles from cron:

0 * * * * cd /path/to/app && php spark payments:process-subscriptions

Notes

• The package opens its own PDO connection from your CodeIgniter database group (same database, no table prefix support).
• HTTP uses Guzzle (PSR-18) with a 30 s timeout.
• Logging goes through CodeIgniter's PSR-3 logger (service('logger')).