Ssentezo Developers
Sandbox and production use the same API host. The organization status, SANDBOX or LIVE, is the environment. This portal does not simulate a successful payment when a call fails.

Framework ยท PHP

Laravel Beta

Laravel package with a facade, callback route, Artisan commands, and status-API confirmation.

Version0.1.0
CompatibilityLaravel 10, 11, or 12. PHP 8.2+. Tested on Laravel 11.
InstallComposer path repository to integrations/laravel-ssentezo and integrations/php-sdk. Not on Packagist.
Sourceintegrations/laravel-ssentezo
LicenseMIT
SandboxSandbox is the organization status on the wallet. In sandbox mode the package refuses the production host, requires sandbox_host_verified, and accepts only 256770000001 to 256770000004. Live mode requires allow_live_payments.

Supported in this version

  • Ssentezo facade for every route
  • PaymentFlow bound in the container
  • CSRF-free callback route
  • PaymentChecked event
  • ssentezo:check and ssentezo:confirm commands
  • Sandbox and live safeguards

Install

  1. Add Composer path repositories for integrations/php-sdk and integrations/laravel-ssentezo, then composer require ssentezo/laravel-wallet:@dev.
  2. Set SSENTEZO_API_USER, SSENTEZO_API_KEY, SSENTEZO_BASE_URL, and SSENTEZO_ORDER_STORE. Run php artisan ssentezo:check.
  3. Implement Ssentezo\Wallet\OrderStore for your orders and call PaymentFlow::start() from checkout.
  4. Schedule php artisan ssentezo:confirm for orders that stay pending.

Checkout

POST /ssentezo/callback uses the unsigned body only for the reference, then calls POST /api/get_status/{externalReference}. Your OrderStore is marked paid only for SUCCEEDED with the same reference, amount, and UGX.