PHPackages                             virementmaitrise/virementmaitrise-sdk-php - 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. [Payment Processing](/categories/payments)
4. /
5. virementmaitrise/virementmaitrise-sdk-php

ActiveLibrary[Payment Processing](/categories/payments)

virementmaitrise/virementmaitrise-sdk-php
=========================================

PHP library for the Virement Maîtrisé API.

2.6.1(7mo ago)0722MITPHPPHP >=7.2

Since Oct 14Pushed 7mo agoCompare

[ Source](https://github.com/virementmaitrise/virementmaitrise-sdk-php)[ Packagist](https://packagist.org/packages/virementmaitrise/virementmaitrise-sdk-php)[ Docs](https://github.com/virementmaitrise/virementmaitrise-sdk-php)[ RSS](/packages/virementmaitrise-virementmaitrise-sdk-php/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (1)Dependencies (10)Versions (2)Used By (2)

PHP library for the Virement Maîtrisé API.
==========================================

[](#php-library-for-the-virement-maîtrisé-api)

[![Latest Stable Version](https://camo.githubusercontent.com/64b47e36ea8f9432f453b63ff12b4793a194b294e8e8fc2ec338779bd63e0f71/687474703a2f2f706f7365722e707567782e6f72672f766972656d656e746d616974726973652f766972656d656e746d616974726973652d73646b2d7068702f76)](https://packagist.org/packages/virementmaitrise/virementmaitrise-sdk-php) [![Total Downloads](https://camo.githubusercontent.com/e69a116cd10316a454c4d8c01484db91e6cbc51ca4900941f4a5f7f07105ef99/687474703a2f2f706f7365722e707567782e6f72672f766972656d656e746d616974726973652f766972656d656e746d616974726973652d73646b2d7068702f646f776e6c6f616473)](https://packagist.org/packages/virementmaitrise/virementmaitrise-sdk-php) [![Monthly Downloads](https://camo.githubusercontent.com/12484dfa366195400ba9acc86a7cf7d13dde0892d0b7d484706223c9967aea1b/687474703a2f2f706f7365722e707567782e6f72672f766972656d656e746d616974726973652f766972656d656e746d616974726973652d73646b2d7068702f642f6d6f6e74686c79)](https://packagist.org/packages/virementmaitrise/virementmaitrise-sdk-php) [![Latest Unstable Version](https://camo.githubusercontent.com/cd0dd23a4174415a67b5571cc7884a6a0a2b19e098d047bdc8bd930576d7e4c3/687474703a2f2f706f7365722e707567782e6f72672f766972656d656e746d616974726973652f766972656d656e746d616974726973652d73646b2d7068702f762f756e737461626c65)](https://packagist.org/packages/virementmaitrise/virementmaitrise-sdk-php) [![License](https://camo.githubusercontent.com/70db639356f457ef88001fb9abf6f28d58ef461cf6ed4b9194194b38017d16c3/687474703a2f2f706f7365722e707567782e6f72672f766972656d656e746d616974726973652f766972656d656e746d616974726973652d73646b2d7068702f6c6963656e7365)](https://packagist.org/packages/virementmaitrise/virementmaitrise-sdk-php)

Virement Maîtrisé is providing a payment solution via bank transfer. Find more at .

This library is a PHP Client for the Virement Maîtrisé API.

Requirements
------------

[](#requirements)

- PHP >= 7.2

Quick install
-------------

[](#quick-install)

Via [Composer](https://getcomposer.org), with our Packagist package [virementmaitrise/virementmaitrise-sdk-php](https://packagist.org/packages/virementmaitrise/virementmaitrise-sdk-php).

This command will get you up and running quickly with a Guzzle HTTP client (v7).

```
composer require virementmaitrise/virementmaitrise-sdk-php guzzlehttp/guzzle
```

The Guzzle client will automatically be found with the help of `php-http/discovery` package. If you prefer to specify a custom HTTP client to use, please read the [Advanced usage](#advanced-usage) section.

Getting started
---------------

[](#getting-started)

Simple usage looks like:

```
require_once('vendor/autoload.php');

$state = ''; // it's my transaction ID, I have to generate it myself, it will be sent back in the callback
$pisClient = new \Fintecture\PisClient([
    'appId' => 'app_id',
    'appSecret' => 'app_secret',
    'privateKey' => 'private_key', // could be a file path or the private key itself
    'environment' => 'sandbox' // or 'production'
]);

$pisToken = $pisClient->token->generate();
if (!$pisToken->error) {
    $pisClient->setAccessToken($pisToken); // set token of PIS client
} else {
    echo $pisToken->errorMsg;
}

$payload = [
    'meta' => [
        // Info of the buyer
        'psu_name' => 'M. John Doe',
        'psu_email' => 'john@doe.com',
        'psu_address' => [
            'street' => '5 Void Street',
            'zip' => '12345',
            'city' => 'Gotham',
            'country' => 'FR'
        ]
    ],
    'data' => [
        'type' => 'SEPA',
        'attributes' => [
            'amount' => '550.60',
            'currency' => 'EUR',
            'communication' => 'Commande N°15654'
        ]
    ]
];

$connect = $pisClient->connect->generate($payload, $state);
if (!$connect->error) {
    $pisClient->redirect($connect->meta->url);
} else {
    echo $connect->errorMsg;
}
```

### Available options of Client

[](#available-options-of-client)

- 'appId' => 'app\_id',
- 'appSecret' => 'app\_secret',
- 'privateKey' => 'private\_key', // could be a file path or the private key itself
- 'environment' => 'sandbox' // or 'production'
- 'shopName' => 'My super shop', // don't forget to give your client a nice name (even if it's optional)

### Examples

[](#examples)

Some examples (including webhook handling) are available in the [*examples* folder](examples/).

Advanced usage
--------------

[](#advanced-usage)

We are decoupled from any HTTP messaging client with help by [HTTPlug](https://httplug.io). A list of community provided clients is found here:

### Using a different HTTP client

[](#using-a-different-http-client)

```
composer require virementmaitrise/virementmaitrise-sdk-php symfony/http-client nyholm/psr7
```

To set up the Virement Maîtrisé client with this HTTP client

```
use Fintecture\PisClient;
use Symfony\Component\HttpClient\Psr18Client;

$pisClient = new PisClient([$config], new Psr18Client());
```

Available methods
-----------------

[](#available-methods)

These methods follow our [API structure](https://docs.virementmaitrise.societegenerale.eu/v2).

### Auth

[](#auth)

- token
    - generate
    - refresh

### AIS

[](#ais)

- account
    - get
- accountHolder
    - get
- authorize
    - generate
    - generateDecoupled
- connect
    - generate
- customer
    - delete
- transaction
    - get

### Customers

[](#customers)

- customers
    - generate
    - get
- customerBankAccount
    - get
    - generate

### PIS

[](#pis)

- assessment
    - get
- connect
    - generate
- initiate
    - generate
- payment
    - get
- refund
    - generate
- requestForPayout
    - generate
- requestToPay
    - generate
- settlement
    - get

### Resources

[](#resources)

- application
    - get
- functionality
    - get
- provider
    - get
- testAccount
    - get

Development
-----------

[](#development)

### Requirements

[](#requirements-1)

- PHP
- Git
- Composer
- Make
- Xdebug (for test coverage)

### Initialize project for development

[](#initialize-project-for-development)

```
make init
```

### PHPUnit (Unit Tests)

[](#phpunit-unit-tests)

Then you can run the tests:

```
make test
```

To generate the test coverage report, you can run this command:

```
make test-coverage
```

### PHPStan (Static Analysis)

[](#phpstan-static-analysis)

There are 10 levels (0-9). Level is set in `phpstan.neon`.

```
make analyse
```

### PHP CS Fixer (Coding Standards)

[](#php-cs-fixer-coding-standards)

```
make format
```

Troubleshooting
---------------

[](#troubleshooting)

Encountering an issue? Please contact our support (where you purchased your license).

License
-------

[](#license)

Virement Maîtrisé PHP API Client is an open-sourced software licensed under the [MIT license](LICENSE).

###  Health Score

30

—

LowBetter than 64% of packages

Maintenance65

Regular maintenance activity

Popularity11

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity30

Early-stage or recently created project

 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

Unknown

Total

1

Last Release

210d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/fa070040eb34fd8728e542daa8c6d4499d817b94df057734020f551818bee8aa?d=identicon)[virementmaitrise](/maintainers/virementmaitrise)

---

Top Contributors

[![QuentinFintecture](https://avatars.githubusercontent.com/u/122442213?v=4)](https://github.com/QuentinFintecture "QuentinFintecture (2 commits)")

---

Tags

paymentBankfintecture

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Type Coverage Yes

### Embed Badge

![Health badge](/badges/virementmaitrise-virementmaitrise-sdk-php/health.svg)

```
[![Health](https://phpackages.com/badges/virementmaitrise-virementmaitrise-sdk-php/health.svg)](https://phpackages.com/packages/virementmaitrise-virementmaitrise-sdk-php)
```

###  Alternatives

[omnipay/common

Common components for Omnipay payment processing library

35119.0M1.0k](/packages/omnipay-common)[opensearch-project/opensearch-php

PHP Client for OpenSearch

15024.3M65](/packages/opensearch-project-opensearch-php)[phpro/http-tools

HTTP tools for developing more consistent HTTP implementations.

28137.8k](/packages/phpro-http-tools)[shetabit/payment

Laravel Payment Gateway Integration Package

944330.1k5](/packages/shetabit-payment)[getbrevo/brevo-php

Official Brevo provided RESTFul API V3 php library

963.1M35](/packages/getbrevo-brevo-php)[swisnl/json-api-client

A PHP package for mapping remote JSON:API resources to Eloquent like models and collections.

211473.2k12](/packages/swisnl-json-api-client)

PHPackages © 2026

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