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
• Installation
  • Register the Service Provider
  • Publish the Configuration
• ⚠ Configuration and Authorization Note
• API

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! 👷‍♂️📘