sloukapetr/moneta-laravel-package

Lightweight Laravel package for Moneta Money Bank VIP REST API integration.

1.1.0 2026-08-11 04:52 UTC

Requires

• php: ^8.2
• illuminate/events: ^11.0|^12.0|^13.0
• illuminate/http: ^11.0|^12.0|^13.0
• illuminate/routing: ^11.0|^12.0|^13.0
• illuminate/support: ^11.0|^12.0|^13.0

Requires (Dev)

• orchestra/testbench: ^9.0|^10.0|^11.0
• pestphp/pest: ^2.0|^3.0

MIT

Published on Packagist.org on 2026-08-11 04:53 UTC

README

Lightweight Laravel package for Moneta Money Bank VIP REST API integration.

Installation

composer require sloukapetr/moneta-laravel-package

Publish the package configuration file:

php artisan vendor:publish --tag=moneta-config

This creates config/moneta.php.

Environment Variables

Use this complete .env block:

MONETA_BASE_URL=https://api.moneta.cz

# Static bearer token mode
MONETA_API_TOKEN=

# OAuth client credentials mode
MONETA_CLIENT_ID=
MONETA_CLIENT_SECRET=
MONETA_OAUTH_SCOPE=
MONETA_OAUTH_TOKEN_URL=https://api.moneta.cz/auth/oauth/v2/token

# Optional context headers
MONETA_IDENTIFICATION_NUMBER=
MONETA_BUSINESS_NAME=
MONETA_APPLICATION_NAME=Laravel Package

# Optional flag
MONETA_SANDBOX=true

If MONETA_OAUTH_SCOPE is empty, the package uses vip_sandbox automatically when MONETA_SANDBOX=true.

Configuration

Default config keys in config/moneta.php:

return [
    'sandbox' => env('MONETA_SANDBOX', true),
    'api_token' => env('MONETA_API_TOKEN'),
    'client_id' => env('MONETA_CLIENT_ID'),
    'client_secret' => env('MONETA_CLIENT_SECRET'),
    'oauth_scope' => env('MONETA_OAUTH_SCOPE'),
    'oauth_token_url' => env('MONETA_OAUTH_TOKEN_URL', 'https://api.moneta.cz/auth/oauth/v2/token'),
    'application_name' => env('MONETA_APPLICATION_NAME', 'Laravel Package'),
    'identification_number' => env('MONETA_IDENTIFICATION_NUMBER'),
    'business_name' => env('MONETA_BUSINESS_NAME'),
    'base_url' => env('MONETA_BASE_URL', 'https://api.moneta.cz'),
    'timeout' => 15,
    'retry' => 3,
];

Usage

use SloukaPetr\Moneta\Facades\Moneta;

$accounts = Moneta::accounts()->all();
$balance = Moneta::accounts()->getBalance($accountId);
$transactions = Moneta::transactions()->get($accountId);
$statements = Moneta::statements()->list($accountId);

Authentication

Option 1: Static Token

Set MONETA_API_TOKEN and call the API directly:

$accounts = Moneta::accounts()->all();

Option 2: OAuth Client Credentials

Use MONETA_CLIENT_ID and MONETA_CLIENT_SECRET and let the package request a token:

$accounts = Moneta::withClientCredentials()->accounts()->all();

You can also override credentials at runtime:

$accounts = Moneta::withContext([
    'client_id' => 'your-client-id',
    'client_secret' => 'your-client-secret',
    'oauth_scope' => 'vip_sandbox',
])->withClientCredentials()->accounts()->all();

Sandbox Notes

• Sandbox returns predefined mock data.
• Most parameters are not validated the same way as in production.
• /api/v4/vip/aisp/my/accounts/statement returns XML in sandbox mode.

Statement Download Flow

1. List available statements:

$statements = Moneta::statements()->list($accountId, ['from' => '2026-01-01', 'to' => '2026-01-31']);

1. Download statement data (JSON or file metadata):

$download = Moneta::statements()->download($accountId, $statementId, 'JSON');

1. For file formats, get URL and download file content:

$url = Moneta::statements()->downloadUrl($accountId, $statementId, 'PDF');
$file = Moneta::statements()->downloadFile($fileId);

Testing

php vendor/bin/pest