**Versions de l’API** · **V2 (Latest)** · [V1](/integrations/v1/docs?lang=fr)

# Abonnements

OpenAPI 3.0.3 · API 2.0.0

```json
[
  {
    "url": "https://api.unisoft.world/integrations/v2",
    "description": "API"
  }
]
```

Dons récurrents.

## Opérations

## GET /abonnements

Lister les abonnements

`list_abonnements`

Autorisation requise : `abonnements:read`. Lit un abonnement enregistré dans l’organisation authentifiée et les collectes autorisées, en excluant les enregistrements supprimés logiquement. Renvoie une projection métier explicite : l’identité et la facturation restent sous payload.info et payload.facturation ; les moyens réutilisables, références/configurations prestataires, tokens, snapshots privés, verrous et calendrier brut sont exclus. Le contrat monétaire nominal reste dans payload.amount, en unités mineures, et payload.devise ; aucun montant ni devise n’est ajouté à la racine et aucune devise ni somme actuelle n’est déduite. Les valeurs scalaires historiques absentes ou invalides valent null ; payload, info et facturation ont toujours une forme documentée. L’état ACTIVE peut coexister avec active false pendant l’attente d’activation. Aucun marqueur renvoyé ne donne la permission de débiter ni ne prouve un règlement bancaire. Aucun appel prestataire, débit, actualisation, rapprochement, initialisation de calendrier ni changement d’état métier n’a lieu ; l’authentification commune peut mettre à jour la télémétrie d’utilisation de la clé API. Les paramètres de requête inconnus et les corps HTTP sont refusés, y compris un objet JSON vide transmis et les octets opaques ; les objets vides synthétiques du MCP sans corps de transport restent pris en charge. Les filtres de liste portent sur les valeurs enregistrées exactes et se combinent avec ET. active false ne signifie pas une pause. Une clé limitée à des collectes reçoit uniquement les abonnements rattachés à une collecte autorisée. Tri par date et heure enregistrées normalisées décroissantes, puis par identifiant décroissant ; les dates illisibles arrivent en dernier. Les nouveaux curseurs sont opaques et liés à l’organisation et aux filtres exacts state/active/contactId. Les anciens curseurs datetime/id valides restent acceptés. Réutilisez nextCursor sans modification avec les mêmes filtres ; les modifications concurrentes ne constituent pas un instantané. Un identifiant d’ancrage historique mal formé produit 409 INVALID_SUBSCRIPTION_HISTORY plutôt qu’une continuation inutilisable. Les curseurs de paiements d’abonnement sont incompatibles.

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "abonnements:read",
  "additional": []
}
```

### Paramètres

```json
{
  "name": "limit",
  "in": "query",
  "schema": {
    "type": "integer",
    "minimum": 1,
    "maximum": 200,
    "default": 50
  }
}
```

```json
{
  "name": "cursor",
  "in": "query",
  "description": "Curseur nextCursor opaque de cette liste d’abonnements. Les nouveaux curseurs sont liés à l’organisation et aux filtres exacts state/active/contactId ; réutilisez-les sans modification avec les mêmes filtres. Les anciens curseurs datetime/id valides restent acceptés. Les curseurs d’historique de paiements sont incompatibles.",
  "schema": {
    "type": "string",
    "maxLength": 4096
  }
}
```

```json
{
  "name": "active",
  "in": "query",
  "description": "Filtre exact sur le marqueur active enregistré. La valeur false couvre plusieurs situations du cycle de vie et ne signifie pas une pause.",
  "schema": {
    "type": "boolean"
  }
}
```

```json
{
  "name": "contactId",
  "in": "query",
  "description": "Identifiant exact du contact CRM.",
  "schema": {
    "type": "string",
    "minLength": 1,
    "maxLength": 200
  }
}
```

```json
{
  "name": "state",
  "in": "query",
  "description": "État enregistré exact, sensible à la casse. Il ne représente ni une catégorie d’affichage ni une permission d’exécution. Un nouvel état inconnu correspondant au motif peut être sélectionné. Omettez ce filtre pour inclure tous les états.",
  "schema": {
    "type": "string",
    "maxLength": 64,
    "pattern": "^[A-Z][A-Z0-9_-]{0,63}$"
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Abonnement"
            }
          },
          "meta": {
            "$ref": "#/components/schemas/Pagination"
          }
        }
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "INVALID_STATE, INVALID_ACTIVE, INVALID_CONTACT_ID, INVALID_LIMIT, INVALID_CURSOR, INVALID_QUERY_PARAMETER, UNKNOWN_QUERY_PARAMETER ou UNEXPECTED_REQUEST_BODY.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "param": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Authentification absente ou invalide.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "param": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "INSUFFICIENT_SCOPE : abonnements:read est requis.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "param": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "INVALID_SUBSCRIPTION_HISTORY : un identifiant historique d’abonnement mal formé empêche de construire un curseur de continuation stable.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "param": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "INTERNAL_ERROR.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "param": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "abonnements:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## GET /abonnements/{id}

Obtenir un abonnement

`get_abonnement`

Autorisation requise : `abonnements:read`. Lit un abonnement enregistré dans l’organisation authentifiée et les collectes autorisées, en excluant les enregistrements supprimés logiquement. Renvoie une projection métier explicite : l’identité et la facturation restent sous payload.info et payload.facturation ; les moyens réutilisables, références/configurations prestataires, tokens, snapshots privés, verrous et calendrier brut sont exclus. Le contrat monétaire nominal reste dans payload.amount, en unités mineures, et payload.devise ; aucun montant ni devise n’est ajouté à la racine et aucune devise ni somme actuelle n’est déduite. Les valeurs scalaires historiques absentes ou invalides valent null ; payload, info et facturation ont toujours une forme documentée. L’état ACTIVE peut coexister avec active false pendant l’attente d’activation. Aucun marqueur renvoyé ne donne la permission de débiter ni ne prouve un règlement bancaire. Aucun appel prestataire, débit, actualisation, rapprochement, initialisation de calendrier ni changement d’état métier n’a lieu ; l’authentification commune peut mettre à jour la télémétrie d’utilisation de la clé API. Les paramètres de requête inconnus et les corps HTTP sont refusés, y compris un objet JSON vide transmis et les octets opaques ; les objets vides synthétiques du MCP sans corps de transport restent pris en charge. Accepte uniquement l’UUID d’abonnement, sans paramètre de requête. Un abonnement absent, supprimé ou hors périmètre produit toujours 404 NOT_FOUND.

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "abonnements:read",
  "additional": []
}
```

### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
    "format": "uuid"
  },
  "description": "Identifiant de la ressource cible existante, renvoyé par son opération de liste ou de lecture autorisée. Ne générez jamais un nouvel UUID pour cibler un enregistrement existant."
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/Abonnement"
          }
        }
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "INVALID_UUID, UNKNOWN_QUERY_PARAMETER ou UNEXPECTED_REQUEST_BODY.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "param": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Authentification absente ou invalide.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "param": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "INSUFFICIENT_SCOPE : abonnements:read est requis.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "param": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "NOT_FOUND : abonnement absent, supprimé, appartenant à une autre organisation ou hors du périmètre des collectes autorisées.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "param": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "INTERNAL_ERROR.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "param": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "abonnements:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## GET /abonnements/{id}/paiements

Lister les paiements enregistrés d’un abonnement

`list_abonnement_paiements`

Autorisations requises : `paiements:read` ET `abonnements:read`. Historique enregistré en lecture seule, sans débit, actualisation, rapprochement ni appel au prestataire. L’abonnement et chaque paiement sont limités indépendamment à l’organisation authentifiée et aux collectes autorisées. Les enregistrements supprimés logiquement sont exclus ; cette exclusion ne constitue pas une annulation financière. Omettez state pour inclure les états terminés, en échec, en attente, remboursés, importés, les traces techniques de pause et les états inconnus. Utilisez state=COMPLETED pour les résultats terminés enregistrés, dont le sens financier dépend du producteur et du prestataire ; cette lecture ne vérifie ni capture ni banque. Un état d’échec exact tel que FAILED ne constitue pas une catégorie universelle d’échec. Les tentatives sont des paiements individuels, qui ne correspondent pas nécessairement à des échéances contractuelles distinctes. Tri par date et heure enregistrées normalisées décroissantes, puis par identifiant de paiement décroissant ; les dates absentes ou illisibles arrivent en dernier. Le curseur est opaque et lié à l’organisation, à l’abonnement et au filtre state ; réutilisez-le sans modification avec le même filtre. Les insertions concurrentes ne constituent pas un instantané. Aucun agrégat multidevise ni décompte de paiements encaissés déduit n’est renvoyé. La réponse utilise une projection métier explicite sans données personnelles du donateur, références de moyens réutilisables, configuration du prestataire ni snapshots privés. Les corps HTTP sont refusés, y compris un objet JSON vide transmis et les octets opaques ; les objets vides synthétiques du MCP sans corps de transport restent pris en charge.

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "paiements:read",
  "additional": [
    "abonnements:read"
  ]
}
```

### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "description": "Identifiant de l’abonnement.",
  "schema": {
    "type": "string",
    "format": "uuid"
  }
}
```

```json
{
  "name": "limit",
  "in": "query",
  "schema": {
    "type": "integer",
    "minimum": 1,
    "maximum": 200,
    "default": 50
  }
}
```

```json
{
  "name": "cursor",
  "in": "query",
  "description": "Curseur nextCursor opaque de cette liste précise de paiements d’abonnement et du même filtre state. Les curseurs de liste d’abonnements ne sont pas compatibles.",
  "schema": {
    "type": "string",
    "maxLength": 4096
  }
}
```

```json
{
  "name": "state",
  "in": "query",
  "description": "État enregistré exact, sensible à la casse. Il ne représente ni une catégorie d’affichage ni une permission d’exécution. Un nouvel état inconnu correspondant au motif peut être sélectionné. Omettez ce filtre pour inclure tous les états.",
  "schema": {
    "type": "string",
    "maxLength": 64,
    "pattern": "^[A-Z][A-Z0-9_-]{0,63}$"
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Paiements enregistrés et métadonnées de continuation.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/AbonnementPaymentPage"
      },
      "example": {
        "success": true,
        "data": [
          {
            "id": "22222222-2222-4222-8222-222222222222",
            "subscriptionId": "11111111-1111-4111-8111-111111111111",
            "amount": 5000,
            "devise": "eur",
            "assoc": "MAIN",
            "state": "COMPLETED",
            "datetime": "2026-11-01T10:00:00.000Z",
            "type": "GENERAL",
            "typeId": null,
            "parentTypeId": null,
            "method": "CB",
            "platform": "STRIPE",
            "source": "SYSTEM",
            "imported": null,
            "finalized": null,
            "subscriptionOccurrence": "11111111-1111-4111-8111-111111111111:monthly:1",
            "subscriptionPlannedDate": "2026-11-01"
          }
        ],
        "meta": {
          "nextCursor": null,
          "hasMore": false,
          "count": 1
        }
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "INVALID_UUID, INVALID_STATE, INVALID_LIMIT, INVALID_CURSOR, INVALID_QUERY_PARAMETER, UNKNOWN_QUERY_PARAMETER ou UNEXPECTED_REQUEST_BODY.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "param": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Authentification absente ou invalide.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "param": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "INSUFFICIENT_SCOPE : les deux autorisations de lecture sont requises.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "param": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "NOT_FOUND : abonnement absent, supprimé, appartenant à une autre organisation ou hors du périmètre des collectes autorisées.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "param": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "INVALID_PAYMENT_HISTORY : un identifiant historique de paiement mal formé empêche de construire un curseur de continuation stable.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "param": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "INTERNAL_ERROR.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "param": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "paiements:read",
  "x-unisoft-additional-scopes": [
    "abonnements:read"
  ],
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## GET /abonnements/{id}/schedule

Lire les dates et le restant contractuel d’un abonnement

`get_abonnement_schedule`

Autorisations requises : `abonnements:read` ET `paiements:read`, y compris pour les contrats gérés par un prestataire. Projection enregistrée en lecture seule, sans débit, appel au prestataire, synchronisation, rapprochement, initialisation persistante de calendrier, verrou ni émission documentaire. Les calendriers mensuels locaux et SEPA XML réutilisent le propriétaire de l’abonnement en mémoire. Les dates sont civiles, au format YYYY-MM-DD dans rules.timezone ; notBefore et asOf sont des instants ISO. horizon (1–240, défaut 12) limite les échéances visibles, jamais les totaux contractuels. nominalAmount est payload.amount ; rules.amount est le montant nominal du calendrier ; occurrence.amount est le montant effectif, éventuellement réduit par le plafond ou modifié par une exception. Les tentatives de paiement ne sont pas des échéances distinctes. paidAmount/paidCount représentent les résultats COMPLETED enregistrés selon les règles du propriétaire, y compris l’historique importé ; ils ne vérifient ni capture ni règlement bancaire. Les tentatives engagées consomment le disponible contractuel. remainingAmount est le disponible sous plafond, plannedAmount le montant contractuel futur complet calculable et remainingCount le nombre complet d’échéances futures calculables. La valeur null indique une donnée inconnue ou illimitée, jamais zéro. Les limites count, maximum, unlimited et legacy combinées sont distinctes. blocked décrit uniquement les paiements engagés ou incertains : false n’implique pas canExecute. canExecute est l’éligibilité commune du calendrier à la lecture ; il ne valide ni prestataire ni mandat et ne donne pas l’autorisation de débiter ; les autres contrôles d’exécution restent requis. Un contrat en pause ou en attente d’activation peut garder des dates futures sans être exécutable. La préparation SEPA XML est une fenêtre de dates séparée, sans transmission bancaire ni date de réception des fonds. Les échéanciers gérés par un prestataire restent indisponibles avec dates, totaux et éligibilité à null ; aucune date distante n’est inventée. allocationBudgets et nextAllocations sont des cartes de promesses en unités mineures ; les cartes vides sont valides ; les budgets de promesse par paiement ne représentent pas le contrat futur complet. Aucune référence de moyen réutilisable, verrou privé, empreinte d’historique ni référence prestataire n’est renvoyée. Les restrictions d’organisation et de collecte concernent l’abonnement et tous les paiements/promesses liés. Une relation historique masquée fait refuser la projection au lieu de modifier silencieusement les totaux. L’historique supprimé ou mal formé est indisponible. Au-delà de 10000 tentatives enregistrées, la lecture échoue avec SUBSCRIPTION_HISTORY_TOO_LARGE. Un 409 impose de corriger ou vérifier les données enregistrées dans l’application propriétaire ; ne jamais retenter un débit à partir de cette lecture. La réponse ne constitue pas un instantané transactionnel et peut changer immédiatement.

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "abonnements:read",
  "additional": [
    "paiements:read"
  ]
}
```

### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "description": "Identifiant de l’abonnement.",
  "schema": {
    "type": "string",
    "format": "uuid"
  }
}
```

```json
{
  "name": "horizon",
  "in": "query",
  "description": "Prochaines échéances visibles ; les totaux contractuels couvrent toujours tout le futur calculable.",
  "schema": {
    "type": "integer",
    "minimum": 1,
    "maximum": 240,
    "default": 12
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Projection enregistrée de l’abonnement en lecture seule.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/SubscriptionScheduleResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "INVALID_UUID, INVALID_HORIZON, INVALID_QUERY_PARAMETER, UNKNOWN_QUERY_PARAMETER ou UNEXPECTED_REQUEST_BODY.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "param": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Authentification absente ou invalide.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "param": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "INSUFFICIENT_SCOPE : les deux autorisations de lecture sont requises.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "param": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "NOT_FOUND : abonnement absent, supprimé, étranger à l’organisation ou hors des collectes autorisées.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "param": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "INVALID_SUBSCRIPTION_SCHEDULE, INVALID_SUBSCRIPTION_HISTORY, SUBSCRIPTION_HISTORY_UNAVAILABLE, SUBSCRIPTION_HISTORY_TOO_LARGE ou SCHEDULE_SCOPE_INCOMPLETE. Vérifiez les données enregistrées et l’accès aux objets liés dans l’application propriétaire ; aucune projection financière partielle n’est renvoyée.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "param": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "INTERNAL_ERROR.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "param": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "abonnements:read",
  "x-unisoft-additional-scopes": [
    "paiements:read"
  ],
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## GET /abonnements/{id}/incident

Consulter un incident enregistré d’abonnement et son lien de régularisation existant

`get_abonnement_incident`

Autorisations requises : abonnements:read ET paiements:read. Accepte uniquement l’UUID de l’abonnement ; les paramètres de requête et les corps non vides sont refusés. Un abonnement absent, supprimé ou hors périmètre renvoie 404. L’abonnement et chaque paiement lié sont limités indépendamment à l’organisation authentifiée et aux collectes autorisées. Consulte les marqueurs d’intervention enregistrés et le dernier paiement autorisé en échec ; celui-ci peut être historique, avoir été suivi d’un succès et ne prouve pas un blocage actuel. MANUAL/CARD_EXPIRED/paymentMethodPending décrivent une intervention enregistrée ; active et state n’autorisent aucun débit. Les dates absentes ou invalides restent null ; aucune date ni expiration n’est déduite. Aucun message d’erreur brut, moyen réutilisable, token d’enrôlement, configuration marchande ou snapshot privé n’est exposé. regularization.link vaut null avec un code de disponibilité exploitable, ou contient un checkout manuel Stripe Connect PENDING déjà enregistré. AVAILABLE exige un contrat carte local actif MANUAL/CARD_EXPIRED (reusable_method.isBank doit être false) sans revue explicite ni changement de moyen, les mêmes snapshots du payeur/contact/facturation, le même compte Stripe figé, la même devise/association/révision et le même montant d’échéance enregistré, la tentative courante de l’échéance PROCESSING et l’incident carte capturé correspondant, une URL HTTPS checkout.stripe.com correspondant à la session et une expiration future explicite enregistrée depuis Stripe. L’abonnement, le paiement, l’échéance et l’appartenance du contact sont revérifiés avant restitution du lien. Partagez cette URL confidentielle uniquement avec son payeur prévu. Il s’agit d’une observation de la base, sans garantie en direct d’acceptation du checkout par le prestataire. EXPIRED_RECORDED_LINK signifie que l’expiration explicite enregistrée est dépassée ; INVALID_RECORDED_LINK indique une expiration absente/invalide, un marqueur d’expiration ou une URL invalide. CURRENT_PAYER_UNVERIFIED et HISTORY_UNVERIFIED nécessitent une revue par un opérateur. READ_OWNER_REQUIRED indique l’absence de checkout lisible admissible ; utilisez le parcours autorisé existant du backoffice. MANAGED_OWNER renvoie au prestataire externe ; SEPA_XML_OWNER exige le parcours SEPA de mandat et de retour bancaire. INACTIVE, NO_RECORDED_INTERVENTION, PAYMENT_METHOD_CHANGE_PENDING et MANUAL_REVIEW_REQUIRED ne fournissent aucun lien. Les checkouts des autres prestataires et les liens d’enrôlement restent indisponibles jusqu’à l’existence d’un propriétaire de lecture faisant autorité. Ce GET ne crée aucun lien, n’envoie aucune relance, n’appelle aucun prestataire, ne rapproche rien, ne change aucun moyen, n’initialise aucun calendrier et ne débite aucun montant. Suivre le checkout retourné constitue une action distincte du payeur. L’authentification peut enregistrer la télémétrie d’usage de la clé API.

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "abonnements:read",
  "additional": [
    "paiements:read"
  ]
}
```

### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "description": "UUID Unisoft de l’abonnement.",
  "schema": {
    "type": "string",
    "format": "uuid"
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Incident enregistré en projection autorisée et disponibilité du lien existant.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/SubscriptionIncidentResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "INVALID_UUID, UNEXPECTED_QUERY_PARAMETERS ou UNEXPECTED_REQUEST_BODY.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Authentification absente ou invalide.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "INSUFFICIENT_SCOPE : les deux autorisations de lecture sont requises.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "NOT_FOUND : absent, supprimé ou hors de l’organisation ou des collectes autorisées.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "INTERNAL_ERROR : l’incident n’a pas pu être consulté ; aucune opération financière n’a été tentée.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "abonnements:read",
  "x-unisoft-additional-scopes": [
    "paiements:read"
  ],
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## POST /abonnements/{id}/revisions/preview

Prévisualiser les règles mensuelles d’abonnement sans écriture

`preview_subscription_revision`

Exige abonnements:read ET paiements:read. POST en lecture seule : aucun verrou, journal écrit ou initialisation persistante du calendrier. Fournir les modifications exactes souhaitées ; les contradictions day/nextDate ou limites ignorées/incompatibles sont refusées, pas supprimées silencieusement. Une opération sans changement retourne NO_EFFECTIVE_CHANGE. previewToken identifie par empreinte l’autorité native, l’historique complet admis, les références et la configuration financière ; ce n’est ni un identifiant de commande ni une réservation. Lire beforeRules/afterRules et les totaux before/after avec l’utilisateur, puis appliquer uniquement les mêmes modifications et le même jeton pour une intention confirmée. Une modification ultérieure du contexte invalide cet aperçu. Utilise l’éditeur mensuel natif d’abonnement et préserve les tentatives lancées ainsi que les exceptions d’occurrence. Tous les champs amount/maximum/total sont en unités mineures ; count et maximum incluent l’historique terminé et engagé. Des totaux null signifient sans limite ou inconnus, jamais zéro. Les dates sont civiles YYYY-MM-DD dans le fuseau du contrat. Seuls les contrats locaux existants ACTIVE/PAUSE avec active:true sont admis ; propriété distante managée ou spécialisée SEPA XML, activation en attente, historique ambigu et références de campagne/promesse masquées sont refusés. Cette tranche modifie uniquement amount/day/nextDate et les limites natives. Aucune autre fréquence ni endDate indépendante n’existe dans ce contrat. Identité du payeur, origine, bénéficiaire, devise, prestataire, moyen réutilisable et effets CRM/notification ne sont pas admis ici. Les plans de répartition doivent rester valides selon le propriétaire natif ; une modification nécessitant une nouvelle répartition retourne ALLOCATION_REVISION_REQUIRED. Aucun prestataire, transport de paiement, débit, document ou notification n’est créé. Le moyen actuellement enregistré peut encore échouer lors des contrôles d’exécution ultérieurs. 

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "abonnements:read",
  "additional": [
    "paiements:read"
  ]
}
```

### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid"
  },
  "description": "Identifiant du contrat d’abonnement récurrent existant."
}
```

### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "changes": {
            "$ref": "#/components/schemas/UnisoftRequest_3e9bbc56cab142f79ac7"
          }
        },
        "required": [
          "changes"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Résultat du propriétaire natif projeté sans références ni instantanés privés.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/SubscriptionRevisionPreviewResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "INVALID_REVISION_INPUT, INVALID_UUID ou UNKNOWN_QUERY_PARAMETER.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Authentification absente ou invalide.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "INSUFFICIENT_SCOPE ou API_KEY_CONTEXT_REQUIRED.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "NOT_FOUND.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "REVISION_OWNER_UNAVAILABLE, ACTIVATION_REQUIRED, SUBSCRIPTION_CLOSED, SUBSCRIPTION_BUSY, SUBSCRIPTION_CONTACT_UNAVAILABLE, INVALID_SUBSCRIPTION_HISTORY, ALLOCATION_REVISION_REQUIRED, CONFLICTING_CALENDAR_FIELDS, NO_EFFECTIVE_CHANGE ou un autre refus natif de calendrier/référence.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "REVISION_STORAGE_UNAVAILABLE.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "abonnements:read",
  "x-unisoft-additional-scopes": [
    "paiements:read"
  ],
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  },
  "x-unisoft-mcp-output-schema": true
}
```

## POST /abonnements/{id}/revisions

Appliquer une révision confirmée des règles natives d’abonnement

`apply_subscription_revision`

Exige abonnements:write ET abonnements:read ET paiements:read ET le droit optionnel explicite abonnements:revise, ainsi que acknowledgeFutureCollections:true. Cela modifie l’autorité des encaissements automatiques futurs. Utiliser d’abord preview_subscription_revision ; envoyer son previewToken exact et les mêmes modifications. Générer idempotencyKey une seule fois et conserver la requête exacte après un délai dépassé. Le véritable éditeur natif acquiert son verrou EDIT, revérifie l’aperçu, modifie le contrat et enregistre son audit natif ; aucun paiement n’est lancé. APPLIED/appliedRevision décrivent une modification acquittée, pas l’état actuel du contrat, une émission de reçu ou un règlement bancaire. RUNNING/UNCERTAIN sont observés par get_subscription_revision_command et ne doivent jamais relancer le propriétaire. La protection durable partagée du contrat refuse aussi un UUID différent après incertitude ; aucun TTL ni reprise automatique du verrou n’est admis. PREVIEW_CONFLICT exige un nouvel aperçu et une intention de nouveau confirmée, jamais un remplacement forcé du jeton périmé. Utilise l’éditeur mensuel natif d’abonnement et préserve les tentatives lancées ainsi que les exceptions d’occurrence. Tous les champs amount/maximum/total sont en unités mineures ; count et maximum incluent l’historique terminé et engagé. Des totaux null signifient sans limite ou inconnus, jamais zéro. Les dates sont civiles YYYY-MM-DD dans le fuseau du contrat. Seuls les contrats locaux existants ACTIVE/PAUSE avec active:true sont admis ; propriété distante managée ou spécialisée SEPA XML, activation en attente, historique ambigu et références de campagne/promesse masquées sont refusés. Cette tranche modifie uniquement amount/day/nextDate et les limites natives. Aucune autre fréquence ni endDate indépendante n’existe dans ce contrat. Identité du payeur, origine, bénéficiaire, devise, prestataire, moyen réutilisable et effets CRM/notification ne sont pas admis ici. Les plans de répartition doivent rester valides selon le propriétaire natif ; une modification nécessitant une nouvelle répartition retourne ALLOCATION_REVISION_REQUIRED. Aucun prestataire, transport de paiement, débit, document ou notification n’est créé. Le moyen actuellement enregistré peut encore échouer lors des contrôles d’exécution ultérieurs. 

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "abonnements:write",
  "additional": [
    "abonnements:read",
    "paiements:read",
    "abonnements:revise"
  ]
}
```

### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid"
  },
  "description": "Identifiant du contrat d’abonnement récurrent existant."
}
```

### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "idempotencyKey": {
            "type": "string",
            "format": "uuid"
          },
          "previewToken": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "acknowledgeFutureCollections": {
            "type": "boolean",
            "enum": [
              true
            ],
            "description": "Reconnaître explicitement que les règles modifiées gouvernent les encaissements automatiques futurs de ce contrat existant."
          },
          "changes": {
            "$ref": "#/components/schemas/UnisoftRequest_3e9bbc56cab142f79ac7"
          }
        },
        "required": [
          "idempotencyKey",
          "previewToken",
          "acknowledgeFutureCollections",
          "changes"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Résultat du propriétaire natif projeté sans références ni instantanés privés.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/SubscriptionRevisionCommandResponse"
      }
    }
  }
}
```

#### HTTP 202

```json
{
  "description": "Résultat du propriétaire natif projeté sans références ni instantanés privés.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/SubscriptionRevisionCommandResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "INVALID_REVISION_INPUT, INVALID_UUID ou UNKNOWN_QUERY_PARAMETER.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Authentification absente ou invalide.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "INSUFFICIENT_SCOPE ou API_KEY_CONTEXT_REQUIRED.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "NOT_FOUND.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "PREVIEW_CONFLICT, IDEMPOTENCY_CONFLICT, LIFECYCLE_RECONCILIATION_REQUIRED, ALLOCATION_REVISION_REQUIRED ou un autre refus natif de calendrier/référence avant attribution de la commande.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "REVISION_STORAGE_UNAVAILABLE. Si commandId est fourni, inspecter la commande et les données actuelles avant une autre intention.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "abonnements:write",
  "x-unisoft-additional-scopes": [
    "abonnements:read",
    "paiements:read",
    "abonnements:revise"
  ],
  "x-unisoft-mcp": {
    "category": "write",
    "readOnly": false,
    "destructive": true,
    "idempotent": true,
    "warn": true
  },
  "x-unisoft-mcp-output-schema": true
}
```

## GET /abonnements/{id}/revisions/commands/{commandId}

Lire le résultat enregistré d’une révision d’abonnement

`get_subscription_revision_command`

Exige abonnements:read. Lit le journal externe de révision sans verrou, modification, relance du propriétaire natif, exposition d’un instantané d’aperçu ni appel de prestataire. id est le contrat et commandId l’identifiant de commande externe retourné. APPLIED/appliedRevision décrivent la modification historique acquittée, pas l’état actuel de l’abonnement ou de la banque. RUNNING/UNCERTAIN ne permettent jamais une nouvelle clé ou une relance du propriétaire ; inspecter les données actuelles et résoudre le cas via l’application propriétaire. Les restrictions d’organisation/campagne continuent de s’appliquer au contrat.

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "abonnements:read",
  "additional": []
}
```

### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid"
  },
  "description": "Identifiant du contrat d’abonnement récurrent existant."
}
```

```json
{
  "name": "commandId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid"
  },
  "description": "Identifiant de commande externe de révision retourné par apply_subscription_revision."
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Résultat du propriétaire natif projeté sans références ni instantanés privés.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/SubscriptionRevisionCommandResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "INVALID_UUID, UNKNOWN_QUERY_PARAMETER ou UNEXPECTED_REQUEST_BODY.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Authentification absente ou invalide.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "INSUFFICIENT_SCOPE.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "NOT_FOUND.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "INVALID_REVISION_COMMAND_HISTORY.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "REVISION_STORAGE_UNAVAILABLE.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "abonnements:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  },
  "x-unisoft-mcp-output-schema": true
}
```

## POST /abonnements/{id}/payment-method-changes/preview

Prévisualiser un changement sécurisé de moyen de paiement d’abonnement

`preview_subscription_payment_method_change`

Requiert abonnements:read ET paiements:read ET l’opt-in abonnements:change-method. POST en lecture seule avec platform. Aucun prestataire, verrou, initialisation persistante ni rapprochement. Examiner flow, currency et les éventuels montant/date d’occurrence avant confirmation. expectedRevision et previewToken représentent l’autorité, l’historique, les références, le contact et la configuration cible exacts sans les réserver. La préparation prend uniquement en charge les contrats mensuels locaux ACTIVE/PAUSE/MANUAL/CARD_EXPIRED existants avec active:true, un historique entièrement réadmis, un marchand actuel et un contact CRM. Les propriétaires managés ou SEPA XML spécialisés, changements/activation en attente, incertitudes bancaires et références cachées de campagne sont refusés. Les cibles initiales sont le mandat STRIPE.SEPA et la carte STRIPE de Stripe Connect actuellement configurés. Les autres prestataires restent gérés par leur propriétaire applicatif natif. SETUP prépare un mandat bancaire sans paiement. ADVANCE prépare le paiement autorisé par le payeur de l’occurrence réelle retournée et enregistre la nouvelle carte via le callback natif vérifié ; amount est en unités mineures (5000 EUR signifie EUR 50), sans débit fictif de tokenisation ni débit du moyen enregistré. Une avance par carte avec affectations requiert ALLOCATION_ADVANCE_OWNER_REQUIRED ; aucune répartition n’est devinée. La préparation bloque l’exécution automatique pendant l’attente ; la confirmation native préserve une pause et restaure seulement l’autorité antérieure permise. Lorsqu’une confirmation SETUP reprend un contrat initialement ACTIVE, le propriétaire natif réancre le calendrier non lancé sur le prochain jour d’encaissement configuré strictement après la confirmation dans le fuseau du contrat ; l’ancienne prochaine date n’est pas garantie. PAUSE reste en pause ; ADVANCE règle son occurrence sélectionnée sans ce réancrage SETUP. Un retour navigateur, PREPARED, une URL ou un paiement COMPLETED seul ne prouvent jamais l’activation d’un moyen réutilisable ni un règlement bancaire. Aucune carte, mandat, référence de compte/configuration, jeton public de callback ou instantané du payeur n’est accepté ou retourné. 

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "abonnements:read",
  "additional": [
    "paiements:read",
    "abonnements:change-method"
  ]
}
```

### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid"
  },
  "description": "Identifiant du contrat d’abonnement existant."
}
```

### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "platform": {
            "type": "string",
            "enum": [
              "STRIPE",
              "STRIPE.SEPA"
            ]
          }
        },
        "required": [
          "platform"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Résultat enregistré réadmis ; aucun moyen réutilisable ni référence privée.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/SubscriptionPaymentChangePreviewResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "INVALID_METHOD_CHANGE_INPUT.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "INSUFFICIENT_SCOPE.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "NOT_FOUND.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "METHOD_TARGET_UNAVAILABLE, METHOD_CHANGE_ALREADY_PENDING, LIFECYCLE_RECONCILIATION_REQUIRED, CONTACT_CONTEXT_UNAVAILABLE ou un refus natif de propriétaire/référence.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          }
        }
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "METHOD_CHANGE_STORAGE_UNAVAILABLE.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-scope": "abonnements:read",
  "x-unisoft-additional-scopes": [
    "paiements:read",
    "abonnements:change-method"
  ],
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## POST /abonnements/{id}/payment-method-changes

Préparer l’autorisation du payeur pour changer de moyen de paiement

`prepare_subscription_payment_method_change`

Requiert abonnements:write ET abonnements:read ET paiements:read ET l’opt-in abonnements:change-method. Une carte STRIPE requiert aussi paiements:write ET l’opt-in abonnements:advance ET acknowledgeAdvancePayment:true. Utiliser d’abord preview_subscription_payment_method_change ; envoyer les mêmes platform, expectedRevision et previewToken, plus acknowledgeFutureCollections:true et une idempotencyKey conservée. Cette mutation réelle peut créer un Checkout chez le prestataire. Le payeur doit terminer le parcours authorizationUrl retourné ; cet appel n’envoie aucune notification. L’URL d’action apparaît uniquement dans ce POST autorisé, y compris lors d’un rejeu identique sûr, jamais dans le GET de statut. PREPARED acquitte la préparation, pas le consentement, l’activation ni l’encaissement. Un lien devenu indisponible est omis tandis que la préparation acquittée demeure. Observer RUNNING/UNCERTAIN uniquement avec get_subscription_payment_method_change_command : ne jamais réentrer dans le propriétaire, changer d’UUID ni déduire un échec. Une barrière durable partagée par contrat est conservée après incertitude, sans TTL ni reprise. La préparation prend uniquement en charge les contrats mensuels locaux ACTIVE/PAUSE/MANUAL/CARD_EXPIRED existants avec active:true, un historique entièrement réadmis, un marchand actuel et un contact CRM. Les propriétaires managés ou SEPA XML spécialisés, changements/activation en attente, incertitudes bancaires et références cachées de campagne sont refusés. Les cibles initiales sont le mandat STRIPE.SEPA et la carte STRIPE de Stripe Connect actuellement configurés. Les autres prestataires restent gérés par leur propriétaire applicatif natif. SETUP prépare un mandat bancaire sans paiement. ADVANCE prépare le paiement autorisé par le payeur de l’occurrence réelle retournée et enregistre la nouvelle carte via le callback natif vérifié ; amount est en unités mineures (5000 EUR signifie EUR 50), sans débit fictif de tokenisation ni débit du moyen enregistré. Une avance par carte avec affectations requiert ALLOCATION_ADVANCE_OWNER_REQUIRED ; aucune répartition n’est devinée. La préparation bloque l’exécution automatique pendant l’attente ; la confirmation native préserve une pause et restaure seulement l’autorité antérieure permise. Lorsqu’une confirmation SETUP reprend un contrat initialement ACTIVE, le propriétaire natif réancre le calendrier non lancé sur le prochain jour d’encaissement configuré strictement après la confirmation dans le fuseau du contrat ; l’ancienne prochaine date n’est pas garantie. PAUSE reste en pause ; ADVANCE règle son occurrence sélectionnée sans ce réancrage SETUP. Un retour navigateur, PREPARED, une URL ou un paiement COMPLETED seul ne prouvent jamais l’activation d’un moyen réutilisable ni un règlement bancaire. Aucune carte, mandat, référence de compte/configuration, jeton public de callback ou instantané du payeur n’est accepté ou retourné. 

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "abonnements:write",
  "additional": [
    "abonnements:read",
    "paiements:read",
    "abonnements:change-method"
  ]
}
```

### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid"
  },
  "description": "Identifiant du contrat d’abonnement existant."
}
```

### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/UnisoftRequest_e4c2e3a5eb7c3cc511e2"
      }
    }
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Résultat enregistré réadmis ; aucun moyen réutilisable ni référence privée.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/SubscriptionPaymentChangePreparationResponse"
      }
    }
  }
}
```

#### HTTP 201

```json
{
  "description": "Résultat enregistré réadmis ; aucun moyen réutilisable ni référence privée.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/SubscriptionPaymentChangePreparationResponse"
      }
    }
  }
}
```

#### HTTP 202

```json
{
  "description": "Résultat enregistré réadmis ; aucun moyen réutilisable ni référence privée.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/SubscriptionPaymentChangePreparationResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "INVALID_METHOD_CHANGE_INPUT.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "INSUFFICIENT_SCOPE ; l’avance par carte requiert aussi paiements:write et abonnements:advance.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "NOT_FOUND.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "PREVIEW_CONFLICT, IDEMPOTENCY_CONFLICT, METHOD_CHANGE_LINK_UNAVAILABLE, ALLOCATION_ADVANCE_OWNER_REQUIRED ou un autre refus du propriétaire réadmis.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          }
        }
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "METHOD_CHANGE_STORAGE_UNAVAILABLE; examiner commandId lorsqu’il est fourni.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-scope": "abonnements:write",
  "x-unisoft-additional-scopes": [
    "abonnements:read",
    "paiements:read",
    "abonnements:change-method"
  ],
  "x-unisoft-mcp": {
    "category": "write",
    "readOnly": false,
    "destructive": true,
    "idempotent": true,
    "warn": true
  }
}
```

## GET /abonnements/{id}/payment-method-changes/commands/{commandId}

Lire l’activation enregistrée du changement sans URL d’action

`get_subscription_payment_method_change_command`

Requiert abonnements:read. Lit seulement la commande externe et l’état natif enregistré après réadmission de l’organisation et du périmètre de campagne. Aucun prestataire, progress/rapprochement, verrou, réessai, notification ni authorizationUrl. commandId est l’identifiant externe retourné, pas celui de l’abonnement, la clé native ni le paiement. activated:true exige CONFIRMED natif et le lastMethodChange correspondant sur le contrat actuel, avec paymentMethodPending:false. activated:false est une observation enregistrée, jamais une preuve d’échec d’un paiement distant. RUNNING/UNCERTAIN interdisent tout réessai automatique, y compris avec un autre UUID. La préparation prend uniquement en charge les contrats mensuels locaux ACTIVE/PAUSE/MANUAL/CARD_EXPIRED existants avec active:true, un historique entièrement réadmis, un marchand actuel et un contact CRM. Les propriétaires managés ou SEPA XML spécialisés, changements/activation en attente, incertitudes bancaires et références cachées de campagne sont refusés. Les cibles initiales sont le mandat STRIPE.SEPA et la carte STRIPE de Stripe Connect actuellement configurés. Les autres prestataires restent gérés par leur propriétaire applicatif natif. SETUP prépare un mandat bancaire sans paiement. ADVANCE prépare le paiement autorisé par le payeur de l’occurrence réelle retournée et enregistre la nouvelle carte via le callback natif vérifié ; amount est en unités mineures (5000 EUR signifie EUR 50), sans débit fictif de tokenisation ni débit du moyen enregistré. Une avance par carte avec affectations requiert ALLOCATION_ADVANCE_OWNER_REQUIRED ; aucune répartition n’est devinée. La préparation bloque l’exécution automatique pendant l’attente ; la confirmation native préserve une pause et restaure seulement l’autorité antérieure permise. Lorsqu’une confirmation SETUP reprend un contrat initialement ACTIVE, le propriétaire natif réancre le calendrier non lancé sur le prochain jour d’encaissement configuré strictement après la confirmation dans le fuseau du contrat ; l’ancienne prochaine date n’est pas garantie. PAUSE reste en pause ; ADVANCE règle son occurrence sélectionnée sans ce réancrage SETUP. Un retour navigateur, PREPARED, une URL ou un paiement COMPLETED seul ne prouvent jamais l’activation d’un moyen réutilisable ni un règlement bancaire. Aucune carte, mandat, référence de compte/configuration, jeton public de callback ou instantané du payeur n’est accepté ou retourné. 

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "abonnements:read",
  "additional": []
}
```

### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid"
  },
  "description": "Identifiant du contrat d’abonnement existant."
}
```

```json
{
  "name": "commandId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid"
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Résultat enregistré réadmis ; aucun moyen réutilisable ni référence privée.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/SubscriptionPaymentChangeCommandResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "INVALID_UUID, UNKNOWN_QUERY_PARAMETER ou UNEXPECTED_REQUEST_BODY.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "INSUFFICIENT_SCOPE.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "NOT_FOUND.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "INVALID_METHOD_CHANGE_COMMAND_HISTORY ou INVALID_METHOD_CHANGE_HISTORY.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          }
        }
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "METHOD_CHANGE_STORAGE_UNAVAILABLE.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-scope": "abonnements:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## POST /abonnements/{id}/occurrences/preview

Prévisualiser le déplacement ou le report d’une occurrence future

`preview_subscription_occurrence`

Requiert abonnements:read ET paiements:read. POST en lecture seule utilisant le calendrier/éditeur natif : aucun verrou, journal ni initialisation persistante. Examiner before/after/next avec l’utilisateur ; previewToken représente l’autorité, l’historique, les références et la configuration marchande sans rien réserver. Utiliser exactement cette action occurrence et ce jeton pour l’application confirmée. NO_EFFECTIVE_CHANGE refuse une exception identique. Les dates sont civiles, au format YYYY-MM-DD, dans le timezone retourné ; amount et remainingAmount sont en unités mineures (5000 EUR signifie EUR 50). Les totaux restants null signifient sans limite ou inconnus, jamais zéro. Seuls les contrats locaux ACTIVE/PAUSE existants avec active:true et un historique ainsi que des références entièrement réadmis sont pris en charge. Les propriétaires managés ou SEPA XML spécialisés, l’activation en attente, les occurrences déjà dues ou lancées, l’historique ambigu, les références cachées de campagne/promesse et une affectation à revoir sont refusés. L’occurrence sélectionnée doit être visible parmi les 240 prochaines occurrences natives planifiées ou différées avant et après la modification ; sinon OCCURRENCE_NOT_PLANNED refuse cette prévisualisation bornée. action date fixe une date future explicite et contourne l’espacement hérité de 25 jours. action skip reporte une échéance finie après la dernière date réelle sans annuler son montant ; sur un contrat sans limite, elle devient DEFERRED avec date:null jusqu’à une date explicite future ou reset. action reset avec field:date retire uniquement date/skip et préserve une éventuelle exception de montant ; OCCURRENCE_WOULD_BECOME_DUE refuse un reset qui rendrait l’échéance immédiatement encaissable. Les autres exceptions, règles, montants, moyens réutilisables, identité du payeur et historique financier sont préservés. Aucun débit, paiement, prestataire, notification ou document n’est invoqué. Pour changer les règles globales, utiliser preview_subscription_revision ; l’avance n’est disponible que dans le parcours réel de changement de carte autorisé par le payeur, jamais comme un débit anticipé arbitraire. 

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "abonnements:read",
  "additional": [
    "paiements:read"
  ]
}
```

### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid"
  },
  "description": "Identifiant du contrat d’abonnement mensuel existant."
}
```

### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "occurrence": {
            "$ref": "#/components/schemas/UnisoftRequest_2401b237a86dca02fa7c"
          }
        },
        "required": [
          "occurrence"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Résultat natif d’occurrence réadmis, sans instantané privé.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/SubscriptionOccurrencePreviewResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "INVALID_OCCURRENCE_INPUT ou UNKNOWN_QUERY_PARAMETER.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "INSUFFICIENT_SCOPE.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "NOT_FOUND.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "OCCURRENCE_NOT_PLANNED, OCCURRENCE_ALREADY_DUE, OCCURRENCE_WOULD_BECOME_DUE, NO_EFFECTIVE_CHANGE, LIFECYCLE_RECONCILIATION_REQUIRED ou un refus natif de calendrier/référence.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          }
        }
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "OCCURRENCE_STORAGE_UNAVAILABLE.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-scope": "abonnements:read",
  "x-unisoft-additional-scopes": [
    "paiements:read"
  ],
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## POST /abonnements/{id}/occurrences

Appliquer une exception de date confirmée à une occurrence future

`apply_subscription_occurrence`

Requiert abonnements:write ET abonnements:read ET paiements:read ET l’opt-in abonnements:revise, avec acknowledgeFutureCollections:true. Utiliser d’abord preview_subscription_occurrence et confirmer ses effets. Envoyer la même action occurrence et le même previewToken ; générer idempotencyKey une seule fois. L’éditeur natif prend un verrou EDIT et compare la source complète par CAS. APPLIED/appliedRevision prouvent une modification historique acquittée, pas un encaissement ni l’état actuel. Conserver exactement la requête après un délai dépassé. Observer RUNNING/UNCERTAIN uniquement avec get_subscription_occurrence_command ; ne jamais réessayer le propriétaire ni utiliser un autre UUID. Une barrière durable partagée par contrat demeure après incertitude, sans TTL ni reprise. PREVIEW_CONFLICT exige une nouvelle prévisualisation et confirmation. Les dates sont civiles, au format YYYY-MM-DD, dans le timezone retourné ; amount et remainingAmount sont en unités mineures (5000 EUR signifie EUR 50). Les totaux restants null signifient sans limite ou inconnus, jamais zéro. Seuls les contrats locaux ACTIVE/PAUSE existants avec active:true et un historique ainsi que des références entièrement réadmis sont pris en charge. Les propriétaires managés ou SEPA XML spécialisés, l’activation en attente, les occurrences déjà dues ou lancées, l’historique ambigu, les références cachées de campagne/promesse et une affectation à revoir sont refusés. L’occurrence sélectionnée doit être visible parmi les 240 prochaines occurrences natives planifiées ou différées avant et après la modification ; sinon OCCURRENCE_NOT_PLANNED refuse cette prévisualisation bornée. action date fixe une date future explicite et contourne l’espacement hérité de 25 jours. action skip reporte une échéance finie après la dernière date réelle sans annuler son montant ; sur un contrat sans limite, elle devient DEFERRED avec date:null jusqu’à une date explicite future ou reset. action reset avec field:date retire uniquement date/skip et préserve une éventuelle exception de montant ; OCCURRENCE_WOULD_BECOME_DUE refuse un reset qui rendrait l’échéance immédiatement encaissable. Les autres exceptions, règles, montants, moyens réutilisables, identité du payeur et historique financier sont préservés. Aucun débit, paiement, prestataire, notification ou document n’est invoqué. Pour changer les règles globales, utiliser preview_subscription_revision ; l’avance n’est disponible que dans le parcours réel de changement de carte autorisé par le payeur, jamais comme un débit anticipé arbitraire. 

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "abonnements:write",
  "additional": [
    "abonnements:read",
    "paiements:read",
    "abonnements:revise"
  ]
}
```

### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid"
  },
  "description": "Identifiant du contrat d’abonnement mensuel existant."
}
```

### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "idempotencyKey": {
            "type": "string",
            "format": "uuid"
          },
          "previewToken": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "acknowledgeFutureCollections": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "occurrence": {
            "$ref": "#/components/schemas/UnisoftRequest_2401b237a86dca02fa7c"
          }
        },
        "required": [
          "idempotencyKey",
          "previewToken",
          "acknowledgeFutureCollections",
          "occurrence"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Résultat natif d’occurrence réadmis, sans instantané privé.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/SubscriptionOccurrenceCommandResponse"
      }
    }
  }
}
```

#### HTTP 202

```json
{
  "description": "Résultat natif d’occurrence réadmis, sans instantané privé.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/SubscriptionOccurrenceCommandResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "INVALID_OCCURRENCE_INPUT ou UNKNOWN_QUERY_PARAMETER.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "INSUFFICIENT_SCOPE.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "NOT_FOUND.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "PREVIEW_CONFLICT, IDEMPOTENCY_CONFLICT, LIFECYCLE_RECONCILIATION_REQUIRED ou un autre refus natif avant la prise en charge.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          }
        }
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "OCCURRENCE_STORAGE_UNAVAILABLE. Examiner commandId lorsqu’il est fourni.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-scope": "abonnements:write",
  "x-unisoft-additional-scopes": [
    "abonnements:read",
    "paiements:read",
    "abonnements:revise"
  ],
  "x-unisoft-mcp": {
    "category": "write",
    "readOnly": false,
    "destructive": true,
    "idempotent": true,
    "warn": true
  }
}
```

## GET /abonnements/{id}/occurrences/commands/{commandId}

Lire le résultat enregistré d’une modification d’occurrence

`get_subscription_occurrence_command`

Requiert abonnements:read. Lit uniquement le journal externe de commande de ce contrat réadmis dans l’organisation et le périmètre de campagne. commandId est l’identifiant de commande externe, jamais une occurrence ni un paiement. APPLIED décrit une modification historique acquittée. RUNNING/UNCERTAIN n’autorisent jamais un réessai ni une nouvelle clé ; examiner les enregistrements actuels et résoudre dans l’application propriétaire. Aucun verrou, prestataire, rapprochement, instantané privé ni URL n’est retourné.

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "abonnements:read",
  "additional": []
}
```

### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid"
  },
  "description": "Identifiant du contrat d’abonnement mensuel existant."
}
```

```json
{
  "name": "commandId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid"
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Résultat natif d’occurrence réadmis, sans instantané privé.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/SubscriptionOccurrenceCommandResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "INVALID_UUID, UNKNOWN_QUERY_PARAMETER ou UNEXPECTED_REQUEST_BODY.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "INSUFFICIENT_SCOPE.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "NOT_FOUND.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "INVALID_OCCURRENCE_COMMAND_HISTORY.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          }
        }
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "OCCURRENCE_STORAGE_UNAVAILABLE.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-scope": "abonnements:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## GET /abonnements/{id}/lifecycle

Lire les conditions de pause, de reprise et de résiliation définitive

`get_subscription_lifecycle`

Exige abonnements:read ET paiements:read. Évalue les capacités à partir des données enregistrées, en lecture seule, sans prestataire, verrou, débit, rapprochement ni initialisation persistante de calendrier. expectedRevision est une version opaque pour une commande de cycle de vie ultérieure, distincte de schedule.revision ; les conditions peuvent changer immédiatement. canPause permet d’arrêter l’autorité future même pendant une opération EXECUTE, qui ne peut pas être rappelée. canResume décrit la possibilité de rétablir les débits automatiques futurs, jamais une autorisation de débiter immédiatement ni une preuve de règlement bancaire. Il exige active:true et PAUSE, un moyen enregistré configuré et pris en charge, un historique complet sans ambiguïté et une disponibilité future du calendrier natif. PAUSE conserve active:true ; active:false peut désigner une activation en attente ou une clôture. La pause/reprise distante managée et le cycle spécialisé SEPA XML sont explicitement indisponibles ici. canCancel qualifie séparément la clôture locale et l’annulation managée native NEDARIM/STRIPE_EXTERNAL ; la résiliation est définitive et ne peut pas être suivie d’une reprise. Une capacité peut être false avec un motif précis ; ne pas en déduire de contournement ni utiliser une autre commande pour la contourner. Les restrictions d’organisation et de campagne s’appliquent à l’abonnement, à son origine et aux promesses liées ; la reprise admet aussi l’historique pertinent complet. Des données financières ambiguës ou masquées ne peuvent pas autoriser une reprise. Aucun moyen réutilisable, identifiant de connexion marchand, jeton de verrou, instantané privé ou erreur de prestataire n’est retourné. Une commande externe de cycle de vie non résolue bloque les écritures de cycle de vie suivantes avec LIFECYCLE_RECONCILIATION_REQUIRED, y compris avec un UUID de requête différent ; le temps ne libère jamais cette protection. 

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "abonnements:read",
  "additional": [
    "paiements:read"
  ]
}
```

### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "description": "Identifiant d’abonnement, distinct de l’identifiant d’une occurrence, d’une tentative de paiement ou d’une commande de cycle de vie.",
  "schema": {
    "type": "string",
    "format": "uuid"
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Conditions de cycle de vie enregistrées à asOf.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/SubscriptionLifecycleResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "INVALID_UUID, UNKNOWN_QUERY_PARAMETER ou UNEXPECTED_REQUEST_BODY.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Authentification absente ou invalide.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "INSUFFICIENT_SCOPE, ORGANISATION_REQUIRED ou API_KEY_CONTEXT_REQUIRED.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "NOT_FOUND.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "LIFECYCLE_CONTEXT_UNAVAILABLE ou LIFECYCLE_SCOPE_INCOMPLETE ; les données liées nécessitent une vérification.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "LIFECYCLE_STORAGE_UNAVAILABLE.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "abonnements:read",
  "x-unisoft-additional-scopes": [
    "paiements:read"
  ],
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  },
  "x-unisoft-mcp-output-schema": true
}
```

## POST /abonnements/{id}/pause

Mettre en pause les encaissements futurs de l’abonnement

`pause_subscription`

Lire d’abord get_subscription_lifecycle et utiliser son expectedRevision exact. Exige abonnements:write ET abonnements:read ET paiements:read. L’appelant génère idempotencyKey une fois par intention ; conserver cette clé et exactement les mêmes données après un délai dépassé. APPLIED trace une modification de cycle de vie acquittée à appliedAt, pas l’état actuel de l’abonnement ni un règlement bancaire. RUNNING et UNCERTAIN exigent de lire get_subscription_lifecycle_command et l’abonnement actuel ; ne jamais réexécuter le propriétaire ni changer de clé pour contourner l’incertitude. Ces commandes de cycle de vie n’appellent aucun prestataire. Elles ne révoquent pas de mandat, ne remboursent pas de paiement, n’annulent pas de débit déjà soumis, ne règlent pas d’échéance et n’effacent pas l’historique. Le verrou natif EXECUTE est conservé lors de la pause. Une pause ne peut pas rappeler une opération déjà en cours. 409 SUBSCRIPTION_REVISION_CHANGED exige une nouvelle lecture et une intention de nouveau confirmée. Le journal de commande ne réattribue jamais une opération selon son ancienneté. Seul un contrat local avec active:true, non terminé et non déjà en pause, est éligible ; PAUSE conserve active:true. Cela arrête l’autorité future sans réécrire l’historique financier ni changer le moyen réutilisable. Un verrou EXECUTE n’empêche pas la pause ; un autre verrou l’empêche. Les contrats distants managés indiquent REMOTE_LIFECYCLE_UNAVAILABLE. SEPA XML indique SEPA_LIFECYCLE_REQUIRED car son propriétaire spécialisé doit aussi préserver les règles de mandat, de relance et d’audit natif. Les restrictions d’organisation et de campagne s’appliquent à l’abonnement, à son origine et aux promesses liées ; la reprise admet aussi l’historique pertinent complet. Des données financières ambiguës ou masquées ne peuvent pas autoriser une reprise. Aucun moyen réutilisable, identifiant de connexion marchand, jeton de verrou, instantané privé ou erreur de prestataire n’est retourné. Une commande externe de cycle de vie non résolue bloque les écritures de cycle de vie suivantes avec LIFECYCLE_RECONCILIATION_REQUIRED, y compris avec un UUID de requête différent ; le temps ne libère jamais cette protection. 

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "abonnements:write",
  "additional": [
    "abonnements:read",
    "paiements:read"
  ]
}
```

### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "description": "Identifiant d’abonnement, distinct de l’identifiant d’une occurrence, d’une tentative de paiement ou d’une commande de cycle de vie.",
  "schema": {
    "type": "string",
    "format": "uuid"
  }
}
```

### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "idempotencyKey": {
            "type": "string",
            "format": "uuid",
            "description": "UUID de commande généré par l’appelant, unique dans l’organisation. Conserver cette clé et exactement les mêmes données après un délai dépassé ; une nouvelle clé correspond à une nouvelle demande."
          },
          "expectedRevision": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$",
            "description": "Version exacte opaque retournée par get_subscription_lifecycle. Ne jamais la construire à partir de la révision du calendrier."
          }
        },
        "required": [
          "idempotencyKey",
          "expectedRevision"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Observation enregistrée de la commande de cycle de vie ; APPLIED n’est pas un état actuel.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/SubscriptionLifecycleCommandResponse"
      }
    }
  }
}
```

#### HTTP 202

```json
{
  "description": "RUNNING ou UNCERTAIN ; l’exécution du propriétaire n’est jamais retentée automatiquement.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/SubscriptionLifecycleCommandResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "INVALID_UUID, INVALID_LIFECYCLE_COMMAND ou UNKNOWN_QUERY_PARAMETER.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Authentification absente ou invalide.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "INSUFFICIENT_SCOPE, ORGANISATION_REQUIRED, API_KEY_CONTEXT_REQUIRED ou INVALID_CAMPAIGN_RESTRICTION.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "NOT_FOUND.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "IDEMPOTENCY_CONFLICT, SUBSCRIPTION_REVISION_CHANGED ou le motif explicite de refus de capacité. Vérifier l’état et les données actuels ; ne pas contourner un refus.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "LIFECYCLE_STORAGE_UNAVAILABLE. Si commandId est présent, inspecter cette commande et l’état actuel avant une autre intention.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "abonnements:write",
  "x-unisoft-additional-scopes": [
    "abonnements:read",
    "paiements:read"
  ],
  "x-unisoft-mcp": {
    "category": "write",
    "readOnly": false,
    "destructive": true,
    "idempotent": true,
    "warn": true
  },
  "x-unisoft-mcp-output-schema": true
}
```

## POST /abonnements/{id}/resume

Reprendre les encaissements automatiques futurs de l’abonnement

`resume_subscription`

Lire d’abord get_subscription_lifecycle et utiliser son expectedRevision exact. Exige abonnements:write ET abonnements:read ET paiements:read. L’appelant génère idempotencyKey une fois par intention ; conserver cette clé et exactement les mêmes données après un délai dépassé. APPLIED trace une modification de cycle de vie acquittée à appliedAt, pas l’état actuel de l’abonnement ni un règlement bancaire. RUNNING et UNCERTAIN exigent de lire get_subscription_lifecycle_command et l’abonnement actuel ; ne jamais réexécuter le propriétaire ni changer de clé pour contourner l’incertitude. Ces commandes de cycle de vie n’appellent aucun prestataire. Elles ne révoquent pas de mandat, ne remboursent pas de paiement, n’annulent pas de débit déjà soumis, ne règlent pas d’échéance et n’effacent pas l’historique. Le verrou natif EXECUTE est conservé lors de la pause. Une pause ne peut pas rappeler une opération déjà en cours. 409 SUBSCRIPTION_REVISION_CHANGED exige une nouvelle lecture et une intention de nouveau confirmée. Le journal de commande ne réattribue jamais une opération selon son ancienneté. Exige aussi le droit optionnel explicite abonnements:resume et acknowledgeFutureDebits:true. Cela rend possibles de futurs débits automatiques avec le moyen actuellement enregistré. Seul un contrat local mensuel avec active:true et PAUSE peut reprendre, avec un moyen enregistré configuré valide, aucun remplacement en attente, aucun verrou natif, aucun paiement incertain ou engagé et une occurrence future calculable. L’initialisation du calendrier natif peut être persistée sous son verrou. Le propriétaire natif réancre la première occurrence non lancée au prochain jour mensuel strictement après aujourd’hui dans le fuseau du contrat ; cette commande ne débite pas les mois manqués. L’exécution des paiements reste soumise à ses propres contrôles ultérieurs. Les contrats distants managés indiquent REMOTE_LIFECYCLE_UNAVAILABLE. SEPA XML indique SEPA_LIFECYCLE_REQUIRED car son propriétaire spécialisé doit aussi préserver les règles de mandat, de relance et d’audit natif. Les restrictions d’organisation et de campagne s’appliquent à l’abonnement, à son origine et aux promesses liées ; la reprise admet aussi l’historique pertinent complet. Des données financières ambiguës ou masquées ne peuvent pas autoriser une reprise. Aucun moyen réutilisable, identifiant de connexion marchand, jeton de verrou, instantané privé ou erreur de prestataire n’est retourné. Une commande externe de cycle de vie non résolue bloque les écritures de cycle de vie suivantes avec LIFECYCLE_RECONCILIATION_REQUIRED, y compris avec un UUID de requête différent ; le temps ne libère jamais cette protection. 

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "abonnements:write",
  "additional": [
    "abonnements:read",
    "paiements:read",
    "abonnements:resume"
  ]
}
```

### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "description": "Identifiant d’abonnement, distinct de l’identifiant d’une occurrence, d’une tentative de paiement ou d’une commande de cycle de vie.",
  "schema": {
    "type": "string",
    "format": "uuid"
  }
}
```

### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "idempotencyKey": {
            "type": "string",
            "format": "uuid",
            "description": "UUID de commande généré par l’appelant, unique dans l’organisation. Conserver cette clé et exactement les mêmes données après un délai dépassé ; une nouvelle clé correspond à une nouvelle demande."
          },
          "expectedRevision": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$",
            "description": "Version exacte opaque retournée par get_subscription_lifecycle. Ne jamais la construire à partir de la révision du calendrier."
          },
          "acknowledgeFutureDebits": {
            "type": "boolean",
            "enum": [
              true
            ],
            "description": "Reconnaître explicitement que la reprise autorise le propriétaire existant de l’abonnement à effectuer de futurs encaissements automatiques."
          }
        },
        "required": [
          "idempotencyKey",
          "expectedRevision",
          "acknowledgeFutureDebits"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Observation enregistrée de la commande de cycle de vie ; APPLIED n’est pas un état actuel.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/SubscriptionLifecycleCommandResponse"
      }
    }
  }
}
```

#### HTTP 202

```json
{
  "description": "RUNNING ou UNCERTAIN ; l’exécution du propriétaire n’est jamais retentée automatiquement.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/SubscriptionLifecycleCommandResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "INVALID_UUID, INVALID_LIFECYCLE_COMMAND ou UNKNOWN_QUERY_PARAMETER.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Authentification absente ou invalide.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "INSUFFICIENT_SCOPE, ORGANISATION_REQUIRED, API_KEY_CONTEXT_REQUIRED ou INVALID_CAMPAIGN_RESTRICTION.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "NOT_FOUND.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "IDEMPOTENCY_CONFLICT, SUBSCRIPTION_REVISION_CHANGED ou le motif explicite de refus de capacité. Vérifier l’état et les données actuels ; ne pas contourner un refus.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "LIFECYCLE_STORAGE_UNAVAILABLE. Si commandId est présent, inspecter cette commande et l’état actuel avant une autre intention.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "abonnements:write",
  "x-unisoft-additional-scopes": [
    "abonnements:read",
    "paiements:read",
    "abonnements:resume"
  ],
  "x-unisoft-mcp": {
    "category": "write",
    "readOnly": false,
    "destructive": true,
    "idempotent": true,
    "warn": true
  },
  "x-unisoft-mcp-output-schema": true
}
```

## POST /abonnements/{id}/cancel

Clôturer un abonnement et arrêter son autorité d’encaissement future

`cancel_subscription`

Lire d’abord get_subscription_lifecycle et son expectedRevision exact. Exige abonnements:write ET abonnements:read ET paiements:read, ainsi que acknowledgeCancellation:true. Cette clôture définitive diffère de PAUSE : resume_subscription ne peut pas rouvrir FINISHED. Un contrat local est clôturé par le propriétaire natif du cycle de vie avec state:FINISHED, active:false, manualCancel:true et canceledAt ; un verrou natif EXECUTE est conservé et un débit déjà lancé ne peut pas être rappelé. Pour les contrats managés NEDARIM ou STRIPE_EXTERNAL, l’annulation native existante du prestataire doit confirmer sa réussite AVANT la clôture du contrat local limité au périmètre autorisé ; aucun repli de clôture forcée n’existe. Ce POST managé peut appeler le prestataire, contrairement à la clôture locale et à la lecture. La référence distante actuellement enregistrée et la configuration exacte d’organisation/association sont utilisées ; les références de prestataire et identifiants de connexion fournis par l’appelant sont interdits. Une réponse en échec ou un délai dépassé peut signifier que l’annulation a déjà eu lieu à distance tandis que l’état local reste inchangé. Cela devient UNCERTAIN et le propriétaire n’est jamais réexécuté, même avec un nouvel UUID. APPLIED trace uniquement la clôture acquittée à appliedAt, pas l’état bancaire actuel, un remboursement ou un règlement. Les tentatives existantes/en cours restent présentes et des résultats du prestataire peuvent encore arriver. Les références distantes absentes, prestataires managés non pris en charge et cycle spécialisé SEPA XML produisent des refus explicites avant l’entrée chez le prestataire. Conserver une seule idempotencyKey UUID et exactement la même requête après un délai dépassé ; utiliser get_subscription_lifecycle_command et les lectures du contrat/de l’historique actuels pour résoudre le cas. Les restrictions d’organisation et de campagne s’appliquent à l’abonnement, à son origine et aux promesses liées ; la reprise admet aussi l’historique pertinent complet. Des données financières ambiguës ou masquées ne peuvent pas autoriser une reprise. Aucun moyen réutilisable, identifiant de connexion marchand, jeton de verrou, instantané privé ou erreur de prestataire n’est retourné. Une commande externe de cycle de vie non résolue bloque les écritures de cycle de vie suivantes avec LIFECYCLE_RECONCILIATION_REQUIRED, y compris avec un UUID de requête différent ; le temps ne libère jamais cette protection. 

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "abonnements:write",
  "additional": [
    "abonnements:read",
    "paiements:read"
  ]
}
```

### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "description": "Identifiant d’abonnement, distinct de l’identifiant d’une occurrence, d’une tentative de paiement ou d’une commande de cycle de vie.",
  "schema": {
    "type": "string",
    "format": "uuid"
  }
}
```

### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "idempotencyKey": {
            "type": "string",
            "format": "uuid",
            "description": "UUID de commande généré par l’appelant, unique dans l’organisation. Conserver cette clé et exactement les mêmes données après un délai dépassé ; une nouvelle clé correspond à une nouvelle demande."
          },
          "expectedRevision": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$",
            "description": "Version exacte opaque retournée par get_subscription_lifecycle. Ne jamais la construire à partir de la révision du calendrier."
          },
          "acknowledgeCancellation": {
            "type": "boolean",
            "enum": [
              true
            ],
            "description": "Reconnaître explicitement la clôture définitive du contrat ; contrairement à PAUSE, ce contrat ne peut pas reprendre via resume_subscription."
          }
        },
        "required": [
          "idempotencyKey",
          "expectedRevision",
          "acknowledgeCancellation"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Observation enregistrée de la commande de cycle de vie ; APPLIED n’est pas un état actuel.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/SubscriptionLifecycleCommandResponse"
      }
    }
  }
}
```

#### HTTP 202

```json
{
  "description": "RUNNING ou UNCERTAIN ; l’exécution du propriétaire n’est jamais retentée automatiquement.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/SubscriptionLifecycleCommandResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "INVALID_UUID, INVALID_LIFECYCLE_COMMAND ou UNKNOWN_QUERY_PARAMETER.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Authentification absente ou invalide.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "INSUFFICIENT_SCOPE, ORGANISATION_REQUIRED, API_KEY_CONTEXT_REQUIRED ou INVALID_CAMPAIGN_RESTRICTION.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "NOT_FOUND.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "SUBSCRIPTION_CLOSED, SUBSCRIPTION_BUSY, REMOTE_CANCELLATION_UNAVAILABLE, REMOTE_CANCELLATION_REFERENCE_REQUIRED, REMOTE_CANCELLATION_CONFIGURATION_UNAVAILABLE, SEPA_LIFECYCLE_REQUIRED, IDEMPOTENCY_CONFLICT, SUBSCRIPTION_REVISION_CHANGED ou LIFECYCLE_RECONCILIATION_REQUIRED.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "LIFECYCLE_STORAGE_UNAVAILABLE. Si commandId est présent, inspecter cette commande et l’état actuel avant une autre intention.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "abonnements:write",
  "x-unisoft-additional-scopes": [
    "abonnements:read",
    "paiements:read"
  ],
  "x-unisoft-mcp": {
    "category": "write",
    "readOnly": false,
    "destructive": true,
    "idempotent": true,
    "warn": true
  },
  "x-unisoft-mcp-output-schema": true
}
```

## GET /abonnements/{id}/lifecycle/commands/{commandId}

Lire un résultat enregistré du cycle de vie d’un abonnement

`get_subscription_lifecycle_command`

Exige abonnements:read. Lit uniquement une commande de cycle de vie enregistrée, sans appeler ni relancer son propriétaire. id est l’identifiant d’abonnement et commandId l’identifiant de commande de cycle de vie. APPLIED/appliedState décrivent la modification acquittée à appliedAt, pas l’état actuel du contrat ou du payeur. RUNNING ou UNCERTAIN n’autorisent jamais un réessai selon le temps écoulé ; inspecter l’état actuel de l’abonnement et utiliser l’application propriétaire pour résoudre l’incertitude. Aucun prestataire ni verrou n’est sollicité. Les restrictions d’organisation et de campagne s’appliquent à l’abonnement, à son origine et aux promesses liées ; la reprise admet aussi l’historique pertinent complet. Des données financières ambiguës ou masquées ne peuvent pas autoriser une reprise. Aucun moyen réutilisable, identifiant de connexion marchand, jeton de verrou, instantané privé ou erreur de prestataire n’est retourné. Une commande externe de cycle de vie non résolue bloque les écritures de cycle de vie suivantes avec LIFECYCLE_RECONCILIATION_REQUIRED, y compris avec un UUID de requête différent ; le temps ne libère jamais cette protection. 

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "abonnements:read",
  "additional": []
}
```

### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "description": "Identifiant d’abonnement, distinct de l’identifiant d’une occurrence, d’une tentative de paiement ou d’une commande de cycle de vie.",
  "schema": {
    "type": "string",
    "format": "uuid"
  }
}
```

```json
{
  "name": "commandId",
  "in": "path",
  "required": true,
  "description": "Identifiant de commande de cycle de vie retourné par pause_subscription, resume_subscription ou cancel_subscription.",
  "schema": {
    "type": "string",
    "format": "uuid"
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Observation enregistrée de la commande de cycle de vie ; APPLIED n’est pas un état actuel.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/SubscriptionLifecycleCommandResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "INVALID_UUID, UNKNOWN_QUERY_PARAMETER ou UNEXPECTED_REQUEST_BODY.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Authentification absente ou invalide.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "INSUFFICIENT_SCOPE, ORGANISATION_REQUIRED ou API_KEY_CONTEXT_REQUIRED.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "NOT_FOUND.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "INVALID_LIFECYCLE_COMMAND_HISTORY ou LIFECYCLE_CONTEXT_UNAVAILABLE.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "LIFECYCLE_STORAGE_UNAVAILABLE.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "abonnements:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  },
  "x-unisoft-mcp-output-schema": true
}
```

## POST /abonnements/{id}/reminder/preview

Consulter la disponibilité et prévisualiser une relance d’abonnement interrompu

`preview_abonnement_reminder`

Nécessite abonnements:read, paiements:read ET contacts:read. L’organisation, le principal API, les objets liés, les affectations, l’association/devise et les collectes autorisées sont contrôlés exactement. Aucun paramètre de requête n’est accepté. Les moyens privés, configurations marchandes, preuves du propriétaire, erreurs brutes et URL d’action ne sont jamais renvoyés. Aperçu pur : aucun journal, réservation, file, exécution, rapprochement, calendrier persistant, checkout ni configuration de moyen. READY exige un contrat local actif MANUAL ou CARD_EXPIRED, un snapshot payeur courant exact, un historique financier admis et aucune tentative engagée/incertaine hors checkout enregistré admis. Les capacités propriétaires prises en charge couvrent Stripe, Stripe External, Kesher, Cardcom, PayGreen, Authorize.Net, Axepta, iPay et les parcours de mandat natifs Stripe/Gocardless lorsque le marchand, le moyen et la devise exacts sont configurés ; cette admission locale ne garantit pas le prestataire en direct. Les références figées actives Stripe External/Kesher appartenant localement à l’organisation peuvent rester admises après changement des valeurs par défaut ; le namespace global, l’association et les empreintes de toutes les configurations documentaires sont contrôlés. Un ancien compte Stripe Connect sans preuve locale d’appartenance est refusé au lieu d’être deviné. linkKind=EXISTING_CHECKOUT utilise le propriétaire des incidents pour vérifier une Session Stripe existante, le payeur/la facturation d’origine, le marchand, l’occurrence, la révision et une expiration future. Une Session enregistrée expirée ou contradictoire n’autorise jamais son remplacement. linkKind=NATIVE_MANUAL_ENTRY utilise la sélection réelle de manual_card_renewal avec des ports d’effet fermés : sa branche de configuration versionnée ou de règlement manuel est capturée avant toute exécution/configuration/progression/écriture. Aucun faux succès du propriétaire ni URL PSP inventée n’est accepté. Son URL provient uniquement du contenu natif de relance et de l’environnement API configuré. Lorsque le payeur suit ensuite cette entrée, le propriétaire natif vérifie de nouveau l’état courant et peut rapprocher, préparer un checkout/mandat, régler une occurrence due et renouveler un moyen ; l’aperçu et l’envoi n’exécutent aucune de ces actions. Le payeur reste payload.info, sans remplacement par un contact CRM modifié plus tard. L’objet en texte brut fourni par l’appelant et le message natif sont utilisés, avec chaque URL d’action masquée par [REGULARIZATION_LINK]. nominalAmountMinor désigne le montant mensuel contractuel. settlementAmountMinor est disponible uniquement pour la tentative existante admise ; il reste null pour une entrée native, sans substitution par le montant nominal ni solde d’impayés deviné. Les montants sont en unités mineures (5000 = 50.00 EUR), sans devise déduite/mélangée/convertie. Le snapshot lie abonnement/historique, preuves marchandes/liées, capacité/entrée native ou Session existante, destinataire, contenu et objet. Envoyer uniquement READY avec le snapshot inchangé. Sinon message/snapshot/linkKind restent null. PENDING_ACTIVATION_OWNER_REQUIRED désigne l’enrôlement initial, préalable d’un propriétaire distinct ; aucune nouvelle activation n’est exposée. MANAGED_OWNER, SEPA_XML_OWNER, changement de moyen en attente et revue manuelle explicite conservent leurs propres parcours. NATIVE_MANUAL_OWNER_UNAVAILABLE signifie que cette entrée native n’a pas de capacité courante vérifiée de configuration/règlement, notamment pour le lien versionné PAYME.IDD et les adaptateurs non pris en charge ; ce n’est pas une restriction générale à Stripe. L’état de repos est informatif pour l’aperçu. Une garde durable par organisation/ressource bloque aussi une autre clé après PENDING, UNCERTAIN ou absence de preuve de clôture terminale, même après expiration du dédoublonnage natif par minute/jour. REMINDER_PREVIOUS_RESULT_UNCERTAIN exige d’observer puis de vérifier l’intention existante dans Unisoft ; ne jamais inventer une nouvelle clé ni contourner la garde. Les réservations de ressource exigent des acquittements positifs, exacts et durables d’insertion/CAS. Une preuve de clôture n’est écrite qu’après acquittement positif du journal terminal ; un simple QUEUED/UPDATED/REFUSED enregistré ne peut accorder un autre propriétaire. Une erreur accessoire de tenue de la clôture conserve l’effet positivement prouvé et maintient la garde.

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "abonnements:read",
  "additional": [
    "paiements:read",
    "contacts:read"
  ]
}
```

### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid"
  }
}
```

### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "subject": {
            "type": "string",
            "minLength": 1,
            "maxLength": 200,
            "allOf": [
              {
                "pattern": "\\S"
              },
              {
                "pattern": "^[^\\r\\n]*$"
              }
            ]
          }
        },
        "required": [
          "subject"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Disponibilité autorisée de relance d’abonnement ou observation enregistrée de commande.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/SubscriptionReminderPreview"
          }
        },
        "required": [
          "success",
          "data"
        ]
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "INVALID_UUID, INVALID_REMINDER_INPUT, EXPLICIT_REST_OVERRIDE_REQUIRED ou UNEXPECTED_REQUEST_BODY. Les champs inconnus et tous les paramètres de requête sont refusés.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        },
        "required": [
          "success",
          "error"
        ]
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Authentification absente ou invalide.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        },
        "required": [
          "success",
          "error"
        ]
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "INSUFFICIENT_SCOPE ou INVALID_PRINCIPAL. Les droits de lecture sont cumulatifs ; l’envoi exige le droit attribué explicitement.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        },
        "required": [
          "success",
          "error"
        ]
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "NOT_FOUND : l’abonnement, une référence requise du payeur/objet lié ou la commande de cette identité API est indisponible dans le périmètre autorisé d’organisation et de collectes.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        },
        "required": [
          "success",
          "error"
        ]
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "SUBSCRIPTION_REMINDER_UNAVAILABLE : consulter preview.availability. REST_TIME et REST_STATUS_UNAVAILABLE bloquent la mise en file. REMINDER_SNAPSHOT_CHANGED, REMINDER_RECENT et IDEMPOTENCY_CONFLICT refusent une intention modifiée ou concurrente. Un échéancier, marchand, association, devise, affectation historique ou payeur invalide exige une revue dans l’application propriétaire. Un résultat incertain n’autorise jamais un réessai avec une nouvelle clé.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        },
        "required": [
          "success",
          "error"
        ]
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "INTERNAL_ERROR. Ne pas en déduire un échec d’envoi ni réessayer avec une nouvelle clé.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        },
        "required": [
          "success",
          "error"
        ]
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "REMINDER_JOURNAL_UNCERTAIN, REMINDER_QUEUE_UNCERTAIN, REMINDER_LINK_UNCERTAIN, REMINDER_TOKEN_UNCERTAIN ou REMINDER_RESERVATION_UNCERTAIN. Un acquittement durable d’écriture est absent ou contradictoire ; aucun nouvel effet ni réessai n’est autorisé. Observer la demande existante avec la même identité. REMINDER_RESOURCE_RESERVATION_UNCERTAIN n’accorde aucun propriétaire de ressource et n’autorise aucun effet ultérieur.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        },
        "required": [
          "success",
          "error"
        ]
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-scope": "abonnements:read",
  "x-unisoft-additional-scopes": [
    "paiements:read",
    "contacts:read"
  ],
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## POST /abonnements/{id}/reminder/send

Mettre en file une relance d’abonnement native admise

`send_abonnement_reminder`

Nécessite abonnements:read, paiements:read ET contacts:read. L’organisation, le principal API, les objets liés, les affectations, l’association/devise et les collectes autorisées sont contrôlés exactement. Aucun paramètre de requête n’est accepté. Les moyens privés, configurations marchandes, preuves du propriétaire, erreurs brutes et URL d’action ne sont jamais renvoyés. Nécessite aussi l’attribution explicite de abonnements:reminders:send. Prévisualiser READY et examiner linkKind, le payeur et les effets ultérieurs de l’entrée native. Fournir le même objet, expectedSnapshot et un idempotencyKey UUID. Un journal durable et une garde de ressource entre clés précèdent le CAS exact de reminderAttempt et l’insertion en file. État courant, marchand/capacité, historique lié, payeur et délai natif d’une minute sont de nouveau admis avant la mise en file. Des métadonnées négatives d’écriture/acquittement n’accordent jamais d’autorité même avec acknowledged=true ; l’incertitude est conservée. Seule l’URL du checkout existant admis ou de l’entrée native du payeur est placée dans l’email ; l’API ne la suit jamais, n’appelle aucun rapprochement/exécution/configuration/progression, ne crée ni recrée de checkout, ne débite pas, ne reprend pas le contrat, ne remplace aucun moyen, n’active pas l’enrôlement initial et ne notifie pas le personnel. Le destinataire peut ensuite utiliser l’entrée native pour son propre parcours financier vérifié séparément ; envoyer l’email ne prouve aucun de ses résultats. Une source modifiée refuse le snapshot/la réservation. Chabbat et Yom Tov utilisent le calendrier canonique Paris/diaspora (Europe/Paris) ; REST_TIME ou calcul indisponible refuse l’admission. forceRest=true exige restOverrideReason ET une intention explicite de dérogation de l’utilisateur, jamais un contournement automatique. La garde porte sur l’admission en file, sans garantie sur le transport/l’arrivée ultérieurs. Un principal/clé/entrée identique observe la commande précédente ; une entrée différente donne IDEMPOTENCY_CONFLICT. Conserver les réservations natives après incertitude. QUEUED prouve uniquement l’admission locale durable, sans livraison, paiement, renouvellement du moyen ni soutien repris. Aucun réessai automatique de commande ni interrogation de prestataire. Les contrôles sont des observations optimistes, sans transaction globale ni garantie future d’utilisabilité du prestataire/lien. Une erreur accessoire de lecture de livraison donne deliveryRead=UNAVAILABLE sans annuler l’effet de file connu. Une garde durable par organisation/ressource bloque aussi une autre clé après PENDING, UNCERTAIN ou absence de preuve de clôture terminale, même après expiration du dédoublonnage natif par minute/jour. REMINDER_PREVIOUS_RESULT_UNCERTAIN exige d’observer puis de vérifier l’intention existante dans Unisoft ; ne jamais inventer une nouvelle clé ni contourner la garde. Les réservations de ressource exigent des acquittements positifs, exacts et durables d’insertion/CAS. Une preuve de clôture n’est écrite qu’après acquittement positif du journal terminal ; un simple QUEUED/UPDATED/REFUSED enregistré ne peut accorder un autre propriétaire. Une erreur accessoire de tenue de la clôture conserve l’effet positivement prouvé et maintient la garde.

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "abonnements:reminders:send",
  "additional": [
    "abonnements:read",
    "paiements:read",
    "contacts:read"
  ]
}
```

### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid"
  }
}
```

### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "subject": {
            "type": "string",
            "minLength": 1,
            "maxLength": 200,
            "allOf": [
              {
                "pattern": "\\S"
              },
              {
                "pattern": "^[^\\r\\n]*$"
              }
            ]
          },
          "idempotencyKey": {
            "type": "string",
            "format": "uuid"
          },
          "expectedSnapshot": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "forceRest": {
            "type": "boolean"
          },
          "restOverrideReason": {
            "type": "string",
            "minLength": 1,
            "maxLength": 500,
            "pattern": "\\S"
          }
        },
        "required": [
          "subject",
          "idempotencyKey",
          "expectedSnapshot"
        ],
        "additionalProperties": false,
        "oneOf": [
          {
            "type": "object",
            "properties": {
              "forceRest": {
                "type": "boolean",
                "enum": [
                  true
                ]
              }
            },
            "required": [
              "forceRest",
              "restOverrideReason"
            ],
            "additionalProperties": true
          },
          {
            "type": "object",
            "properties": {
              "forceRest": {
                "type": "boolean",
                "enum": [
                  false
                ]
              }
            },
            "additionalProperties": true,
            "not": {
              "required": [
                "restOverrideReason"
              ]
            }
          }
        ]
      }
    }
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Disponibilité autorisée de relance d’abonnement ou observation enregistrée de commande.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/SubscriptionReminderCommand"
          }
        },
        "required": [
          "success",
          "data"
        ]
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "INVALID_UUID, INVALID_REMINDER_INPUT, EXPLICIT_REST_OVERRIDE_REQUIRED ou UNEXPECTED_REQUEST_BODY. Les champs inconnus et tous les paramètres de requête sont refusés.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        },
        "required": [
          "success",
          "error"
        ]
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Authentification absente ou invalide.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        },
        "required": [
          "success",
          "error"
        ]
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "INSUFFICIENT_SCOPE ou INVALID_PRINCIPAL. Les droits de lecture sont cumulatifs ; l’envoi exige le droit attribué explicitement.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        },
        "required": [
          "success",
          "error"
        ]
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "NOT_FOUND : l’abonnement, une référence requise du payeur/objet lié ou la commande de cette identité API est indisponible dans le périmètre autorisé d’organisation et de collectes.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        },
        "required": [
          "success",
          "error"
        ]
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "SUBSCRIPTION_REMINDER_UNAVAILABLE : consulter preview.availability. REST_TIME et REST_STATUS_UNAVAILABLE bloquent la mise en file. REMINDER_SNAPSHOT_CHANGED, REMINDER_RECENT et IDEMPOTENCY_CONFLICT refusent une intention modifiée ou concurrente. Un échéancier, marchand, association, devise, affectation historique ou payeur invalide exige une revue dans l’application propriétaire. Un résultat incertain n’autorise jamais un réessai avec une nouvelle clé.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        },
        "required": [
          "success",
          "error"
        ]
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "INTERNAL_ERROR. Ne pas en déduire un échec d’envoi ni réessayer avec une nouvelle clé.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        },
        "required": [
          "success",
          "error"
        ]
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "REMINDER_JOURNAL_UNCERTAIN, REMINDER_QUEUE_UNCERTAIN, REMINDER_LINK_UNCERTAIN, REMINDER_TOKEN_UNCERTAIN ou REMINDER_RESERVATION_UNCERTAIN. Un acquittement durable d’écriture est absent ou contradictoire ; aucun nouvel effet ni réessai n’est autorisé. Observer la demande existante avec la même identité. REMINDER_RESOURCE_RESERVATION_UNCERTAIN n’accorde aucun propriétaire de ressource et n’autorise aucun effet ultérieur.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        },
        "required": [
          "success",
          "error"
        ]
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-scope": "abonnements:reminders:send",
  "x-unisoft-additional-scopes": [
    "abonnements:read",
    "paiements:read",
    "contacts:read"
  ],
  "x-unisoft-mcp": {
    "category": "write",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": true
  }
}
```

## GET /abonnements/{id}/reminder/commands/{requestId}

Observer une commande de relance d’abonnement sans la rejouer

`get_abonnement_reminder_command`

Nécessite abonnements:read, paiements:read ET contacts:read. L’organisation, le principal API, les objets liés, les affectations, l’association/devise et les collectes autorisées sont contrôlés exactement. Aucun paramètre de requête n’est accepté. Les moyens privés, configurations marchandes, preuves du propriétaire, erreurs brutes et URL d’action ne sont jamais renvoyés. Nécessite aussi abonnements:reminders:send explicitement accordé et le principal API d’origine. Lecture seule : aucune interrogation de prestataire, réservation de relance, nouvel envoi, rapprochement financier ni nouveau checkout. Les droits courants sur l’organisation/collecte de l’abonnement sont de nouveau admis ; un changement ultérieur de cycle ne supprime pas un email déjà mis en file. PENDING/UNCERTAIN ne signifie jamais échec et n’autorise jamais une nouvelle clé. QUEUED_OR_IN_FLIGHT ne distingue pas l’attente d’un worker actif. SMTP_ACCEPTED prouve seulement l’acceptation du transport ; DELIVERED exige un rapport explicite et deliveredAt valide. UNKNOWN, UNCERTAIN ou deliveryRead=UNAVAILABLE laisse la livraison non prouvée. Ni l’admission en file ni la livraison ne prouve que le payeur a suivi l’entrée native, payé, renouvelé son moyen ou repris le contrat. Une garde durable par organisation/ressource bloque aussi une autre clé après PENDING, UNCERTAIN ou absence de preuve de clôture terminale, même après expiration du dédoublonnage natif par minute/jour. REMINDER_PREVIOUS_RESULT_UNCERTAIN exige d’observer puis de vérifier l’intention existante dans Unisoft ; ne jamais inventer une nouvelle clé ni contourner la garde. Les réservations de ressource exigent des acquittements positifs, exacts et durables d’insertion/CAS. Une preuve de clôture n’est écrite qu’après acquittement positif du journal terminal ; un simple QUEUED/UPDATED/REFUSED enregistré ne peut accorder un autre propriétaire. Une erreur accessoire de tenue de la clôture conserve l’effet positivement prouvé et maintient la garde.

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "abonnements:reminders:send",
  "additional": [
    "abonnements:read",
    "paiements:read",
    "contacts:read"
  ]
}
```

### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid"
  }
}
```

```json
{
  "name": "requestId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid"
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Disponibilité autorisée de relance d’abonnement ou observation enregistrée de commande.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/SubscriptionReminderCommand"
          }
        },
        "required": [
          "success",
          "data"
        ]
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "INVALID_UUID, INVALID_REMINDER_INPUT, EXPLICIT_REST_OVERRIDE_REQUIRED ou UNEXPECTED_REQUEST_BODY. Les champs inconnus et tous les paramètres de requête sont refusés.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        },
        "required": [
          "success",
          "error"
        ]
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Authentification absente ou invalide.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        },
        "required": [
          "success",
          "error"
        ]
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "INSUFFICIENT_SCOPE ou INVALID_PRINCIPAL. Les droits de lecture sont cumulatifs ; l’envoi exige le droit attribué explicitement.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        },
        "required": [
          "success",
          "error"
        ]
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "NOT_FOUND : l’abonnement, une référence requise du payeur/objet lié ou la commande de cette identité API est indisponible dans le périmètre autorisé d’organisation et de collectes.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        },
        "required": [
          "success",
          "error"
        ]
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "SUBSCRIPTION_REMINDER_UNAVAILABLE : consulter preview.availability. REST_TIME et REST_STATUS_UNAVAILABLE bloquent la mise en file. REMINDER_SNAPSHOT_CHANGED, REMINDER_RECENT et IDEMPOTENCY_CONFLICT refusent une intention modifiée ou concurrente. Un échéancier, marchand, association, devise, affectation historique ou payeur invalide exige une revue dans l’application propriétaire. Un résultat incertain n’autorise jamais un réessai avec une nouvelle clé.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        },
        "required": [
          "success",
          "error"
        ]
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "INTERNAL_ERROR. Ne pas en déduire un échec d’envoi ni réessayer avec une nouvelle clé.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        },
        "required": [
          "success",
          "error"
        ]
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "REMINDER_JOURNAL_UNCERTAIN, REMINDER_QUEUE_UNCERTAIN, REMINDER_LINK_UNCERTAIN, REMINDER_TOKEN_UNCERTAIN ou REMINDER_RESERVATION_UNCERTAIN. Un acquittement durable d’écriture est absent ou contradictoire ; aucun nouvel effet ni réessai n’est autorisé. Observer la demande existante avec la même identité. REMINDER_RESOURCE_RESERVATION_UNCERTAIN n’accorde aucun propriétaire de ressource et n’autorise aucun effet ultérieur.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        },
        "required": [
          "success",
          "error"
        ]
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-scope": "abonnements:reminders:send",
  "x-unisoft-additional-scopes": [
    "abonnements:read",
    "paiements:read",
    "contacts:read"
  ],
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## POST /abonnements/requests

Préparer un abonnement mensuel nécessitant l’autorisation du payeur

`prepare_subscription`

Autorisations requises : `abonnements:write` ET `paiements:write`. Crée ou enrichit l’identité CRM, crée un contrat d’abonnement GENERAL avec active:false et prépare un Checkout hébergé pour le premier paiement via les propriétaires existants. Les correspondances CRM ambiguës, supprimées, étrangères ou dupliquées sont refusées ; les écritures CRM utilisent un seul contact admis avec des mises à jour conditionnelles limitées au périmètre. C’est une écriture réelle pouvant créer un client/Checkout chez le prestataire ; elle ne débite pas un moyen enregistré. Le payeur doit autoriser et payer sur la page retournée. La couverture initiale est GENERAL mensuel avec un adaptateur de carte hébergé Stripe Connect ou Stripe External vérifié. Les cibles liées, contrats managés, mandats bancaires et moyens réutilisables ne sont pas admis ici. montant est en unités majeures ; maxAmount en mineures. Les deux limites à zéro signifient explicitement sans limite. La même idempotencyKey et exactement les mêmes données ne réexécutent jamais les propriétaires de création. Des données différentes retournent IDEMPOTENCY_CONFLICT. PREPARING ou UNCERTAIN exige un rapprochement par identifiant de requête ; ne jamais changer de clé pour forcer un réessai. PREPARED trace un Checkout préparé, pas un consentement, une activation, une capture ou un règlement bancaire confirmés. Son expiration est prouvée par une lecture native authentifiée de Session ; aucune durée n’est inventée quand le propriétaire de création omet l’expiration. Avant toute divulgation de l’URL, y compris lors d’un rejeu, le marchand/la politique actuels, les données natives en attente et la Session authentifiée ouverte/non payée doivent toujours correspondre. Le rejeu peut lire le prestataire mais ne recrée jamais le Checkout ni le contrat. L’URL est retournée uniquement au principal disposant des deux droits d’écriture ; GET de statut l’exclut volontairement et n’appelle aucun prestataire. Les clés limitées aux campagnes sont refusées. Lire le guide subscription-commands avant toute écriture.

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "abonnements:write",
  "additional": [
    "paiements:write"
  ]
}
```

### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/UnisoftRequest_7bdae3ccb939dc1b03a6"
      }
    }
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Préparation enregistrée, pas une preuve de consentement du payeur, d’encaissement ou de règlement bancaire.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/SubscriptionPreparationResponse"
      }
    }
  }
}
```

#### HTTP 202

```json
{
  "description": "Préparation enregistrée, pas une preuve de consentement du payeur, d’encaissement ou de règlement bancaire.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/SubscriptionPreparationResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Code d’erreur fixe ; aucune exception de prestataire, information de connexion ou donnée privée.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/SubscriptionPreparationError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Code d’erreur fixe ; aucune exception de prestataire, information de connexion ou donnée privée.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/SubscriptionPreparationError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Code d’erreur fixe ; aucune exception de prestataire, information de connexion ou donnée privée.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/SubscriptionPreparationError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Code d’erreur fixe ; aucune exception de prestataire, information de connexion ou donnée privée.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/SubscriptionPreparationError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Code d’erreur fixe ; aucune exception de prestataire, information de connexion ou donnée privée.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/SubscriptionPreparationError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "abonnements:write",
  "x-unisoft-additional-scopes": [
    "paiements:write"
  ],
  "x-unisoft-mcp": {
    "category": "create",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": true
  },
  "x-unisoft-mcp-output-schema": true
}
```

## GET /abonnements/requests/{requestId}

Lire une préparation d’abonnement sans son lien d’action

`get_subscription_preparation`

Autorisation requise : `abonnements:read`. Lit uniquement la préparation externe enregistrée et son intention financière dans l’organisation authentifiée. Ne contacte aucun prestataire, n’initialise aucun calendrier, ne retente aucune création et n’expose pas l’URL d’autorisation du payeur. PREPARED est l’observation initiale du Checkout, pas l’état actuel du prestataire ou de l’abonnement ; lire get_abonnement/get_paiement_status avec leurs propres droits pour les enregistrements courants. PREPARING et UNCERTAIN ne doivent pas être remplacés par une nouvelle requête. Aucun instantané d’identité, référence marchande, carte, jeton client ou mandat n’est retourné. Les clés limitées aux campagnes sont refusées.

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "abonnements:read",
  "additional": []
}
```

### Paramètres

```json
{
  "name": "requestId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid"
  },
  "description": "Identifiant de préparation existante retourné par prepare_subscription ; ce n’est ni un identifiant d’abonnement ni un nouvel UUID généré."
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Préparation enregistrée, pas une preuve de consentement du payeur, d’encaissement ou de règlement bancaire.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/SubscriptionPreparationResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Code d’erreur fixe ; aucune exception de prestataire, information de connexion ou donnée privée.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/SubscriptionPreparationError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Code d’erreur fixe ; aucune exception de prestataire, information de connexion ou donnée privée.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/SubscriptionPreparationError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Code d’erreur fixe ; aucune exception de prestataire, information de connexion ou donnée privée.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/SubscriptionPreparationError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Code d’erreur fixe ; aucune exception de prestataire, information de connexion ou donnée privée.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/SubscriptionPreparationError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Code d’erreur fixe ; aucune exception de prestataire, information de connexion ou donnée privée.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/SubscriptionPreparationError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "abonnements:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  },
  "x-unisoft-mcp-output-schema": true
}
```

## Schémas

