> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://arkea.ferndocs.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://arkea.ferndocs.com/_mcp/server.

# Nouveautés de la v2

La v2 de l'API Open Banking est en bêta sur le bac à sable. Elle est additive :
toutes les requêtes v1 fonctionnent à l'identique en v2 une fois le chemin de base
mis à jour, et la v1 reste en disponibilité générale pendant la migration.

|                | v1                                    | v2                                    |
| -------------- | ------------------------------------- | ------------------------------------- |
| Chemin de base | `https://sandbox.api.getarkea.com/v1` | `https://sandbox.api.getarkea.com/v2` |
| Disponibilité  | GA                                    | Bêta                                  |
| Endpoints      | 6                                     | 9                                     |

## Nouveaux endpoints

#### Transactions

`GET /accounts/{accountId}/transactions` renvoie les transactions comptabilisées et
en attente, filtrables avec `from` et `to`, les plus récentes d'abord.

#### Paiements en lot

`POST /payments/bulk` soumet jusqu'à 500 virements SEPA en un seul lot depuis un
compte débiteur unique.

#### Lecture des consentements

`GET /consents/{consentId}` renvoie le statut, la date d'expiration et les comptes
couverts par un consentement.

## Migration

1. Pointez votre client vers le chemin de base v2. Les appels existants aux comptes, paiements et consentements ne changent pas.
2. Remplacez le suivi des transactions basé sur les soldes par `GET /accounts/{accountId}/transactions`.
3. Regroupez les versements récurrents via `POST /payments/bulk` — un lot correspond à une seule autorisation, et le statut `PART` indique que certains virements ont été rejetés tandis que d'autres ont abouti.

> **Info**
>
> Les clés du bac à sable fonctionnent avec les deux versions. L'accès à la v2 en
> production est accordé selon l'accord partenaire pendant la bêta.