akira/laravel-sisp

this is a laravel package to handle SISP payment

1.x-dev 2025-06-23 23:40 UTC

Requires

• php: ^8.4
• illuminate/contracts: ^11.0||^12.0
• pinkary-project/type-guard: ^0.1.0
• spatie/laravel-package-tools: ^1.16

Requires (Dev)

• larastan/larastan: ^2.9||^3.0
• laravel/pint: ^1.14
• nunomaduro/collision: ^8.1.1||^7.10.0
• orchestra/testbench: ^10.0.0||^9.0.0||^8.22.0
• peckphp/peck: ^0.1.3
• pestphp/pest: ^3.0
• pestphp/pest-plugin-arch: ^3.0
• pestphp/pest-plugin-laravel: ^3.0
• pestphp/pest-plugin-type-coverage: ^3.5
• phpstan/extension-installer: ^1.3||^2.0
• phpstan/phpstan-deprecation-rules: ^1.1||^2.0
• phpstan/phpstan-phpunit: ^1.3||^2.0
• rector/rector: ^2.0
• spatie/laravel-ray: ^1.35

MIT

• Kidiatoliny

• laravel
• akira
• laravel-sisp

README

This package allows you to easily handle payments through the SISP Payment Gateway, enabling seamless payment processing within your application. Whether you’re building an e-commerce platform or handling subscription services, Laravel SISP is designed to simplify your payment workflows.

Requirements

• PHP 8.4 or higher
• Laravel 11 or higher

Installation

You can install the package via composer:

composer require akira/laravel-sisp

You can publish and run the migrations with:

php artisan laravel-sisp:install

You can publish the config file with:

php artisan vendor:publish --tag="laravel-sisp-config"

This is the contents of the published config file:

return [

    /*
    |--------------------------------------------------------------------------
    | SISP URL
    |--------------------------------------------------------------------------
    |
    | This is the URL of the SISP payment gateway.
    |
    */
    'url' => env('SISP_URL'),

    /*
    |--------------------------------------------------------------------------
    | Merchant Virtual POS Terminal Identification
    |--------------------------------------------------------------------------
    |
    | This identifier is generated by SISP and provided to the merchant.
    |
    */
    'posID' => env('SISP_POS_ID'),

    /*
    |--------------------------------------------------------------------------
    | Merchant Virtual POS Terminal Password
    |--------------------------------------------------------------------------
    |
    | This password is generated by SISP and provided to the merchant.
    |
    */
    'posAutCode' => env('SISP_POS_AUT_CODE'),

    /*
    |--------------------------------------------------------------------------
    | Currency Code for the Transaction
    |--------------------------------------------------------------------------
    |
    | This is a three-digit code as defined in ISO 4217.
    | Always should be '132' for Cape Verde Escudo (CVE).
    |
    */
    'currency' => env('SISP_CURRENCY', '132'),

    /*
    |--------------------------------------------------------------------------
    | Language for Transaction Response Messages
    |--------------------------------------------------------------------------
    |
    | This is a two-letter code as defined in ISO 639-1.
    | Default is 'en' for English. Other options include 'pt' for Portuguese.
    |
    */
    'languageMessages' => env('SISP_LANGUAGE_MESSAGES', 'en'),

    /*
    |--------------------------------------------------------------------------
    | Fingerprint Algorithm Version
    |--------------------------------------------------------------------------
    |
    | This is the version of the fingerprint algorithm.
    | Default is '1'.
    |
    */
    'fingerPrintVersion' => env('SISP_FINGERPRINT_VERSION', '1'),

    /*
    |--------------------------------------------------------------------------
    | URL for Merchant's Server Response
    |--------------------------------------------------------------------------
    |
    | This is the URL of the merchant's server where the merchant will receive
    | the response from SISP.
    |
    */
    'urlMerchantResponse' => config('app.url').'/sisp-payment-response',

    /*
    |--------------------------------------------------------------------------
    | 3D Secure Transaction Indicator
    |--------------------------------------------------------------------------
    |
    | Indicates whether the transaction is 3D Secure or not.
    | Default is '1' for 3D Secure.
    |
    */
    'is3DSec' => env('SISP_IS_3D_SEC', '1'),

    /*
    |--------------------------------------------------------------------------
    | Transaction Code
    |--------------------------------------------------------------------------
    |
    | Type of transaction being initiated.
    |
    */
    'transactionCode' => env('SISP_DEFAULT_TRANSACTION_CODE', '1'),

    /*
    |--------------------------------------------------------------------------
    | Merchant Identification
    |--------------------------------------------------------------------------
    |
    | This identifier is generated by SISP and provided to the merchant.
    |
    */
    'merchantId' => env('SISP_MERCHANT_ID'),

    /*
   |--------------------------------------------------------------------------
   | Transaction Table Name
   |--------------------------------------------------------------------------
   |
   | This is the name of the table where the transactions will be stored.
   |
   */
    'table_name' => 'sisp_transactions',
];

Documentation

You'll find installation instructions and full documentation on Akira Sisp website.

Testing

composer test

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

Credits

• Kidiatoliny
• All Contributors

License

The MIT License (MIT). Please see License File for more information.