```json
{
  "components": {
    "schemas": {
      "Abonnement": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "id",
          "organisation",
          "contact",
          "recurrentType",
          "active",
          "confirmed",
          "managed",
          "state",
          "datetime",
          "canceledAt",
          "nb",
          "max",
          "payload"
        ],
        "properties": {
          "id": {
            "type": "string",
            "nullable": true,
            "description": "Identifiant d’abonnement enregistré. Les valeurs historiques absentes ou de type incorrect valent null."
          },
          "organisation": {
            "type": "string",
            "nullable": true,
            "description": "Organisation propriétaire, sélectionnée depuis l’organisation authentifiée avant la projection."
          },
          "contact": {
            "type": "string",
            "nullable": true,
            "description": "Identifiant du contact CRM enregistré. Aucune identité ni permission sur le contact n’est déduite de la référence."
          },
          "recurrentType": {
            "type": "string",
            "nullable": true,
            "description": "Code de récurrence enregistré. Le moteur local actuel utilise MONTH ; ce champ ne décrit pas à lui seul un calendrier calculé."
          },
          "active": {
            "type": "boolean",
            "nullable": true,
            "description": "Marqueur active enregistré exact. false couvre plusieurs situations du cycle de vie et ne signifie pas une pause ; null indique une valeur inconnue."
          },
          "confirmed": {
            "type": "boolean",
            "nullable": true,
            "description": "Marqueur de confirmation enregistré exact, ou null si absent/invalide. Il ne représente pas un résultat de règlement bancaire."
          },
          "managed": {
            "type": "boolean",
            "nullable": true,
            "description": "Marqueur enregistré exact de gestion distante, ou null si absent/invalide. Aucune référence ni synchronisation distante n’est exposée."
          },
          "state": {
            "type": "string",
            "nullable": true,
            "description": "État du cycle de vie enregistré exact respectant le motif documenté. Les codes inconnus bien formés sont conservés ; les valeurs absentes ou mal formées valent null. Aucune permission de débit ni aucun état d’affichage déduit n’est renvoyé.",
            "pattern": "^[A-Z][A-Z0-9_-]{0,63}$",
            "maxLength": 64
          },
          "datetime": {
            "type": "string",
            "format": "date-time",
            "nullable": true,
            "description": "Date et heure initiales/d’ancrage enregistrées, normalisées en ISO pour les années 0000 à 9999. Accepte les dates stockées valides, les millisecondes entières depuis l’époque Unix, les dates/heures ISO strictes avec fuseau ou YYYY-MM-DD à minuit UTC. Les dates civiles impossibles et les chaînes ambiguës valent null sans report vers un autre jour. Il ne s’agit pas de la prochaine date de débit calculée."
          },
          "canceledAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true,
            "description": "Date et heure d’annulation enregistrées, normalisées avec les mêmes règles strictes que datetime. null indique une valeur absente ou invalide, sans prouver qu’une annulation est impossible ou inutile."
          },
          "nb": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991,
            "nullable": true,
            "description": "Limite contractuelle du nombre d’échéances enregistrée. null indique une valeur absente/invalide ; il ne s’agit ni d’un nombre de paiements encaissés ni d’une fréquence. Un zéro stocké explicitement est conservé et ne constitue pas une limite positive."
          },
          "max": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991,
            "nullable": true,
            "description": "Plafond contractuel total enregistré en unités monétaires mineures. null indique une valeur absente/invalide, sans plafond fabriqué ; un zéro stocké explicitement est conservé et ne constitue pas une limite positive. Il ne s’agit ni d’un reste ni d’un montant encaissé."
          },
          "payload": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "amount",
              "devise",
              "assoc",
              "type",
              "typeId",
              "parentTypeId",
              "method",
              "platform",
              "name",
              "cerfa",
              "cerfaYear",
              "pledgeReceiptRequested",
              "info",
              "facturation",
              "dettes"
            ],
            "properties": {
              "amount": {
                "type": "integer",
                "minimum": 1,
                "maximum": 9007199254740991,
                "nullable": true,
                "description": "Montant nominal enregistré en unités monétaires mineures : 5000 = 50.00 EUR. Il ne représente ni un total encaissé ni le montant d’une échéance particulière. Les valeurs absentes, égales à zéro, négatives ou invalides valent null sans conversion ni repli."
              },
              "devise": {
                "type": "string",
                "nullable": true,
                "pattern": "^[a-z]{3}$",
                "description": "Devise nominale enregistrée, en minuscules. Les valeurs absentes ou mal formées valent null ; la devise de l’organisation ne s’y substitue jamais."
              },
              "assoc": {
                "type": "string",
                "nullable": true,
                "description": "Association bénéficiaire enregistrée. MAIN est une référence valide à l’association principale ; aucune association absente n’est devinée."
              },
              "type": {
                "type": "string",
                "nullable": true,
                "description": "Type d’affectation métier enregistré. Les chaînes historiques et futures sont conservées sans donner accès à la cible."
              },
              "typeId": {
                "type": "string",
                "nullable": true,
                "description": "Cible métier enregistrée. FORM désigne une soumission ; GENERAL peut valoir null. Cette référence ne donne aucune autorité sur une autre ressource."
              },
              "parentTypeId": {
                "type": "string",
                "nullable": true,
                "description": "Identifiant enregistré du formulaire parent lorsqu’il existe ; aucun parent n’est déduit de l’abonnement."
              },
              "method": {
                "type": "string",
                "nullable": true,
                "description": "Instrument enregistré pour le contrat. Aucun instrument réutilisable ni capacité prestataire n’est déduit."
              },
              "platform": {
                "type": "string",
                "nullable": true,
                "description": "Prestataire d’exécution enregistré. Aucune référence réutilisable ni configuration prestataire n’est exposée."
              },
              "name": {
                "type": "string",
                "nullable": true,
                "description": "Libellé du contrat enregistré pour la lecture humaine."
              },
              "cerfa": {
                "type": "boolean",
                "nullable": true,
                "description": "Choix enregistré de document fiscal pour les futurs paiements. Il ne prouve ni éligibilité fiscale, ni émission d’un reçu, ni montant encaissé."
              },
              "cerfaYear": {
                "type": "boolean",
                "nullable": true,
                "description": "Mode annuel de document fiscal enregistré. Il est indépendant de l’encaissement des paiements et du traitement documentaire unitaire ordinaire."
              },
              "pledgeReceiptRequested": {
                "type": "boolean",
                "nullable": true,
                "description": "Intention enregistrée de document fiscal pour les affectations aux promesses, lorsqu’elle existe. Les snapshots des paiements existants restent la référence pour ces paiements."
              },
              "info": {
                "type": "object",
                "additionalProperties": false,
                "required": [
                  "nom",
                  "prenom",
                  "email",
                  "tel"
                ],
                "properties": {
                  "nom": {
                    "type": "string",
                    "nullable": true,
                    "description": "Champ d’identité enregistré du donateur. Les chaînes vides sont conservées ; les valeurs absentes ou de type incorrect valent null. Aucun enrichissement depuis le contact n’est effectué."
                  },
                  "prenom": {
                    "type": "string",
                    "nullable": true,
                    "description": "Champ d’identité enregistré du donateur. Les chaînes vides sont conservées ; les valeurs absentes ou de type incorrect valent null. Aucun enrichissement depuis le contact n’est effectué."
                  },
                  "email": {
                    "type": "string",
                    "nullable": true,
                    "description": "Champ d’identité enregistré du donateur. Les chaînes vides sont conservées ; les valeurs absentes ou de type incorrect valent null. Aucun enrichissement depuis le contact n’est effectué."
                  },
                  "tel": {
                    "type": "string",
                    "nullable": true,
                    "description": "Champ d’identité enregistré du donateur. Les chaînes vides sont conservées ; les valeurs absentes ou de type incorrect valent null. Aucun enrichissement depuis le contact n’est effectué."
                  }
                },
                "description": "Identité enregistrée du donateur en liste blanche. Aucun enrichissement CRM, donnée de moyen de paiement ni champ privé supplémentaire."
              },
              "facturation": {
                "type": "object",
                "additionalProperties": false,
                "required": [
                  "nom",
                  "prenom",
                  "raison",
                  "siren",
                  "civilite",
                  "adresse",
                  "postal",
                  "ville",
                  "etat",
                  "pays",
                  "social_id",
                  "perso",
                  "giftAid"
                ],
                "properties": {
                  "nom": {
                    "type": "string",
                    "nullable": true,
                    "description": "Champ enregistré d’identité ou d’adresse de facturation. Les chaînes vides sont conservées ; les valeurs absentes ou de type incorrect valent null. Les références prestataires d’acheteur et de carte sont exclues."
                  },
                  "prenom": {
                    "type": "string",
                    "nullable": true,
                    "description": "Champ enregistré d’identité ou d’adresse de facturation. Les chaînes vides sont conservées ; les valeurs absentes ou de type incorrect valent null. Les références prestataires d’acheteur et de carte sont exclues."
                  },
                  "raison": {
                    "type": "string",
                    "nullable": true,
                    "description": "Champ enregistré d’identité ou d’adresse de facturation. Les chaînes vides sont conservées ; les valeurs absentes ou de type incorrect valent null. Les références prestataires d’acheteur et de carte sont exclues."
                  },
                  "siren": {
                    "type": "string",
                    "nullable": true,
                    "description": "Champ enregistré d’identité ou d’adresse de facturation. Les chaînes vides sont conservées ; les valeurs absentes ou de type incorrect valent null. Les références prestataires d’acheteur et de carte sont exclues."
                  },
                  "civilite": {
                    "type": "string",
                    "nullable": true,
                    "description": "Champ enregistré d’identité ou d’adresse de facturation. Les chaînes vides sont conservées ; les valeurs absentes ou de type incorrect valent null. Les références prestataires d’acheteur et de carte sont exclues."
                  },
                  "adresse": {
                    "type": "string",
                    "nullable": true,
                    "description": "Champ enregistré d’identité ou d’adresse de facturation. Les chaînes vides sont conservées ; les valeurs absentes ou de type incorrect valent null. Les références prestataires d’acheteur et de carte sont exclues."
                  },
                  "postal": {
                    "type": "string",
                    "nullable": true,
                    "description": "Champ enregistré d’identité ou d’adresse de facturation. Les chaînes vides sont conservées ; les valeurs absentes ou de type incorrect valent null. Les références prestataires d’acheteur et de carte sont exclues."
                  },
                  "ville": {
                    "type": "string",
                    "nullable": true,
                    "description": "Champ enregistré d’identité ou d’adresse de facturation. Les chaînes vides sont conservées ; les valeurs absentes ou de type incorrect valent null. Les références prestataires d’acheteur et de carte sont exclues."
                  },
                  "etat": {
                    "type": "string",
                    "nullable": true,
                    "description": "Champ enregistré d’identité ou d’adresse de facturation. Les chaînes vides sont conservées ; les valeurs absentes ou de type incorrect valent null. Les références prestataires d’acheteur et de carte sont exclues."
                  },
                  "pays": {
                    "type": "string",
                    "nullable": true,
                    "description": "Champ enregistré d’identité ou d’adresse de facturation. Les chaînes vides sont conservées ; les valeurs absentes ou de type incorrect valent null. Les références prestataires d’acheteur et de carte sont exclues."
                  },
                  "social_id": {
                    "type": "string",
                    "nullable": true,
                    "description": "Champ enregistré d’identité ou d’adresse de facturation. Les chaînes vides sont conservées ; les valeurs absentes ou de type incorrect valent null. Les références prestataires d’acheteur et de carte sont exclues."
                  },
                  "perso": {
                    "type": "boolean",
                    "nullable": true,
                    "description": "Discriminant personne physique/entreprise enregistré. null indique une valeur inconnue, sans identité personnelle déduite."
                  },
                  "giftAid": {
                    "type": "boolean",
                    "nullable": true,
                    "description": "Déclaration Gift Aid enregistrée explicitement, ou null si absente/invalide. Aucune éligibilité n’est déduite."
                  }
                },
                "description": "Identité et adresse de facturation enregistrées en liste blanche. Aucune carte stockée, référence d’acheteur/client ni donnée prestataire."
              },
              "dettes": {
                "type": "array",
                "nullable": true,
                "description": "Lignes enregistrées d’affectation aux promesses. montant est en unités monétaires MAJEURES et peut décrire le budget total du contrat historique, sans représenter un paiement encaissé particulier. Un tableau explicitement vide reste vide ; les conteneurs absents/invalides valent null et les lignes mal formées conservent des champs null. Aucun total d’affectation ni solde actuel de promesse n’est déduit.",
                "items": {
                  "type": "object",
                  "additionalProperties": false,
                  "required": [
                    "id",
                    "montant"
                  ],
                  "properties": {
                    "id": {
                      "type": "string",
                      "nullable": true,
                      "description": "Identifiant de promesse enregistré. Cette référence ne donne aucune autorité pour lire la promesse."
                    },
                    "montant": {
                      "type": "number",
                      "minimum": 0,
                      "maximum": 90071992547409.9,
                      "nullable": true,
                      "description": "Affectation enregistrée en unités monétaires MAJEURES, sans arrondi ni conversion d’unité. Les valeurs non finies, négatives, de type incorrect ou hors limites valent null."
                    }
                  }
                }
              }
            },
            "description": "Contrat d’abonnement enregistré en liste blanche. Les données monétaires nominales restent sous payload.amount/devise. Aucun moyen réutilisable, configuration prestataire ni snapshot d’exécution/documentaire n’est renvoyé."
          }
        },
        "description": "Projection métier d’abonnement enregistré, commune à la liste et au détail. Elle ne calcule ni calendrier, ni total encaissé, ni permission d’exécution, ni état du règlement bancaire."
      },
      "Pagination": {
        "type": "object",
        "properties": {
          "nextCursor": {
            "type": "string",
            "nullable": true
          },
          "hasMore": {
            "type": "boolean"
          },
          "count": {
            "type": "integer"
          }
        }
      },
      "AbonnementPaymentPage": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "data",
          "meta"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/AbonnementPayment"
            }
          },
          "meta": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "nextCursor",
              "hasMore",
              "count"
            ],
            "properties": {
              "nextCursor": {
                "type": "string",
                "nullable": true,
                "maxLength": 4096
              },
              "hasMore": {
                "type": "boolean"
              },
              "count": {
                "type": "integer",
                "minimum": 0,
                "maximum": 200
              }
            }
          }
        }
      },
      "AbonnementPayment": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "id",
          "subscriptionId",
          "amount",
          "devise",
          "assoc",
          "state",
          "datetime",
          "type",
          "typeId",
          "parentTypeId",
          "method",
          "platform",
          "source",
          "imported",
          "finalized",
          "subscriptionOccurrence",
          "subscriptionPlannedDate"
        ],
        "properties": {
          "id": {
            "type": "string",
            "nullable": true,
            "description": "Identifiant du paiement enregistré. Vaut null si un identifiant historique mal formé ne peut pas être représenté."
          },
          "subscriptionId": {
            "type": "string",
            "nullable": true,
            "description": "Identifiant d’abonnement provenant de la relation paiement.abo enregistrée."
          },
          "amount": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991,
            "nullable": true,
            "description": "Montant effectif enregistré en unités monétaires mineures : 5000 = 50.00 EUR. Zéro est possible pour les traces techniques ABO_PAUSE. La valeur null indique une donnée absente ou invalide et ne signifie jamais zéro."
          },
          "devise": {
            "type": "string",
            "nullable": true,
            "pattern": "^[a-z]{3}$",
            "description": "Devise enregistrée, en minuscules. La valeur null indique une donnée absente ou invalide ; aucune devise n’est déduite de l’abonnement actuel."
          },
          "assoc": {
            "type": "string",
            "nullable": true,
            "description": "Association bénéficiaire enregistrée. MAIN désigne l’association principale ; null indique une valeur absente, sans remplacement déduit."
          },
          "state": {
            "type": "string",
            "nullable": true,
            "description": "Code d’état exact du paiement enregistré. COMPLETED représente un résultat terminé enregistré dont le sens financier dépend du producteur et du prestataire ; cette lecture ne vérifie ni capture ni règlement bancaire. INIT désigne une préparation inachevée, PRELEVEMENT-SUBMITED un ordre bancaire transmis et ABO_PAUSE une trace technique de pause. Un état absent ou mal formé vaut null et n’est pas compté comme un succès. Les codes d’état inconnus bien formés sont conservés. Une référence ou le temps écoulé ne permettent jamais de déduire une réussite ou une expiration.",
            "pattern": "^[A-Z][A-Z0-9_-]{0,63}$",
            "maxLength": 64
          },
          "datetime": {
            "type": "string",
            "format": "date-time",
            "nullable": true,
            "description": "Date et heure enregistrées du paiement, normalisées en ISO pour les années 0000 à 9999. Cette valeur est définie avant le checkout dans une préparation en ligne, ou fournie comme date métier dans les parcours manuels et d’import ; elle ne garantit pas la date du règlement bancaire. Accepte les dates stockées valides, les millisecondes entières depuis l’époque Unix, les dates/heures ISO strictes avec fuseau ou YYYY-MM-DD à minuit UTC. Les dates civiles impossibles et les chaînes ambiguës valent null sans report vers un autre jour et sont triées en dernier."
          },
          "type": {
            "type": "string",
            "nullable": true,
            "description": "Type d’affectation métier enregistré."
          },
          "typeId": {
            "type": "string",
            "nullable": true,
            "description": "Cible métier enregistrée. FORM désigne une soumission de formulaire, et non le formulaire parent."
          },
          "parentTypeId": {
            "type": "string",
            "nullable": true,
            "description": "Identifiant enregistré du formulaire parent lorsqu’il existe ; une relation manquante n’est pas devinée."
          },
          "method": {
            "type": "string",
            "nullable": true,
            "description": "Instrument de paiement enregistré. Aucun instrument n’est déduit du prestataire."
          },
          "platform": {
            "type": "string",
            "nullable": true,
            "description": "Prestataire de paiement enregistré lorsque le parcours en possède un. Aucun appel au prestataire n’est effectué."
          },
          "source": {
            "type": "string",
            "nullable": true,
            "description": "Canal de création enregistré."
          },
          "imported": {
            "type": "boolean",
            "nullable": true,
            "description": "La valeur true désigne un encaissement historique importé. La valeur false est explicite ; null indique un marqueur absent. Les résultats terminés importés sont inclus sauf si un autre filtre les exclut."
          },
          "finalized": {
            "type": "boolean",
            "nullable": true,
            "description": "Marqueur de complétude des informations lorsqu’il existe. Il est indépendant de l’encaissement des fonds et de l’émission d’un reçu. La valeur null indique son absence."
          },
          "subscriptionOccurrence": {
            "type": "string",
            "nullable": true,
            "description": "Identité d’échéance logique enregistrée par les moteurs qui la conservent. Plusieurs tentatives peuvent appartenir à une même échéance. Les valeurs absentes des parcours historiques ou gérés par un prestataire restent null."
          },
          "subscriptionPlannedDate": {
            "type": "string",
            "format": "date",
            "nullable": true,
            "description": "Date civile prévue YYYY-MM-DD figée par le moteur d’exécution local lorsqu’elle existe. Elle ne précise ni instant ni fuseau horaire. Les producteurs gérés par un prestataire et SEPA XML n’utilisent pas nécessairement ce champ."
          }
        }
      },
      "SubscriptionScheduleResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "data"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/SubscriptionSchedule"
          }
        }
      },
      "SubscriptionSchedule": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "id",
          "asOf",
          "mode",
          "calendarStatus",
          "nominalAmount",
          "devise",
          "state",
          "active",
          "revision",
          "rules",
          "today",
          "occurrences",
          "deferred",
          "next",
          "due",
          "blocked",
          "blocks",
          "canExecute",
          "awaitingActivation",
          "complete",
          "truncated",
          "plannedAmount",
          "remainingAmount",
          "remainingCount",
          "facts",
          "allocationBudgets",
          "nextAllocations",
          "preparation"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "asOf": {
            "type": "string",
            "format": "date-time"
          },
          "mode": {
            "type": "string",
            "enum": [
              "local",
              "managed",
              "sepa_xml"
            ]
          },
          "calendarStatus": {
            "type": "string",
            "enum": [
              "PROJECTED",
              "REMOTE_SCHEDULE_UNAVAILABLE"
            ]
          },
          "nominalAmount": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991,
            "nullable": true,
            "description": "payload.amount enregistré en unités mineures ; 5000 = 50.00 EUR. Les valeurs absentes ou mal formées d’un contrat géré par un prestataire restent null."
          },
          "devise": {
            "type": "string",
            "nullable": true,
            "description": "Devise du contrat enregistrée en minuscules ; une devise inconnue d’un contrat géré par un prestataire reste null.",
            "pattern": "^[a-z]{3}$"
          },
          "state": {
            "type": "string",
            "nullable": true,
            "description": "État exact du cycle de vie enregistré ; ACTIVE avec active false peut correspondre à une attente d’activation."
          },
          "active": {
            "type": "boolean",
            "nullable": true
          },
          "revision": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991,
            "nullable": true
          },
          "rules": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "amount",
              "day",
              "anchor",
              "timezone",
              "mode",
              "count",
              "maximum",
              "firstSequence"
            ],
            "properties": {
              "amount": {
                "type": "integer",
                "minimum": 1
              },
              "day": {
                "type": "integer",
                "minimum": 1,
                "maximum": 31
              },
              "anchor": {
                "type": "string",
                "format": "date"
              },
              "timezone": {
                "type": "string"
              },
              "mode": {
                "type": "string",
                "enum": [
                  "count",
                  "maximum",
                  "unlimited",
                  "legacy"
                ]
              },
              "count": {
                "type": "integer",
                "minimum": 0,
                "maximum": 9007199254740991,
                "nullable": true
              },
              "maximum": {
                "type": "integer",
                "minimum": 0,
                "maximum": 9007199254740991,
                "nullable": true
              },
              "firstSequence": {
                "type": "integer",
                "minimum": 1
              }
            },
            "nullable": true
          },
          "today": {
            "type": "string",
            "nullable": true,
            "format": "date"
          },
          "occurrences": {
            "type": "array",
            "maxItems": 240,
            "items": {
              "$ref": "#/components/schemas/SubscriptionScheduleOccurrence"
            }
          },
          "deferred": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/SubscriptionScheduleOccurrence"
            }
          },
          "next": {
            "$ref": "#/components/schemas/SubscriptionScheduleNullableOccurrence"
          },
          "due": {
            "type": "boolean",
            "nullable": true
          },
          "blocked": {
            "type": "boolean",
            "nullable": true
          },
          "blocks": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "canExecute": {
            "type": "boolean",
            "nullable": true
          },
          "awaitingActivation": {
            "type": "boolean",
            "nullable": true
          },
          "complete": {
            "type": "boolean",
            "nullable": true
          },
          "truncated": {
            "type": "boolean",
            "nullable": true
          },
          "plannedAmount": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991,
            "nullable": true,
            "description": "Montant contractuel restant complet après tentatives terminées/engagées enregistrées et exceptions du propriétaire, indépendamment de horizon. Vaut null pour un échéancier illimité ou indisponible."
          },
          "remainingAmount": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991,
            "nullable": true,
            "description": "Plafond inutilisé après montants terminés et engagés enregistrés. Vaut null sans plafond déclaré ou si l’échéancier distant est indisponible."
          },
          "remainingCount": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991,
            "nullable": true,
            "description": "Nombre complet d’échéances restantes selon les règles count/maximum/legacy, indépendamment de horizon. Vaut null pour un échéancier illimité ou indisponible."
          },
          "facts": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "paidCount",
              "committedCount",
              "paidAmount",
              "committedAmount",
              "uncertainCount"
            ],
            "properties": {
              "paidCount": {
                "type": "integer",
                "minimum": 0,
                "maximum": 9007199254740991,
                "nullable": true
              },
              "committedCount": {
                "type": "integer",
                "minimum": 0,
                "maximum": 9007199254740991,
                "nullable": true
              },
              "paidAmount": {
                "type": "integer",
                "minimum": 0,
                "maximum": 9007199254740991,
                "nullable": true
              },
              "committedAmount": {
                "type": "integer",
                "minimum": 0,
                "maximum": 9007199254740991,
                "nullable": true
              },
              "uncertainCount": {
                "type": "integer",
                "minimum": 0,
                "maximum": 9007199254740991,
                "nullable": true
              }
            },
            "nullable": true
          },
          "allocationBudgets": {
            "type": "object",
            "nullable": true,
            "additionalProperties": {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991
            },
            "description": "Budgets de promesses du propriétaire en unités mineures, ou null si indisponibles. Un budget de promesse directe par paiement concerne le prochain paiement, pas le contrat complet."
          },
          "nextAllocations": {
            "type": "object",
            "nullable": true,
            "additionalProperties": {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991
            },
            "description": "Répartition du propriétaire pour la prochaine échéance effective en unités mineures ; vaut null sans prochaine échéance ou si une revue d’affectation est requise. Une carte vide est valide hors affectation aux promesses."
          },
          "preparation": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "allowed",
              "reason",
              "availableFrom",
              "latestDay"
            ],
            "properties": {
              "allowed": {
                "type": "boolean"
              },
              "reason": {
                "type": "string",
                "nullable": true,
                "enum": [
                  "SEPA_NOT_DUE",
                  "SEPA_CATCHUP_REVIEW_REQUIRED",
                  null
                ]
              },
              "availableFrom": {
                "type": "string",
                "format": "date"
              },
              "latestDay": {
                "type": "string",
                "format": "date"
              }
            },
            "nullable": true
          }
        }
      },
      "SubscriptionScheduleOccurrence": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "id",
          "sequence",
          "originalDate",
          "date",
          "amount",
          "state",
          "notBefore"
        ],
        "properties": {
          "id": {
            "type": "string"
          },
          "sequence": {
            "type": "integer",
            "minimum": 1
          },
          "originalDate": {
            "type": "string",
            "format": "date"
          },
          "date": {
            "type": "string",
            "nullable": true,
            "format": "date"
          },
          "amount": {
            "type": "integer",
            "minimum": 1,
            "maximum": 9007199254740991
          },
          "state": {
            "type": "string",
            "enum": [
              "PLANNED",
              "POSTPONED",
              "DEFERRED"
            ]
          },
          "notBefore": {
            "type": "string",
            "nullable": true,
            "format": "date-time"
          }
        }
      },
      "SubscriptionScheduleNullableOccurrence": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "id",
          "sequence",
          "originalDate",
          "date",
          "amount",
          "state",
          "notBefore"
        ],
        "properties": {
          "id": {
            "type": "string"
          },
          "sequence": {
            "type": "integer",
            "minimum": 1
          },
          "originalDate": {
            "type": "string",
            "format": "date"
          },
          "date": {
            "type": "string",
            "nullable": true,
            "format": "date"
          },
          "amount": {
            "type": "integer",
            "minimum": 1,
            "maximum": 9007199254740991
          },
          "state": {
            "type": "string",
            "enum": [
              "PLANNED",
              "POSTPONED",
              "DEFERRED"
            ]
          },
          "notBefore": {
            "type": "string",
            "nullable": true,
            "format": "date-time"
          }
        },
        "nullable": true
      },
      "SubscriptionIncidentResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "data"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/SubscriptionIncident"
          }
        }
      },
      "SubscriptionIncident": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "subscriptionId",
          "state",
          "active",
          "mode",
          "intervention",
          "latestFailedPayment",
          "regularization"
        ],
        "properties": {
          "subscriptionId": {
            "type": "string",
            "format": "uuid"
          },
          "state": {
            "type": "string",
            "nullable": true,
            "enum": [
              "ACTIVE",
              "MANUAL",
              "CARD_EXPIRED",
              "PAUSE",
              "FINISHED",
              "CANCELED",
              "CANCELLED",
              null
            ],
            "description": "État de cycle de vie enregistré. Les états historiques absents, invalides ou non pris en charge restent null."
          },
          "active": {
            "type": "boolean",
            "nullable": true,
            "description": "Marqueur active enregistré ; null s’il est absent ou mal formé. Il n’autorise aucun débit."
          },
          "mode": {
            "type": "string",
            "enum": [
              "local",
              "managed",
              "sepa_xml"
            ],
            "description": "Propriétaire de l’exécution : calendrier local, prestataire externe ou SEPA XML."
          },
          "intervention": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "required",
              "reason",
              "recordedAt"
            ],
            "properties": {
              "required": {
                "type": "boolean",
                "nullable": true,
                "description": "Marqueur enregistré MANUAL/CARD_EXPIRED ou attente de moyen ; null pour un état inconnu. false ne prouve pas l’absence d’un échec de paiement."
              },
              "reason": {
                "type": "string",
                "nullable": true,
                "enum": [
                  "CARD_EXPIRED",
                  "PAYMENT_METHOD_CHANGE_PENDING",
                  "MANUAL_INTERVENTION",
                  "MANUAL_REVIEW_REQUIRED",
                  "GOCARDLESS_DEBIT_DISPUTED",
                  "GOCARDLESS_MANDATE_UNUSABLE",
                  "SEPA_XML_DEBIT_DISPUTED",
                  "SEPA_XML_MANDATE_UNUSABLE",
                  "SEPA_XML_REVIEW_REQUIRED",
                  null
                ],
                "description": "Motif de blocage autorisé. Les motifs privés inconnus deviennent MANUAL_REVIEW_REQUIRED ; aucune erreur libre n’est restituée."
              },
              "recordedAt": {
                "type": "string",
                "format": "date-time",
                "nullable": true,
                "description": "manualDate enregistré sous forme d’instant ISO, lorsqu’il s’applique. null signifie absent ou invalide ; aucune déduction depuis l’ancienneté."
              }
            }
          },
          "latestFailedPayment": {
            "type": "object",
            "nullable": true,
            "additionalProperties": false,
            "required": [
              "id",
              "state",
              "recordedAt",
              "incidentAt"
            ],
            "description": "Dernière tentative autorisée en échec enregistrée, y compris un incident historique suivi d’un succès. Elle ne représente pas nécessairement le blocage actuel ni une échéance distincte.",
            "properties": {
              "id": {
                "type": "string",
                "format": "uuid",
                "nullable": true
              },
              "state": {
                "type": "string",
                "enum": [
                  "FAILED",
                  "ERROR",
                  "REQUIRES_PAYMENT_METHOD",
                  "CANCELED"
                ]
              },
              "recordedAt": {
                "type": "string",
                "format": "date-time",
                "nullable": true
              },
              "incidentAt": {
                "type": "string",
                "format": "date-time",
                "nullable": true,
                "description": "failureAt/lateFailureAt GoCardless lorsqu’ils existent, sinon datetime du paiement. Les autres prestataires utilisent datetime. Les valeurs absentes ou invalides restent null."
              }
            }
          },
          "regularization": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "availability",
              "link"
            ],
            "properties": {
              "availability": {
                "type": "string",
                "enum": [
                  "AVAILABLE",
                  "NO_RECORDED_INTERVENTION",
                  "INACTIVE",
                  "MANAGED_OWNER",
                  "SEPA_XML_OWNER",
                  "PAYMENT_METHOD_CHANGE_PENDING",
                  "MANUAL_REVIEW_REQUIRED",
                  "READ_OWNER_REQUIRED",
                  "INVALID_RECORDED_LINK",
                  "EXPIRED_RECORDED_LINK",
                  "CURRENT_PAYER_UNVERIFIED",
                  "HISTORY_UNVERIFIED"
                ],
                "description": "AVAILABLE indique qu’un checkout Stripe Connect enregistré satisfait les preuves locales. Les autres codes expliquent pourquoi link vaut null ; ils n’autorisent jamais une création ni une nouvelle tentative de paiement."
              },
              "link": {
                "type": "object",
                "nullable": true,
                "additionalProperties": false,
                "required": [
                  "url",
                  "expiresAt",
                  "paymentId",
                  "purpose"
                ],
                "properties": {
                  "url": {
                    "type": "string",
                    "format": "uri",
                    "description": "URL HTTPS Stripe Checkout déjà enregistrée pour ce payeur. Traitez-la comme un accès confidentiel du payeur ; son ouverture permet de régler et renouveler sa carte."
                  },
                  "expiresAt": {
                    "type": "string",
                    "format": "date-time",
                    "description": "Expiration explicite de session enregistrée par le producteur Stripe, sans durée déduite localement. La disponibilité chez le prestataire n’est pas vérifiée en direct."
                  },
                  "paymentId": {
                    "type": "string",
                    "format": "uuid"
                  },
                  "purpose": {
                    "type": "string",
                    "enum": [
                      "SETTLE_AND_RENEW_CARD"
                    ]
                  }
                }
              }
            }
          }
        }
      },
      "UnisoftRequest_3e9bbc56cab142f79ac7": {
        "type": "object",
        "minProperties": 1,
        "properties": {
          "amount": {
            "type": "integer",
            "minimum": 1,
            "maximum": 100000000,
            "description": "Montant mensuel nominal en unités mineures ; 5000 signifie EUR 50. Les tentatives déjà lancées conservent leur montant."
          },
          "day": {
            "type": "integer",
            "minimum": 1,
            "maximum": 31,
            "description": "Jour d’encaissement mensuel dans le fuseau du contrat natif. Les mois courts suivent la règle du calendrier natif."
          },
          "nextDate": {
            "type": "string",
            "format": "date",
            "description": "Date civile YYYY-MM-DD, aujourd’hui ou plus tard dans le fuseau du contrat. Réancre uniquement la première occurrence non lancée. Elle doit correspondre à day si les deux sont fournis."
          },
          "mode": {
            "type": "string",
            "enum": [
              "unlimited",
              "count",
              "maximum",
              "legacy"
            ],
            "description": "Mode de limite natif. unlimited n’a aucune limite de nombre ou de montant ; count limite le nombre total d’occurrences ; maximum limite le total en unités mineures ; legacy combine les deux limites. Cela ne change jamais la fréquence mensuelle."
          },
          "count": {
            "type": "integer",
            "minimum": 1,
            "maximum": 1200,
            "nullable": true,
            "description": "Nombre contractuel total d’occurrences, y compris les occurrences terminées et engagées ; ce n’est ni le nombre restant ni un nombre de mois à ajouter. null signifie aucune limite de nombre et doit correspondre à mode."
          },
          "maximum": {
            "type": "integer",
            "minimum": 1,
            "maximum": 9007199254740991,
            "nullable": true,
            "description": "Plafond contractuel total en unités mineures, y compris les montants terminés et engagés ; ce n’est pas un nouveau budget restant. null signifie aucun plafond et doit correspondre à mode."
          }
        },
        "additionalProperties": false
      },
      "SubscriptionRevisionPreviewResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "data"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/SubscriptionRevisionPreview"
          }
        }
      },
      "SubscriptionRevisionPreview": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "id",
          "asOf",
          "previewToken",
          "revision",
          "currency",
          "beforeRules",
          "afterRules",
          "before",
          "after",
          "changedFields",
          "preservedExceptionCount"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "asOf": {
            "type": "string",
            "format": "date-time"
          },
          "previewToken": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "revision": {
            "type": "integer",
            "minimum": 0
          },
          "currency": {
            "type": "string",
            "pattern": "^[a-z]{3}$"
          },
          "beforeRules": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "amount",
              "day",
              "anchor",
              "timezone",
              "mode",
              "count",
              "maximum",
              "firstSequence"
            ],
            "properties": {
              "amount": {
                "type": "integer",
                "minimum": 1
              },
              "day": {
                "type": "integer",
                "minimum": 1,
                "maximum": 31
              },
              "anchor": {
                "type": "string",
                "format": "date"
              },
              "timezone": {
                "type": "string"
              },
              "mode": {
                "type": "string",
                "enum": [
                  "unlimited",
                  "count",
                  "maximum",
                  "legacy"
                ]
              },
              "count": {
                "type": "integer",
                "nullable": true
              },
              "maximum": {
                "type": "integer",
                "nullable": true
              },
              "firstSequence": {
                "type": "integer",
                "minimum": 1
              }
            }
          },
          "afterRules": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "amount",
              "day",
              "anchor",
              "timezone",
              "mode",
              "count",
              "maximum",
              "firstSequence"
            ],
            "properties": {
              "amount": {
                "type": "integer",
                "minimum": 1
              },
              "day": {
                "type": "integer",
                "minimum": 1,
                "maximum": 31
              },
              "anchor": {
                "type": "string",
                "format": "date"
              },
              "timezone": {
                "type": "string"
              },
              "mode": {
                "type": "string",
                "enum": [
                  "unlimited",
                  "count",
                  "maximum",
                  "legacy"
                ]
              },
              "count": {
                "type": "integer",
                "nullable": true
              },
              "maximum": {
                "type": "integer",
                "nullable": true
              },
              "firstSequence": {
                "type": "integer",
                "minimum": 1
              }
            }
          },
          "before": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "remainingCount",
              "remainingAmount",
              "plannedAmount",
              "complete",
              "blocks"
            ],
            "properties": {
              "remainingCount": {
                "type": "integer",
                "minimum": 0,
                "nullable": true
              },
              "remainingAmount": {
                "type": "integer",
                "minimum": 0,
                "nullable": true
              },
              "plannedAmount": {
                "type": "integer",
                "minimum": 0,
                "nullable": true
              },
              "complete": {
                "type": "boolean"
              },
              "blocks": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            }
          },
          "after": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "remainingCount",
              "remainingAmount",
              "plannedAmount",
              "complete",
              "blocks"
            ],
            "properties": {
              "remainingCount": {
                "type": "integer",
                "minimum": 0,
                "nullable": true
              },
              "remainingAmount": {
                "type": "integer",
                "minimum": 0,
                "nullable": true
              },
              "plannedAmount": {
                "type": "integer",
                "minimum": 0,
                "nullable": true
              },
              "complete": {
                "type": "boolean"
              },
              "blocks": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            }
          },
          "changedFields": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "preservedExceptionCount": {
            "type": "integer",
            "minimum": 0
          }
        }
      },
      "SubscriptionRevisionCommandResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "data"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/SubscriptionRevisionCommand"
          }
        }
      },
      "SubscriptionRevisionCommand": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "id",
          "subscriptionId",
          "state",
          "appliedRevision",
          "createdAt",
          "updatedAt"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "subscriptionId": {
            "type": "string",
            "format": "uuid"
          },
          "state": {
            "type": "string",
            "enum": [
              "RUNNING",
              "APPLIED",
              "UNCERTAIN"
            ]
          },
          "appliedRevision": {
            "type": "integer",
            "minimum": 0,
            "nullable": true
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "SubscriptionPaymentChangePreviewResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "data"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/SubscriptionPaymentChangePreview"
          }
        }
      },
      "SubscriptionPaymentChangePreview": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "id",
          "platform",
          "flow",
          "expectedRevision",
          "previewToken",
          "currency",
          "timezone",
          "occurrence",
          "requiresPayerAuthorization"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "platform": {
            "type": "string",
            "enum": [
              "STRIPE",
              "STRIPE.SEPA"
            ]
          },
          "flow": {
            "type": "string",
            "enum": [
              "SETUP",
              "ADVANCE"
            ]
          },
          "expectedRevision": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "previewToken": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "currency": {
            "type": "string"
          },
          "timezone": {
            "type": "string"
          },
          "occurrence": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "id",
              "date",
              "amount"
            ],
            "properties": {
              "id": {
                "type": "string"
              },
              "date": {
                "type": "string",
                "format": "date"
              },
              "amount": {
                "type": "integer",
                "minimum": 1
              }
            },
            "nullable": true
          },
          "requiresPayerAuthorization": {
            "type": "boolean",
            "enum": [
              true
            ]
          }
        }
      },
      "UnisoftRequest_e4c2e3a5eb7c3cc511e2": {
        "oneOf": [
          {
            "type": "object",
            "properties": {
              "platform": {
                "type": "string",
                "enum": [
                  "STRIPE.SEPA"
                ]
              },
              "idempotencyKey": {
                "type": "string",
                "format": "uuid"
              },
              "expectedRevision": {
                "type": "string",
                "pattern": "^[a-f0-9]{64}$"
              },
              "previewToken": {
                "type": "string",
                "pattern": "^[a-f0-9]{64}$"
              },
              "acknowledgeFutureCollections": {
                "type": "boolean",
                "enum": [
                  true
                ]
              }
            },
            "required": [
              "platform",
              "idempotencyKey",
              "expectedRevision",
              "previewToken",
              "acknowledgeFutureCollections"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "platform": {
                "type": "string",
                "enum": [
                  "STRIPE"
                ]
              },
              "idempotencyKey": {
                "type": "string",
                "format": "uuid"
              },
              "expectedRevision": {
                "type": "string",
                "pattern": "^[a-f0-9]{64}$"
              },
              "previewToken": {
                "type": "string",
                "pattern": "^[a-f0-9]{64}$"
              },
              "acknowledgeFutureCollections": {
                "type": "boolean",
                "enum": [
                  true
                ]
              },
              "acknowledgeAdvancePayment": {
                "type": "boolean",
                "enum": [
                  true
                ]
              }
            },
            "required": [
              "platform",
              "idempotencyKey",
              "expectedRevision",
              "previewToken",
              "acknowledgeFutureCollections",
              "acknowledgeAdvancePayment"
            ],
            "additionalProperties": false
          }
        ]
      },
      "SubscriptionPaymentChangePreparationResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "data"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/SubscriptionPaymentChangePreparation"
          }
        }
      },
      "SubscriptionPaymentChangePreparation": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "id",
          "subscriptionId",
          "state",
          "platform",
          "flow",
          "requiresPayerAuthorization",
          "createdAt",
          "updatedAt"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "subscriptionId": {
            "type": "string",
            "format": "uuid"
          },
          "state": {
            "type": "string",
            "enum": [
              "RUNNING",
              "PREPARED",
              "UNCERTAIN"
            ]
          },
          "platform": {
            "type": "string",
            "enum": [
              "STRIPE",
              "STRIPE.SEPA"
            ]
          },
          "flow": {
            "type": "string",
            "enum": [
              "SETUP",
              "ADVANCE"
            ]
          },
          "requiresPayerAuthorization": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time"
          },
          "nativeState": {
            "type": "string",
            "nullable": true
          },
          "activated": {
            "type": "boolean",
            "nullable": true
          },
          "authorizationExpiresAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "authorizationUrl": {
            "type": "string",
            "format": "uri"
          }
        }
      },
      "SubscriptionPaymentChangeCommandResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "data"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/SubscriptionPaymentChangeCommand"
          }
        }
      },
      "SubscriptionPaymentChangeCommand": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "id",
          "subscriptionId",
          "state",
          "platform",
          "flow",
          "requiresPayerAuthorization",
          "createdAt",
          "updatedAt"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "subscriptionId": {
            "type": "string",
            "format": "uuid"
          },
          "state": {
            "type": "string",
            "enum": [
              "RUNNING",
              "PREPARED",
              "UNCERTAIN"
            ]
          },
          "platform": {
            "type": "string",
            "enum": [
              "STRIPE",
              "STRIPE.SEPA"
            ]
          },
          "flow": {
            "type": "string",
            "enum": [
              "SETUP",
              "ADVANCE"
            ]
          },
          "requiresPayerAuthorization": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time"
          },
          "nativeState": {
            "type": "string",
            "nullable": true
          },
          "activated": {
            "type": "boolean",
            "nullable": true
          },
          "authorizationExpiresAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          }
        }
      },
      "UnisoftRequest_2401b237a86dca02fa7c": {
        "oneOf": [
          {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "pattern": "^[a-fA-F0-9-]{36}:monthly:[1-9][0-9]{0,8}$",
                "description": "Identifiant stable d’occurrence fourni par le calendrier natif de l’abonnement ; distinct de l’identifiant d’une tentative de paiement."
              },
              "action": {
                "type": "string",
                "enum": [
                  "date"
                ]
              },
              "value": {
                "type": "string",
                "format": "date",
                "description": "Nouvelle date civile YYYY-MM-DD strictement postérieure à aujourd’hui dans le fuseau du contrat. Une date explicite contourne la règle héritée d’espacement de 25 jours."
              }
            },
            "required": [
              "id",
              "action",
              "value"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "pattern": "^[a-fA-F0-9-]{36}:monthly:[1-9][0-9]{0,8}$",
                "description": "Identifiant stable d’occurrence fourni par le calendrier natif de l’abonnement ; distinct de l’identifiant d’une tentative de paiement."
              },
              "action": {
                "type": "string",
                "enum": [
                  "skip"
                ]
              }
            },
            "required": [
              "id",
              "action"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "pattern": "^[a-fA-F0-9-]{36}:monthly:[1-9][0-9]{0,8}$",
                "description": "Identifiant stable d’occurrence fourni par le calendrier natif de l’abonnement ; distinct de l’identifiant d’une tentative de paiement."
              },
              "action": {
                "type": "string",
                "enum": [
                  "reset"
                ]
              },
              "field": {
                "type": "string",
                "enum": [
                  "date"
                ]
              }
            },
            "required": [
              "id",
              "action",
              "field"
            ],
            "additionalProperties": false
          }
        ]
      },
      "SubscriptionOccurrencePreviewResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "data"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/SubscriptionOccurrencePreview"
          }
        }
      },
      "SubscriptionOccurrencePreview": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "id",
          "asOf",
          "previewToken",
          "revision",
          "currency",
          "timezone",
          "before",
          "after",
          "next",
          "remainingCount",
          "remainingAmount"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "asOf": {
            "type": "string",
            "format": "date-time"
          },
          "previewToken": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "revision": {
            "type": "integer",
            "minimum": 0
          },
          "currency": {
            "type": "string",
            "pattern": "^[a-z]{3}$"
          },
          "timezone": {
            "type": "string"
          },
          "before": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "id",
              "sequence",
              "originalDate",
              "date",
              "amount",
              "state"
            ],
            "properties": {
              "id": {
                "type": "string",
                "pattern": "^[a-fA-F0-9-]{36}:monthly:[1-9][0-9]{0,8}$",
                "description": "Identifiant stable d’occurrence fourni par le calendrier natif de l’abonnement ; distinct de l’identifiant d’une tentative de paiement."
              },
              "sequence": {
                "type": "integer",
                "minimum": 1
              },
              "originalDate": {
                "type": "string",
                "format": "date"
              },
              "date": {
                "type": "string",
                "format": "date",
                "nullable": true
              },
              "amount": {
                "type": "integer",
                "minimum": 1
              },
              "state": {
                "type": "string",
                "enum": [
                  "PLANNED",
                  "POSTPONED",
                  "DEFERRED"
                ]
              }
            }
          },
          "after": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "id",
              "sequence",
              "originalDate",
              "date",
              "amount",
              "state"
            ],
            "properties": {
              "id": {
                "type": "string",
                "pattern": "^[a-fA-F0-9-]{36}:monthly:[1-9][0-9]{0,8}$",
                "description": "Identifiant stable d’occurrence fourni par le calendrier natif de l’abonnement ; distinct de l’identifiant d’une tentative de paiement."
              },
              "sequence": {
                "type": "integer",
                "minimum": 1
              },
              "originalDate": {
                "type": "string",
                "format": "date"
              },
              "date": {
                "type": "string",
                "format": "date",
                "nullable": true
              },
              "amount": {
                "type": "integer",
                "minimum": 1
              },
              "state": {
                "type": "string",
                "enum": [
                  "PLANNED",
                  "POSTPONED",
                  "DEFERRED"
                ]
              }
            }
          },
          "next": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "id",
              "sequence",
              "originalDate",
              "date",
              "amount",
              "state"
            ],
            "properties": {
              "id": {
                "type": "string",
                "pattern": "^[a-fA-F0-9-]{36}:monthly:[1-9][0-9]{0,8}$",
                "description": "Identifiant stable d’occurrence fourni par le calendrier natif de l’abonnement ; distinct de l’identifiant d’une tentative de paiement."
              },
              "sequence": {
                "type": "integer",
                "minimum": 1
              },
              "originalDate": {
                "type": "string",
                "format": "date"
              },
              "date": {
                "type": "string",
                "format": "date",
                "nullable": true
              },
              "amount": {
                "type": "integer",
                "minimum": 1
              },
              "state": {
                "type": "string",
                "enum": [
                  "PLANNED",
                  "POSTPONED",
                  "DEFERRED"
                ]
              }
            },
            "nullable": true
          },
          "remainingCount": {
            "type": "integer",
            "minimum": 0,
            "nullable": true
          },
          "remainingAmount": {
            "type": "integer",
            "minimum": 0,
            "nullable": true
          }
        }
      },
      "SubscriptionOccurrenceCommandResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "data"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/SubscriptionOccurrenceCommand"
          }
        }
      },
      "SubscriptionOccurrenceCommand": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "id",
          "subscriptionId",
          "state",
          "appliedRevision",
          "createdAt",
          "updatedAt"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "subscriptionId": {
            "type": "string",
            "format": "uuid"
          },
          "state": {
            "type": "string",
            "enum": [
              "RUNNING",
              "APPLIED",
              "UNCERTAIN"
            ]
          },
          "appliedRevision": {
            "type": "integer",
            "minimum": 0,
            "nullable": true
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "SubscriptionLifecycleResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "data"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/SubscriptionLifecycle"
          }
        }
      },
      "SubscriptionLifecycle": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "id",
          "state",
          "active",
          "expectedRevision",
          "asOf",
          "canPause",
          "pauseReason",
          "canResume",
          "resumeReason",
          "canCancel",
          "cancelReason"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "state": {
            "type": "string"
          },
          "active": {
            "type": "boolean"
          },
          "expectedRevision": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "asOf": {
            "type": "string",
            "format": "date-time"
          },
          "canPause": {
            "type": "boolean"
          },
          "pauseReason": {
            "type": "string",
            "nullable": true
          },
          "canResume": {
            "type": "boolean"
          },
          "resumeReason": {
            "type": "string",
            "nullable": true
          },
          "canCancel": {
            "type": "boolean"
          },
          "cancelReason": {
            "type": "string",
            "nullable": true
          }
        }
      },
      "SubscriptionLifecycleCommandResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "data"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/SubscriptionLifecycleCommand"
          }
        }
      },
      "SubscriptionLifecycleCommand": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "id",
          "subscriptionId",
          "action",
          "state",
          "appliedState",
          "appliedAt",
          "createdAt",
          "updatedAt"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "subscriptionId": {
            "type": "string",
            "format": "uuid"
          },
          "action": {
            "type": "string",
            "enum": [
              "PAUSE",
              "RESUME",
              "CANCEL"
            ]
          },
          "state": {
            "type": "string",
            "enum": [
              "RUNNING",
              "APPLIED",
              "UNCERTAIN"
            ]
          },
          "appliedState": {
            "type": "string",
            "enum": [
              "PAUSE",
              "ACTIVE",
              "FINISHED",
              null
            ],
            "nullable": true
          },
          "appliedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "SubscriptionReminderPreview": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "subscriptionId": {
            "type": "string",
            "format": "uuid"
          },
          "availability": {
            "type": "string",
            "enum": [
              "READY",
              "PENDING_ACTIVATION_OWNER_REQUIRED",
              "NOT_INTERRUPTED",
              "MANAGED_OWNER",
              "SEPA_XML_OWNER",
              "PAYMENT_IN_PROGRESS",
              "SUBSCRIPTION_LIMIT_REACHED",
              "REMINDER_RECENT",
              "LIFECYCLE_RECONCILIATION_REQUIRED",
              "NATIVE_MANUAL_OWNER_UNAVAILABLE",
              "NO_EMAIL_CHANNEL",
              "INACTIVE",
              "PAYMENT_METHOD_CHANGE_PENDING",
              "MANUAL_REVIEW_REQUIRED",
              "READ_OWNER_REQUIRED",
              "NO_RECORDED_INTERVENTION",
              "INVALID_RECORDED_LINK",
              "EXPIRED_RECORDED_LINK",
              "CURRENT_PAYER_UNVERIFIED",
              "HISTORY_UNVERIFIED"
            ]
          },
          "state": {
            "type": "string",
            "pattern": "^[A-Z][A-Z0-9_-]{0,63}$"
          },
          "active": {
            "type": "boolean"
          },
          "nominalAmountMinor": {
            "type": "integer",
            "minimum": 1,
            "maximum": 9007199254740991,
            "nullable": true
          },
          "settlementAmountMinor": {
            "type": "integer",
            "minimum": 1,
            "maximum": 9007199254740991,
            "nullable": true
          },
          "currency": {
            "type": "string",
            "pattern": "^[a-z]{3}$",
            "nullable": true
          },
          "assoc": {
            "type": "string",
            "nullable": true
          },
          "platform": {
            "type": "string",
            "nullable": true
          },
          "method": {
            "type": "string",
            "nullable": true
          },
          "recipientEmail": {
            "type": "string",
            "nullable": true
          },
          "linkKind": {
            "type": "string",
            "nullable": true,
            "enum": [
              "EXISTING_CHECKOUT",
              "NATIVE_MANUAL_ENTRY",
              null
            ],
            "description": "EXISTING_CHECKOUT est une Session enregistrée admise ; NATIVE_MANUAL_ENTRY est l’entrée native du payeur dont le propriétaire peut préparer un règlement ou un renouvellement du moyen lorsque le payeur la suit. Null signifie indisponible. Aucun de ces choix ne crée quoi que ce soit pendant l’aperçu ou l’envoi."
          },
          "recipientSource": {
            "type": "string",
            "enum": [
              "SUBSCRIPTION_PAYER_SNAPSHOT"
            ]
          },
          "subject": {
            "type": "string"
          },
          "message": {
            "type": "string",
            "nullable": true
          },
          "snapshot": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$",
            "nullable": true
          },
          "existingPaymentId": {
            "type": "string",
            "format": "uuid",
            "nullable": true
          },
          "existingLinkExpiresAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "linkIsPreview": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "rest": {
            "$ref": "#/components/schemas/SubscriptionReminderRest"
          }
        },
        "required": [
          "subscriptionId",
          "availability",
          "state",
          "active",
          "nominalAmountMinor",
          "settlementAmountMinor",
          "currency",
          "assoc",
          "platform",
          "method",
          "recipientEmail",
          "linkKind",
          "recipientSource",
          "subject",
          "message",
          "snapshot",
          "existingPaymentId",
          "existingLinkExpiresAt",
          "linkIsPreview",
          "rest"
        ]
      },
      "SubscriptionReminderRest": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "blocked": {
            "type": "boolean"
          },
          "reason": {
            "type": "string",
            "nullable": true
          },
          "until": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "timeZone": {
            "type": "string",
            "enum": [
              "Europe/Paris"
            ]
          }
        },
        "required": [
          "blocked",
          "reason",
          "until",
          "timeZone"
        ]
      },
      "SubscriptionReminderCommand": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "requestId": {
            "type": "string",
            "format": "uuid"
          },
          "action": {
            "type": "string",
            "enum": [
              "SEND",
              "RULES"
            ]
          },
          "status": {
            "type": "string",
            "enum": [
              "PENDING",
              "QUEUED",
              "UPDATED",
              "REFUSED",
              "UNCERTAIN"
            ]
          },
          "requestedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "completedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "targetIds": {
            "type": "array",
            "maxItems": 50,
            "items": {
              "type": "string"
            }
          },
          "error": {
            "type": "string",
            "nullable": true
          },
          "outcomes": {
            "type": "array",
            "maxItems": 50,
            "items": {
              "type": "object",
              "additionalProperties": false,
              "properties": {
                "targetId": {
                  "type": "string"
                },
                "status": {
                  "type": "string",
                  "enum": [
                    "QUEUED",
                    "DUPLICATE",
                    "REFUSED",
                    "UNCERTAIN"
                  ]
                }
              },
              "required": [
                "targetId",
                "status"
              ]
            }
          },
          "retryable": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "deliveryRead": {
            "type": "string",
            "enum": [
              "AVAILABLE",
              "UNAVAILABLE"
            ]
          },
          "deliveries": {
            "type": "array",
            "maxItems": 50,
            "items": {
              "type": "object",
              "additionalProperties": false,
              "properties": {
                "targetId": {
                  "type": "string"
                },
                "sendId": {
                  "type": "string",
                  "format": "uuid"
                },
                "state": {
                  "type": "string",
                  "enum": [
                    "QUEUED_OR_IN_FLIGHT",
                    "SMTP_ACCEPTED",
                    "DELIVERED",
                    "FAILED",
                    "CANCELED",
                    "UNCERTAIN",
                    "UNKNOWN"
                  ]
                }
              },
              "required": [
                "targetId",
                "sendId",
                "state"
              ]
            }
          },
          "subscriptionId": {
            "type": "string",
            "format": "uuid"
          }
        },
        "required": [
          "requestId",
          "action",
          "status",
          "requestedAt",
          "completedAt",
          "targetIds",
          "error",
          "outcomes",
          "retryable",
          "deliveryRead",
          "deliveries",
          "subscriptionId"
        ]
      },
      "UnisoftRequest_7bdae3ccb939dc1b03a6": {
        "type": "object",
        "properties": {
          "idempotencyKey": {
            "type": "string",
            "format": "uuid",
            "description": "UUID de requête créé par l’appelant. Après un délai dépassé, le réutiliser avec exactement les mêmes données ; changer la clé peut créer un autre contrat en attente."
          },
          "montant": {
            "type": "number",
            "minimum": 0.01,
            "maximum": 1000000,
            "multipleOf": 0.01,
            "description": "Montant mensuel nominal en unités majeures, par exemple 50 pour EUR 50. Son équivalent exact en unités mineures est utilisé pour le premier paiement hébergé."
          },
          "devise": {
            "type": "string",
            "pattern": "^[a-z]{3}$",
            "description": "Devise d’encaissement enregistrée, en minuscules. Elle doit correspondre à l’association choisie ; aucune conversion implicite."
          },
          "assoc": {
            "type": "string",
            "minLength": 1,
            "maxLength": 200,
            "pattern": "^[A-Za-z0-9_-]+$",
            "description": "Identifiant d’association bénéficiaire existante fourni par list_associations, dont MAIN. Aucune association par défaut n’est déduite."
          },
          "cerfa": {
            "type": "boolean",
            "description": "Traitement fiscal demandé pour les paiements futurs. Cela n’émet aucun document. Une politique d’association contradictoire est refusée."
          },
          "nbMonth": {
            "type": "integer",
            "minimum": 0,
            "maximum": 1200,
            "description": "Nombre maximal d’occurrences mensuelles ; 0 signifie aucune limite de nombre. Le fournir explicitement. Ce n’est ni un nombre déjà payé ni une durée en jours."
          },
          "maxAmount": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991,
            "description": "Plafond contractuel total en unités mineures, contrairement à montant. 0 signifie aucun plafond de montant. Un plafond positif doit couvrir le premier paiement nominal. Les deux limites peuvent s’appliquer ; les deux à zéro demandent explicitement un contrat sans limite."
          },
          "name": {
            "type": "string",
            "minLength": 1,
            "maxLength": 200,
            "description": "Libellé lisible porté par le contrat natif et son premier Checkout. Le propriétaire peut ajouter des précisions d’occurrence."
          },
          "info": {
            "type": "object",
            "properties": {
              "nom": {
                "type": "string",
                "minLength": 1,
                "maxLength": 200
              },
              "prenom": {
                "type": "string",
                "minLength": 1,
                "maxLength": 200
              },
              "email": {
                "type": "string",
                "maxLength": 320,
                "format": "email"
              },
              "tel": {
                "type": "string",
                "maxLength": 50
              }
            },
            "required": [
              "nom",
              "prenom",
              "email"
            ],
            "additionalProperties": false,
            "description": "Instantané de l’identité du payeur. Le propriétaire natif peut créer ou enrichir un contact CRM correspondant. Aucun identifiant de contact, carte réutilisable, jeton client ou mandat n’est admis."
          },
          "facturation": {
            "type": "object",
            "properties": {
              "perso": {
                "type": "boolean"
              },
              "nom": {
                "type": "string",
                "maxLength": 500
              },
              "prenom": {
                "type": "string",
                "maxLength": 500
              },
              "civilite": {
                "type": "string",
                "maxLength": 500
              },
              "raison": {
                "type": "string",
                "maxLength": 500
              },
              "siren": {
                "type": "string",
                "maxLength": 500
              },
              "adresse": {
                "type": "string",
                "maxLength": 500
              },
              "postal": {
                "type": "string",
                "maxLength": 500
              },
              "ville": {
                "type": "string",
                "maxLength": 500
              },
              "etat": {
                "type": "string",
                "maxLength": 500
              },
              "pays": {
                "type": "string",
                "maxLength": 500
              },
              "social_id": {
                "type": "string",
                "maxLength": 500
              },
              "giftAid": {
                "type": "boolean"
              }
            },
            "required": [
              "perso"
            ],
            "additionalProperties": false,
            "description": "Identité de facturation pour les documents ultérieurs. Les textes sont des chaînes ; aucun champ privé de moyen de paiement n’est admis."
          }
        },
        "required": [
          "idempotencyKey",
          "name",
          "montant",
          "devise",
          "assoc",
          "cerfa",
          "nbMonth",
          "maxAmount",
          "info"
        ],
        "additionalProperties": false
      },
      "SubscriptionPreparationResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "data"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/SubscriptionPreparation"
          }
        }
      },
      "SubscriptionPreparation": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "id",
          "state",
          "subscriptionId",
          "paymentId",
          "contract",
          "requiresPayerAuthorization",
          "createdAt",
          "updatedAt"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "state": {
            "type": "string",
            "enum": [
              "PREPARING",
              "PREPARED",
              "UNCERTAIN"
            ]
          },
          "subscriptionId": {
            "type": "string",
            "format": "uuid",
            "nullable": true
          },
          "paymentId": {
            "type": "string",
            "format": "uuid",
            "nullable": true
          },
          "contract": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "type",
              "amountMinor",
              "currency",
              "association",
              "receiptRequested",
              "maxOccurrences",
              "maxAmountMinor"
            ],
            "properties": {
              "type": {
                "type": "string",
                "enum": [
                  "GENERAL"
                ]
              },
              "amountMinor": {
                "type": "integer",
                "minimum": 1
              },
              "currency": {
                "type": "string"
              },
              "association": {
                "type": "string"
              },
              "receiptRequested": {
                "type": "boolean"
              },
              "maxOccurrences": {
                "type": "integer",
                "minimum": 0
              },
              "maxAmountMinor": {
                "type": "integer",
                "minimum": 0
              }
            }
          },
          "requiresPayerAuthorization": {
            "type": "boolean",
            "enum": [
              true
            ],
            "description": "Ce parcours exige l’autorisation du payeur. C’est une exigence du parcours, pas une observation indiquant si le payeur l’a déjà terminé."
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time"
          },
          "authorizationExpiresAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true,
            "description": "Expiration enregistrée du Checkout, pas une preuve de son état actuel chez le prestataire. Une préparation expirée ou qui n’est plus en attente ne peut plus restituer son lien."
          },
          "authorizationUrl": {
            "type": "string",
            "format": "uri",
            "description": "Retournée uniquement par le POST autorisé avec les deux droits d’écriture, y compris lors d’un rejeu identique. La lecture GET de statut ne retourne jamais cette URL d’action."
          }
        }
      },
      "SubscriptionPreparationError": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string",
            "pattern": "^[A-Z][A-Z0-9_]+$"
          },
          "requestId": {
            "type": "string",
            "format": "uuid"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "details": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "code"
            ],
            "properties": {
              "code": {
                "type": "string"
              },
              "location": {
                "type": "string",
                "enum": [
                  "body",
                  "path",
                  "query"
                ]
              }
            }
          }
        }
      }
    },
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "API Key",
        "description": "Format : `ke_live_xxx`"
      },
      "apiKeyHeader": {
        "type": "apiKey",
        "in": "header",
        "name": "X-API-Key"
      }
    }
  }
}
```
