---
title: "new VivaClient(...)"
method: POST
path: "/VivaClient/__construct"
tags: ["VivaClient"]
---

# new VivaClient(...)

`POST /VivaClient/__construct`

Instancie le client SDK. L'authentification OAuth2 est automatique au premier appel API.

```php
use QrCommunication\VivaMerchant\VivaClient;
use QrCommunication\VivaMerchant\Enums\Environment;

$viva = new VivaClient(
    merchantId: 'votre-merchant-uuid',
    apiKey: 'votre-api-key',
    clientId: 'xxx.apps.vivapayments.com',
    clientSecret: 'votre-client-secret',
    environment: 'demo', // string ou Environment enum
);
```

**Où trouver les identifiants ?**
- `merchantId` + `apiKey` → Viva Dashboard > Settings > API Access
- `clientId` + `clientSecret` → Viva Dashboard > Settings > API Access > OAuth Clients

## Request body

- VivaClientConstructorParams
  - `merchantId` string, uuid, required — Merchant UUID — Dashboard Viva > Settings > API Access
  - `apiKey` string, required — API Key — Dashboard Viva > Settings > API Access
  - `clientId` string, required — OAuth Client ID — format `xxx.apps.vivapayments.com`
  - `clientSecret` string, required — OAuth Client Secret
  - `environment` 'demo' | 'production' — Environnement (`'demo'` ou `'production'`, ou `Environment` enum)

## Response `200`

Instance `VivaClient` créée

- VivaClientInstance — Instance `VivaClient` avec les propriétés `readonly` suivantes :
  - `orders` string — `Orders` — `$viva->orders`
  - `transactions` string — `Transactions` — `$viva->transactions`
  - `sources` string — `Sources` — `$viva->sources`
  - `wallets` string — `Wallets` — `$viva->wallets`
  - `bankAccounts` string — `BankAccounts` — `$viva->bankAccounts`
  - `webhooks` string — `Webhooks` — `$viva->webhooks`
  - `account` string — `Account` — `$viva->account`
  - `nativeCheckout` string — `NativeCheckout` — `$viva->nativeCheckout`
  - `dataServices` string — `DataServices` — `$viva->dataServices`

---

[API](https://skmtc.net/qrcommunication/apis/viva-wallet-merchant-sdk-re-fe-rence-php.md) · [All operations](https://skmtc.net/qrcommunication/apis/viva-wallet-merchant-sdk-re-fe-rence-php/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/qrcommunication/viva-wallet-merchant-sdk-re-fe-rence-php/versions/bcafd06ce584/schema)