PHPackages                             friends-of-vertex-cards/api-client - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. friends-of-vertex-cards/api-client

ActiveLibrary[API Development](/categories/api)

friends-of-vertex-cards/api-client
==================================

PHP library for Vertex Cards API interaction

v0.7(6mo ago)025MITPHPPHP >=8.3CI passing

Since Oct 12Pushed 6mo agoCompare

[ Source](https://github.com/friends-of-vertex-cards/api-client)[ Packagist](https://packagist.org/packages/friends-of-vertex-cards/api-client)[ RSS](/packages/friends-of-vertex-cards-api-client/feed)WikiDiscussions main Synced today

READMEChangelog (7)Dependencies (11)Versions (9)Used By (0)

Vertex Cards API Client
=======================

[](#vertex-cards-api-client)

PHP library for Vertex Cards API interaction

Supported PHP Versions
----------------------

[](#supported-php-versions)

- PHP 8.3+

Documentation
-------------

[](#documentation)

### 1. Installation

[](#1-installation)

The Vertex Cards API Client can be installed using Composer by running the following command:

```
composer require friends-of-vertex-cards/api-client
```

### 2. Getting API token

[](#2-getting-api-token)

The library provides authorization flows for users based on a custom header.

Proceed to [documentation](https://developers.vertex-cards.com/docs/common/getting-started) to obtain your Live API Key and Company Uuid.

### 3. Client Initialization

[](#3-client-initialization)

Create ApiClient object using the following code:

```
$apiKey = 'your-api-key'; // step 2. Getting API token
$factory = new \FriendsOfVertexCards\ApiClient\VertexCardsClientFactory(
            new \Http\Adapter\Guzzle7\Client(),
            new \Symfony\Component\Serializer\Serializer(),
            'https://gateway.vertex-cards.com',
            '/api/v1/cards',
            new \Psr\Log\NullLogger(),
);

$client = $factory->create(new ConfigureDto($apiKey));
```

Also you can implement your own factory by implementing `\FriendsOfVertexCards\ApiClient\VertexCardsClientFactoryInterface`

4. API Requests
---------------

[](#4-api-requests)

You can find the full list of API methods [here](https://developers.vertex-cards.com/docs/api-reference).

### 4.1 Request Sample

[](#41-request-sample)

Example of getting accounts:

```
$companyUuid = Ramsey\Uuid\Uuid::fromString('your-company-uuid') // step 2. Getting API token
$apiKey = 'your-api-key'; // step 2. Getting API token
/** @var \FriendsOfVertexCards\ApiClient\VertexCardsClientInterface $client */
$client = $factory->create(new ConfigureDto($apiKey)); // step 3. Client Initialization

/** @var \FriendsOfVertexCards\ApiClient\Account\List\GetListAccountResponse $accounts */
$accounts = $client->getAccounts(new \FriendsOfVertexCards\ApiClient\Account\List\GetListAccountRequest($companyUuid, 1, 10));
```

5. Use cases
------------

[](#5-use-cases)

- [Init top up](examples/topup-account.php)
- [Create card](examples/create-card.php)
- [Get card credentials](examples/get-card-credentials.php)
- [Top up card balance](examples/top-up-card.php)
- [Withdraw card balance](examples/withdraw-card-balance.php)

###  Health Score

33

—

LowBetter than 72% of packages

Maintenance67

Regular maintenance activity

Popularity6

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity46

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~11 days

Total

7

Last Release

195d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/f70b61d6ade535dd3a573fb534ad8583f6a73d2b4deee347e933fc51c5831fca?d=identicon)[Friends of Vertex Cards](/maintainers/Friends%20of%20Vertex%20Cards)

---

Top Contributors

[![friends-of-vertex-cards](https://avatars.githubusercontent.com/u/237273036?v=4)](https://github.com/friends-of-vertex-cards "friends-of-vertex-cards (12 commits)")

###  Code Quality

TestsPHPUnit

Code StylePHP CS Fixer

### Embed Badge

![Health badge](/badges/friends-of-vertex-cards-api-client/health.svg)

```
[![Health](https://phpackages.com/badges/friends-of-vertex-cards-api-client/health.svg)](https://phpackages.com/packages/friends-of-vertex-cards-api-client)
```

###  Alternatives

[sylius/sylius

E-Commerce platform for PHP, based on Symfony framework.

8.5k5.9M738](/packages/sylius-sylius)[shopware/core

Shopware platform is the core for all Shopware ecommerce products.

585.6M574](/packages/shopware-core)[shopware/platform

The Shopware e-commerce core

3.4k1.5M3](/packages/shopware-platform)[sulu/sulu

Core framework that implements the functionality of the Sulu content management system

1.3k1.4M203](/packages/sulu-sulu)[web-auth/webauthn-lib

FIDO2/Webauthn Support For PHP

12310.5M135](/packages/web-auth-webauthn-lib)[blackfire/player

A powerful web crawler and web scraper with Blackfire support

49617.1k](/packages/blackfire-player)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)