v9

latestOpenAPI 3.1.0MITraw.githubusercontent.com2026-05-05502770.7 KB
BankAccounts

$viva->bankAccounts->link()

Lie un compte bancaire (validation IBAN + enregistrement).

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

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

Request body

ibanstring required

IBAN du compte bancaire

beneficiaryNamestring required

Nom du titulaire du compte

friendlyNamestring nullable

Nom d'affichage optionnel

Example request

{
  "iban": "FR7630006000011234567890189",
  "beneficiaryName": "Jean Dupont",
  "friendlyName": "Compte principal"
}

Response

Compte bancaire lié

bankAccountIdstring uuid

UUID du compte bancaire lié

isVivaIbanboolean

L'IBAN appartient-il à un compte Viva interne ?