README

An unofficial package for Stanbic bank; following the ISO20022 standard.

Installation

You can install the package via composer:

composer require akika/laravel-stanbic

Optional Steps

You can skip thse optional steps.

In your .env, configure which filesystem disk we will read and write the payment files to. This is already preconfigured to pick the sftp disk.

STANBIC_FILESYSTEM_DISK=sftp

You can publish the config file with:

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

Usage

Credit Transfer Initiation with Pain00100103

This package provides a Laravel implementation for generating ISO 20022 PAIN.001.001.03 XML messages for credit transfers.

Basic Usage

use Akika\LaravelStanbic\Data\AggregateRoots\Pain00100103;
use Akika\LaravelStanbic\Data\ValueObjects\GroupHeader;
use Akika\LaravelStanbic\Data\ValueObjects\PaymentInfo;
use Akika\LaravelStanbic\Data\ValueObjects\CreditTransferTransactionInfo;

// 1. Create group header
$groupHeader = GroupHeader::make()
    ->setMessageId('unique-message-id')
    ->setCreationDate(now())
    ->setNumberOfTransactions(1)
    ->setControlSum(1000.00)
    ->setInitiatingParty('Your Company Name', 'Optional description');

// 2. Create transaction info
$transactionInfo = CreditTransferTransactionInfo::make()
    ->setPaymentId('payment-id', 'instruction-id')
    ->setAmount(1000.00, Currency::Rand)
    ->setChargeBearer(ChargeBearerType::Debt)
    ->setCreditorAgent('bank-code', 'STANDARD BANK SA', new PostalAddress(countryCode: CountryCode::SouthAfrica))
    ->setCreditor('Beneficiary Name', new PostalAddress(streetName: 'Street Name', countryCode: CountryCode::SouthAfrica))
    ->setCreditorAccount('beneficiary-account-number')
    ->setRemittanceInfo('Payment description');

// 3. Create payment info
$paymentInfo = PaymentInfo::make()
    ->setPaymentInfoId('payment-info-id')
    ->setBatchBooking(true)
    ->setPaymentTypeInfo(InstructionPriority::Norm, 63)
    ->setRequestedExecutionDate(now())
    ->setDebtor('Your Company Name')
    ->setDebtorAccount('your-account-number', Currency::Rand)
    ->setCreditTransferTransactionInfo($transactionInfo);

// 4. Generate and store XML
$filePath = Pain00100103::make()
    ->setGroupHeader($groupHeader)
    ->setPaymentInfo($paymentInfo)
    ->store(); // Returns the stored file path

• The generated XML files follow the ISO 20022 PAIN.001.001.03 standard and are automatically stored with unique filenames.
• Stanbic bank will pick the generated file from the configured stanbic.disk filesystem disk.

Reading Stanbic Status Reports

This package provides automated reading of Stanbic bank status reports (PAIN.002.001.03) from your configured storage disk.

Manual Execution

The command automatically scans for XML files containing pain.002.001.03 in the configured disk and processes each one by dispatching the event.

php artisan stanbic:read

Scheduled Execution

For Laravel 11 and above, add the command to your routes/console.php.

// Run every 15 minutes
Schedule::command('stanbic:read')->everyFifteenMinutes();

// Or run hourly
Schedule::command('stanbic:read')->hourly();

// ...etc

For Laravel 10 and below, add the command to your app/Console/Kernel.php schedule:

// Run every 15 minutes
$schedule->command('stanbic:read')->everyFifteenMinutes();

// Or run hourly
$schedule->command('stanbic:read')->hourly();

// ...etc

Event Handling

The command dispatches a Pain00200103ReportReceived event for each status report found. Hook into this event to process the reports:

Create an Event Listener

php artisan make:listener ProcessStatusReport

Register the Listener

For Laravel 11 and above, In your AppServiceProvider.php's boot method:

Event::listen(Pain00200103ReportReceived::class, ProcessStatusReport::class);

For Laravel 10 and below, In your app/Providers/EventServiceProvider.php:

use Akika\LaravelStanbic\Events\Pain00200103ReportReceived;
use App\Listeners\ProcessStatusReport;

protected $listen = [
    Pain00200103ReportReceived::class => [
        ProcessStatusReport::class,
    ],
];

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

• Akika Digital
• All Contributors

License

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