pinvandaag/tms-ccv-api-php

A PHP wrapper for the CCV - Estate Management - Terminal Management API

v0.0.1 2026-06-12 14:14 UTC

Requires

• php: ^8.2
• ext-dom: *
• guzzlehttp/guzzle: ^7.7
• phpdocumentor/reflection-docblock: ^5.3
• psr/log: ^3.0
• symfony/property-access: ^6.3|^7
• symfony/serializer: ^6.3|^7

Requires (Dev)

• phpstan/phpstan: ^2.1
• phpunit/phpunit: ^11
• squizlabs/php_codesniffer: ^3.7
• vimeo/psalm: ^6

MIT

• PIN Vandaag B.V.

README

A PHP Wrapper for the CCV - Estate Management - Terminal Management

Installation

composer require pinvandaag/tms-ccv-api-php

Small usage example

<?php

use Dotenv\Dotenv;
use PinVandaag\BuckarooAPI\TmsCcvAPIClient;

final class BuckarooController
{
    private TmsCcvAPIClient $apiClient;

    public function __construct()
    {
        $dotenv = Dotenv::createImmutable(__DIR__ . "/../../../../");
        $dotenv->safeLoad();
        $dotenv->required(['TMS_CCV_API_KEY'])->notEmpty();

        $this->apiClient = (new TmsCcvAPIClient())
            ->configure(
                apiKey: $_ENV['TMS_CCV_API_KEY'],
                baseUri: 'https://tms-demo-ccvdev.eu/api'
            );
    }

    public function getTerminal()
    {
        $tmsGateway = $_GET['tmsGateway'] ?? null;

        if ($tmsGateway === null || $tmsGateway === '') {
            throw new \RuntimeException('Missing tmsGateway.');
        }

        $terminalId = $_GET['terminalId'] ?? null;

        if ($terminalId === null || $terminalId === '') {
            throw new \RuntimeException('Missing terminalId.');
        }

        $result = $this->apiClient->getTerminal(
            tmsGateway: $tmsGateway,
            terminalId: $terminalId
        );

        $this->jsonResponse([
            'data' => $result,
        ]);
    }
}