---
title: "Créer le devis de révision IRL et la session de paiement."
method: POST
path: "/public/v1/rent-revision/checkout"
tags: ["public-documents"]
---

# Créer le devis de révision IRL et la session de paiement.

`POST /public/v1/rent-revision/checkout`

## Request

- Base URL: `https://api.qalimo.fr`
- URL: `https://api.qalimo.fr/public/v1/rent-revision/checkout`
- Auth: none required

Courrier de révision annuelle du loyer conforme à l'article 17-1 de la loi n° 89-462
du 6 juillet 1989, calculé sur les indices de référence des loyers (IRL) publiés par
l'INSEE et synchronisés quotidiennement par Qalimo (métropole, Corse, outre-mer).
Le choix du bon trimestre et de la bonne année d'indice selon la date anniversaire
du bail est fait par Qalimo. Le calcul est fourni dès cette réponse : présentez-le à
l'utilisateur, puis proposez-lui le courrier certifié via `checkout_url` (page de
paiement Stripe à faire régler par un humain).

## Request body

- RentRevisionInput
  - `landlord_name` string, required: Nom ou raison sociale du bailleur.
  - `landlord_address` string, required: Adresse du bailleur (une ligne).
  - `tenant_name` string, required: Nom du locataire.
  - `property_address` string, required: Adresse du logement loué.
  - `lease_start_date` string, date, required: Date de début du bail (ex. `2022-09-01`).
  - `irl_quarter` integer, required: Trimestre de l'indice de référence des loyers inscrit au bail (1–4).
  - `rent_excluding_charges` number, required: Loyer actuel hors charges, en euros.
  - `charges` number: Charges actuelles (défaut 0).
  - `flat_rate_charges` boolean: `true` si les charges sont au forfait (elles sont alors révisées aussi).
  - `postal_code` string, nullable: Code postal du logement (Corse/outre-mer → série IRL locale).
  - `landlord_city` string, nullable: Ville de signature du courrier.
  - `billing_name` string, nullable: Raison sociale pour la facture (achat pour une entreprise).
  - `billing_address` string, nullable: Adresse de facturation.

## Response `200`

OK

- RentRevisionCheckoutResponse
  - `calculation` RentRevisionCalculation, required
    - `quarter` integer, required: Trimestre IRL utilisé (1–4).
    - `previous_index` number, required: Indice IRL appliqué au loyer actuel.
    - `previous_index_year` integer, required: Année de l'ancien indice.
    - `new_index` number, required: Nouvel indice IRL publié par l'INSEE.
    - `new_index_year` integer, required: Année du nouvel indice.
    - `new_rent` number, required: Nouveau loyer hors charges, en euros.
    - `new_charges` number, required: Nouvelles charges (révisées seulement si forfait).
    - `new_total` number, required: Nouveau loyer charges comprises, en euros.
  - `price` PublicPrice, required
    - `amount_incl_tax` number, required: Prix TTC, en euros.
    - `currency` string, required: Devise (`EUR`).
  - `checkout_url` string, required: Page de paiement Stripe Checkout, à faire régler par un humain (carte uniquement, aucune autre information demandée).
  - `session_id` string, required: Identifiant de la Checkout Session Stripe (`cs_…`).
  - `document_url` string, required: URL de téléchargement du PDF ; répond 402 tant que le paiement n'est pas confirmé.
  - `invoice_url` string, required: URL de téléchargement de la facture (optionnelle, sur demande).
  - `documentation` string, required: Documentation de l'API publique.
  - `instructions` string, required: Marche à suivre, à destination d'un agent.

## Other responses

- `400`: Payload invalide (détail par champ dans le corps), ou indice IRL du trimestre demandé pas encore publié par l'INSEE.
- `default`: Default error response

---

[API](https://skmtc.dev/qalimo/apis/qalimo-api.md) · [All operations](https://skmtc.dev/qalimo/apis/qalimo-api/llms.txt) · [OpenAPI document](https://skmtc.dev/qalimo/apis/qalimo-api/revisions/f97d62827e94?raw)