---
title: "$viva->bankAccounts->link()"
method: POST
path: "/BankAccounts/link"
tags: ["BankAccounts"]
---

# $viva->bankAccounts->link()

`POST /BankAccounts/link`

Lie un compte bancaire (validation IBAN + enregistrement).

```php
$result = $viva->bankAccounts->link(
    iban: 'FR7630006000011234567890189',
    beneficiaryName: 'Jean Dupont',
    friendlyName: 'Compte principal',
);

echo $result['bankAccountId']; // UUID
echo $result['isVivaIban'];    // false (IBAN externe)
```

## Request body

- BankAccountLinkParams
  - `iban` string, required — IBAN du compte bancaire
  - `beneficiaryName` string, required — Nom du titulaire du compte
  - `friendlyName` string, nullable — Nom d'affichage optionnel

## Response `200`

Compte bancaire lié

- BankAccountLinkResult
  - `bankAccountId` string, uuid — UUID du compte bancaire lié
  - `isVivaIban` boolean — L'IBAN appartient-il à un compte Viva interne ?

---

[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)