movemoveapp / laravel-vendista
A Laravel SDK for integrating with Vendista, an acquiring system that provides payment terminals for vending machines. This package allows you to easily connect your Laravel-based applications to the Vendista API to manage vending transactions, monitor terminal statuses, and process payments.
Requires
- php: ^8.0|^8.1|^8.2|^8.3|^8.4
- ext-json: *
- guzzlehttp/guzzle: ^7.5.1
- guzzlehttp/psr7: ^2.5
This package is auto-updated.
Last update: 2025-05-24 13:48:17 UTC
README
A Laravel SDK for integrating with Vendista, an acquiring system that provides payment terminals for vending machines.
This package allows you to easily connect your Laravel-based applications to the Vendista API to manage vending transactions, monitor terminal statuses, and process payments.
Features
- Secure integration with Vendista payment terminals
- API client for real-time transaction handling
- Terminal status and health monitoring
- Laravel 10, 11, and 12 compatible
- Well-structured and extendable codebase
Use Cases
- Smart vending machines
- Self-service kiosks
- Automated retail systems
Installation
Install the package via Composer:
composer require movemoveapp/laravel-vendista
Register the Service Provider
After installing the package, you need to register the Vendista service provider.
Up to and including Laravel 10, add the following line to the providers array in your config/app.php file:
... 'providers' => [ ... MoveMoveApp\Vendista\VendistaServiceProvider::class, ... ]
From Laravel versions 11 and above, you may edit bootstrap/providers.php file:
<?php return [ ... MoveMoveApp\Vendista\VendistaServiceProvider::class, ];
Publish the Configuration
After installation, publish the configuration file to set up the package with Laravel:
php artisan vendor:publish --provider='MoveMoveApp\Vendista\VendistaServiceProvider'
⚠️ Configuration and Authorization Note
At the moment, Vendista does not support generating API keys manually. Instead, you must call a specific authentication method via their API to obtain a valid access token. The documentation for this process can be found here.
We, the MoveMove Outsource Team, are currently in discussions with Vendista to improve this flow and support proper API key generation in the future.
Once the configuration file is published, you can set up your Vendista credentials in your .env file. Obtain your API key and secret key from the Vendista dashboard and set them as follows:
... VENDISTA_USERNAME=your_vendista_username VENDISTA_PASSWORD=your_vendista_password
These keys will allow your application to authenticate requests to the Vendista API.
API
This section is currently under development. We’re actively working on providing full API usage examples and detailed documentation.
Stay tuned! 👷♂️📘