akira/laravel-sisp

this is a laravel package to handle SISP payment

v0.7.2 2026-06-04 02:02 UTC

Requires

• php: ^8.4 || ^8.5
• akira/laravel-pdf-invoices: ^1.8
• illuminate/contracts: ^12.0 || ^13.0
• pinkary-project/type-guard: ^0.1.0
• spatie/laravel-package-tools: ^1.16
• stevebauman/location: ^7.6

Requires (Dev)

• driftingly/rector-laravel: ^2.3
• inertiajs/inertia-laravel: ^3.1
• larastan/larastan: ^3.0
• laravel/pint: ^1.29
• nunomaduro/collision: ^8.1.1
• orchestra/testbench: ^10.0.0 || ^11.0.0
• peckphp/peck: ^0.1.3
• pestphp/pest: ^4.0
• pestphp/pest-plugin-arch: ^4.0
• pestphp/pest-plugin-laravel: ^4.0
• pestphp/pest-plugin-type-coverage: ^4.0
• phpstan/extension-installer: ^1.3
• phpstan/phpstan-deprecation-rules: ^2.0.0
• phpstan/phpstan-phpunit: ^2.0.0
• rector/rector: ^2.4

MIT

• Kidiatoliny

• laravel
• akira
• laravel-sisp

README

Laravel SISP is a Laravel package for SISP Cabo Verde payment flows, with transaction management, invoice generation, callback validation, sandbox tooling, and multi-merchant credential support.

Install

composer require akira/laravel-sisp
php artisan laravel-sisp:install

{
  "require": {
    "akira/laravel-sisp": "^0.7"
  }
}

Area	Included
Payments	Payment request building, SISP form rendering, callbacks, cancellation, retry, and refunds
Transactions	Eloquent models, audit logs, reconciliation, and status queries
Invoices	PDF invoice generation after approved payments
Security	Fingerprint validation, signed retry and cancellation requests, rate limits, metadata collection, and blacklist support
Frontend	Blade views and optional Inertia rendering

Quick Start

SISP_URL=https://mc.vinti4net.cv/Client_VbV_v2/biz_vbv_clientdata.jsp
SISP_POS_ID=your_pos_id
SISP_POS_AUT_CODE=your_authorization_code
SISP_MERCHANT_ID=your_merchant_id
SISP_SANDBOX=true

<form action="{{ route('sisp.payment') }}" method="POST">
    @csrf

    <input type="number" name="amount" required>
    <input type="text" name="items[0][product_name]" required>
    <input type="number" name="items[0][quantity]" required>
    <input type="number" name="items[0][unit_price]" required>
    <input type="number" name="items[0][total_price]" required>
    <input type="email" name="customer_email">

    <button type="submit">Pay</button>
</form>

Use the facade when application code needs lower-level package operations:

use Akira\Sisp\Facades\Sisp;

$transaction = Sisp::reconcileTransactionStatus($transaction);
$countries = Sisp::countries();

Documentation

• Roadmap
• Installation
• Configuration
• Quick Start
• Payment Flow
• Transaction Management
• Invoice Generation
• Security
• Examples
• Troubleshooting
• FAQ
• API Reference

Reference documentation is maintained in this repository under docs.

Testing

composer test

Additional focused checks are available through Composer scripts:

composer test:coverage
composer test:type-coverage
composer test:types
composer test:lint

Changelog

See CHANGELOG.md for release history. Releases are generated with git-cliff.

Contributing

See CONTRIBUTING.md for local setup, test expectations, commit style, and pull request guidance.

Security

Report security issues through the process documented in SECURITY.md.

Credits

Laravel SISP is maintained by Kidiatoliny and the Akira team. Contributor recognition is managed through All Contributors.

License

Laravel SISP is dual-licensed under MIT or Apache-2.0. Unless you state otherwise, contributions are licensed under both licenses.