---
title: "Lien de l'espace débiteur"
description: "Donner à un client un lien pour consulter et télécharger les factures et avoirs suivis."
canonical: https://developer.billabex.com/fr/guides/espace-debiteur/
lang: fr
alternate: https://developer.billabex.com/en/guides/debtor-portal/
last-updated: 2026-09-27
---

# Lien de l'espace débiteur

> Donner à un client un lien pour consulter et télécharger les factures et avoirs suivis.

Source: https://developer.billabex.com/fr/guides/espace-debiteur/
Langue: Français (fr)
Version anglaise: https://developer.billabex.com/en/guides/debtor-portal/

Chaque compte peut avoir un **lien d'espace débiteur** : une page où le client consulte et
télécharge les documents du suivi en cours de son compte, sans compte ni mot de passe. La page est
servie sur le domaine de l'agent (`https://portal.revoptim.com/...`), celui des adresses qui
envoient les relances.

## Ce que montre la page

La page montre le suivi **vivant**, recalculé à chaque visite, et non la copie d'un email :

- les factures dont parlent les relances à cet instant : les factures échues tant qu'un retard reste
  dû, sinon les factures à venir. Les factures exclues des relances et les factures soldées
  n'apparaissent jamais ;
- les avoirs dont il reste un montant à utiliser ;
- le RIB de l'organisation, sauf pour un compte en prélèvement ;
- une archive ZIP de ces documents, jusqu'à 200 fichiers et 150 Mo. Au-delà, chaque document reste
  téléchargeable individuellement.

Une facture sans PDF est listée comme non disponible. Un document qui sort du suivi est refusé,
même par une URL de téléchargement conservée d'une visite précédente.

## Une capacité permanente

Le lien ne désigne aucune personne. **Quiconque le détient** consulte les documents courants du
compte, y compris les futurs, jusqu'à sa **régénération**. Désactiver un contact ne lui retire pas
sa copie : seule une régénération le fait, et elle invalide toutes les copies à la fois, y compris
les liens des emails déjà envoyés.

La partie secrète du lien suit le `#`. Un navigateur n'envoie jamais cette partie au serveur, elle
reste donc hors des journaux d'accès ; conservez et transmettez le lien complet comme une clé d'API.

## Endpoints

| Méthode | Chemin                                         | Scope                            | Comportement                                                                           |
| ------- | ---------------------------------------------- | -------------------------------- | -------------------------------------------------------------------------------------- |
| `GET`   | `/accounts/{accountId}/portal-link`            | `accounts:read` / `accounts:all` | Le lien courant, ou `204` si aucun n'a été créé. Ne crée jamais de lien.               |
| `POST`  | `/accounts/{accountId}/portal-link`            | `accounts:all`                   | Le lien existant, ou un nouveau. Rejouable : ne remplace jamais un lien.               |
| `POST`  | `/accounts/{accountId}/portal-link/regenerate` | `accounts:all`                   | Un nouveau lien. Toutes les copies précédentes cessent de fonctionner. Non idempotent. |

Chaque réponse porte `accountId`, `url`, `version` et `issuedAt`, avec `Cache-Control: no-store`.
`POST /portal-link` ajoute `created`, faux si le lien existait déjà. `version` augmente à chaque
régénération et n'est pas secrète : conservez-la pour savoir si un lien stocké est encore le lien
courant.

```bash
curl -X POST https://app.billabex.com/api/public/v1/accounts/$ACCOUNT_ID/portal-link \
  -H "Authorization: Bearer $TOKEN"
```

```json
{
  "accountId": "123e4567-e89b-12d3-a456-426614174000",
  "url": "https://portal.revoptim.com/123e4567-e89b-12d3-a456-426614174000#k3Jd0vXw2b1qR8mZp6TsY4nLhF9cA7eGuBoIiKjW5xA",
  "version": 1,
  "issuedAt": "2026-09-27T09:30:00.000Z",
  "created": true
}
```

Le lien ne fait jamais partie de la ressource compte : `GET /accounts` et
`GET /accounts/{accountId}` ne le renvoient pas.

## MCP

Les trois mêmes opérations existent en outils MCP : `get-account-portal-link` (`mcp:read`),
`ensure-account-portal-link` et `regenerate-account-portal-link` (`mcp:write`). La régénération est
déclarée destructive et non idempotente.

---

Billabex developer portal. OpenAPI specification: https://developer.billabex.com/openapi.json.
Agent instructions: https://developer.billabex.com/llms.txt. Complete documentation: https://developer.billabex.com/llms-full.txt.