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

# Paiements

OpenAPI 3.0.3 · API 2.0.0

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

Dons et paiements.

## Opérations

## GET /paiements

Lister les paiements

`list_paiements`

Autorisation requise : `paiements:read`. Liste uniquement les paiements COMPLETED ou REFUNDED non supprimés, dans le périmètre de l’organisation et de la clé API. `externalRef` utilise une égalité exacte, sensible à la casse, et se combine avec les autres filtres ; plusieurs paiements peuvent partager cette valeur. Sans correspondance, renvoie une liste paginée vide. Les tentatives INIT, en attente et échouées restent exclues, même avec externalRef.

### Authentification

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

### Permissions requises

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

### Paramètres

```json
{
  "name": "limit",
  "in": "query",
  "schema": {
    "type": "integer",
    "minimum": 1,
    "maximum": 200,
    "default": 50
  },
  "description": "Nombre de résultats par page."
}
```

```json
{
  "name": "cursor",
  "in": "query",
  "schema": {
    "type": "string"
  },
  "description": "Curseur opaque renvoyé par la requête précédente."
}
```

```json
{
  "name": "createdAfter",
  "in": "query",
  "schema": {
    "type": "string",
    "format": "date-time"
  },
  "description": "Filtre : créé après cette date (ISO 8601)."
}
```

```json
{
  "name": "createdBefore",
  "in": "query",
  "schema": {
    "type": "string",
    "format": "date-time"
  },
  "description": "Filtre : créé avant cette date (ISO 8601)."
}
```

```json
{
  "name": "type",
  "in": "query",
  "schema": {
    "type": "string"
  },
  "description": "GENERAL | SERVICE | CAISSE | DETTE | FORM"
}
```

```json
{
  "name": "platform",
  "in": "query",
  "schema": {
    "type": "string"
  },
  "description": "STRIPE | PAYGREEN | ..."
}
```

```json
{
  "name": "contactId",
  "in": "query",
  "schema": {
    "type": "string"
  }
}
```

```json
{
  "name": "externalRef",
  "in": "query",
  "schema": {
    "type": "string",
    "minLength": 1,
    "maxLength": 255,
    "pattern": "\\S",
    "description": "Référence facultative dans votre système. Non vide, enregistrée telle quelle ; correspondance exacte sensible à la casse. Non unique et ne constitue PAS une clé d’idempotence. À distinguer de externalId (dédoublonnage à l’import). Renvoyée lors de la lecture des paiements et dans les webhooks de paiement si elle est fournie. Héritée par les paiements récurrents.",
    "example": "commande-1234"
  },
  "description": "Référence externe exacte, sensible à la casse ; encodez la valeur dans l’URL. Exemple : ?externalRef=commande-1234. Une valeur répétée/structurée ou invalide renvoie 400 INVALID_EXTERNAL_REF."
}
```

### Réponses

#### HTTP 200

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

#### HTTP 400

```json
{
  "description": "INVALID_EXTERNAL_REF",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "INVALID_EXTERNAL_REF"
          }
        }
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "ERREUR",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "ERROR"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "AUTORISATION_INSUFFISANTE",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "INSUFFICIENT_SCOPE"
          }
        }
      }
    }
  }
}
```

### OpenAPI

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

## POST /paiements

Créer un lien de paiement autonome

`create_paiements`

Droit requis : `paiements:write`. Prépare une demande de paiement ponctuel et renvoie l’URL de la page de paiement hébergée (ou clientSecret pour les prestataires intégrés). L’entité cible (`typeId`) doit appartenir à l’organisation de la clé API. `config.organisation` est interdit en entrée ; l’organisation authentifiée est fournie par le serveur. `config` est validé avant traitement : `config.montant` doit être un nombre fini > 0 en unités monétaires majeures et ≤ 1000000 (sauf le type SERVICE, dont le montant provient du service) ; `config.service` est accepté uniquement avec le type SERVICE ; chaque entrée `config.dettes[]` doit appartenir à votre organisation et porter un montant fini > 0. La création d’un lien hébergé ou l’obtention d’un résultat de paiement intégré ne prouve pas l’encaissement. La création récurrente est indisponible ici ; utiliser prepare_subscription pour le parcours GENERAL mensuel hébergé Stripe pris en charge. La modification d’un paiement existant est indisponible ici, y compris le complément d’identité du donateur. Seuls false ou l’omission sont admis pour config.abo et config.update. La réponse est le résultat direct de la demande de paiement, sans enveloppe data.

### Authentification

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

### Permissions requises

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

### Corps de la requête

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

### Réponses

#### HTTP 200

```json
{
  "description": "Résultat direct de la demande de paiement.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/PaymentResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "MISSING_CONFIG / INVALID_MONTANT / MONTANT_TOO_LARGE / SERVICE_NOT_ALLOWED / INVALID_DETTES / INVALID_EXTERNAL_REF / INVALID_EXTERNAL_METADATA",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "MISSING_CONFIG / INVALID_MONTANT / MONTANT_TOO_LARGE / SERVICE_NOT_ALLOWED / INVALID_DETTES / INVALID_EXTERNAL_REF / INVALID_EXTERNAL_METADATA"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "ORG_NOT_FOUND / TARGET_NOT_FOUND / DETTE_NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "ORG_NOT_FOUND / TARGET_NOT_FOUND / DETTE_NOT_FOUND"
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "paiements:write",
  "x-unisoft-mcp": {
    "category": "create",
    "readOnly": false,
    "destructive": false,
    "idempotent": false,
    "warn": false
  }
}
```

## POST /paiements/import

Importer un paiement déjà encaissé

`import_paiement`

Autorisation requise : `paiements:write`. Enregistre un don encaissé AILLEURS (chèque, virement, espèces, ancien logiciel, autre plateforme) comme paiement historique/comptable — enregistré avec `imported:true` et `state:"COMPLETED"`. Il alimente les statistiques, les compteurs de collecte, le CRM et la conversion de devises, mais AUCUN reçu/cerfa n’est émis ni réémis. C’est l’équivalent unitaire et validé des outils d’import en masse en ligne de commande. Utilisez `POST /paiements` (et non cette opération) pour permettre à un donateur de payer en ligne maintenant. Idempotent lorsque `externalId` est fourni (une migration peut être relancée sans risque). L’association et la devise cibles doivent correspondre au contexte canonique de la cible. Les contradictions renvoient IMPORT_TARGET_FINANCE_MISMATCH ; un contexte cible non établi renvoie IMPORT_TARGET_FINANCE_UNAVAILABLE, avant toute persistance ou tout recalcul des caches.

### Authentification

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

### Permissions requises

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

### Corps de la requête

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

### Réponses

#### HTTP 200

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

#### HTTP 400

```json
{
  "description": "INVALID_AMOUNT / INVALID_METHOD / ASSOC_NOT_FOUND / INVALID_EXTERNAL_REF / INVALID_EXTERNAL_METADATA",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "INVALID_AMOUNT / INVALID_METHOD / ASSOC_NOT_FOUND / INVALID_EXTERNAL_REF / INVALID_EXTERNAL_METADATA"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "CONTACT_NOT_FOUND / TARGET_NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "CONTACT_NOT_FOUND / TARGET_NOT_FOUND"
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-mcp": false,
  "x-unisoft-scope": "paiements:write"
}
```

## GET /paiements/{id}

Obtenir un paiement

`get_paiement`

Autorisation requise : `paiements:read`. Le détail reste disponible à l’état REFUND_PENDING pour inspecter un remboursement non confirmé. Vérifiez auprès de Nedarim tout remboursement Nedarim non confirmé avant de réessayer.

### Authentification

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

### Permissions requises

```json
{
  "accepted": "paiements: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/Paiement"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "NOT_FOUND"
          }
        }
      }
    }
  }
}
```

### OpenAPI

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

## POST /paiements/{id}/refund

Rembourser un paiement

`refund_paiement`

Autorisation requise : `paiements:write`. Déclenche un remboursement intégral auprès du fournisseur de paiement. Fournisseurs pris en charge : Stripe, Stripe externe, iPay, Nedarim et PayGreen. Le paiement doit appartenir à l’organisation de la clé API, être terminé, ne pas être groupé ni déjà remboursé. Nedarim conserve le reçu d’origine et émet un reçu négatif. Une réponse Nedarim ou PayGreen non confirmée laisse le paiement à l’état REFUND_PENDING : vérifiez auprès du fournisseur avant de demander un autre remboursement. PayGreen vérifie la référence de commande, la boutique, le montant, la devise et les fonds encaissés avant de demander un remboursement complet. Cette opération financière est irréversible.

### Authentification

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

### Permissions requises

```json
{
  "accepted": "paiements:write",
  "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."
}
```

### Corps de la requête

```json
{
  "required": false,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "reason": {
            "type": "string",
            "enum": [
              "requested_by_customer",
              "duplicate",
              "fraudulent"
            ],
            "default": "requested_by_customer"
          },
          "message": {
            "type": "string",
            "description": "Note interne facultative enregistrée dans l’historique d’audit du remboursement."
          },
          "pauseAbo": {
            "type": "boolean",
            "description": "Mettre également en pause l’abonnement associé, s’il existe.",
            "default": false
          }
        },
        "additionalProperties": false
      }
    }
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Remboursement accepté",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/PaymentRefundResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "INVALID_REASON / INVALID_STATE / GROUPED_PAIEMENT / ALREADY_REFUNDED / REFUND_FAILED / NEDARIM_REFUND_UNCONFIRMED. Si pending vaut true, vérifiez la transaction dans Nedarim avant de réessayer.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/PaymentRefundResponse"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "PAIEMENT_NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "PAIEMENT_NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### HTTP 405

```json
{
  "description": "METHOD_NOT_ALLOWED",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "METHOD_NOT_ALLOWED"
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "paiements:write",
  "x-unisoft-mcp": {
    "category": "action",
    "readOnly": false,
    "destructive": true,
    "idempotent": false,
    "warn": true
  }
}
```

## GET /paiements/{id}/status

Lire l’état enregistré d’une tentative de paiement

`get_paiement_status`

Nécessite paiements:read. Lit l’enregistrement courant d’un paiement dans l’organisation authentifiée et le périmètre de campagne autorisé. Inclut les tentatives masquées par la liste historique des paiements terminés. Accepte uniquement l’identifiant du paiement : les paramètres de requête et les corps non vides sont refusés. Un paiement absent, supprimé ou hors périmètre renvoie toujours 404. Le résultat est une observation en liste blanche, sans vérification bancaire, instruction de réessai ni contrôle de préparation d’un reçu. Lire séparément les champs renvoyés : state est le code enregistré ; phase associe INIT à PREPARED, les états en attente à PROCESSING, COMPLETED à RECORDED_COMPLETED, REFUNDED à RECORDED_REFUNDED et les codes non reconnus à UNKNOWN. RECORDED_COMPLETED peut correspondre à une autorisation Axepta avant capture ou à un encaissement historique importé ; cela ne prouve ni capture, ni règlement bancaire, ni versement. amountMinor est le montant de ce paiement en unités mineures (5000 pour 50 EUR), et non la mensualité nominale de l’abonnement. Un montant ou une devise null reste inconnu. imported est le booléen explicitement enregistré, ou null si la valeur est absente/invalide. donorInformationStatus interprète finalized indépendamment de l’état financier et de l’émission d’un reçu ; COMPLETED peut coexister avec INCOMPLETE. recordedAt correspond à datetime du paiement (préparation en ligne ou date métier fournie en saisie manuelle/import), et non au règlement bancaire ou à l’émission du reçu. Ne jamais déduire une expiration de l’ancienneté ni une autorisation de réessai de cette observation. Aucun appel prestataire, débit, remboursement, exécution d’abonnement ou 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.

### Authentification

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

### Permissions requises

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

### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "description": "UUID du paiement Unisoft renvoyé par le parcours de paiement.",
  "schema": {
    "type": "string",
    "format": "uuid"
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "État du paiement enregistré ; lire séparément phase, imported et donorInformationStatus.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/PaymentStatusResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "UUID invalide, paramètres de requête inattendus ou corps de requête non vide.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Clé API 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": "Autorisation paiements:read absente ou organisation désactivée.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Paiement 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": "Impossible de lire l’état. 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": "paiements:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  },
  "x-unisoft-mcp-output-schema": true
}
```

## GET /paiements/{id}/context

Consulter les observations datées et les relations autorisées d’un paiement

`get_paiement_context`

Toutes les autorisations paiements:read, contacts:read, promesses:read, abonnements:read, forms_submit:read et receipts:read sont requises ; une autorisation manquante renvoie 403 sans donnée de paiement ou de relation. L’entrée est uniquement un UUID de paiement ; les paramètres de requête et corps non vides sont refusés. Les paiements absents, supprimés, étrangers à l’organisation ou hors des collectes autorisées partagent la même réponse 404. Chaque ressource liée est réadmise indépendamment dans l’organisation authentifiée et le périmètre des collectes autorisées ; une référence enregistrée n’accorde jamais de droit. Les références de contact et de soumission sont masquées pour chaque clé limitée aux collectes, comme indiqué dans campaignRestrictedDomains, car leur propre appartenance à une collecte ne peut pas être établie. FORM typeId désigne une soumission, abo un abonnement. Les relations null ou vides indiquent qu’aucune relation admissible n’a été retournée et ne prouvent pas une absence historique. Les références de promesses identifient des cibles ou affectations enregistrées sans calculer de solde, prorata ou calendrier d’abonnement ; une carte d’affectation figée explicitement vide exclut le repli vers les références historiques dettes. Les références documentaires exigent receipts:read et l’admission actuelle de leur paiement, y compris tous les membres des groupes ou reçus annuels. Timeline contient uniquement les dates enregistrées prises en charge : payment.datetime, les dernières refund.createdAt/updatedAt et document.datetime des documents réadmis, triées par ordre croissant avec départage déterministe. Cette observation partielle ne reconstitue jamais les transitions, chaque tentative de remboursement, les événements prestataire, le règlement bancaire, la capture, la livraison ou l’expiration. En ligne, datetime date généralement la préparation ; en saisie manuelle/import, il peut s’agir de la date métier fournie. Le sens des états enregistrés est conservé : COMPLETED peut correspondre à une autorisation Axepta avant capture ou à un import historique ; finalized décrit indépendamment les informations du donateur. Les montants, devises et dates inconnus restent inconnus. Plus de 200 références de promesse ou un contexte documentaire trop volumineux renvoient 409 sans graphe partiel. Aucun débit, réessai, appel prestataire, émission/envoi documentaire, rapprochement ou initialisation persistante de calendrier n’a lieu. L’authentification peut mettre à jour les statistiques d’usage de la clé API.

### Authentification

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

### Permissions requises

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

### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "description": "UUID du paiement Unisoft renvoyé par le parcours de paiement.",
  "schema": {
    "type": "string",
    "format": "uuid"
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Observation du paiement limitée aux champs autorisés, événements datés et références autorisées indépendamment.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/PaymentContextResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "UUID invalide, paramètres de requête inattendus ou corps de requête non vide.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "param": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    }
  }
}
```

#### HTTP 401

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

#### HTTP 403

```json
{
  "description": "Au moins une autorisation de lecture des domaines requis manque, ou l’organisation est désactivée.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "param": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    }
  }
}
```

#### HTTP 404

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

#### HTTP 409

```json
{
  "description": "PAYMENT_CONTEXT_LIMIT_EXCEEDED : le graphe de relations enregistré dépasse la borne de lecture autorisée ; aucun graphe partiel n’est retourné.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "param": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "Lecture du contexte impossible. Aucune opération financière ou documentaire n’a été tentée.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "param": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    }
  }
}
```

### OpenAPI

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

## GET /payment-methods

Consulter les choix de paiement configurés pour une association et une cible

`list_payment_methods`

Autorisation requise : paiements:read. Consulte la configuration locale actuelle des choix de paiement pour une association légale, une devise effective et un type d’affectation. Fournir assoc (MAIN ou UUID d’association), currency (trois lettres), type (GENERAL, FORM, DETTE, CAISSE ou CAMPAGNE), typeId pour chaque type sauf GENERAL et, en option, recurring (false par défaut). Pour FORM, la cible est une soumission ; son formulaire parent est vérifié indépendamment. L’appartenance des cibles, l’association légale, la devise et les restrictions de collecte sont contrôlées avant toute divulgation de configuration ; les clés limitées à des collectes peuvent seulement utiliser CAMPAGNE avec un typeId explicitement autorisé. Les devises et références d’association doivent correspondre : aucun repli silencieux vers MAIN ni conversion. Les devises virtuelles d’affichage d’une collecte sont refusées. Une cible refusée par le propriétaire actuel de publication ou de cycle de vie de la collecte est INELIGIBLE. AVAILABLE décrit seulement la configuration locale observée : cela ne confirme ni l’acceptation du paiement, ni la validité des identifiants, ni un moyen réutilisable. Le propriétaire actuel de sélection résout la priorité des prestataires sans enregistrer de choix. Les références marchandes absentes restent INDETERMINATE ; une option demandée qui se replie vers un autre choix est UNAVAILABLE. L’éligibilité finale reste toujours INDETERMINATE, ou INELIGIBLE en cas de refus local observé, car les exigences de montant, donateur, affectations, calendrier, stock, checkout et prestataire ne sont pas fournies. Consulter prerequisites pour les étapes nécessaires ; ne jamais en déduire la permission de débiter ou de réessayer. Les portefeuilles exigent aussi une vérification dans le navigateur ; la configuration SEPA_XML exige son admission distincte par le runtime, un mandat et un calendrier, et n’est pas sélectionnée par le propriétaire carte. Aucun débit, création de checkout ou de lien, création de mandat, appel au prestataire, contrôle d’identifiants, rapprochement ni écriture métier n’a lieu ; l’authentification partagée peut mettre à jour la télémétrie d’utilisation de la clé API. Aucun identifiant de configuration prestataire, référence de compte, moyen réutilisable, secret ou snapshot privé de cible n’est renvoyé. Les paramètres inconnus, valeurs répétées ou structurées et corps non vides sont refusés. SERVICE, LIVRET, les paiements fractionnés et les moyens hors ligne sont exclus de cette lecture.

### Authentification

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

### Permissions requises

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

### Paramètres

```json
{
  "name": "assoc",
  "in": "query",
  "required": true,
  "description": "Association légale : MAIN ou un UUID d’association provenant de list_associations.",
  "schema": {
    "type": "string",
    "pattern": "^(MAIN|[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})$"
  }
}
```

```json
{
  "name": "currency",
  "in": "query",
  "required": true,
  "description": "Devise effective d’encaissement sur trois lettres ; insensible à la casse et normalisée en minuscules.",
  "schema": {
    "type": "string",
    "pattern": "^[A-Za-z]{3}$"
  }
}
```

```json
{
  "name": "type",
  "in": "query",
  "required": true,
  "description": "Type d’affectation métier. SERVICE et LIVRET sont exclus.",
  "schema": {
    "type": "string",
    "enum": [
      "GENERAL",
      "FORM",
      "DETTE",
      "CAISSE",
      "CAMPAGNE"
    ]
  }
}
```

```json
{
  "name": "typeId",
  "in": "query",
  "description": "Requis pour FORM (UUID de soumission), DETTE (promesse), CAISSE ou CAMPAGNE ; interdit pour GENERAL.",
  "schema": {
    "type": "string",
    "format": "uuid"
  }
}
```

```json
{
  "name": "recurring",
  "in": "query",
  "description": "Intention récurrente ; false par défaut. REST accepte seulement les valeurs littérales true ou false, et MCP un booléen.",
  "schema": {
    "type": "boolean",
    "default": false
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Choix configurés localement, avec sélection, éligibilité et préalables manquants distincts.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/PaymentMethodsResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Paramètres invalides ou inconnus : association, devise, type, cible, recurring ou corps non vide.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/PaymentMethodsErrorResponse"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Authentification absente ou invalide.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/PaymentMethodsErrorResponse"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "paiements:read manquant ou organisation désactivée.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/PaymentMethodsErrorResponse"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Association, cible, parent ou collecte liée absent, supprimé, étranger à l’organisation ou hors des collectes autorisées.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/PaymentMethodsErrorResponse"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Configuration enregistrée invalide, devise de l’association inconnue ou résolution de l’association cible indéterminée. Compléter ou corriger la configuration locale avant de se fier à cette lecture.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/PaymentMethodsErrorResponse"
      }
    }
  }
}
```

#### HTTP 422

```json
{
  "description": "Incohérence association/cible/devise ou VIRTUAL_CURRENCY_DISPLAY_ONLY. Utiliser l’association et la devise effectives d’encaissement de la cible.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/PaymentMethodsErrorResponse"
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "Échec de la lecture de configuration ; aucune opération de paiement n’a été tentée.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/PaymentMethodsErrorResponse"
      }
    }
  }
}
```

### OpenAPI

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

## GET /paiements/{id}/refund-history

Lire l’état enregistré et l’historique partiel du remboursement d’un paiement

`get_paiement_refund_history`

Autorisation requise : paiements:read. Lit uniquement le paiement enregistré et ses journaux PAIEMENT_REFUND existants, dans l’organisation authentifiée et le périmètre des collectes autorisées. Seul l’UUID du paiement est accepté : les paramètres de requête et les corps non vides sont refusés. Un paiement absent, supprimé ou hors périmètre renvoie 404. latestAttempt expose seulement le dernier instantané conservé : state, attemptNumber positif, reservedAt et updatedAt ; les valeurs absentes ou invalides restent null. Une nouvelle tentative remplace les données de l’instantané précédent. status vaut NOT_RECORDED uniquement lorsqu’aucun instantané ni journal de remboursement n’a été trouvé ; cette absence ne prouve ni un échec ni l’absence réelle de remboursement. PENDING correspond au couple REFUND_PENDING/PENDING sans erreur enregistrée ; une erreur en attente, des états contradictoires ou des états inconnus donnent UNKNOWN. RECORDED_SUCCEEDED correspond au couple REFUNDED/SUCCEEDED ; RECORDED_FAILED et RECORDED_CANCELED exigent les couples COMPLETED/FAILED ou COMPLETED/CANCELED. Il s’agit de résultats métier enregistrés, sans vérification bancaire : le propriétaire actuel peut enregistrer SUCCEEDED même pour une réponse prestataire PENDING. Ni un journal de réussite ni le dernier état ne prouvent le règlement bancaire, la suppression d’un reçu, la pause d’un abonnement ou le droit de rejouer. history contient uniquement les événements REFUND_RECORDED déjà journalisés, les datetime enregistrés les plus récents en premier, avec une limite de 100 et hasMore. Ces journaux peuvent manquer, précéder un échec ultérieur et ne conservent pas toutes les réservations, tous les échecs, toutes les confirmations ou les numéros de tentative. historyCompleteness vaut toujours PARTIAL, y compris pour une liste vide ou hasMore=false. Les dates sont des instants ISO enregistrés ou null, jamais déduites de l’ancienneté. UNKNOWN et PENDING exigent une vérification par le parcours métier autorisé existant avant toute nouvelle tentative ; cette lecture n’autorise ni ne déclenche aucun rejeu. Aucun remboursement partiel, interrogation du prestataire, rapprochement, remboursement, débit ou modification d’état métier. L’authentification partagée peut actualiser la télémétrie d’utilisation de la clé API. Les motifs, commentaires, acteurs, erreurs brutes, configurations privées, moyens réutilisables et références du prestataire sont exclus.

### Authentification

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

### Permissions requises

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

### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "description": "UUID du paiement Unisoft dont le remboursement enregistré doit être consulté.",
  "schema": {
    "type": "string",
    "format": "uuid"
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Observation du remboursement enregistré avec historique explicitement partiel.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/PaymentRefundHistoryResponse"
      }
    }
  }
}
```

#### 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": "Clé API 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": "Autorisation paiements:read absente ou organisation désactivée.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Paiement 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": "Impossible de lire l’observation enregistrée du remboursement. Aucun remboursement n’a été tenté.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

### OpenAPI

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

## GET /paiements/{id}/finance

Lire les frais et le net enregistrés d’un paiement avec leurs limites de disponibilité

`get_paiement_finance`

Nécessite paiements:read. Lit un paiement enregistré dans l’organisation authentifiée et les collectes autorisées, y compris une tentative incomplète. Accepte uniquement son UUID ; les paramètres de requête inconnus et les corps non vides sont refusés. Un paiement absent, supprimé ou hors périmètre renvoie toujours 404 NOT_FOUND. grossMinor correspond à amount en unités mineures de la devise enregistrée du paiement : 5000 représente 50 EUR pour eur. bankFeesMinor et serviceFeesMinor sont les nombres bruts bankFees/orgfees enregistrés en unités mineures ; leur devise n’est pas prouvée et vaut toujours null dans bankFeesCurrency/serviceFeesCurrency. Stripe peut enregistrer des frais dans la devise du règlement, différente de celle du paiement. Ne jamais attribuer la devise du paiement aux frais ni soustraire des frais non nuls dans des devises non prouvées. La provenance de chaque frais est ESTIMATED lorsqu’un composant estimateFees de PAYGREEN correspond, RECORDED_WITHOUT_PROVENANCE pour un autre frais enregistré valide, ou UNKNOWN pour un frais absent ou invalide ; aucun frais enregistré n’est certifié définitif. Les montants absents ou invalides restent null ; des frais absents ne signifient jamais zéro. totalFeesMinor vaut zéro et netMinor vaut grossMinor uniquement lorsque les deux frais sont explicitement zéro et que le brut et la devise du paiement sont connus. Sinon netAvailability vaut UNKNOWN avec un motif de préalable, notamment FEE_CURRENCY_NOT_RECORDED. AVAILABLE est un net à frais enregistrés nuls, sans signifier une réception bancaire ou des frais définitifs. Aucune devise, aucun taux, ajustement de remboursement ou contestation, ni état financier ne sont déduits. COMPLETED peut correspondre à une autorisation avant capture. Ce net n’est ni un règlement prestataire, ni un versement, ni une réception bancaire. Les données converties sont UNAVAILABLE/HISTORICAL_CONVERSION_PROVENANCE_NOT_RECORDED car la devise cible historique et la provenance du taux manquent et les frais convertis peuvent comporter des zéros substitués. payout et reconciliation restent UNAVAILABLE/AUTHORIZED_OWNER_ADAPTER_REQUIRED dans cette seule opération. Pour la projection de trésorerie enregistrée et autorisée séparément, utiliser get_payment_treasury et get_payment_treasury_payouts avec payment_treasury:read et l’autorité actuelle du véritable créateur ADMIN/par association ; les conditions de source et de marchand pris en charge restent applicables. UNAVAILABLE ne signifie jamais aucun versement ni absence de rapprochement. Une référence de paiement ou prestataire seule ne donne aucun droit. Ce lecteur financier ordinaire ne peut ni actualiser ni exposer ces projections séparées. Aucun appel bancaire ou prestataire, synchronisation, rapprochement, débit, remboursement ou écriture métier n’a lieu ; l’authentification commune peut actualiser la télémétrie d’utilisation de la clé API. Les erreurs de base renvoient 500 INTERNAL_ERROR sans détails privés.

### Authentification

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

### Permissions requises

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

### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "description": "UUID du paiement Unisoft.",
  "schema": {
    "type": "string",
    "format": "uuid"
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Calcul des frais enregistrés et capacités explicitement indisponibles.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/PaymentFinanceResponse"
      }
    }
  }
}
```

#### HTTP 400

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

#### HTTP 401

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

#### HTTP 403

```json
{
  "description": "Autorisation paiements:read absente ou organisation désactivée.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "param": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Paiement absent, supprimé ou hors du périmètre de l’organisation ou des collectes.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "param": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "INTERNAL_ERROR. Aucune opération financière n’a été tentée.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "param": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    }
  }
}
```

### OpenAPI

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

## GET /paiements/{id}/incidents

Consulter les litiges et rejets persistés d’un paiement

`get_paiement_incidents`

Autorisation requise : `paiements:read`. Lit le dernier instantané d’incident persisté par source prise en charge pour un paiement de l’organisation authentifiée et des campagnes autorisées, y compris les tentatives en échec. La couverture des données enregistrées est partielle et ne constitue jamais un historique exhaustif ni une vérification bancaire. Seul l’UUID du paiement est accepté : les paramètres de requête inconnus et les corps non vides sont refusés. Les paiements absents, supprimés ou hors périmètre donnent le même 404. Les prestataires pris en charge sont les familles Stripe carte/wallet/SEPA explicites, GOCARDLESS et SEPA_XML ; les autres plateformes donnent UNSUPPORTED sans source. PARTIAL_PERSISTED reste toujours partiel, même sans source ou avec NOT_RECORDED. Un message d’erreur prestataire, un état d’échec, l’ancienneté ou un retour navigateur ne prouvent jamais seuls un litige. Les observations sont RECORDED, NOT_RECORDED (aucune trace sélectionnée persistée), UNRECOGNISED (trace impossible à interpréter sûrement) ou UNAVAILABLE (Stripe treasury exige un adaptateur distinct d’autorisation bancaire/association et n’est pas lu par cette opération). Stripe debit_disputed ne désigne un litige que pour Stripe SEPA ; card_declined est un refus. GoCardless charged_back, refund_requested ou authorisation_disputed prouvent une contestation ; un code bancaire seul ne suffit pas. SEPA_XML utilise sepaXml.failure, vérifié contre ce paiement et sa remise courante, avec les types REJECT, RETURN, DISPUTE ou REFUND. Les corrections Stripe treasury et historiques de litiges carte sont indisponibles ici : paiements:read et un paymentId stocké ne donnent pas l’accès bancaire/association distinct exigé par ce propriétaire. Pour les corrections de trésorerie enregistrées et autorisées séparément, utiliser get_payment_treasury_corrections avec payment_treasury:read et son admission actuelle du créateur ADMIN/par association, du compte et de la source. Ce lecteur d’incidents persistés ne comprend pas cette projection séparée ; ne pas déduire un litige carte d’une erreur de paiement. Ces sources peuvent décrire le même incident et ne doivent pas être comptées ou additionnées entre elles. Seules des listes explicites de codes/motifs/états sont publiées ; un motif inconnu ou absent reste UNKNOWN et n’est jamais copié d’un message brut. providerStatus est un code prestataire/événement autorisé ou null ; recordedPaymentState est un état Unisoft actuel autorisé ou null et ne décrit pas le cycle de vie du litige chez le prestataire ; resolution vaut RESOLVED uniquement pour un resolvedAt SEPA_XML explicite et valide, sinon UNKNOWN. Les dates sont des instants ISO persistés ou null : occurredAt est la date de l’incident enregistrée (pas celle de préparation du paiement ni du règlement bancaire) ; observedAt est null car aucune observation supplémentaire du prestataire n’est lue ; resolvedAt est l’instant de résolution SEPA explicite du propriétaire. Aucune fraîcheur ni permission de réessayer, restaurer un mandat ou reprendre un abonnement n’est garantie. Aucun appel prestataire, polling, synchronisation, rapprochement, débit ni écriture métier n’a lieu ; l’authentification peut enregistrer la télémétrie d’usage de la clé API.

### Authentification

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

### Permissions requises

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

### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "description": "UUID de la tentative de paiement Unisoft.",
  "schema": {
    "type": "string",
    "format": "uuid"
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Observations persistées partielles avec états inconnus et sources non prises en charge explicites.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/PaymentIncidentsResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "INVALID_UUID, UNEXPECTED_QUERY_PARAMETERS ou UNEXPECTED_REQUEST_BODY.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "param": {
            "type": "string",
            "enum": [
              "id"
            ]
          },
          "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"
          },
          "message": {
            "type": "string"
          },
          "param": {
            "type": "string",
            "enum": [
              "id"
            ]
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Autorisation paiements:read absente ou organisation désactivée.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "param": {
            "type": "string",
            "enum": [
              "id"
            ]
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "NOT_FOUND : paiement absent, supprimé ou hors du périmètre organisation/campagne.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "param": {
            "type": "string",
            "enum": [
              "id"
            ]
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "INTERNAL_ERROR : observation persistée illisible ; aucune opération prestataire tentée.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "param": {
            "type": "string",
            "enum": [
              "id"
            ]
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    }
  }
}
```

### OpenAPI

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

## GET /paiements/export

Exporter les paiements enregistrés et les totaux qualifiés de la période

`export_paiements`

Autorisation requise : paiements:read. Export JSON en lecture seule des paiements enregistrés de l’organisation authentifiée, limité indépendamment aux collectes autorisées pour une clé restreinte (type doit être CAMPAGNE). Les paramètres from/to sont obligatoires : instants RFC 3339 avec fuseau explicite et au plus trois chiffres fractionnaires (précision milliseconde), from inclus et to exclus, sur au plus 31 jours écoulés. Les filtres associationId (MAIN ou UUID), instrument et currency en minuscules sont exacts et combinés avec ET. Aucun filtre arbitraire, pipeline, sélection d’état, identité de donateur ni corps non vide n’est accepté. Tous les états enregistrés, imports, états de remboursement, contributions en nature et traces techniques ABO_PAUSE sont inclus ; les enregistrements supprimés logiquement sont exclus. Seules les valeurs datetime enregistrées prises en charge peuvent entrer dans la période : dates BSON, millisecondes entières sûres depuis l’époque ou chaînes RFC 3339 valides avec fuseau explicite et au plus trois chiffres fractionnaires. Les dates absentes/invalides sont hors de cet export et leur nombre reste inconnu. Le champ datetime désigne généralement la préparation en ligne ou la date métier manuelle/importée, sans garantir la date de règlement bancaire. Tri par datetime normalisé décroissant puis UUID de paiement décroissant, avec collation binaire simple. Le curseur opaque est lié à l’organisation, aux restrictions de collecte et aux filtres ; le réutiliser tel quel avec les mêmes filtres. Au plus 10000 enregistrements correspondants par fenêtre et 200 par page (50 par défaut). Un dépassement retourne 422 EXPORT_WINDOW_TOO_LARGE sans totaux partiels : scinder la période. Une identité de paiement mal formée ou dupliquée retourne 409 INVALID_EXPORT_RECORDS. Chaque page répète les totaux de toute la période filtrée actuelle, et non de cette seule page : ne jamais additionner les totaux répétés sur les pages. Les totaux séparent association, instrument, devise, état exact enregistré, marqueur imported explicite (y compris null inconnu) et recordKind. Ils additionnent uniquement les montants nominaux enregistrés en unités mineures, sans décompter des encaissements bancaires, virements ni échéances d’abonnement distinctes. COMPLETED peut correspondre à une autorisation Axepta avant capture. REFUNDED conserve son montant nominal positif initial ; les mouvements de remboursement ne sont pas datés dans la période ici et aucune déduction de remboursement, de frais ou conversion de devise n’a lieu. Montants/devises inconnus restent null, les montants invalides sont comptés explicitement et les sommes hors précision sûre renvoient OVERFLOW. NATURE et ABO_PAUSE sont séparés des enregistrements monétaires ; même MONETARY_RECORD ne prouve aucune réception de fonds. La projection exclut données personnelles, texte libre, moyens de paiement réutilisables, références prestataire et snapshots privés. Aucun instantané n’est garanti entre les pages : insertions, changements et suppressions peuvent modifier lignes et totaux. Cette lecture n’appelle aucun prestataire et ne déclenche ni débit, remboursement, rapprochement, initialisation de calendrier ni émission documentaire ; l’authentification peut actualiser la télémétrie d’usage de la clé API. Le travail en base est limité à cinq secondes ; sur 500 INTERNAL_ERROR, réessayer plus tard ou réduire la période sans supposer un résultat vide.

### Authentification

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

### Permissions requises

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

### Paramètres

```json
{
  "name": "from",
  "in": "query",
  "required": true,
  "schema": {
    "type": "string",
    "pattern": "^\\d{4}-\\d{2}-\\d{2}T(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d{1,3})?(?:Z|[+-](?:[01]\\d|2[0-3]):[0-5]\\d)$",
    "format": "date-time"
  },
  "description": "Borne basse inclusive sur datetime du paiement ; instant RFC 3339 avec fuseau explicite et au plus trois chiffres fractionnaires. Utiliser une durée écoulée d’au plus 31 jours."
}
```

```json
{
  "name": "to",
  "in": "query",
  "required": true,
  "schema": {
    "type": "string",
    "pattern": "^\\d{4}-\\d{2}-\\d{2}T(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d{1,3})?(?:Z|[+-](?:[01]\\d|2[0-3]):[0-5]\\d)$",
    "format": "date-time"
  },
  "description": "Borne haute exclusive sur datetime du paiement, postérieure à from. Fuseau explicite et au plus trois chiffres fractionnaires requis ; des périodes adjacentes peuvent partager cette borne sans chevauchement."
}
```

```json
{
  "name": "associationId",
  "in": "query",
  "schema": {
    "type": "string",
    "maxLength": 36
  },
  "description": "Association bénéficiaire enregistrée exacte : MAIN ou UUID d’association. Omettre pour inclure toutes les associations, y compris les valeurs historiques inconnues."
}
```

```json
{
  "name": "instrument",
  "in": "query",
  "schema": {
    "type": "string",
    "enum": [
      "CASH",
      "CHEQUE",
      "VIREMENT",
      "PRELEVEMENT",
      "CB",
      "NATURE"
    ]
  },
  "description": "Instrument enregistré exact : CASH, CHEQUE, VIREMENT, PRELEVEMENT, CB ou NATURE. Omettre pour inclure tous les instruments, y compris les valeurs historiques inconnues."
}
```

```json
{
  "name": "currency",
  "in": "query",
  "schema": {
    "type": "string",
    "pattern": "^[a-z]{3}$"
  },
  "description": "Devise enregistrée exacte à trois lettres après normalisation en minuscules, par exemple eur. Omettre pour obtenir des totaux séparés pour chaque devise et pour les devises inconnues."
}
```

```json
{
  "name": "limit",
  "in": "query",
  "schema": {
    "type": "integer",
    "minimum": 1,
    "maximum": 200,
    "default": 50
  },
  "description": "Nombre maximal d’enregistrements de paiement de cette page. Ne limite pas les totaux de période."
}
```

```json
{
  "name": "cursor",
  "in": "query",
  "schema": {
    "type": "string",
    "maxLength": 2048
  },
  "description": "Valeur nextCursor opaque de cet export avec la même organisation, les mêmes restrictions de collecte et la même période/les mêmes filtres. Ne pas utiliser le curseur de la liste habituelle des paiements."
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Page de paiements en projection autorisée et totaux qualifiés de toute la période filtrée actuelle.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/PaymentExportResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Période absente ou invalide, période supérieure à 31 jours écoulés, filtre/limit/cursor invalide, paramètre de requête inattendu ou corps non vide.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/PaymentExportError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Clé API absente ou invalide.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/PaymentExportError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Autorisation paiements:read absente ou organisation désactivée.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/PaymentExportError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "INVALID_EXPORT_RECORDS : une date/identité mal formée ou une identité dupliquée empêche une pagination stable. Aucun export ni total partiel n’est retourné.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/PaymentExportError"
      }
    }
  }
}
```

#### HTTP 422

```json
{
  "description": "EXPORT_WINDOW_TOO_LARGE : plus de 10000 enregistrements correspondent. Scinder la période ; aucun export ni total partiel n’est retourné.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/PaymentExportError"
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "INTERNAL_ERROR : lecture impossible, y compris à cause de la limite de cinq secondes en base. Réessayer plus tard ou réduire la période ; aucune opération financière n’a été tentée.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/PaymentExportError"
      }
    }
  }
}
```

### OpenAPI

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

## GET /paiements/{id}/treasury

Lire les frais, net et observations de capture enregistrés

`get_payment_treasury`

Requiert paiements:read ET payment_treasury:read explicitement attribué, sur la clé authentifiée et sa version persistée actuelle. Cette clé exacte doit conserver createdBy vers un véritable accès ADMIN actuel, activé, non expiré et de la même organisation, ayant accès à toutes les associations du compte marchand. Aucun administrateur synthétique. ROOT, clés sans créateur réel, onlyAttr, restrictions de campagne, modes inconnus, références ambiguës, marchands partagés entre organisations et bindings périmés/incohérents sont refusés. Le mode doit être explicitement connu sur le paiement ou son snapshot wallet ; aucun mode historique n’est deviné. Ce sont des observations Stripe Treasury natives persistées, sans lecture prestataire/banque en direct. Aucun SDK, secret, file de synchronisation, mutation financière ni message. Tous les montants sont des entiers signés en unités mineures Stripe, avec devise et exposant explicites (0 ou 2) ; ne jamais supposer des centimes pour toutes les devises, substituer EUR/zéro, mélanger devises de présentation/règlement ou calculer un taux de change non documenté. Une observation manquante ne prouve pas l’absence de fonds, litiges ou versements. COMPLETED seul ne prouve ni capture ni réception bancaire. providerRefreshed et bankVerified restent false. Autorité et références locales sont relues avant restitution. presentment est la devise du paiement/charge ; settlement contient le montant, les frais et le net équilibrés natifs dans leur devise de règlement enregistrée séparément. Des frais non nuls sans cette devise sont refusés. Les deux devises peuvent différer. L’état natif de maturité et sa date d’observation qualifient la disponibilité ; AVAILABLE n’est ni un versement ni un dépôt bancaire. captured=null signifie inconnu, pas false. Aucun montant n’est attribué depuis un solde marchand global. Lire get_payment_treasury_payouts pour une composition publiée vérifiée et get_payment_treasury_corrections pour les corrections enregistrées séparément.

### Authentification

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

### Permissions requises

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

### Paramètres

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

### Réponses

#### HTTP 200

```json
{
  "description": "Observations Treasury persistées et qualifiées.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/PaymentTreasurySnapshotResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Erreur fixe d’autorité, de données historiques ou de requête.",
  "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"
            }
          },
          "details": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "code": {
                "type": "string"
              },
              "location": {
                "type": "string",
                "enum": [
                  "body",
                  "query",
                  "path"
                ]
              }
            }
          },
          "param": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Erreur fixe d’autorité, de données historiques ou de requête.",
  "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"
            }
          },
          "details": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "code": {
                "type": "string"
              },
              "location": {
                "type": "string",
                "enum": [
                  "body",
                  "query",
                  "path"
                ]
              }
            }
          },
          "param": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Erreur fixe d’autorité, de données historiques ou de requête.",
  "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"
            }
          },
          "details": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "code": {
                "type": "string"
              },
              "location": {
                "type": "string",
                "enum": [
                  "body",
                  "query",
                  "path"
                ]
              }
            }
          },
          "param": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Erreur fixe d’autorité, de données historiques ou de requête.",
  "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"
            }
          },
          "details": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "code": {
                "type": "string"
              },
              "location": {
                "type": "string",
                "enum": [
                  "body",
                  "query",
                  "path"
                ]
              }
            }
          },
          "param": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Erreur fixe d’autorité, de données historiques ou de requête.",
  "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"
            }
          },
          "details": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "code": {
                "type": "string"
              },
              "location": {
                "type": "string",
                "enum": [
                  "body",
                  "query",
                  "path"
                ]
              }
            }
          },
          "param": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "Erreur fixe d’autorité, de données historiques ou de requête.",
  "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"
            }
          },
          "details": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "code": {
                "type": "string"
              },
              "location": {
                "type": "string",
                "enum": [
                  "body",
                  "query",
                  "path"
                ]
              }
            }
          },
          "param": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

### OpenAPI

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

## GET /paiements/{id}/treasury/corrections

Lire les remboursements et litiges Stripe enregistrés pour ce paiement

`get_payment_treasury_corrections`

Requiert paiements:read ET payment_treasury:read explicitement attribué, sur la clé authentifiée et sa version persistée actuelle. Cette clé exacte doit conserver createdBy vers un véritable accès ADMIN actuel, activé, non expiré et de la même organisation, ayant accès à toutes les associations du compte marchand. Aucun administrateur synthétique. ROOT, clés sans créateur réel, onlyAttr, restrictions de campagne, modes inconnus, références ambiguës, marchands partagés entre organisations et bindings périmés/incohérents sont refusés. Le mode doit être explicitement connu sur le paiement ou son snapshot wallet ; aucun mode historique n’est deviné. Ce sont des observations Stripe Treasury natives persistées, sans lecture prestataire/banque en direct. Aucun SDK, secret, file de synchronisation, mutation financière ni message. Tous les montants sont des entiers signés en unités mineures Stripe, avec devise et exposant explicites (0 ou 2) ; ne jamais supposer des centimes pour toutes les devises, substituer EUR/zéro, mélanger devises de présentation/règlement ou calculer un taux de change non documenté. Une observation manquante ne prouve pas l’absence de fonds, litiges ou versements. COMPLETED seul ne prouve ni capture ni réception bancaire. providerRefreshed et bankVerified restent false. Autorité et références locales sont relues avant restitution. Les relations natives de correction doivent correspondre au marchand/mode, à la référence locale et à l’ascendance charge/paymentIntent actuels, pas seulement à un paymentId historique. type distingue refund de dispute ; aucun des deux ne demande remboursement ou réessai. reason reste null car le producteur natif ne conserve pas le motif de litige ; les motifs d’échec/attente de remboursement ne le remplacent pas. Status est l’état prestataire enregistré avec observedAt/stale. Pagination current/pageSize, au plus 1000 relations pertinentes. Une liste vide décrit seulement l’absence de relation persistée admise, pas l’absence certaine de litige.

### Authentification

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

### Permissions requises

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

### Paramètres

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

```json
{
  "name": "current",
  "in": "query",
  "schema": {
    "type": "integer",
    "minimum": 1,
    "maximum": 100000,
    "default": 1
  }
}
```

```json
{
  "name": "pageSize",
  "in": "query",
  "schema": {
    "type": "integer",
    "minimum": 1,
    "maximum": 100,
    "default": 25
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Observations Treasury persistées et qualifiées.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/PaymentTreasuryCorrectionPageResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Erreur fixe d’autorité, de données historiques ou de requête.",
  "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"
            }
          },
          "details": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "code": {
                "type": "string"
              },
              "location": {
                "type": "string",
                "enum": [
                  "body",
                  "query",
                  "path"
                ]
              }
            }
          },
          "param": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Erreur fixe d’autorité, de données historiques ou de requête.",
  "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"
            }
          },
          "details": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "code": {
                "type": "string"
              },
              "location": {
                "type": "string",
                "enum": [
                  "body",
                  "query",
                  "path"
                ]
              }
            }
          },
          "param": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Erreur fixe d’autorité, de données historiques ou de requête.",
  "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"
            }
          },
          "details": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "code": {
                "type": "string"
              },
              "location": {
                "type": "string",
                "enum": [
                  "body",
                  "query",
                  "path"
                ]
              }
            }
          },
          "param": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Erreur fixe d’autorité, de données historiques ou de requête.",
  "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"
            }
          },
          "details": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "code": {
                "type": "string"
              },
              "location": {
                "type": "string",
                "enum": [
                  "body",
                  "query",
                  "path"
                ]
              }
            }
          },
          "param": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Erreur fixe d’autorité, de données historiques ou de requête.",
  "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"
            }
          },
          "details": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "code": {
                "type": "string"
              },
              "location": {
                "type": "string",
                "enum": [
                  "body",
                  "query",
                  "path"
                ]
              }
            }
          },
          "param": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "Erreur fixe d’autorité, de données historiques ou de requête.",
  "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"
            }
          },
          "details": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "code": {
                "type": "string"
              },
              "location": {
                "type": "string",
                "enum": [
                  "body",
                  "query",
                  "path"
                ]
              }
            }
          },
          "param": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

### OpenAPI

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

## GET /paiements/{id}/treasury/payouts

Lire les relations de versement vérifiées et le rapprochement bancaire enregistré

`get_payment_treasury_payouts`

Requiert paiements:read ET payment_treasury:read explicitement attribué, sur la clé authentifiée et sa version persistée actuelle. Cette clé exacte doit conserver createdBy vers un véritable accès ADMIN actuel, activé, non expiré et de la même organisation, ayant accès à toutes les associations du compte marchand. Aucun administrateur synthétique. ROOT, clés sans créateur réel, onlyAttr, restrictions de campagne, modes inconnus, références ambiguës, marchands partagés entre organisations et bindings périmés/incohérents sont refusés. Le mode doit être explicitement connu sur le paiement ou son snapshot wallet ; aucun mode historique n’est deviné. Ce sont des observations Stripe Treasury natives persistées, sans lecture prestataire/banque en direct. Aucun SDK, secret, file de synchronisation, mutation financière ni message. Tous les montants sont des entiers signés en unités mineures Stripe, avec devise et exposant explicites (0 ou 2) ; ne jamais supposer des centimes pour toutes les devises, substituer EUR/zéro, mélanger devises de présentation/règlement ou calculer un taux de change non documenté. Une observation manquante ne prouve pas l’absence de fonds, litiges ou versements. COMPLETED seul ne prouve ni capture ni réception bancaire. providerRefreshed et bankVerified restent false. Autorité et références locales sont relues avant restitution. Utilise seulement la version de composition native publiée VERIFIED, liée à l’ascendance actuelle du paiement. net est la contribution de cette transaction, pas le versement entier ni une attribution depuis un solde marchand. Le rôle PAYMENT peut identifier une contribution initiale ; REFUND/DISPUTE/FEES/OTHER ne doit pas être présenté comme son versement initial. Un versement enregistré paid ne confirme pas la banque. bank.state est la comparaison native relue du relevé : CONFIRMED décrit une observation persistée de correspondance, UNMATCHED l’absence de correspondance admise, CONFLICT un désaccord. Ce n’est pas une vérification en direct ; aucune identité bancaire, libellé de relevé, destination ni numéro de compte n’est retourné. Aucune composition inconnue/non publiée/manuelle/legacy n’est inventée depuis l’ancienneté ou les références. Pagination current/pageSize, au plus 1000 relations natives.

### Authentification

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

### Permissions requises

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

### Paramètres

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

```json
{
  "name": "current",
  "in": "query",
  "schema": {
    "type": "integer",
    "minimum": 1,
    "maximum": 100000,
    "default": 1
  }
}
```

```json
{
  "name": "pageSize",
  "in": "query",
  "schema": {
    "type": "integer",
    "minimum": 1,
    "maximum": 100,
    "default": 25
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Observations Treasury persistées et qualifiées.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/PaymentTreasuryPayoutPageResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Erreur fixe d’autorité, de données historiques ou de requête.",
  "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"
            }
          },
          "details": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "code": {
                "type": "string"
              },
              "location": {
                "type": "string",
                "enum": [
                  "body",
                  "query",
                  "path"
                ]
              }
            }
          },
          "param": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Erreur fixe d’autorité, de données historiques ou de requête.",
  "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"
            }
          },
          "details": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "code": {
                "type": "string"
              },
              "location": {
                "type": "string",
                "enum": [
                  "body",
                  "query",
                  "path"
                ]
              }
            }
          },
          "param": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Erreur fixe d’autorité, de données historiques ou de requête.",
  "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"
            }
          },
          "details": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "code": {
                "type": "string"
              },
              "location": {
                "type": "string",
                "enum": [
                  "body",
                  "query",
                  "path"
                ]
              }
            }
          },
          "param": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Erreur fixe d’autorité, de données historiques ou de requête.",
  "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"
            }
          },
          "details": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "code": {
                "type": "string"
              },
              "location": {
                "type": "string",
                "enum": [
                  "body",
                  "query",
                  "path"
                ]
              }
            }
          },
          "param": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Erreur fixe d’autorité, de données historiques ou de requête.",
  "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"
            }
          },
          "details": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "code": {
                "type": "string"
              },
              "location": {
                "type": "string",
                "enum": [
                  "body",
                  "query",
                  "path"
                ]
              }
            }
          },
          "param": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "Erreur fixe d’autorité, de données historiques ou de requête.",
  "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"
            }
          },
          "details": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "code": {
                "type": "string"
              },
              "location": {
                "type": "string",
                "enum": [
                  "body",
                  "query",
                  "path"
                ]
              }
            }
          },
          "param": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

### OpenAPI

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

## POST /paiements/{id}/allocations/preview

Prévisualiser un changement de payeur et de répartition sur des promesses

`preview_payment_allocations`

Requiert paiements:read ET promesses:read ET contacts:read. Lecture pure d’un paiement GENERAL ponctuel COMPLETED globalement unique, avec montant mineur positif, association, devise minuscule et contact existant connus. Refuse une clé limitée aux campagnes, un paiement d’abonnement, remboursement, cible legacy ou historique ambigu. dettes est la liste complète de remplacement, au plus 50 promesses uniques, chaque montant en unités majeures ; [] détache tout. contactId facultatif change seulement le rattachement CRM ; ne réécrit ni identité/facturation, ni documents, ni receiptPolicySnapshot. Les promesses sélectionnées appartiennent au contact obtenu et à la même organisation/association/devise. Le calcul natif des promesses détermine restes et couverture par abonnement ; devises inconnues, prorata historique sans carte figée par paiement, références en double et plus de 10000 lignes pertinentes sont refusés, jamais remplacés par zéro/EUR. Les montants, soldes et parts fiscales de réponse sont des entiers en unités mineures ; dettes[].montant reste en majeures. expectedRevision lie le paiement, l’historique pertinent, les promesses, l’émetteur et la liste/contact proposés exacts. C’est un instantané optimiste, pas une réservation. fiscal.recordedAmount préserve l’autorité fiscale historique ; expectedForNewAllocation décrit seulement la politique de la réaffectation comptable proposée. exception=true exige un acquittement explicite à l’application et ne réécrit jamais les documents fiscaux. Aucun CRM, cache, prestataire, reçu, débit ni message.

### Authentification

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

### Permissions requises

```json
{
  "accepted": "paiements:read",
  "additional": [
    "promesses: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": {
          "dettes": {
            "type": "array",
            "maxItems": 50,
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string",
                  "format": "uuid"
                },
                "montant": {
                  "type": "number",
                  "description": "Unités majeures positives, exactement deux décimales ; les montants de réponse sont des entiers en unités mineures.",
                  "minimum": 0,
                  "exclusiveMinimum": true
                }
              },
              "required": [
                "id",
                "montant"
              ],
              "additionalProperties": false
            }
          },
          "contactId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "pattern": "^\\S(?:.*\\S)?$",
            "description": "Contact existant exact facultatif. Son absence conserve le rattachement au payeur. Toutes les promesses sélectionnées doivent appartenir au contact obtenu. L’identité de facturation et les documents émis ne sont jamais réécrits."
          }
        },
        "required": [
          "dettes"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Aperçu comptable ou résultat de commande qualifié.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/PaymentAllocationPreviewResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Code fixe de refus ou d’incertitude.",
  "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"
            }
          },
          "details": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "code": {
                "type": "string"
              },
              "location": {
                "type": "string",
                "enum": [
                  "body",
                  "query",
                  "path"
                ]
              }
            }
          },
          "param": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Code fixe de refus ou d’incertitude.",
  "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"
            }
          },
          "details": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "code": {
                "type": "string"
              },
              "location": {
                "type": "string",
                "enum": [
                  "body",
                  "query",
                  "path"
                ]
              }
            }
          },
          "param": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Code fixe de refus ou d’incertitude.",
  "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"
            }
          },
          "details": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "code": {
                "type": "string"
              },
              "location": {
                "type": "string",
                "enum": [
                  "body",
                  "query",
                  "path"
                ]
              }
            }
          },
          "param": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Code fixe de refus ou d’incertitude.",
  "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"
            }
          },
          "details": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "code": {
                "type": "string"
              },
              "location": {
                "type": "string",
                "enum": [
                  "body",
                  "query",
                  "path"
                ]
              }
            }
          },
          "param": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Code fixe de refus ou d’incertitude.",
  "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"
            }
          },
          "details": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "code": {
                "type": "string"
              },
              "location": {
                "type": "string",
                "enum": [
                  "body",
                  "query",
                  "path"
                ]
              }
            }
          },
          "param": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "Code fixe de refus ou d’incertitude.",
  "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"
            }
          },
          "details": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "code": {
                "type": "string"
              },
              "location": {
                "type": "string",
                "enum": [
                  "body",
                  "query",
                  "path"
                ]
              }
            }
          },
          "param": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

### OpenAPI

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

## POST /paiements/{id}/allocations/apply

Appliquer une affectation comptable revue avec une clé de commande stable

`apply_payment_allocations`

Requiert paiements:write ET payment_allocations:write explicitement attribué ET promesses:write ET contacts:write. Appeler d’abord preview_payment_allocations avec la liste dettes/contactId complète souhaitée, puis fournir exactement cette liste/contact, son expectedRevision, un UUID d’idempotence stable et confirmFiscalException explicite. [] détache tout ; ce n’est ni une omission ni une absence de changement. Aucun acquittement fiscal automatique : obtenir la décision de l’opérateur si fiscal.exception est true. Revérifie organisation, contact, devise, soldes natifs et instantané complet sous verrous externes persistants paiement/promesses avant mise à jour conditionnelle. Ces verrous sérialisent seulement ces commandes externes d’affectation ; les éditeurs internes et callbacks de paiement ne les respectent pas. Un historique observé modifié est refusé ; aucune garantie transactionnelle globale ni bancaire. Écrit dettes et pledgeAllocations en mineures, conserve les instantanés fiscaux/facturation et références documentaires, trace l’acteur API et les états natifs de résolution déclaration/suggestion, puis rafraîchit les caches et marque le contact modifié. Aucun débit, annulation prestataire, émission documentaire, email ni création implicite de contact. Les avertissements signalent le suivi non financier cache/tag sans annuler l’écriture comptable acquittée. Le journal atomique principal/organisation/UUID précède les effets. Même clé/corps lit le résultat sans réappliquer. PENDING/UNCERTAIN ou perte d’acquittement d’écriture ne permet jamais autre clé, import ou rejeu automatique ; les verrous d’une mutation incertaine n’expirent pas. SUCCEEDED/ACCOUNTING_UPDATED confirme seulement l’écriture comptable conditionnelle, pas une vérification bancaire ni une correction documentaire. Un changement de contact vérifie aussi la garde externe des mutations sur les UUID exacts admis des ancien/nouveau contacts pour REFERENCE et LIFECYCLE, et uniquement le nouveau contact pour TAGS. Le contrôle suit la relecture du reçu et précède le CAS comptable. CONTACT_MUTATION_BLOCKED (409) ou CONTACT_MUTATION_FENCE_UNAVAILABLE (503) avant le CAS refuse la nouvelle écriture. Un aperçu, une relecture de reçu ou une répartition sans changement de contact n’invente aucun effet CRM. Si une garde conflictuelle apparaît seulement après un CAS comptable acquitté, le marquage est évité avec CONTACT_TAG_PENDING ; le résultat comptable connu est conservé. Aucun réessai automatique de marquage ni paiement de remplacement n’est permis.

### Authentification

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

### Permissions requises

```json
{
  "accepted": "paiements:write",
  "additional": [
    "payment_allocations:write",
    "promesses:write",
    "contacts:write"
  ]
}
```

### 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": {
        "$ref": "#/components/schemas/UnisoftRequest_882f91996439f2ac9d1f"
      }
    }
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Aperçu comptable ou résultat de commande qualifié.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/PaymentAllocationCommandResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Code fixe de refus ou d’incertitude.",
  "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"
            }
          },
          "details": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "code": {
                "type": "string"
              },
              "location": {
                "type": "string",
                "enum": [
                  "body",
                  "query",
                  "path"
                ]
              }
            }
          },
          "param": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Code fixe de refus ou d’incertitude.",
  "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"
            }
          },
          "details": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "code": {
                "type": "string"
              },
              "location": {
                "type": "string",
                "enum": [
                  "body",
                  "query",
                  "path"
                ]
              }
            }
          },
          "param": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Code fixe de refus ou d’incertitude.",
  "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"
            }
          },
          "details": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "code": {
                "type": "string"
              },
              "location": {
                "type": "string",
                "enum": [
                  "body",
                  "query",
                  "path"
                ]
              }
            }
          },
          "param": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Code fixe de refus ou d’incertitude.",
  "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"
            }
          },
          "details": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "code": {
                "type": "string"
              },
              "location": {
                "type": "string",
                "enum": [
                  "body",
                  "query",
                  "path"
                ]
              }
            }
          },
          "param": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Code fixe de refus ou d’incertitude.",
  "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"
            }
          },
          "details": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "code": {
                "type": "string"
              },
              "location": {
                "type": "string",
                "enum": [
                  "body",
                  "query",
                  "path"
                ]
              }
            }
          },
          "param": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "Code fixe de refus ou d’incertitude.",
  "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"
            }
          },
          "details": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "code": {
                "type": "string"
              },
              "location": {
                "type": "string",
                "enum": [
                  "body",
                  "query",
                  "path"
                ]
              }
            }
          },
          "param": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Code fixe de refus ou d’incertitude.",
  "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"
            }
          },
          "details": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "code": {
                "type": "string"
              },
              "location": {
                "type": "string",
                "enum": [
                  "body",
                  "query",
                  "path"
                ]
              }
            }
          },
          "param": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

### OpenAPI

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

## GET /paiements/allocation-requests/{requestId}

Lire le résultat d’une commande d’affectation comptable

`get_payment_allocation_request`

Requiert paiements:write ET payment_allocations:write ET promesses:write ET contacts:write. Lecture pure du journal de la même organisation et du même principal API avec l’UUID d’idempotence initial. Aucune mutation paiement, CRM, cache, reçu ou prestataire. PENDING/UNCERTAIN peut contenir des effets validés et des verrous conservés ; ne jamais rejouer automatiquement ni remplacer la clé. SUCCEEDED/ACCOUNTING_UPDATED décrit seulement la comptabilité. receiptSnapshotChanged et bankVerified restent false. Aucune identité historique brute, jeton prestataire ni exception n’est retourné.

### Authentification

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

### Permissions requises

```json
{
  "accepted": "paiements:write",
  "additional": [
    "payment_allocations:write",
    "promesses:write",
    "contacts:write"
  ]
}
```

### Paramètres

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

### Réponses

#### HTTP 200

```json
{
  "description": "Aperçu comptable ou résultat de commande qualifié.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/PaymentAllocationCommandResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Code fixe de refus ou d’incertitude.",
  "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"
            }
          },
          "details": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "code": {
                "type": "string"
              },
              "location": {
                "type": "string",
                "enum": [
                  "body",
                  "query",
                  "path"
                ]
              }
            }
          },
          "param": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Code fixe de refus ou d’incertitude.",
  "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"
            }
          },
          "details": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "code": {
                "type": "string"
              },
              "location": {
                "type": "string",
                "enum": [
                  "body",
                  "query",
                  "path"
                ]
              }
            }
          },
          "param": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Code fixe de refus ou d’incertitude.",
  "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"
            }
          },
          "details": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "code": {
                "type": "string"
              },
              "location": {
                "type": "string",
                "enum": [
                  "body",
                  "query",
                  "path"
                ]
              }
            }
          },
          "param": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Code fixe de refus ou d’incertitude.",
  "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"
            }
          },
          "details": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "code": {
                "type": "string"
              },
              "location": {
                "type": "string",
                "enum": [
                  "body",
                  "query",
                  "path"
                ]
              }
            }
          },
          "param": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Code fixe de refus ou d’incertitude.",
  "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"
            }
          },
          "details": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "code": {
                "type": "string"
              },
              "location": {
                "type": "string",
                "enum": [
                  "body",
                  "query",
                  "path"
                ]
              }
            }
          },
          "param": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "Code fixe de refus ou d’incertitude.",
  "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"
            }
          },
          "details": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "code": {
                "type": "string"
              },
              "location": {
                "type": "string",
                "enum": [
                  "body",
                  "query",
                  "path"
                ]
              }
            }
          },
          "param": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

### OpenAPI

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

## POST /paiements/manual

Enregistrer des fonds constatés comme paiement manuel

`record_manual_payment`

Requiert paiements:write ET payment_manual:write explicitement attribué ET contacts:write. Enregistre la déclaration d’un opérateur ayant constaté des fonds ; ce n’est ni un lien de paiement ni un import historique. Fournir confirmation FUNDS_OBSERVED, montant en unités majeures, date réelle explicite, contactId existant, assoc/devise juridique, method, identité et facturation complètes, cerfa et dontSendReceipt. Le paiement manuel natif devient COMPLETED, non importé et finalized ; cela ne prouve pas le règlement bancaire. Le marquage et la synchronisation CRM natifs s’exécutent et peuvent compléter l’identité ou la facturation vide du contact. Les propriétaires asynchrones habituels peuvent générer des documents fiscaux/ordinaires et envoyer un email quand dontSendReceipt=false ; SUCCEEDED ne prouve ni émission ni livraison. Le contact existant doit être unique et appartenir à cette organisation ; aucun rapprochement ni création implicite. Adresse/code postal/ville/pays de facturation et identité personnelle ou société sélectionnée sont obligatoires. Aucune éligibilité fiscale n’est inventée. GENERAL exige l’absence de typeId ; CAISSE/CAMPAGNE exigent une cible exacte connue dont l’association/devise correspond. Une clé limitée aux campagnes peut seulement enregistrer les collectes autorisées. La campagne utilise son verrou de stock natif avec productAction NONE explicite : aucun produit, stock ni acompte de commande n’est vendu. FORM, DETTE, récurrence, legacy SERVICE et répartitions de promesses ne sont pas admis ici ; ils exigent leurs propriétaires financiers/de validation dédiés. Les méthodes décrivent seulement les instruments constatés : CB ne débite pas de carte et PRELEVEMENT ne crée pas de mandat. Un journal atomique organisation/principal API/UUID est réservé avant effets ; la même clé ne réexécute jamais le CRM ni l’insertion. Réutiliser le même corps/la même clé pour lire le résultat après perte de réponse. PENDING et UNCERTAIN peuvent contenir des effets et ne permettent jamais de réessai automatique, une autre clé ou un autre import. Lire le journal et résoudre explicitement l’incertitude. Aucune identité ni autorisation administrateur interne n’est fabriquée. Les effets CRM exigent l’UUID exact du contact admis. Après contrôle d’un éventuel rejeu de reçu, la garde externe des mutations de contact est vérifiée avant les propriétaires CRM natifs pour les effets CORE, COORDINATES, TAGS et LIFECYCLE. Une commande CRM conflictuelle conservée refuse une nouvelle saisie avec CONTACT_MUTATION_BLOCKED (409) ; une garde impossible à prouver renvoie CONTACT_MUTATION_FENCE_UNAVAILABLE (503). Aucun nouveau paiement ni rédacteur de contact n’est lancé après ces refus préalables. La relecture du reçu reste sans effet. Une garde apparaissant après un effet natif partiel laisse la commande UNCERTAIN et n’autorise jamais une nouvelle clé. C’est une admission passive, pas une transaction avec les rédacteurs internes.

### Authentification

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

### Permissions requises

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

### Corps de la requête

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

### Réponses

#### HTTP 200

```json
{
  "description": "Journal qualifié de commande de saisie manuelle.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/PaymentManualResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Erreur fixe d’admission ou de commande ; aucune exception prestataire brute.",
  "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"
            }
          },
          "details": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "code": {
                "type": "string"
              },
              "location": {
                "type": "string",
                "enum": [
                  "body",
                  "query",
                  "path"
                ]
              }
            }
          },
          "param": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Erreur fixe d’admission ou de commande ; aucune exception prestataire brute.",
  "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"
            }
          },
          "details": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "code": {
                "type": "string"
              },
              "location": {
                "type": "string",
                "enum": [
                  "body",
                  "query",
                  "path"
                ]
              }
            }
          },
          "param": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Erreur fixe d’admission ou de commande ; aucune exception prestataire brute.",
  "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"
            }
          },
          "details": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "code": {
                "type": "string"
              },
              "location": {
                "type": "string",
                "enum": [
                  "body",
                  "query",
                  "path"
                ]
              }
            }
          },
          "param": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Erreur fixe d’admission ou de commande ; aucune exception prestataire brute.",
  "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"
            }
          },
          "details": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "code": {
                "type": "string"
              },
              "location": {
                "type": "string",
                "enum": [
                  "body",
                  "query",
                  "path"
                ]
              }
            }
          },
          "param": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Erreur fixe d’admission ou de commande ; aucune exception prestataire brute.",
  "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"
            }
          },
          "details": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "code": {
                "type": "string"
              },
              "location": {
                "type": "string",
                "enum": [
                  "body",
                  "query",
                  "path"
                ]
              }
            }
          },
          "param": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "Erreur fixe d’admission ou de commande ; aucune exception prestataire brute.",
  "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"
            }
          },
          "details": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "code": {
                "type": "string"
              },
              "location": {
                "type": "string",
                "enum": [
                  "body",
                  "query",
                  "path"
                ]
              }
            }
          },
          "param": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Erreur fixe d’admission ou de commande ; aucune exception prestataire brute.",
  "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"
            }
          },
          "details": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "code": {
                "type": "string"
              },
              "location": {
                "type": "string",
                "enum": [
                  "body",
                  "query",
                  "path"
                ]
              }
            }
          },
          "param": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

### OpenAPI

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

## GET /paiements/manual/requests/{requestId}

Lire le résultat d’une saisie manuelle de paiement

`get_manual_payment_request`

Requiert paiements:write ET payment_manual:write ET contacts:write. Lecture seule avec l’UUID d’idempotence initial, dans la même organisation et avec le même principal API. Revérifie les droits de collecte. Aucune action CRM, documentaire, bancaire ou prestataire. SUCCEEDED/MANUALLY_RECORDED acquitte seulement la saisie manuelle ; bankVerified reste false. PENDING peut indiquer une exécution en cours ou interrompue ; UNCERTAIN signifie que des effets ne peuvent pas être exclus sûrement. Aucun des deux ne permet une autre saisie financière. Ne jamais remplacer la clé pour contourner l’incertitude. Un historique privé inconnu est refusé au lieu d’être interprété comme un succès.

### Authentification

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

### Permissions requises

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

### Paramètres

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

### Réponses

#### HTTP 200

```json
{
  "description": "Journal qualifié de commande de saisie manuelle.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/PaymentManualResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Erreur fixe d’admission ou de commande ; aucune exception prestataire brute.",
  "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"
            }
          },
          "details": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "code": {
                "type": "string"
              },
              "location": {
                "type": "string",
                "enum": [
                  "body",
                  "query",
                  "path"
                ]
              }
            }
          },
          "param": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Erreur fixe d’admission ou de commande ; aucune exception prestataire brute.",
  "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"
            }
          },
          "details": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "code": {
                "type": "string"
              },
              "location": {
                "type": "string",
                "enum": [
                  "body",
                  "query",
                  "path"
                ]
              }
            }
          },
          "param": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Erreur fixe d’admission ou de commande ; aucune exception prestataire brute.",
  "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"
            }
          },
          "details": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "code": {
                "type": "string"
              },
              "location": {
                "type": "string",
                "enum": [
                  "body",
                  "query",
                  "path"
                ]
              }
            }
          },
          "param": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Erreur fixe d’admission ou de commande ; aucune exception prestataire brute.",
  "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"
            }
          },
          "details": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "code": {
                "type": "string"
              },
              "location": {
                "type": "string",
                "enum": [
                  "body",
                  "query",
                  "path"
                ]
              }
            }
          },
          "param": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Erreur fixe d’admission ou de commande ; aucune exception prestataire brute.",
  "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"
            }
          },
          "details": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "code": {
                "type": "string"
              },
              "location": {
                "type": "string",
                "enum": [
                  "body",
                  "query",
                  "path"
                ]
              }
            }
          },
          "param": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "Erreur fixe d’admission ou de commande ; aucune exception prestataire brute.",
  "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"
            }
          },
          "details": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "code": {
                "type": "string"
              },
              "location": {
                "type": "string",
                "enum": [
                  "body",
                  "query",
                  "path"
                ]
              }
            }
          },
          "param": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

### OpenAPI

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

## POST /payment-links

Créer une demande de paiement ponctuelle avec une clé de réessai stable

`create_idempotent_payment_link`

Requiert paiements:write. Crée une nouvelle demande ponctuelle via la façade POST /paiements existante, avec tous ses contrôles d’organisation, cible, association, devise et identité. Fournir config.montant en unités majeures (125.5 signifie EUR 125.50 pour eur), pas en centimes. idempotencyKey est obligatoire : une réservation atomique de journal par organisation, principal API, action et UUID ; une entrée modifiée crée un conflit. La même clé n’appelle jamais deux fois le propriétaire, même après expiration de l’attente ou perte de l’écriture du journal. Lire le journal après une incertitude ; ne jamais inventer un nouvel UUID pour forcer une tentative. Le succès HTTP indique que la commande a été traitée : lire data.status et outcome. REQUEST_CREATED acquitte la réponse du propriétaire, pas un encaissement, une capture, un règlement bancaire, un reçu ou une livraison d’email. L’URL enregistrée par une commande n’est pas une vérification actuelle de disponibilité ; lire get_payment_link avant de réutiliser une ancienne URL. L’URL peut être null pour les parcours embarqués ou prestataires ; aucun clientSecret, moyen réutilisable ni réponse prestataire privée n’est exposé. Une URL vide ne permet pas de recréer la demande. Aucune relance n’est envoyée. Les intentions récurrentes, legacy SERVICE et de complétion d’identité sont exclues.

### Authentification

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

### Permissions requises

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

### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "idempotencyKey": {
            "type": "string",
            "format": "uuid",
            "description": "UUID stable de cette intention métier. Le réutiliser avec exactement la même config après une réponse perdue ; une autre charge utile crée un conflit. Un autre UUID peut créer un autre paiement."
          },
          "config": {
            "$ref": "#/components/schemas/UnisoftRequest_c6721c5be3f91d5f9f68"
          }
        },
        "required": [
          "idempotencyKey",
          "config"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Commande qualifiée ou observation du lien enregistré.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/PaymentCommandResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Code d’erreur externe fixe ; aucune exception prestataire ni valeur soumise.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "required": [
          "success",
          "error"
        ],
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "details": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "code": {
                "type": "string"
              },
              "location": {
                "type": "string",
                "enum": [
                  "body",
                  "query",
                  "path"
                ]
              }
            }
          },
          "param": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Code d’erreur externe fixe ; aucune exception prestataire ni valeur soumise.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "required": [
          "success",
          "error"
        ],
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "details": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "code": {
                "type": "string"
              },
              "location": {
                "type": "string",
                "enum": [
                  "body",
                  "query",
                  "path"
                ]
              }
            }
          },
          "param": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Code d’erreur externe fixe ; aucune exception prestataire ni valeur soumise.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "required": [
          "success",
          "error"
        ],
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "details": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "code": {
                "type": "string"
              },
              "location": {
                "type": "string",
                "enum": [
                  "body",
                  "query",
                  "path"
                ]
              }
            }
          },
          "param": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Code d’erreur externe fixe ; aucune exception prestataire ni valeur soumise.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "required": [
          "success",
          "error"
        ],
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "details": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "code": {
                "type": "string"
              },
              "location": {
                "type": "string",
                "enum": [
                  "body",
                  "query",
                  "path"
                ]
              }
            }
          },
          "param": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Code d’erreur externe fixe ; aucune exception prestataire ni valeur soumise.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "required": [
          "success",
          "error"
        ],
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "details": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "code": {
                "type": "string"
              },
              "location": {
                "type": "string",
                "enum": [
                  "body",
                  "query",
                  "path"
                ]
              }
            }
          },
          "param": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "Code d’erreur externe fixe ; aucune exception prestataire ni valeur soumise.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "required": [
          "success",
          "error"
        ],
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "details": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "code": {
                "type": "string"
              },
              "location": {
                "type": "string",
                "enum": [
                  "body",
                  "query",
                  "path"
                ]
              }
            }
          },
          "param": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

### OpenAPI

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

## GET /payment-links/requests/{requestId}

Lire le résultat d’une demande idempotente de lien de paiement

`get_payment_link_request`

Requiert paiements:write. Lecture seule, dans l’organisation et avec le principal API ayant créé cette requête. requestId est l’UUID d’idempotence d’origine. PENDING peut représenter un appel en cours ou un processus perdu après un effet ; UNCERTAIN indique que le résultat propriétaire ne peut pas être récupéré sûrement. Aucun des deux ne permet une autre création automatique. Aucune expiration de lease ne réexécute le propriétaire financier. SUCCEEDED/REQUEST_CREATED ne prouve pas un encaissement. L’accès au paiement ou à la collecte est revérifié avant de restituer une capacité de paiement enregistrée. Aucun appel prestataire ni message.

### Authentification

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

### Permissions requises

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

### Paramètres

```json
{
  "name": "requestId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid"
  },
  "description": "UUID d’idempotence créé par l’appelant pour cette requête, dans la même organisation et avec le même principal API."
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Commande qualifiée ou observation du lien enregistré.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/PaymentCommandResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Code d’erreur externe fixe ; aucune exception prestataire ni valeur soumise.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "required": [
          "success",
          "error"
        ],
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "details": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "code": {
                "type": "string"
              },
              "location": {
                "type": "string",
                "enum": [
                  "body",
                  "query",
                  "path"
                ]
              }
            }
          },
          "param": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Code d’erreur externe fixe ; aucune exception prestataire ni valeur soumise.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "required": [
          "success",
          "error"
        ],
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "details": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "code": {
                "type": "string"
              },
              "location": {
                "type": "string",
                "enum": [
                  "body",
                  "query",
                  "path"
                ]
              }
            }
          },
          "param": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Code d’erreur externe fixe ; aucune exception prestataire ni valeur soumise.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "required": [
          "success",
          "error"
        ],
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "details": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "code": {
                "type": "string"
              },
              "location": {
                "type": "string",
                "enum": [
                  "body",
                  "query",
                  "path"
                ]
              }
            }
          },
          "param": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Code d’erreur externe fixe ; aucune exception prestataire ni valeur soumise.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "required": [
          "success",
          "error"
        ],
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "details": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "code": {
                "type": "string"
              },
              "location": {
                "type": "string",
                "enum": [
                  "body",
                  "query",
                  "path"
                ]
              }
            }
          },
          "param": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Code d’erreur externe fixe ; aucune exception prestataire ni valeur soumise.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "required": [
          "success",
          "error"
        ],
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "details": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "code": {
                "type": "string"
              },
              "location": {
                "type": "string",
                "enum": [
                  "body",
                  "query",
                  "path"
                ]
              }
            }
          },
          "param": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "Code d’erreur externe fixe ; aucune exception prestataire ni valeur soumise.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "required": [
          "success",
          "error"
        ],
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "details": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "code": {
                "type": "string"
              },
              "location": {
                "type": "string",
                "enum": [
                  "body",
                  "query",
                  "path"
                ]
              }
            }
          },
          "param": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

### OpenAPI

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

## GET /paiements/{id}/link

Lire un lien de paiement autorisé existant et sa disponibilité enregistrée

`get_payment_link`

Requiert paiements:read ET l’attribution explicite payment_links:read. Retourne une URL de checkout stockée par le journal de commande externe, ou l’URL exacte de la passerelle Paygreen native, uniquement pour un paiement INIT autorisé sans ambiguïté. Une URL manquante reste null/NOT_RECORDED ; aucune session Stripe ni URL prestataire absente n’est régénérée. Une expiration connue, une échéance mal formée ou un état différent d’INIT ne retourne aucune URL. RECORDED_UNEXPIRED est seulement une observation d’expiration locale ; UNKNOWN ne prouve pas qu’un checkout soit payable et providerVerified vaut toujours false. Cette lecture ne crée, n’actualise, ne rejoue, n’annule, ne débite ni ne relance. revocation.supported est une admission optimiste au seul propriétaire natif d’annulation des wallets Stripe, pas une annulation garantie. Réutiliser expectedRevision pour l’action de révocation séparée. Aucune révocation des autres plateformes n’est inventée.

### Authentification

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

### Permissions requises

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

### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid"
  },
  "description": "UUID du paiement existant ; ne jamais générer un identifiant pour cibler un paiement existant."
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Commande qualifiée ou observation du lien enregistré.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/PaymentExistingLinkResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Code d’erreur externe fixe ; aucune exception prestataire ni valeur soumise.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "required": [
          "success",
          "error"
        ],
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "details": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "code": {
                "type": "string"
              },
              "location": {
                "type": "string",
                "enum": [
                  "body",
                  "query",
                  "path"
                ]
              }
            }
          },
          "param": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Code d’erreur externe fixe ; aucune exception prestataire ni valeur soumise.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "required": [
          "success",
          "error"
        ],
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "details": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "code": {
                "type": "string"
              },
              "location": {
                "type": "string",
                "enum": [
                  "body",
                  "query",
                  "path"
                ]
              }
            }
          },
          "param": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Code d’erreur externe fixe ; aucune exception prestataire ni valeur soumise.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "required": [
          "success",
          "error"
        ],
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "details": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "code": {
                "type": "string"
              },
              "location": {
                "type": "string",
                "enum": [
                  "body",
                  "query",
                  "path"
                ]
              }
            }
          },
          "param": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Code d’erreur externe fixe ; aucune exception prestataire ni valeur soumise.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "required": [
          "success",
          "error"
        ],
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "details": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "code": {
                "type": "string"
              },
              "location": {
                "type": "string",
                "enum": [
                  "body",
                  "query",
                  "path"
                ]
              }
            }
          },
          "param": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Code d’erreur externe fixe ; aucune exception prestataire ni valeur soumise.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "required": [
          "success",
          "error"
        ],
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "details": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "code": {
                "type": "string"
              },
              "location": {
                "type": "string",
                "enum": [
                  "body",
                  "query",
                  "path"
                ]
              }
            }
          },
          "param": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "Code d’erreur externe fixe ; aucune exception prestataire ni valeur soumise.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "required": [
          "success",
          "error"
        ],
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "details": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "code": {
                "type": "string"
              },
              "location": {
                "type": "string",
                "enum": [
                  "body",
                  "query",
                  "path"
                ]
              }
            }
          },
          "param": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

### OpenAPI

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

## POST /paiements/{id}/link/revoke

Demander l’annulation native d’un wallet Stripe avec suivi enregistré

`revoke_payment_link`

Requiert paiements:write ET l’attribution explicite payment_links:revoke. Seul un paiement INIT Stripe Apple Pay/Google Pay avec checkout exact unique et références autorisées est admis. Lire d’abord get_payment_link et fournir expectedRevision avec une idempotencyKey stable. L’adaptateur externe vérifie d’abord l’identifiant, le montant, la devise et les métadonnées de paiement de l’Intent via le rattachement marchand natif, puis revérifie la révision courante. Le propriétaire natif d’annulation peut refuser un paiement en cours, annuler un Intent impayé et libérer sa réservation, ou découvrir un Intent déjà réussi et finaliser ce paiement à la place. Lire outcome : CANCELED et RECORDED_COMPLETED sont distincts ; ce n’est jamais un remboursement ni une simple annulation d’état local. Le prestataire peut être appelé et une complétion découverte peut déclencher ses effets habituels. Un résultat levé, inconnu ou perdu devient UNCERTAIN sans nouveau réessai automatique. Lire le journal de révocation ; ne jamais employer une autre clé pour contourner l’incertitude. Aucun renouvellement de checkout/session ni envoi de relance. La révision optimiste n’est pas une transaction verrouillant l’application interne.

### Authentification

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

### Permissions requises

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

### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid"
  },
  "description": "UUID du paiement existant ; ne jamais générer un identifiant pour cibler un paiement existant."
}
```

### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "idempotencyKey": {
            "type": "string",
            "format": "uuid"
          },
          "expectedRevision": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$",
            "description": "Jeton exact d’admission optimiste fourni par la lecture du lien de ce paiement. Un paiement modifié ou un autre checkout est refusé avant délégation."
          }
        },
        "required": [
          "idempotencyKey",
          "expectedRevision"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Commande qualifiée ou observation du lien enregistré.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/PaymentCommandResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Code d’erreur externe fixe ; aucune exception prestataire ni valeur soumise.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "required": [
          "success",
          "error"
        ],
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "details": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "code": {
                "type": "string"
              },
              "location": {
                "type": "string",
                "enum": [
                  "body",
                  "query",
                  "path"
                ]
              }
            }
          },
          "param": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Code d’erreur externe fixe ; aucune exception prestataire ni valeur soumise.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "required": [
          "success",
          "error"
        ],
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "details": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "code": {
                "type": "string"
              },
              "location": {
                "type": "string",
                "enum": [
                  "body",
                  "query",
                  "path"
                ]
              }
            }
          },
          "param": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Code d’erreur externe fixe ; aucune exception prestataire ni valeur soumise.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "required": [
          "success",
          "error"
        ],
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "details": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "code": {
                "type": "string"
              },
              "location": {
                "type": "string",
                "enum": [
                  "body",
                  "query",
                  "path"
                ]
              }
            }
          },
          "param": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Code d’erreur externe fixe ; aucune exception prestataire ni valeur soumise.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "required": [
          "success",
          "error"
        ],
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "details": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "code": {
                "type": "string"
              },
              "location": {
                "type": "string",
                "enum": [
                  "body",
                  "query",
                  "path"
                ]
              }
            }
          },
          "param": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Code d’erreur externe fixe ; aucune exception prestataire ni valeur soumise.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "required": [
          "success",
          "error"
        ],
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "details": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "code": {
                "type": "string"
              },
              "location": {
                "type": "string",
                "enum": [
                  "body",
                  "query",
                  "path"
                ]
              }
            }
          },
          "param": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "Code d’erreur externe fixe ; aucune exception prestataire ni valeur soumise.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "required": [
          "success",
          "error"
        ],
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "details": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "code": {
                "type": "string"
              },
              "location": {
                "type": "string",
                "enum": [
                  "body",
                  "query",
                  "path"
                ]
              }
            }
          },
          "param": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

### OpenAPI

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

## GET /paiements/link-revocations/{requestId}

Lire le résultat enregistré d’une demande de révocation de lien

`get_payment_link_revocation`

Requiert paiements:write ET payment_links:revoke. Lire le journal du même principal API et de la même organisation avec l’UUID d’idempotence d’origine. Aucun rafraîchissement prestataire, annulation ou effet de complétion. PENDING/UNCERTAIN ne permet pas un réessai ; CANCELED acquitte le résultat propriétaire natif et RECORDED_COMPLETED indique qu’il a découvert un Intent réussi à la place. Le journal de requête n’est ni une chronologie prestataire complète, ni un rapport de capture, ni une preuve de règlement bancaire.

### Authentification

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

### Permissions requises

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

### Paramètres

```json
{
  "name": "requestId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid"
  },
  "description": "UUID d’idempotence créé par l’appelant pour cette requête, dans la même organisation et avec le même principal API."
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Commande qualifiée ou observation du lien enregistré.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/PaymentCommandResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Code d’erreur externe fixe ; aucune exception prestataire ni valeur soumise.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "required": [
          "success",
          "error"
        ],
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "details": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "code": {
                "type": "string"
              },
              "location": {
                "type": "string",
                "enum": [
                  "body",
                  "query",
                  "path"
                ]
              }
            }
          },
          "param": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Code d’erreur externe fixe ; aucune exception prestataire ni valeur soumise.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "required": [
          "success",
          "error"
        ],
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "details": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "code": {
                "type": "string"
              },
              "location": {
                "type": "string",
                "enum": [
                  "body",
                  "query",
                  "path"
                ]
              }
            }
          },
          "param": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Code d’erreur externe fixe ; aucune exception prestataire ni valeur soumise.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "required": [
          "success",
          "error"
        ],
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "details": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "code": {
                "type": "string"
              },
              "location": {
                "type": "string",
                "enum": [
                  "body",
                  "query",
                  "path"
                ]
              }
            }
          },
          "param": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Code d’erreur externe fixe ; aucune exception prestataire ni valeur soumise.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "required": [
          "success",
          "error"
        ],
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "details": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "code": {
                "type": "string"
              },
              "location": {
                "type": "string",
                "enum": [
                  "body",
                  "query",
                  "path"
                ]
              }
            }
          },
          "param": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Code d’erreur externe fixe ; aucune exception prestataire ni valeur soumise.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "required": [
          "success",
          "error"
        ],
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "details": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "code": {
                "type": "string"
              },
              "location": {
                "type": "string",
                "enum": [
                  "body",
                  "query",
                  "path"
                ]
              }
            }
          },
          "param": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "Code d’erreur externe fixe ; aucune exception prestataire ni valeur soumise.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "required": [
          "success",
          "error"
        ],
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "details": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "code": {
                "type": "string"
              },
              "location": {
                "type": "string",
                "enum": [
                  "body",
                  "query",
                  "path"
                ]
              }
            }
          },
          "param": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

### OpenAPI

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

## Schémas

```json
{
  "components": {
    "schemas": {
      "Paiement": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "id",
          "organisation",
          "name",
          "type",
          "typeId",
          "parentTypeId",
          "method",
          "platform",
          "source",
          "contact",
          "abo",
          "assoc",
          "externalId",
          "cerfaId",
          "recuId",
          "imported",
          "finalized",
          "cerfa",
          "cerfaYear",
          "amount",
          "devise",
          "state",
          "datetime",
          "info",
          "facturation",
          "refund"
        ],
        "properties": {
          "id": {
            "type": "string",
            "nullable": true
          },
          "organisation": {
            "type": "string",
            "nullable": true
          },
          "name": {
            "type": "string",
            "nullable": true
          },
          "type": {
            "type": "string",
            "nullable": true
          },
          "typeId": {
            "type": "string",
            "nullable": true
          },
          "parentTypeId": {
            "type": "string",
            "nullable": true
          },
          "method": {
            "type": "string",
            "nullable": true
          },
          "platform": {
            "type": "string",
            "nullable": true
          },
          "source": {
            "type": "string",
            "nullable": true
          },
          "contact": {
            "type": "string",
            "nullable": true
          },
          "abo": {
            "type": "string",
            "nullable": true
          },
          "assoc": {
            "type": "string",
            "nullable": true
          },
          "externalId": {
            "type": "string",
            "nullable": true
          },
          "cerfaId": {
            "type": "string",
            "nullable": true
          },
          "recuId": {
            "type": "string",
            "nullable": true
          },
          "imported": {
            "type": "boolean",
            "nullable": true
          },
          "finalized": {
            "type": "boolean",
            "nullable": true
          },
          "cerfa": {
            "type": "boolean",
            "nullable": true
          },
          "cerfaYear": {
            "type": "boolean",
            "nullable": true
          },
          "amount": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991,
            "nullable": true,
            "description": "Montant enregistré en unités mineures ; null s’il est absent ou invalide. 5000 = EUR 50. Aucune déduction de règlement bancaire."
          },
          "devise": {
            "type": "string",
            "nullable": true,
            "pattern": "^[a-z]{3}$"
          },
          "state": {
            "type": "string",
            "nullable": true,
            "pattern": "^[A-Za-z][A-Za-z0-9_.-]{0,63}$"
          },
          "datetime": {
            "type": "string",
            "nullable": true,
            "format": "date-time"
          },
          "info": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "nom",
              "prenom",
              "email",
              "tel"
            ],
            "properties": {
              "nom": {
                "type": "string",
                "nullable": true
              },
              "prenom": {
                "type": "string",
                "nullable": true
              },
              "email": {
                "type": "string",
                "nullable": true
              },
              "tel": {
                "type": "string",
                "nullable": true
              }
            },
            "nullable": true
          },
          "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
              },
              "prenom": {
                "type": "string",
                "nullable": true
              },
              "raison": {
                "type": "string",
                "nullable": true
              },
              "siren": {
                "type": "string",
                "nullable": true
              },
              "civilite": {
                "type": "string",
                "nullable": true
              },
              "adresse": {
                "type": "string",
                "nullable": true
              },
              "postal": {
                "type": "string",
                "nullable": true
              },
              "ville": {
                "type": "string",
                "nullable": true
              },
              "etat": {
                "type": "string",
                "nullable": true
              },
              "pays": {
                "type": "string",
                "nullable": true
              },
              "social_id": {
                "type": "string",
                "nullable": true
              },
              "perso": {
                "type": "boolean",
                "nullable": true
              },
              "giftAid": {
                "type": "boolean",
                "nullable": true
              }
            },
            "nullable": true
          },
          "refund": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "state",
              "reason",
              "createdAt",
              "updatedAt"
            ],
            "properties": {
              "state": {
                "type": "string",
                "nullable": true,
                "enum": [
                  "PENDING",
                  "SUCCEEDED",
                  "FAILED",
                  "CANCELED",
                  null
                ]
              },
              "reason": {
                "type": "string",
                "nullable": true,
                "enum": [
                  "requested_by_customer",
                  "duplicate",
                  "fraudulent",
                  null
                ]
              },
              "createdAt": {
                "type": "string",
                "nullable": true,
                "format": "date-time"
              },
              "updatedAt": {
                "type": "string",
                "nullable": true,
                "format": "date-time"
              }
            },
            "nullable": true
          },
          "externalRef": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255
          },
          "externalMetadata": {
            "type": "object",
            "maxProperties": 50,
            "additionalProperties": {
              "type": "string",
              "maxLength": 500
            }
          }
        },
        "description": "Projection métier des données de paiement enregistrées, limitée à une liste blanche et partagée par la liste, le détail et l’import. Les instantanés d’identité et de facturation restent distincts du CRM. Les montants, devises, dates et indicateurs inconnus restent null. Aucun moyen de paiement réutilisable, référence ou configuration de prestataire, jeton de paiement, erreur brute, instantané privé ni champ futur inconnu n’est renvoyé. Un état COMPLETED enregistré peut correspondre à une autorisation avant capture ou à un import historique ; ni le règlement bancaire ni le crédit d’un remboursement ne sont vérifiés."
      },
      "Pagination": {
        "type": "object",
        "properties": {
          "nextCursor": {
            "type": "string",
            "nullable": true
          },
          "hasMore": {
            "type": "boolean"
          },
          "count": {
            "type": "integer"
          }
        }
      },
      "UnisoftRequest_414e1860ccd141107a40": {
        "type": "object",
        "properties": {
          "externalRef": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "pattern": "\\S",
            "description": "Référence facultative dans votre système. Non vide, enregistrée telle quelle ; correspondance exacte sensible à la casse. Non unique et ne constitue PAS une clé d’idempotence. À distinguer de externalId (dédoublonnage à l’import). Renvoyée lors de la lecture des paiements et dans les webhooks de paiement si elle est fournie. Héritée par les paiements récurrents.",
            "example": "commande-1234"
          },
          "externalMetadata": {
            "type": "object",
            "maxProperties": 50,
            "additionalProperties": {
              "type": "string",
              "maxLength": 500
            },
            "description": "Carte facultative de chaînes clé-valeur gérée par l’appelant. Jusqu’à 50 clés (1–64 caractères chacune), valeurs de 500 caractères maximum. Les clés ne peuvent contenir . ou $, ni le caractère NUL, et ne peuvent être égales à __proto__, prototype ou constructor. Les valeurs null, tableaux, objets imbriqués et valeurs non textuelles sont refusés. Enregistrée telle quelle et renvoyée lors de la lecture des paiements et dans les webhooks ; héritée par les paiements récurrents. Distincte des métadonnées du fournisseur ; évitez d’y placer des secrets. Aucun de ces champs n’est obligatoire pour les paiements historiques.",
            "example": {
              "registrationId": "inscription-567",
              "eventId": "chabbat-890"
            }
          },
          "type": {
            "type": "string",
            "enum": [
              "GENERAL",
              "FORM",
              "DETTE",
              "CAISSE",
              "SERVICE",
              "CAMPAGNE"
            ]
          },
          "typeId": {
            "type": "string",
            "nullable": true,
            "description": "Identifiant de l’entité cible (obligatoire sauf si type=GENERAL)."
          },
          "montant": {
            "type": "number",
            "minimum": 0.01,
            "maximum": 1000000,
            "multipleOf": 0.01,
            "description": "Montant en unités majeures (par ex. euros)."
          },
          "devise": {
            "type": "string",
            "nullable": true
          },
          "name": {
            "type": "string",
            "nullable": true
          },
          "info": {
            "$ref": "#/components/schemas/UnisoftRequest_b6eaf8c17ece06a2ed03"
          },
          "facturation": {
            "$ref": "#/components/schemas/UnisoftRequest_ef522362195300ba7557"
          },
          "returnUrl": {
            "type": "string",
            "nullable": true
          },
          "platform": {
            "type": "string",
            "nullable": true,
            "description": "Forcer une plateforme spécifique (par ex. STRIPE.SEPA, PAYME.IDD, PAYPAL)."
          },
          "abo": {
            "type": "boolean",
            "enum": [
              false
            ],
            "description": "Seule une demande ponctuelle est prise en charge ici. Pour un abonnement pris en charge, utiliser prepare_subscription."
          },
          "nbMonth": {
            "type": "integer",
            "nullable": true
          },
          "maxAmount": {
            "type": "integer",
            "nullable": true
          },
          "assoc": {
            "type": "string",
            "minLength": 1,
            "maxLength": 200,
            "description": "Association bénéficiaire explicite d’un don GENERAL, identifiée avec list_associations. L’omission conserve le choix du service métier, qui peut utiliser defaultAssoc, sans garantie qu’il s’agisse de MAIN. L’association d’un paiement lié à une cible est déterminée par le service métier responsable de cette cible."
          },
          "cerfa": {
            "type": "boolean"
          },
          "update": {
            "type": "boolean",
            "enum": [
              false
            ],
            "description": "La modification de paiements existants, y compris le complément d’identité, est indisponible dans cette opération. Omettre ce champ ou transmettre false."
          },
          "id": {
            "type": "string",
            "minLength": 1,
            "maxLength": 200,
            "description": "Identifiant historique de paiement. Sa présence n’autorise pas la modification d’un paiement existant ; update et le mode UPDATE sont indisponibles."
          },
          "service": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "minLength": 1,
                "maxLength": 200
              }
            },
            "required": [
              "id"
            ],
            "additionalProperties": false,
            "description": "Référence historique de cible SERVICE. Elle n’est pas acceptée pour les autres types de paiement."
          },
          "dettes": {
            "type": "array",
            "maxItems": 200,
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 200
                },
                "montant": {
                  "type": "number",
                  "minimum": 0.01,
                  "maximum": 90071992547409,
                  "multipleOf": 0.01
                }
              },
              "required": [
                "id",
                "montant"
              ],
              "additionalProperties": false
            },
            "description": "Ventilations autorisées sur des promesses, en unités majeures ; pour une demande récurrente, il s’agit de budgets contractuels de ventilation, pas d’une échéance unique."
          }
        },
        "required": [
          "type",
          "montant"
        ],
        "additionalProperties": false,
        "description": "Intention de paiement pour l’organisation authentifiée. Le contexte d’organisation est fourni par le serveur ; config.organisation n’est pas un champ d’entrée admis."
      },
      "UnisoftRequest_b6eaf8c17ece06a2ed03": {
        "type": "object",
        "properties": {
          "nom": {
            "type": "string",
            "description": "Nom de famille."
          },
          "prenom": {
            "type": "string",
            "description": "Prénom."
          },
          "email": {
            "type": "string",
            "description": "Adresse email à laquelle le reçu du paiement est envoyé."
          },
          "tel": {
            "type": "string",
            "description": "Numéro de téléphone (format E.164 recommandé)."
          }
        },
        "additionalProperties": false,
        "nullable": true,
        "description": "Instantané de l’identité du donateur enregistrée sur le paiement (qui a donné). **Entièrement facultatif** — envoyez `null`, `{}` ou omettez-le pour un donateur anonyme/inconnu ; chaque sous-champ est également facultatif.\n\nRègles d’enregistrement : si AU MOINS un champ est renseigné, l’objet est enregistré au complet (les autres champs deviennent des chaînes vides, jamais null) ; si TOUS les champs sont vides, il est enregistré comme `null`, ce qui signifie « aucun contact donateur » et empêche l’envoi du reçu par EMAIL (le document du reçu est tout de même produit). `email` est l’adresse à laquelle le reçu est envoyé — sans elle, le donateur ne reçoit aucun email.\n\nUn seul cas est refusé (400 INVALID_INFO) : l’envoi d’une valeur qui n’est pas un objet, par ex. une chaîne ou un tableau. Cela indique toujours une erreur d’intégration (chaîne JSON non analysée), jamais un véritable donateur."
      },
      "UnisoftRequest_ef522362195300ba7557": {
        "type": "object",
        "properties": {
          "perso": {
            "type": "boolean",
            "description": "true = particulier (nom/prenom), false = entreprise (raison/siren). Valeur par défaut : true.",
            "default": true
          },
          "nom": {
            "type": "string",
            "description": "Nom de famille imprimé sur le reçu (particulier)."
          },
          "prenom": {
            "type": "string",
            "description": "Prénom imprimé sur le reçu (particulier)."
          },
          "civilite": {
            "type": "string",
            "description": "Civilité (M., Mme…) imprimée sur le reçu fiscal."
          },
          "raison": {
            "type": "string",
            "description": "Raison sociale. OBLIGATOIRE si perso est false — c’est le seul nom imprimé sur un reçu d’entreprise."
          },
          "siren": {
            "type": "string",
            "description": "Numéro d’immatriculation de l’entreprise (SIREN), imprimé à côté de sa raison sociale."
          },
          "adresse": {
            "type": "string",
            "description": "Adresse (rue) imprimée sur le reçu et synchronisée avec le contact CRM."
          },
          "postal": {
            "type": "string",
            "description": "Code postal."
          },
          "ville": {
            "type": "string",
            "description": "Ville."
          },
          "etat": {
            "type": "string",
            "description": "État / province. Imprimé sur le format de reçu canadien (CA) et synchronisé avec le CRM."
          },
          "pays": {
            "type": "string",
            "description": "Nom du pays. Utilisé par certains fournisseurs de paiement pour déterminer le code pays ISO."
          },
          "social_id": {
            "type": "string",
            "description": "Identifiant national (par ex. Teoudat Zehout) — utilisé par les plateformes de reçus israéliennes et synchronisé avec le contact CRM."
          },
          "giftAid": {
            "type": "boolean",
            "description": "Royaume-Uni uniquement : le donateur a accepté le Gift Aid. Active l’indicateur Gift Aid sur le contact CRM pour permettre à l’organisme de récupérer l’allègement fiscal. Omettez ce champ pour les dons hors Royaume-Uni."
          }
        },
        "additionalProperties": false,
        "nullable": true,
        "description": "Identité de facturation/fiscale IMPRIMÉE SUR LE REÇU et le reçu fiscal (cerfa). **Entièrement facultative** — envoyez `null`, `{}` ou omettez-la ; chaque champ sera enregistré comme une chaîne vide (jamais null), ce qui permet de générer le reçu, mais celui-ci sera imprimé sans adresse. Chaque sous-champ est également facultatif. Renseignez-la TOUJOURS lorsque le don ouvre droit à un reçu fiscal, sans quoi le document sera vierge et inutilisable par le donateur.\n\n`perso` est le discriminant : `true` (par défaut) = particulier, le reçu est établi au nom de `nom` + `prenom` ; `false` = entreprise, le reçu est établi au nom de `raison` — fournissez TOUJOURS `raison` avec `perso:false`, sinon le reçu de l’entreprise portera un nom vide (accepté, mais inutilisable par le donateur). Lorsque `perso` est true et que `nom`/`prenom` sont omis, ils sont copiés depuis `info` si présents.\n\nDeux cas sont refusés (400 INVALID_FACTURATION) ; ils indiquent toujours une erreur d’intégration, pas un véritable don : envoyer une valeur qui n’est pas un objet (une chaîne ou un tableau au lieu du bloc), ou envoyer une valeur non booléenne pour `perso` (par ex. `1`, `0` ou `\"yes\"` — auparavant ces valeurs étaient interprétées silencieusement comme `true`, émettant un reçu de particulier pour une entreprise). Les champs texte fournis sous forme booléenne sont traités comme vides, de sorte que le mot \"false\" ne peut jamais être imprimé sur un reçu ; les nombres sont acceptés et convertis (`postal: 75001` → `\"75001\"`)."
      },
      "PaymentResponse": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "paiementId": {
            "type": "string",
            "nullable": true
          },
          "url": {
            "type": "string",
            "nullable": true,
            "description": "URL de la page de paiement hébergée."
          },
          "clientSecret": {
            "type": "string",
            "nullable": true,
            "description": "Renvoyé par certains fournisseurs de type Stripe pour une interface intégrée."
          },
          "error": {
            "type": "string",
            "nullable": true
          }
        }
      },
      "UnisoftRequest_810f34219cd254d860a7": {
        "type": "object",
        "properties": {
          "externalRef": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "pattern": "\\S",
            "description": "Référence facultative dans votre système. Non vide, enregistrée telle quelle ; correspondance exacte sensible à la casse. Non unique et ne constitue PAS une clé d’idempotence. À distinguer de externalId (dédoublonnage à l’import). Renvoyée lors de la lecture des paiements et dans les webhooks de paiement si elle est fournie. Héritée par les paiements récurrents.",
            "example": "commande-1234"
          },
          "externalMetadata": {
            "type": "object",
            "maxProperties": 50,
            "additionalProperties": {
              "type": "string",
              "maxLength": 500
            },
            "description": "Carte facultative de chaînes clé-valeur gérée par l’appelant. Jusqu’à 50 clés (1–64 caractères chacune), valeurs de 500 caractères maximum. Les clés ne peuvent contenir . ou $, ni le caractère NUL, et ne peuvent être égales à __proto__, prototype ou constructor. Les valeurs null, tableaux, objets imbriqués et valeurs non textuelles sont refusés. Enregistrée telle quelle et renvoyée lors de la lecture des paiements et dans les webhooks ; héritée par les paiements récurrents. Distincte des métadonnées du fournisseur ; évitez d’y placer des secrets. Aucun de ces champs n’est obligatoire pour les paiements historiques.",
            "example": {
              "registrationId": "inscription-567",
              "eventId": "chabbat-890"
            }
          },
          "amount": {
            "type": "integer",
            "minimum": 1,
            "maximum": 9007199254740991,
            "description": "Montant entier strictement positif dans la plage des entiers sûrs, en unités mineures. Si montant est également fourni, les deux montants doivent correspondre exactement ; aucune conversion implicite ni aucun arrondi."
          },
          "montant": {
            "type": "number",
            "minimum": 0.01,
            "maximum": 90071992547409,
            "multipleOf": 0.01,
            "description": "Montant strictement positif en unités majeures, avec au plus deux décimales et une conversion exacte en unités mineures dans la plage des entiers sûrs. Aucun arrondi."
          },
          "method": {
            "type": "string",
            "enum": [
              "CB",
              "VIREMENT",
              "CHEQUE",
              "PRELEVEMENT",
              "CASH",
              "NATURE"
            ],
            "description": "Moyen de paiement. CB = carte/en ligne, VIREMENT = virement, CHEQUE = chèque, PRELEVEMENT = prélèvement bancaire, CASH = espèces, NATURE = don en nature. Les alias courants (wire/check/cash…) sont acceptés et normalisés."
          },
          "assoc": {
            "type": "string",
            "description": "Association de l’organisation à laquelle ce don est rattaché — elle DÉTERMINE la devise et le reçu. Valeur par défaut : \"MAIN\". Consultez GET /associations pour les valeurs valides. `devise` en est toujours dérivée (ne peut pas être remplacée).",
            "default": "MAIN"
          },
          "contactId": {
            "type": "string",
            "description": "Identifiant facultatif d’un contact CRM (de CETTE organisation) auquel rattacher le don. Aucun contact n’est créé implicitement — fournissez un identifiant existant ou omettez ce champ."
          },
          "type": {
            "type": "string",
            "enum": [
              "GENERAL",
              "CAMPAGNE",
              "DETTE",
              "CAISSE",
              "FORM"
            ],
            "description": "Type de rattachement. GENERAL (par défaut) = don simple. Sinon, rattachez à une entité de l’organisation via `typeId` : CAMPAGNE (alimente son compteur), DETTE (promesse de don), CAISSE, FORM (soumission). Le rattachement ne modifie PAS la devise (`assoc` la détermine).",
            "default": "GENERAL"
          },
          "typeId": {
            "type": "string",
            "description": "Identifiant de l’entité cible lorsque `type` ≠ GENERAL (campagne / dette / cagnotte / identifiant forms_submit). Doit appartenir à votre organisation."
          },
          "info": {
            "$ref": "#/components/schemas/UnisoftRequest_b6eaf8c17ece06a2ed03"
          },
          "facturation": {
            "$ref": "#/components/schemas/UnisoftRequest_ef522362195300ba7557"
          },
          "commentaire": {
            "type": "string",
            "description": "Note en texte libre conservée sur le paiement."
          },
          "datetime": {
            "type": "string",
            "anyOf": [
              {
                "format": "date"
              },
              {
                "format": "date-time"
              }
            ],
            "description": "Date métier historique : YYYY-MM-DD interprétée à minuit UTC, ou instant RFC 3339 avec fuseau horaire. En cas d’omission, utilise la date et l’heure actuelles ; les dates égales à zéro, ambiguës ou impossibles sont refusées."
          },
          "source": {
            "type": "string",
            "description": "Libellé identifiant la provenance du paiement (par ex. \"HELLOASSO\", \"MY_OLD_SOFTWARE\"). Converti en majuscules. Valeur par défaut : \"API_IMPORT\".",
            "default": "API_IMPORT"
          },
          "externalId": {
            "type": "string",
            "description": "Votre référence stable pour ce paiement dans le système source. Lorsqu’elle est fournie, l’import est IDEMPOTENT : renvoyer le même externalId met à jour le même paiement au lieu d’en créer un doublon (réessai ou relance de migration sans risque). Sans cette référence, chaque appel crée un nouveau paiement."
          }
        },
        "required": [
          "method"
        ],
        "additionalProperties": false,
        "description": "Don déjà encaissé à enregistrer comme paiement HISTORIQUE/comptable (chèque, virement, espèces, ancien logiciel ou autre plateforme). Il est enregistré avec `imported:true` et `state:\"COMPLETED\"` (forcés côté serveur) : il alimente les statistiques, compteurs de campagne, CRM et conversions de devise, mais aucun reçu/cerfa n’est émis de nouveau — le donateur l’a déjà reçu lors de l’encaissement. Utilisez cette opération pour migrer des paiements historiques ou consigner un don effectué hors plateforme ; utilisez plutôt `POST /paiements` pour qu’un donateur paie en ligne maintenant."
      },
      "PaymentRefundResponse": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "pending": {
            "type": "boolean",
            "description": "Le résultat du remboursement n’est pas confirmé. Vérifiez auprès du fournisseur avant de réessayer."
          },
          "refundId": {
            "type": "string",
            "nullable": true
          },
          "status": {
            "type": "string",
            "nullable": true
          },
          "error": {
            "type": "string",
            "nullable": true
          },
          "message": {
            "type": "string",
            "nullable": true
          }
        }
      },
      "PaymentStatusResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "data"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/PaymentStatus"
          }
        }
      },
      "PaymentStatus": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "id",
          "state",
          "phase",
          "amountMinor",
          "currency",
          "imported",
          "donorInformationStatus",
          "recordedAt"
        ],
        "description": "Instantané en liste blanche d’un paiement enregistré. Aucune requête prestataire ni opération financière n’est effectuée. Les valeurs historiques inconnues ou invalides restent null ou UNKNOWN ; elles ne sont jamais remplacées par un succès ou un montant nul.",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Identifiant stable du paiement Unisoft ; chaque tentative de paiement possède son propre identifiant."
          },
          "state": {
            "type": "string",
            "nullable": true,
            "maxLength": 64,
            "pattern": "^[A-Za-z][A-Za-z0-9_.-]{0,63}$",
            "description": "Code d’état Unisoft enregistré, sans déduction à partir de l’ancienneté, de la référence prestataire ou du retour navigateur. Null si la valeur est absente ou structurellement invalide. Un nouveau code non reconnu est conservé ici et correspond à la phase UNKNOWN."
          },
          "phase": {
            "type": "string",
            "enum": [
              "PREPARED",
              "PROCESSING",
              "RECORDED_COMPLETED",
              "FAILED",
              "CANCELED",
              "REFUND_PENDING",
              "RECORDED_REFUNDED",
              "TECHNICAL",
              "UNKNOWN"
            ],
            "description": "Interprétation prudente de state. INIT=PREPARED ; AWAITING_DEVICE/PENDING/PRELEVEMENT-SUBMITED/SEPA_PENDING=PROCESSING ; COMPLETED=RECORDED_COMPLETED ; FAILED/ERROR/REQUIRES_PAYMENT_METHOD=FAILED ; CANCELED/CANCELLED=CANCELED ; REFUND_PENDING=REFUND_PENDING ; REFUNDED=RECORDED_REFUNDED ; ABO_PAUSE=TECHNICAL ; toute autre valeur=UNKNOWN. RECORDED_COMPLETED décrit le résultat métier enregistré par Unisoft : Axepta peut enregistrer une autorisation avant capture, et les imports enregistrent un paiement historique déjà encaissé. Cela ne prouve ni capture, ni règlement bancaire, ni versement, ni autorisation de réessai. RECORDED_REFUNDED décrit également le résultat enregistré. Les états en attente ou inconnus ne doivent pas déclencher automatiquement un nouveau débit."
          },
          "amountMinor": {
            "type": "integer",
            "nullable": true,
            "minimum": 0,
            "maximum": 9007199254740991,
            "description": "Montant enregistré du paiement en unités mineures, par exemple 5000 pour 50 EUR. Il s’agit du montant de cette tentative, et non de la mensualité nominale de l’abonnement. Null si la valeur est absente, négative, fractionnaire ou hors de la plage des entiers sûrs ; zéro peut correspondre à une trace technique ABO_PAUSE."
          },
          "currency": {
            "type": "string",
            "nullable": true,
            "pattern": "^[a-z]{3}$",
            "description": "Code de devise enregistré sur trois lettres, normalisé en minuscules. Null si la valeur est absente ou mal formée ; aucune devise de l’organisation n’est substituée."
          },
          "imported": {
            "type": "boolean",
            "nullable": true,
            "description": "Marqueur d’import enregistré : true ou false uniquement si un booléen est explicitement conservé ; null si la valeur est absente ou invalide. Les consommateurs historiques testent souvent imported:true, mais un marqueur absent reste inconnu dans cette réponse. Les imports historiques ne déclenchent pas de nouveau débit et suivent des règles différentes des paiements natifs dans les files documentaires et certains totaux."
          },
          "donorInformationStatus": {
            "type": "string",
            "enum": [
              "NOT_REPORTED",
              "INCOMPLETE",
              "COMPLETE",
              "UNKNOWN"
            ],
            "description": "Interprétation séparée de finalized : false=INCOMPLETE, true=COMPLETE, absent/null=NOT_REPORTED, invalide=UNKNOWN. Ce marqueur concerne les informations du donateur ou la publication, et non l’émission d’un reçu ou la réception des fonds. COMPLETED peut coexister avec INCOMPLETE ; NOT_REPORTED ne signifie pas un échec de finalisation."
          },
          "recordedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true,
            "description": "Valeur datetime enregistrée sur le paiement, sous forme d’instant ISO. Son sens dépend du parcours producteur : généralement la préparation en ligne, ou la date métier fournie en saisie manuelle/import. Ce n’est pas une date confirmée de règlement bancaire ni d’émission de reçu. Null si la valeur est absente ou non prise en charge ; jamais remplacée par l’heure actuelle."
          }
        },
        "example": {
          "id": "11111111-1111-4111-8111-111111111111",
          "state": "COMPLETED",
          "phase": "RECORDED_COMPLETED",
          "amountMinor": 5000,
          "currency": "eur",
          "imported": null,
          "donorInformationStatus": "INCOMPLETE",
          "recordedAt": "2026-11-07T10:00:00.000Z"
        }
      },
      "PaymentContextResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "data"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/PaymentContext"
          }
        }
      },
      "PaymentContext": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "payment",
          "timeline",
          "relations",
          "campaignRestrictedDomains"
        ],
        "properties": {
          "payment": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "id",
              "state",
              "phase",
              "amountMinor",
              "currency",
              "imported",
              "donorInformationStatus",
              "recordedAt"
            ],
            "description": "Instantané en liste blanche d’un paiement enregistré. Aucune requête prestataire ni opération financière n’est effectuée. Les valeurs historiques inconnues ou invalides restent null ou UNKNOWN ; elles ne sont jamais remplacées par un succès ou un montant nul.",
            "properties": {
              "id": {
                "type": "string",
                "format": "uuid",
                "description": "Identifiant stable du paiement Unisoft ; chaque tentative de paiement possède son propre identifiant."
              },
              "state": {
                "type": "string",
                "nullable": true,
                "maxLength": 64,
                "pattern": "^[A-Za-z][A-Za-z0-9_.-]{0,63}$",
                "description": "Code d’état Unisoft enregistré, sans déduction à partir de l’ancienneté, de la référence prestataire ou du retour navigateur. Null si la valeur est absente ou structurellement invalide. Un nouveau code non reconnu est conservé ici et correspond à la phase UNKNOWN."
              },
              "phase": {
                "type": "string",
                "enum": [
                  "PREPARED",
                  "PROCESSING",
                  "RECORDED_COMPLETED",
                  "FAILED",
                  "CANCELED",
                  "REFUND_PENDING",
                  "RECORDED_REFUNDED",
                  "TECHNICAL",
                  "UNKNOWN"
                ],
                "description": "Interprétation prudente de state. INIT=PREPARED ; AWAITING_DEVICE/PENDING/PRELEVEMENT-SUBMITED/SEPA_PENDING=PROCESSING ; COMPLETED=RECORDED_COMPLETED ; FAILED/ERROR/REQUIRES_PAYMENT_METHOD=FAILED ; CANCELED/CANCELLED=CANCELED ; REFUND_PENDING=REFUND_PENDING ; REFUNDED=RECORDED_REFUNDED ; ABO_PAUSE=TECHNICAL ; toute autre valeur=UNKNOWN. RECORDED_COMPLETED décrit le résultat métier enregistré par Unisoft : Axepta peut enregistrer une autorisation avant capture, et les imports enregistrent un paiement historique déjà encaissé. Cela ne prouve ni capture, ni règlement bancaire, ni versement, ni autorisation de réessai. RECORDED_REFUNDED décrit également le résultat enregistré. Les états en attente ou inconnus ne doivent pas déclencher automatiquement un nouveau débit."
              },
              "amountMinor": {
                "type": "integer",
                "nullable": true,
                "minimum": 0,
                "maximum": 9007199254740991,
                "description": "Montant enregistré du paiement en unités mineures, par exemple 5000 pour 50 EUR. Il s’agit du montant de cette tentative, et non de la mensualité nominale de l’abonnement. Null si la valeur est absente, négative, fractionnaire ou hors de la plage des entiers sûrs ; zéro peut correspondre à une trace technique ABO_PAUSE."
              },
              "currency": {
                "type": "string",
                "nullable": true,
                "pattern": "^[a-z]{3}$",
                "description": "Code de devise enregistré sur trois lettres, normalisé en minuscules. Null si la valeur est absente ou mal formée ; aucune devise de l’organisation n’est substituée."
              },
              "imported": {
                "type": "boolean",
                "nullable": true,
                "description": "Marqueur d’import enregistré : true ou false uniquement si un booléen est explicitement conservé ; null si la valeur est absente ou invalide. Les consommateurs historiques testent souvent imported:true, mais un marqueur absent reste inconnu dans cette réponse. Les imports historiques ne déclenchent pas de nouveau débit et suivent des règles différentes des paiements natifs dans les files documentaires et certains totaux."
              },
              "donorInformationStatus": {
                "type": "string",
                "enum": [
                  "NOT_REPORTED",
                  "INCOMPLETE",
                  "COMPLETE",
                  "UNKNOWN"
                ],
                "description": "Interprétation séparée de finalized : false=INCOMPLETE, true=COMPLETE, absent/null=NOT_REPORTED, invalide=UNKNOWN. Ce marqueur concerne les informations du donateur ou la publication, et non l’émission d’un reçu ou la réception des fonds. COMPLETED peut coexister avec INCOMPLETE ; NOT_REPORTED ne signifie pas un échec de finalisation."
              },
              "recordedAt": {
                "type": "string",
                "format": "date-time",
                "nullable": true,
                "description": "Valeur datetime enregistrée sur le paiement, sous forme d’instant ISO. Son sens dépend du parcours producteur : généralement la préparation en ligne, ou la date métier fournie en saisie manuelle/import. Ce n’est pas une date confirmée de règlement bancaire ni d’émission de reçu. Null si la valeur est absente ou non prise en charge ; jamais remplacée par l’heure actuelle."
              }
            },
            "example": {
              "id": "11111111-1111-4111-8111-111111111111",
              "state": "COMPLETED",
              "phase": "RECORDED_COMPLETED",
              "amountMinor": 5000,
              "currency": "eur",
              "imported": null,
              "donorInformationStatus": "INCOMPLETE",
              "recordedAt": "2026-11-07T10:00:00.000Z"
            }
          },
          "timeline": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PaymentContextTimelineEvent"
            },
            "description": "Événements enregistrés triés par instant croissant, puis par kind, resourceType et resourceId. Cette observation est partielle : aucun historique complet d’état, flux d’événements prestataire, capture, règlement bancaire, expiration ou autorisation de réessai n’est reconstitué."
          },
          "relations": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "contact",
              "pledges",
              "subscription",
              "submission",
              "documents"
            ],
            "description": "Uniquement les références actuellement admissibles. Null ou une liste vide indique qu’aucune référence admissible n’a été retournée ; cela ne prouve pas l’absence de relation historique. Les cibles invalides, supprimées, étrangères à l’organisation ou hors des collectes autorisées restent masquées.",
            "properties": {
              "contact": {
                "type": "object",
                "nullable": true,
                "additionalProperties": false,
                "required": [
                  "id"
                ],
                "description": "Référence CRM provenant de payment.contact. Toujours null pour une clé limitée aux collectes, car les contacts ne possèdent pas de propriétaire indépendant d’appartenance à une collecte.",
                "properties": {
                  "id": {
                    "type": "string",
                    "format": "uuid",
                    "description": "Identifiant de la ressource actuellement autorisée."
                  }
                }
              },
              "pledges": {
                "type": "array",
                "maxItems": 200,
                "items": {
                  "$ref": "#/components/schemas/PaymentContextPledgeReference"
                },
                "description": "Références distinctes de promesses autorisées, triées par id. Ces références ne représentent pas des totaux d’affectation financière."
              },
              "subscription": {
                "type": "object",
                "nullable": true,
                "additionalProperties": false,
                "required": [
                  "id"
                ],
                "description": "Référence contractuelle provenant de payment.abo, vérifiée indépendamment via payload.type=CAMPAGNE et payload.typeId lorsque la clé est limitée aux collectes. Aucun calendrier n’est initialisé ni déduit.",
                "properties": {
                  "id": {
                    "type": "string",
                    "format": "uuid",
                    "description": "Identifiant de la ressource actuellement autorisée."
                  }
                }
              },
              "submission": {
                "type": "object",
                "nullable": true,
                "additionalProperties": false,
                "required": [
                  "id"
                ],
                "description": "Pour FORM, payment.typeId désigne une soumission forms_submit, pas le formulaire parent. Toujours null pour une clé limitée aux collectes, car les soumissions ne possèdent pas de propriétaire indépendant d’appartenance à une collecte.",
                "properties": {
                  "id": {
                    "type": "string",
                    "format": "uuid",
                    "description": "Identifiant de la ressource actuellement autorisée."
                  }
                }
              },
              "documents": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/PaymentContextDocumentReference"
                },
                "description": "Documents actuellement autorisés, rattachés par le propriétaire documentaire, y compris les documents groupés et annuels réadmis. Aucune URL, identité du donateur, photographie privée ou réponse prestataire n’est retournée."
              }
            }
          },
          "campaignRestrictedDomains": {
            "type": "array",
            "uniqueItems": true,
            "items": {
              "type": "string",
              "enum": [
                "CONTACT",
                "SUBMISSION"
              ]
            },
            "description": "CONTACT et SUBMISSION sont indiqués pour chaque clé limitée aux collectes, indépendamment de l’existence d’un lien historique. Leurs références sont masquées car leur appartenance indépendante à une collecte ne peut pas être établie. Liste vide pour les clés sans restriction."
          }
        }
      },
      "PaymentContextTimelineEvent": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "kind",
          "at",
          "resourceType",
          "resourceId",
          "source"
        ],
        "description": "Une date enregistrée prise en charge, jamais une transition déduite ou un journal d’audit complet. Les dates invalides ou absentes ne produisent aucun événement.",
        "properties": {
          "kind": {
            "type": "string",
            "enum": [
              "PAYMENT_DATE_RECORDED",
              "REFUND_REQUEST_RECORDED",
              "REFUND_RECORD_UPDATED",
              "DOCUMENT_RECORDED"
            ],
            "description": "PAYMENT_DATE_RECORDED correspond à payment.datetime, dont le producteur peut enregistrer la préparation ou une date fournie en saisie manuelle/import. REFUND_REQUEST_RECORDED et REFUND_RECORD_UPDATED correspondent aux dernières dates conservées de l’enregistrement de remboursement, sans représenter chaque tentative ou un verdict bancaire. DOCUMENT_RECORDED correspond à document.datetime, sans confirmer la livraison."
          },
          "at": {
            "type": "string",
            "format": "date-time",
            "description": "Instant enregistré pris en charge, normalisé en UTC ISO 8601 ; jamais remplacé par l’heure actuelle."
          },
          "resourceType": {
            "type": "string",
            "enum": [
              "PAYMENT",
              "FISCAL_RECEIPT",
              "RECEIPT"
            ],
            "description": "Type de la ressource autorisée indépendamment qui porte la date enregistrée."
          },
          "resourceId": {
            "type": "string",
            "format": "uuid",
            "description": "Identifiant de la ressource portant cette date."
          },
          "source": {
            "type": "string",
            "enum": [
              "payment.datetime",
              "payment.refund.createdAt",
              "payment.refund.updatedAt",
              "document.datetime"
            ],
            "description": "Source exacte de la date persistée, parmi les champs autorisés."
          }
        }
      },
      "PaymentContextPledgeReference": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "id",
          "sources"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Identifiant de la promesse actuellement autorisée."
          },
          "sources": {
            "type": "array",
            "minItems": 1,
            "uniqueItems": true,
            "items": {
              "type": "string",
              "enum": [
                "PAYMENT_TARGET",
                "PAYMENT_ALLOCATION",
                "LEGACY_ALLOCATION_REFERENCE"
              ]
            },
            "description": "PAYMENT_TARGET désigne le typeId DETTE enregistré et ne prouve pas une affectation courante. PAYMENT_ALLOCATION désigne une entrée positive entière sûre de pledgeAllocations, ou de subscriptionAllocations lorsque la première carte est absente. Une carte explicitement vide exclut les références d’affectation historiques. LEGACY_ALLOCATION_REFERENCE désigne dettes[].id uniquement si aucune carte n’existe ; aucun montant, prorata, solde réglé ou affectation contractuelle n’est déduit."
          }
        }
      },
      "PaymentContextDocumentReference": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "id",
          "kind"
        ],
        "description": "Référence d’un reçu fiscal ou ordinaire existant ; le propriétaire documentaire vérifie le lien au paiement et tous les membres du groupe ou du reçu annuel. Cette référence ne génère, ne renvoie et ne télécharge aucun document.",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Identifiant du document actuellement autorisé."
          },
          "kind": {
            "type": "string",
            "enum": [
              "FISCAL_RECEIPT",
              "RECEIPT"
            ],
            "description": "FISCAL_RECEIPT désigne un enregistrement cerfas ; RECEIPT désigne un enregistrement recus."
          }
        }
      },
      "PaymentMethodsResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "data"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/PaymentMethodsData"
          }
        }
      },
      "PaymentMethodsData": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "association",
          "currency",
          "type",
          "typeId",
          "recurring",
          "targetEligibility",
          "providerVerification",
          "methods"
        ],
        "properties": {
          "association": {
            "type": "string",
            "description": "Référence vérifiée de l’association légale : MAIN ou un UUID d’association."
          },
          "currency": {
            "type": "string",
            "pattern": "^[a-z]{3}$",
            "description": "Devise effective d’encaissement correspondant à l’association ; aucune conversion ni devise virtuelle d’affichage."
          },
          "type": {
            "type": "string",
            "enum": [
              "GENERAL",
              "FORM",
              "DETTE",
              "CAISSE",
              "CAMPAGNE"
            ],
            "description": "Affectation métier du paiement. Pour FORM, typeId désigne un UUID de soumission, pas la définition du formulaire."
          },
          "typeId": {
            "type": "string",
            "format": "uuid",
            "nullable": true,
            "description": "UUID vérifié de la cible ; null pour GENERAL."
          },
          "recurring": {
            "type": "boolean",
            "description": "Intention récurrente demandée ; ne désigne ni un abonnement existant ni une instruction d’exécution."
          },
          "targetEligibility": {
            "type": "string",
            "enum": [
              "INDETERMINATE",
              "INELIGIBLE"
            ],
            "description": "Une référence de cible valide ne prouve pas que son contexte complet de paiement peut être accepté."
          },
          "providerVerification": {
            "type": "string",
            "enum": [
              "NOT_PERFORMED"
            ],
            "description": "Aucune requête au prestataire, validation d’identifiants, vérification bancaire ni évaluation des capacités du navigateur n’a été effectuée."
          },
          "methods": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PaymentMethodOption"
            },
            "description": "Choix locaux de paiement correspondant à l’intention récurrente. Les choix absents ne sont pas annoncés ; leur absence ne décrit pas les capacités générales du prestataire."
          }
        }
      },
      "PaymentMethodOption": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "choice",
          "configuration",
          "selection",
          "platform",
          "instrument",
          "eligibility",
          "prerequisites"
        ],
        "properties": {
          "choice": {
            "type": "string",
            "enum": [
              "CARD",
              "PRELEVEMENT.GOCARDLESS",
              "STRIPE.SEPA",
              "SEPA_XML",
              "PAYPAL",
              "CARDCOM.BIT",
              "KESHER.BIT",
              "AAC",
              "STRIPE.APPLEPAY",
              "STRIPE.GOOGLEPAY"
            ],
            "description": "Choix demandé pour le parcours de paiement ; CARD utilise le prestataire carte actuellement sélectionné pour l’association."
          },
          "configuration": {
            "type": "string",
            "enum": [
              "AVAILABLE",
              "UNAVAILABLE",
              "INDETERMINATE"
            ],
            "description": "AVAILABLE signifie que la configuration locale de l’option et sa sélection marchande ont été observées. Cela ne vérifie jamais les identifiants, la disponibilité du prestataire ni l’acceptation."
          },
          "selection": {
            "type": "string",
            "enum": [
              "RESOLVED",
              "UNAVAILABLE",
              "INDETERMINATE",
              "NOT_EVALUATED"
            ],
            "description": "Résultat du propriétaire actuel de sélection pure. SEPA_XML contourne ce propriétaire et reste NOT_EVALUATED jusqu’à son admission par son propre runtime."
          },
          "platform": {
            "type": "string",
            "nullable": true,
            "enum": [
              "PAYGREEN",
              "STRIPE",
              "STRIPE_EXTERNAL",
              "STRIPE.SEPA",
              "STRIPE_EXTERNAL.SEPA",
              "AUTHORIZENET",
              "PAYME",
              "CARDCOM",
              "CARDCOM.BIT",
              "NEDARIM",
              "IPAY",
              "AXEPTA",
              "HYP",
              "PAYPAL",
              "AAC",
              "KESHER",
              "KESHER.BIT",
              "GOCARDLESS",
              "STRIPE.APPLEPAY",
              "STRIPE.GOOGLEPAY",
              "STRIPE_EXTERNAL.APPLEPAY",
              "STRIPE_EXTERNAL.GOOGLEPAY",
              "SEPA_XML",
              null
            ],
            "description": "Code du prestataire sélectionné appartenant à la liste autorisée, ou null si la sélection est indisponible, incertaine ou non évaluée."
          },
          "instrument": {
            "type": "string",
            "nullable": true,
            "enum": [
              "CB",
              "PRELEVEMENT",
              "VIREMENT",
              null
            ],
            "description": "Instrument renvoyé par le propriétaire de sélection. null reste inconnu et n’est jamais déduit du nom d’un prestataire."
          },
          "eligibility": {
            "type": "string",
            "enum": [
              "INDETERMINATE",
              "INELIGIBLE"
            ],
            "description": "L’éligibilité finale du paiement n’est jamais confirmée par cette lecture de configuration. INELIGIBLE indique un refus local observé ; INDETERMINATE exige les préalables indiqués."
          },
          "prerequisites": {
            "type": "array",
            "uniqueItems": true,
            "items": {
              "type": "string",
              "enum": [
                "PAYMENT_CONTEXT_REQUIRED",
                "PROVIDER_VERIFICATION_REQUIRED",
                "MERCHANT_CONFIGURATION_NOT_CONFIRMED",
                "CONFIGURATION_REVIEW_REQUIRED",
                "REQUESTED_CHOICE_NOT_SELECTED",
                "BROWSER_WALLET_CHECK_REQUIRED",
                "MANDATE_AND_SCHEDULE_REQUIRED",
                "SEPA_RUNTIME_ADMISSION_REQUIRED",
                "TARGET_CURRENCY_NOT_RECORDED",
                "TARGET_CHECKOUT_REQUIRED",
                "TARGET_NOT_ACCEPTING_PAYMENTS",
                "FORM_REQUIRES_BANK_WITHDRAWAL"
              ]
            },
            "description": "Contrôles restants ou motifs de refus locaux. PAYMENT_CONTEXT_REQUIRED couvre notamment montant, donateur, affectations, calendrier et règles de cible absents de cette requête."
          }
        }
      },
      "PaymentMethodsErrorResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      },
      "PaymentRefundHistoryResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "data"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/PaymentRefundHistory"
          }
        }
      },
      "PaymentRefundHistory": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "paymentId",
          "status",
          "latestAttempt",
          "history",
          "historyCompleteness",
          "hasMore"
        ],
        "properties": {
          "paymentId": {
            "type": "string",
            "format": "uuid",
            "description": "Identifiant stable du paiement Unisoft."
          },
          "status": {
            "type": "string",
            "enum": [
              "NOT_RECORDED",
              "PENDING",
              "RECORDED_SUCCEEDED",
              "RECORDED_FAILED",
              "RECORDED_CANCELED",
              "UNKNOWN"
            ],
            "description": "Interprétation prudente du résultat enregistré. NOT_RECORDED signifie qu’aucun instantané de remboursement ni journal de remboursement n’a été trouvé ; cela ne prouve ni l’absence réelle de remboursement ni son échec. PENDING correspond au couple REFUND_PENDING/PENDING sans erreur enregistrée ; une erreur sur une réservation en attente ou un enregistrement contradictoire ou mal formé donne UNKNOWN. RECORDED_SUCCEEDED correspond au couple REFUNDED/SUCCEEDED ; RECORDED_FAILED et RECORDED_CANCELED correspondent à COMPLETED/FAILED ou COMPLETED/CANCELED. Ces codes décrivent les données Unisoft, sans vérifier indépendamment la banque ni autoriser une nouvelle tentative."
          },
          "latestAttempt": {
            "$ref": "#/components/schemas/PaymentRefundAttempt"
          },
          "history": {
            "type": "array",
            "maxItems": 100,
            "items": {
              "$ref": "#/components/schemas/PaymentRefundAuditEvent"
            },
            "description": "Au plus 100 journaux de remboursement existants, triés par datetime enregistré décroissant puis par _id Mongo privé décroissant. Une date absente ou mal formée reste null. Cette liste ne reconstruit ni réservations, ni échecs, ni confirmations par callback, ni tentatives."
          },
          "historyCompleteness": {
            "type": "string",
            "enum": [
              "PARTIAL"
            ],
            "description": "Toujours PARTIAL : l’écriture des journaux est facultative en cas d’erreur et le paiement conserve seulement la dernière tentative. Cette lecture ne fournit aucun grand livre financier complet, même lorsque hasMore vaut false."
          },
          "hasMore": {
            "type": "boolean",
            "description": "true si plus de 100 journaux correspondants ont été trouvés. Cette observation bornée ne possède aucun paramètre de continuation ; false ne prouve pas que l’historique est complet."
          }
        }
      },
      "PaymentRefundAttempt": {
        "type": "object",
        "additionalProperties": false,
        "nullable": true,
        "required": [
          "state",
          "attemptNumber",
          "reservedAt",
          "updatedAt"
        ],
        "description": "Dernière tentative de remboursement conservée uniquement. Une nouvelle réservation remplace cet instantané ; il ne contient pas toutes les tentatives.",
        "properties": {
          "state": {
            "type": "string",
            "nullable": true,
            "enum": [
              "PENDING",
              "SUCCEEDED",
              "FAILED",
              "CANCELED",
              null
            ],
            "description": "État de remboursement enregistré, limité aux codes autorisés. null indique une valeur absente, invalide ou inconnue. PENDING peut représenter une réservation ou un résultat prestataire non confirmé ; consulter status au niveau principal."
          },
          "attemptNumber": {
            "type": "integer",
            "nullable": true,
            "minimum": 1,
            "maximum": 9007199254740991,
            "description": "Compteur positif refund.attempt enregistré, ou null si absent ou invalide. Ce compteur ne fournit ni la liste des tentatives antérieures ni le nombre de remboursements terminés."
          },
          "reservedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true,
            "description": "refund.createdAt enregistré sous forme d’instant ISO, ou null si absent ou invalide. Cet instant marque la réservation locale et ne prouve ni l’envoi au prestataire ni la fin du remboursement."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true,
            "description": "refund.updatedAt enregistré sous forme d’instant ISO, ou null si absent ou invalide. Il s’agit de la dernière mise à jour conservée ; aucune transition intermédiaire n’est reconstruite."
          }
        }
      },
      "PaymentRefundAuditEvent": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "event",
          "recordedAt"
        ],
        "properties": {
          "event": {
            "type": "string",
            "enum": [
              "REFUND_RECORDED"
            ],
            "description": "Journal PAIEMENT_REFUND existant du propriétaire de finalisation partagé. Il témoigne d’une étape métier, sans nouvelle vérification bancaire ni rattachement à un numéro de tentative."
          },
          "recordedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true,
            "description": "datetime du journal enregistré sous forme d’instant ISO, ou null si absent ou invalide. Il ne s’agit pas d’une date de règlement bancaire."
          }
        }
      },
      "PaymentFinanceResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "data"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/PaymentFinance"
          }
        }
      },
      "PaymentFinance": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "id",
          "currency",
          "grossMinor",
          "bankFeesMinor",
          "serviceFeesMinor",
          "bankFeesCurrency",
          "serviceFeesCurrency",
          "bankFeesBasis",
          "serviceFeesBasis",
          "totalFeesMinor",
          "netMinor",
          "netAvailability",
          "netUnavailableReason",
          "conversion",
          "payout",
          "reconciliation"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Identifiant stable de la tentative de paiement Unisoft."
          },
          "currency": {
            "type": "string",
            "nullable": true,
            "pattern": "^[a-z]{3}$",
            "description": "Devise enregistrée du paiement, normalisée en minuscules ; null si absente ou invalide. Aucune devise de l’organisation n’est substituée."
          },
          "grossMinor": {
            "type": "integer",
            "nullable": true,
            "minimum": 0,
            "maximum": 9007199254740991,
            "description": "Montant enregistré du paiement en unités monétaires mineures ; 5000 représente 50 EUR si currency vaut eur. La valeur null indique un montant absent, négatif, fractionnaire ou hors entier sûr. Zéro peut représenter une trace technique."
          },
          "bankFeesMinor": {
            "type": "integer",
            "nullable": true,
            "minimum": 0,
            "maximum": 9007199254740991,
            "description": "Nombre brut bankFees enregistré en unités mineures dont la devise n’est pas conservée par le producteur historique. Ne pas lui attribuer currency et ne pas soustraire un frais non nul de grossMinor. La valeur null indique un frais absent ou invalide ; zéro n’est jamais déduit. Peut être une estimation."
          },
          "serviceFeesMinor": {
            "type": "integer",
            "nullable": true,
            "minimum": 0,
            "maximum": 9007199254740991,
            "description": "Nombre brut orgfees de service ou de logiciel enregistré en unités mineures dont la devise et la provenance ne sont pas conservées. Ne pas lui attribuer la devise du paiement et ne pas soustraire un frais non nul. Un zéro explicite reste zéro ; des frais absents ou invalides restent null."
          },
          "bankFeesCurrency": {
            "type": "string",
            "nullable": true,
            "enum": [
              null
            ],
            "description": "Toujours null : le producteur n’a pas conservé la devise du frais. Chez Stripe, les frais dans la devise de règlement peuvent différer de la devise du paiement. Aucune devise n’est devinée."
          },
          "serviceFeesCurrency": {
            "type": "string",
            "nullable": true,
            "enum": [
              null
            ],
            "description": "Toujours null : aucune devise indépendante enregistrée de ce frais n’est disponible. Elle n’est pas déduite du paiement, de l’organisation ou des champs convertis."
          },
          "bankFeesBasis": {
            "type": "string",
            "enum": [
              "ESTIMATED",
              "RECORDED_WITHOUT_PROVENANCE",
              "UNKNOWN"
            ],
            "description": "ESTIMATED lorsqu’un estimateFees.bankFees de PAYGREEN correspond au frais enregistré ; sinon RECORDED_WITHOUT_PROVENANCE pour un montant valide, ou UNKNOWN pour un montant absent ou invalide. Un frais enregistré n’est jamais présenté comme vérifié ou définitif."
          },
          "serviceFeesBasis": {
            "type": "string",
            "enum": [
              "ESTIMATED",
              "RECORDED_WITHOUT_PROVENANCE",
              "UNKNOWN"
            ],
            "description": "ESTIMATED lorsqu’un estimateFees.orgfees de PAYGREEN correspond au frais enregistré ; sinon RECORDED_WITHOUT_PROVENANCE pour un montant valide, ou UNKNOWN. L’absence de marqueur d’estimation ne prouve pas le caractère définitif du frais."
          },
          "totalFeesMinor": {
            "type": "integer",
            "nullable": true,
            "minimum": 0,
            "maximum": 9007199254740991,
            "description": "Zéro uniquement lorsque les deux frais enregistrés sont explicitement zéro et que la devise du paiement est connue ; sinon null car la devise des frais n’est pas prouvée. La valeur null ne signifie pas une absence de frais."
          },
          "netMinor": {
            "type": "integer",
            "nullable": true,
            "minimum": 0,
            "maximum": 9007199254740991,
            "description": "Disponible uniquement lorsque les deux frais enregistrés sont explicitement zéro et que grossMinor et la devise du paiement sont connus : netMinor vaut alors grossMinor sans mélanger de devises. Tout frais non nul sans devise prouvée laisse le net inconnu. Aucun ajustement de remboursement, règlement prestataire ou encaissement bancaire n’est déduit."
          },
          "netAvailability": {
            "type": "string",
            "enum": [
              "AVAILABLE",
              "UNKNOWN"
            ],
            "description": "AVAILABLE signifie qu’un net à frais enregistrés nuls peut être exprimé dans la devise du paiement ; cela ne signifie ni frais définitifs, ni réception des fonds, ni règlement prestataire, ni versement."
          },
          "netUnavailableReason": {
            "type": "string",
            "nullable": true,
            "enum": [
              "MISSING_OR_INVALID_CURRENCY",
              "MISSING_OR_INVALID_GROSS",
              "MISSING_OR_INVALID_BANK_FEES",
              "MISSING_OR_INVALID_SERVICE_FEES",
              "FEE_CURRENCY_NOT_RECORDED",
              null
            ],
            "description": "Premier prérequis absent ou invalide, ou FEE_CURRENCY_NOT_RECORDED pour tout frais non nul ; null uniquement si netMinor est disponible."
          },
          "conversion": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "availability",
              "reason"
            ],
            "properties": {
              "availability": {
                "type": "string",
                "enum": [
                  "UNAVAILABLE"
                ]
              },
              "reason": {
                "type": "string",
                "enum": [
                  "HISTORICAL_CONVERSION_PROVENANCE_NOT_RECORDED"
                ]
              }
            },
            "description": "Les montants convertis ne sont pas exposés : la devise cible historique n’est pas enregistrée et les frais convertis peuvent provenir de frais absents. Aucun taux n’est récupéré ou supposé."
          },
          "payout": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "availability",
              "reason"
            ],
            "properties": {
              "availability": {
                "type": "string",
                "enum": [
                  "UNAVAILABLE"
                ]
              },
              "reason": {
                "type": "string",
                "enum": [
                  "AUTHORIZED_OWNER_ADAPTER_REQUIRED"
                ]
              }
            },
            "description": "Le versement n’est pas exposé par cette opération externe. Cela ne dit rien sur son existence ou son état. L’autorité actuelle de trésorerie interne ne peut pas être déduite d’une référence de paiement ou d’une clé API."
          },
          "reconciliation": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "availability",
              "reason"
            ],
            "properties": {
              "availability": {
                "type": "string",
                "enum": [
                  "UNAVAILABLE"
                ]
              },
              "reason": {
                "type": "string",
                "enum": [
                  "AUTHORIZED_OWNER_ADAPTER_REQUIRED"
                ]
              }
            },
            "description": "Le rapprochement n’est pas exposé par cette opération externe. UNAVAILABLE ne signifie ni UNMATCHED ni CONFIRMED. Un adaptateur du propriétaire explicitement autorisé constitue un préalable."
          }
        }
      },
      "PaymentIncidentsResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "data"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/PaymentIncidents"
          }
        }
      },
      "PaymentIncidents": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "id",
          "provider",
          "coverage",
          "sources"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Identifiant de la tentative de paiement Unisoft autorisée."
          },
          "provider": {
            "type": "string",
            "nullable": true,
            "enum": [
              "STRIPE",
              "GOCARDLESS",
              "SEPA_XML",
              null
            ],
            "description": "Famille du prestataire persisté prise en charge, ou null. Le texte libre d’une plateforme historique n’est jamais renvoyé."
          },
          "coverage": {
            "type": "string",
            "enum": [
              "PARTIAL_PERSISTED",
              "UNSUPPORTED"
            ],
            "description": "PARTIAL_PERSISTED ne couvre que les instantanés stockés listés et n’est jamais complet. UNSUPPORTED indique que cette plateforme ne possède ici aucune source d’incident prise en charge."
          },
          "sources": {
            "type": "array",
            "maxItems": 2,
            "items": {
              "$ref": "#/components/schemas/PaymentIncidentSource"
            },
            "description": "Deux observations de source pour Stripe, une pour GoCardless/SEPA_XML, aucune pour les plateformes non prises en charge. Dernier instantané par source ; aucune déduplication, exhaustivité historique ou agrégation monétaire n’est annoncée."
          }
        }
      },
      "PaymentIncidentSource": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "source",
          "observation",
          "snapshot"
        ],
        "properties": {
          "source": {
            "type": "string",
            "enum": [
              "STRIPE_PAYMENT_FAILURE",
              "STRIPE_TREASURY_DISPUTE",
              "GOCARDLESS_PAYMENT_FAILURE",
              "SEPA_XML_PAYMENT_FAILURE"
            ],
            "description": "Source persistée de cet instantané unique. Des sources peuvent se recouvrir ; elles ne représentent pas des décomptes de débits ou d’incidents distincts."
          },
          "observation": {
            "type": "string",
            "enum": [
              "RECORDED",
              "NOT_RECORDED",
              "UNRECOGNISED",
              "UNAVAILABLE"
            ],
            "description": "RECORDED fournit un instantané sûr. NOT_RECORDED indique qu’aucune trace persistée sélectionnée n’existe ; UNRECOGNISED une trace invalide ou non prise en charge ; UNAVAILABLE un adaptateur d’autorisation distinct requis pour Stripe treasury. Aucun de ces états n’affirme l’absence d’un incident bancaire."
          },
          "snapshot": {
            "$ref": "#/components/schemas/PaymentIncidentSnapshot"
          }
        }
      },
      "PaymentIncidentSnapshot": {
        "type": "object",
        "nullable": true,
        "additionalProperties": false,
        "description": "Dernier instantané stocké pris en charge pour cette source, ou null. Il ne s’agit pas d’un historique des événements prestataire.",
        "required": [
          "kind",
          "reason",
          "code",
          "bankReasonCode",
          "providerStatus",
          "recordedPaymentState",
          "resolution",
          "occurredAt",
          "observedAt",
          "resolvedAt"
        ],
        "properties": {
          "kind": {
            "type": "string",
            "enum": [
              "DISPUTE",
              "REJECTION",
              "RETURN",
              "REFUND",
              "UNKNOWN"
            ],
            "description": "Classification démontrée par la source prestataire persistée, sans interprétation d’un texte d’erreur arbitraire. REFUND est ici un événement explicite de retour bancaire SEPA_XML, pas un remboursement marchand générique."
          },
          "reason": {
            "type": "string",
            "enum": [
              "DEBIT_DISPUTED",
              "INSUFFICIENT_FUNDS",
              "PAYMENT_DECLINED",
              "MANDATE_UNUSABLE",
              "PAYER_APPROVAL_DENIED",
              "UNKNOWN"
            ],
            "description": "Motif de présentation sûr : DEBIT_DISPUTED désigne une contestation de prélèvement/autorisation ; INSUFFICIENT_FUNDS un solde insuffisant ; PAYMENT_DECLINED un refus enregistré ; MANDATE_UNUSABLE une cause stockée ou politique SEPA de mandat inutilisable ; PAYER_APPROVAL_DENIED un accord du payeur refusé. UNKNOWN signifie qu’aucun motif n’est pris en charge et ne constitue pas une instruction de réessai."
          },
          "code": {
            "type": "string",
            "nullable": true,
            "enum": [
              "debit_disputed",
              "card_declined",
              "refund_requested",
              "authorisation_disputed",
              "insufficient_funds",
              "customer_approval_denied",
              "return_on_odd_details",
              "refer_to_payer",
              "bank_account_transferred",
              "mandate_cancelled",
              "mandate_expired",
              "mandate_suspended",
              "mandate_is_inactive",
              "bank_account_closed",
              "bank_account_disabled",
              "invalid_bank_details",
              "account_blocked_for_direct_debit",
              "account_blocked_for_any_financial_transaction",
              "direct_debit_not_enabled",
              null
            ],
            "description": "Cause Stripe/GoCardless persistée autorisée, ou null. Les codes inconnus et tous les messages bruts du prestataire sont omis."
          },
          "bankReasonCode": {
            "type": "string",
            "nullable": true,
            "enum": [
              "AM04",
              "AC01",
              "AC04",
              "AC06",
              "AG01",
              "MD01",
              "MD06",
              null
            ],
            "description": "Code bancaire autorisé, ou null. Un code bancaire GoCardless appartient à son système bancaire et ne prouve jamais seul une contestation ni un sens commun entre systèmes."
          },
          "providerStatus": {
            "type": "string",
            "nullable": true,
            "enum": [
              "failed",
              "late_failure",
              "charged_back",
              "cancelled",
              "customer_approval_denied",
              "REJECT",
              "RETURN",
              "DISPUTE",
              "REFUND",
              null
            ],
            "description": "Action GoCardless ou type d’événement SEPA_XML persisté autorisé, ou null. Les états inconnus restent null ; aucun état prestataire n’est récupéré en direct."
          },
          "recordedPaymentState": {
            "type": "string",
            "nullable": true,
            "enum": [
              "FAILED",
              "ERROR",
              "REQUIRES_PAYMENT_METHOD",
              "CANCELED",
              "COMPLETED",
              "SEPA_PARTIAL",
              null
            ],
            "description": "État Unisoft actuel autorisé associé à l’instantané, ou null. Il ne décrit pas le cycle de vie du litige chez le prestataire. COMPLETED peut coexister avec un incident SEPA_XML résolu ; il ne certifie ni règlement bancaire ni autorisation de reprendre un abonnement."
          },
          "resolution": {
            "type": "string",
            "enum": [
              "UNKNOWN",
              "RESOLVED"
            ],
            "description": "RESOLVED exige le resolvedAt explicite et valide du propriétaire SEPA_XML. Les autres sources restent UNKNOWN ; l’absence de résolution ne prouve pas qu’un litige est ouvert."
          },
          "occurredAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true,
            "description": "Instant d’incident persisté, ou null s’il est absent ou invalide. Les instantanés d’échec Stripe n’ont pas d’instant d’événement propre persisté et donnent null. Aucun remplacement par datetime du paiement ou la date courante."
          },
          "observedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true,
            "description": "Null dans cette version : aucune observation prestataire distincte n’est lue. Aucune fraîcheur n’est garantie."
          },
          "resolvedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true,
            "description": "Instant de résolution SEPA_XML persisté, sinon null. Le rétablissement des fonds n’autorise pas à reprendre un abonnement."
          }
        }
      },
      "PaymentExportResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "data",
          "totals",
          "meta"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "type": "array",
            "maxItems": 200,
            "items": {
              "$ref": "#/components/schemas/PaymentExportRecord"
            }
          },
          "totals": {
            "type": "array",
            "maxItems": 10000,
            "items": {
              "$ref": "#/components/schemas/PaymentExportTotal"
            }
          },
          "meta": {
            "$ref": "#/components/schemas/PaymentExportMeta"
          }
        }
      },
      "PaymentExportRecord": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "id",
          "recordedAt",
          "associationId",
          "instrument",
          "currency",
          "state",
          "imported",
          "recordKind",
          "amountMinor"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "UUID stable d’une tentative de paiement. Plusieurs tentatives peuvent concerner la même échéance d’abonnement ; aucun nombre d’échéances n’est déduit."
          },
          "recordedAt": {
            "type": "string",
            "format": "date-time",
            "description": "Champ datetime enregistré, normalisé en instant UTC. Il s’agit généralement de la date de préparation en ligne ou de la date métier fournie en saisie manuelle/import, sans garantie de date de règlement bancaire ni d’émission de reçu."
          },
          "associationId": {
            "type": "string",
            "nullable": true,
            "description": "UUID de l’association bénéficiaire enregistré, ou MAIN. Une valeur absente ou mal formée reste null ; aucune association par défaut de l’organisation actuelle n’est substituée."
          },
          "instrument": {
            "type": "string",
            "nullable": true,
            "enum": [
              "CASH",
              "CHEQUE",
              "VIREMENT",
              "PRELEVEMENT",
              "CB",
              "NATURE",
              null
            ],
            "description": "Instrument de paiement enregistré. NATURE désigne une contribution en nature. Les instruments absents ou non pris en charge restent null ; aucun instrument n’est déduit du prestataire."
          },
          "currency": {
            "type": "string",
            "nullable": true,
            "pattern": "^[a-z]{3}$",
            "description": "Code de devise enregistré à trois lettres, normalisé en minuscules. Une valeur absente ou mal formée reste null ; aucune conversion ni devise par défaut n’est appliquée."
          },
          "state": {
            "type": "string",
            "nullable": true,
            "pattern": "^[A-Z][A-Z0-9_-]{0,63}$",
            "description": "État Unisoft enregistré, y compris les futurs codes bien formés ; null si absent ou mal formé. COMPLETED peut correspondre à une autorisation Axepta avant capture. REFUND_PENDING et REFUNDED restent des états enregistrés distincts, sans être des flux de trésorerie négatifs."
          },
          "imported": {
            "type": "boolean",
            "nullable": true,
            "description": "Marqueur d’import explicitement enregistré. true, false et absent/invalide (null) forment des groupes distincts. Un marqueur absent n’est pas présenté comme la preuve d’un paiement natif."
          },
          "recordKind": {
            "type": "string",
            "enum": [
              "MONETARY_RECORD",
              "IN_KIND",
              "TECHNICAL",
              "UNKNOWN"
            ],
            "description": "TECHNICAL pour ABO_PAUSE, sinon IN_KIND pour NATURE, sinon MONETARY_RECORD pour un instrument reconnu et un montant enregistré entier sûr strictement positif, sinon UNKNOWN. Cette classification ne prouve pas la réception de fonds."
          },
          "amountMinor": {
            "type": "integer",
            "nullable": true,
            "minimum": 0,
            "maximum": 9007199254740991,
            "description": "Montant nominal enregistré en unités monétaires mineures (5000 pour EUR 50), y compris le montant nominal positif initial d’un paiement remboursé. Null si absent, négatif, fractionnaire ou hors précision sûre ; les zéros techniques sont conservés."
          }
        }
      },
      "PaymentExportTotal": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "associationId",
          "instrument",
          "currency",
          "state",
          "imported",
          "recordKind",
          "recordCount",
          "validAmountCount",
          "unknownAmountCount",
          "amountMinor",
          "amountStatus"
        ],
        "properties": {
          "associationId": {
            "type": "string",
            "nullable": true,
            "description": "UUID de l’association bénéficiaire enregistré, ou MAIN. Une valeur absente ou mal formée reste null ; aucune association par défaut de l’organisation actuelle n’est substituée."
          },
          "instrument": {
            "type": "string",
            "nullable": true,
            "enum": [
              "CASH",
              "CHEQUE",
              "VIREMENT",
              "PRELEVEMENT",
              "CB",
              "NATURE",
              null
            ],
            "description": "Instrument de paiement enregistré. NATURE désigne une contribution en nature. Les instruments absents ou non pris en charge restent null ; aucun instrument n’est déduit du prestataire."
          },
          "currency": {
            "type": "string",
            "nullable": true,
            "pattern": "^[a-z]{3}$",
            "description": "Code de devise enregistré à trois lettres, normalisé en minuscules. Une valeur absente ou mal formée reste null ; aucune conversion ni devise par défaut n’est appliquée."
          },
          "state": {
            "type": "string",
            "nullable": true,
            "pattern": "^[A-Z][A-Z0-9_-]{0,63}$",
            "description": "État Unisoft enregistré, y compris les futurs codes bien formés ; null si absent ou mal formé. COMPLETED peut correspondre à une autorisation Axepta avant capture. REFUND_PENDING et REFUNDED restent des états enregistrés distincts, sans être des flux de trésorerie négatifs."
          },
          "imported": {
            "type": "boolean",
            "nullable": true,
            "description": "Marqueur d’import explicitement enregistré. true, false et absent/invalide (null) forment des groupes distincts. Un marqueur absent n’est pas présenté comme la preuve d’un paiement natif."
          },
          "recordKind": {
            "type": "string",
            "enum": [
              "MONETARY_RECORD",
              "IN_KIND",
              "TECHNICAL",
              "UNKNOWN"
            ],
            "description": "TECHNICAL pour ABO_PAUSE, sinon IN_KIND pour NATURE, sinon MONETARY_RECORD pour un instrument reconnu et un montant enregistré entier sûr strictement positif, sinon UNKNOWN. Cette classification ne prouve pas la réception de fonds."
          },
          "recordCount": {
            "type": "integer",
            "minimum": 1,
            "maximum": 10000,
            "description": "Nombre d’enregistrements de paiement dans ce groupe exact. Il ne s’agit ni d’un nombre d’encaissements bancaires ni d’un nombre d’échéances d’abonnement distinctes."
          },
          "validAmountCount": {
            "type": "integer",
            "minimum": 0,
            "maximum": 10000,
            "description": "Enregistrements dont le montant nominal est un entier sûr positif ou nul, y compris un zéro technique. Cela ne prouve pas la réussite financière."
          },
          "unknownAmountCount": {
            "type": "integer",
            "minimum": 0,
            "maximum": 10000,
            "description": "Enregistrements dont le montant nominal ne peut pas être interprété de façon sûre. Ils ne sont pas comptabilisés silencieusement comme zéro."
          },
          "amountMinor": {
            "type": "integer",
            "nullable": true,
            "minimum": 0,
            "maximum": 9007199254740991,
            "description": "Somme exacte de tous les montants nominaux de ce seul groupe lorsque la devise est connue, tous les montants sont valides et la somme est un entier sûr. Sinon null. Aucun calcul net, déduction de remboursement ou de frais, règlement bancaire ni conversion multidevise n’est effectué."
          },
          "amountStatus": {
            "type": "string",
            "enum": [
              "COMPLETE",
              "INCOMPLETE",
              "UNKNOWN_CURRENCY",
              "OVERFLOW"
            ],
            "description": "COMPLETE signifie que la somme nominale est exacte ; UNKNOWN_CURRENCY est prioritaire si la devise manque, puis INCOMPLETE si un montant est invalide, puis OVERFLOW si la somme entière exacte dépasse la précision sûre de JavaScript. Un total inconnu ne vaut jamais zéro."
          }
        }
      },
      "PaymentExportMeta": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "period",
          "count",
          "matchedRecordCount",
          "hasMore",
          "nextCursor",
          "totalsScope",
          "totalMeaning",
          "bankSettlementVerified",
          "snapshot",
          "excludedInvalidDatetimeCount"
        ],
        "properties": {
          "period": {
            "$ref": "#/components/schemas/PaymentExportPeriod"
          },
          "count": {
            "type": "integer",
            "minimum": 0,
            "maximum": 200
          },
          "matchedRecordCount": {
            "type": "integer",
            "minimum": 0,
            "maximum": 10000,
            "description": "Enregistrements correspondants non supprimés avec un datetime pris en charge dans la période filtrée. Cela ne prétend pas couvrir l’historique financier réel de façon exhaustive."
          },
          "hasMore": {
            "type": "boolean"
          },
          "nextCursor": {
            "type": "string",
            "nullable": true,
            "maxLength": 2048,
            "description": "Continuation opaque pour la même organisation, les mêmes restrictions de collecte et les mêmes filtres. Null à la dernière page. Le paramètre limit peut changer entre les pages ; le résultat n’est pas un instantané."
          },
          "totalsScope": {
            "type": "string",
            "enum": [
              "FILTERED_PERIOD"
            ],
            "description": "Les totaux couvrent toujours toute la période filtrée de la lecture actuelle, y compris les lignes avant et après la page courante. Ne pas additionner les totaux de période répétés sur les pages."
          },
          "totalMeaning": {
            "type": "string",
            "enum": [
              "RECORDED_NOMINAL_AMOUNTS"
            ]
          },
          "bankSettlementVerified": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "snapshot": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "excludedInvalidDatetimeCount": {
            "type": "integer",
            "nullable": true,
            "enum": [
              null
            ],
            "description": "Toujours null : cette opération ne peut pas placer les datetime historiques absents ou non pris en charge dans une période et ne les compte pas. Null signifie inconnu, sans affirmer que zéro enregistrement est exclu."
          }
        }
      },
      "PaymentExportPeriod": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "from",
          "to",
          "datetimeField",
          "upperBoundExclusive"
        ],
        "properties": {
          "from": {
            "type": "string",
            "format": "date-time",
            "description": "Borne basse inclusive, normalisée en UTC, sur le champ datetime enregistré du paiement."
          },
          "to": {
            "type": "string",
            "format": "date-time",
            "description": "Borne haute exclusive, normalisée en UTC, sur le champ datetime enregistré du paiement."
          },
          "datetimeField": {
            "type": "string",
            "enum": [
              "datetime"
            ]
          },
          "upperBoundExclusive": {
            "type": "boolean",
            "enum": [
              true
            ]
          }
        }
      },
      "PaymentExportError": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "param": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      },
      "PaymentTreasurySnapshotResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "data"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/PaymentTreasurySnapshot"
          }
        }
      },
      "PaymentTreasurySnapshot": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "paymentId",
          "coverage",
          "observations",
          "providerRefreshed",
          "bankVerified"
        ],
        "properties": {
          "paymentId": {
            "type": "string",
            "format": "uuid"
          },
          "providerRefreshed": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "bankVerified": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "coverage": {
            "type": "string",
            "enum": [
              "PERSISTED_SNAPSHOT",
              "NOT_SYNCHRONIZED"
            ]
          },
          "observations": {
            "type": "array",
            "maxItems": 100,
            "items": {
              "type": "object",
              "additionalProperties": false,
              "required": [
                "accountKey",
                "livemode",
                "presentment",
                "settlement",
                "captured",
                "amountRefunded",
                "disputed",
                "maturity",
                "observedAt",
                "stale"
              ],
              "properties": {
                "accountKey": {
                  "type": "string",
                  "pattern": "^(test|live):acct_[A-Za-z0-9]+$"
                },
                "livemode": {
                  "type": "boolean"
                },
                "presentment": {
                  "type": "object",
                  "nullable": true,
                  "additionalProperties": false,
                  "required": [
                    "amount",
                    "currency",
                    "exponent"
                  ],
                  "properties": {
                    "amount": {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    "currency": {
                      "type": "string",
                      "pattern": "^[a-z]{3}$"
                    },
                    "exponent": {
                      "type": "integer",
                      "enum": [
                        0,
                        2
                      ]
                    }
                  }
                },
                "settlement": {
                  "type": "object",
                  "nullable": true,
                  "additionalProperties": false,
                  "required": [
                    "amount",
                    "currency",
                    "exponent",
                    "fee",
                    "net",
                    "exchangeRate"
                  ],
                  "properties": {
                    "amount": {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    "currency": {
                      "type": "string",
                      "pattern": "^[a-z]{3}$"
                    },
                    "exponent": {
                      "type": "integer",
                      "enum": [
                        0,
                        2
                      ]
                    },
                    "fee": {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    "net": {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    "exchangeRate": {
                      "type": "number",
                      "nullable": true,
                      "minimum": 0,
                      "exclusiveMinimum": true
                    }
                  }
                },
                "captured": {
                  "type": "boolean",
                  "nullable": true
                },
                "amountRefunded": {
                  "type": "integer",
                  "minimum": 0,
                  "maximum": 9007199254740991,
                  "nullable": true
                },
                "disputed": {
                  "type": "boolean",
                  "nullable": true
                },
                "maturity": {
                  "type": "object",
                  "additionalProperties": false,
                  "required": [
                    "state",
                    "availableOn"
                  ],
                  "properties": {
                    "state": {
                      "type": "string",
                      "enum": [
                        "PENDING",
                        "AVAILABLE",
                        "NOT_CREATED",
                        "NOT_CAPTURED",
                        "UNKNOWN"
                      ]
                    },
                    "availableOn": {
                      "type": "string",
                      "nullable": true,
                      "format": "date-time"
                    }
                  }
                },
                "observedAt": {
                  "type": "string",
                  "nullable": true,
                  "format": "date-time"
                },
                "stale": {
                  "type": "boolean"
                }
              }
            }
          }
        }
      },
      "PaymentTreasuryCorrectionPageResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "data"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/PaymentTreasuryCorrectionPage"
          }
        }
      },
      "PaymentTreasuryCorrectionPage": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "paymentId",
          "coverage",
          "data",
          "total",
          "pagination",
          "providerRefreshed",
          "bankVerified"
        ],
        "properties": {
          "paymentId": {
            "type": "string",
            "format": "uuid"
          },
          "providerRefreshed": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "bankVerified": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "coverage": {
            "type": "string",
            "enum": [
              "PERSISTED_RELATIONS"
            ]
          },
          "total": {
            "type": "integer",
            "minimum": 0,
            "maximum": 1000
          },
          "pagination": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "current",
              "pageSize"
            ],
            "properties": {
              "current": {
                "type": "integer",
                "minimum": 1,
                "maximum": 100000
              },
              "pageSize": {
                "type": "integer",
                "minimum": 1,
                "maximum": 100
              }
            }
          },
          "data": {
            "type": "array",
            "maxItems": 100,
            "items": {
              "type": "object",
              "additionalProperties": false,
              "required": [
                "accountKey",
                "id",
                "type",
                "status",
                "presentment",
                "reason",
                "createdAt",
                "observedAt",
                "stale"
              ],
              "properties": {
                "accountKey": {
                  "type": "string"
                },
                "id": {
                  "type": "string"
                },
                "type": {
                  "type": "string",
                  "enum": [
                    "refund",
                    "dispute"
                  ]
                },
                "status": {
                  "type": "string",
                  "nullable": true
                },
                "presentment": {
                  "type": "object",
                  "nullable": true,
                  "additionalProperties": false,
                  "required": [
                    "amount",
                    "currency",
                    "exponent"
                  ],
                  "properties": {
                    "amount": {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    "currency": {
                      "type": "string",
                      "pattern": "^[a-z]{3}$"
                    },
                    "exponent": {
                      "type": "integer",
                      "enum": [
                        0,
                        2
                      ]
                    }
                  }
                },
                "reason": {
                  "type": "string",
                  "nullable": true,
                  "enum": [
                    null
                  ]
                },
                "createdAt": {
                  "type": "string",
                  "nullable": true,
                  "format": "date-time"
                },
                "observedAt": {
                  "type": "string",
                  "nullable": true,
                  "format": "date-time"
                },
                "stale": {
                  "type": "boolean"
                }
              }
            }
          }
        }
      },
      "PaymentTreasuryPayoutPageResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "data"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/PaymentTreasuryPayoutPage"
          }
        }
      },
      "PaymentTreasuryPayoutPage": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "paymentId",
          "coverage",
          "data",
          "total",
          "pagination",
          "providerRefreshed",
          "bankVerified"
        ],
        "properties": {
          "paymentId": {
            "type": "string",
            "format": "uuid"
          },
          "providerRefreshed": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "bankVerified": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "coverage": {
            "type": "string",
            "enum": [
              "PERSISTED_RELATIONS"
            ]
          },
          "total": {
            "type": "integer",
            "minimum": 0,
            "maximum": 1000
          },
          "pagination": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "current",
              "pageSize"
            ],
            "properties": {
              "current": {
                "type": "integer",
                "minimum": 1,
                "maximum": 100000
              },
              "pageSize": {
                "type": "integer",
                "minimum": 1,
                "maximum": 100
              }
            }
          },
          "data": {
            "type": "array",
            "maxItems": 100,
            "items": {
              "type": "object",
              "additionalProperties": false,
              "required": [
                "accountKey",
                "id",
                "role",
                "transactionId",
                "net",
                "currency",
                "exponent",
                "compositionState",
                "status",
                "createdAt",
                "arrivalDate",
                "observedAt",
                "stale",
                "bank"
              ],
              "properties": {
                "accountKey": {
                  "type": "string"
                },
                "id": {
                  "type": "string"
                },
                "role": {
                  "type": "string",
                  "enum": [
                    "PAYMENT",
                    "REFUND",
                    "DISPUTE",
                    "FEES",
                    "OTHER"
                  ]
                },
                "transactionId": {
                  "type": "string",
                  "nullable": true
                },
                "net": {
                  "type": "integer",
                  "minimum": -9007199254740991,
                  "maximum": 9007199254740991
                },
                "currency": {
                  "type": "string",
                  "pattern": "^[a-z]{3}$"
                },
                "exponent": {
                  "type": "integer",
                  "enum": [
                    0,
                    2
                  ]
                },
                "compositionState": {
                  "type": "string",
                  "enum": [
                    "VERIFIED"
                  ]
                },
                "status": {
                  "type": "string",
                  "nullable": true
                },
                "createdAt": {
                  "type": "string",
                  "nullable": true,
                  "format": "date-time"
                },
                "arrivalDate": {
                  "type": "string",
                  "nullable": true,
                  "format": "date-time"
                },
                "observedAt": {
                  "type": "string",
                  "nullable": true,
                  "format": "date-time"
                },
                "stale": {
                  "type": "boolean"
                },
                "bank": {
                  "type": "object",
                  "additionalProperties": false,
                  "required": [
                    "state",
                    "matchedAt"
                  ],
                  "properties": {
                    "state": {
                      "type": "string",
                      "enum": [
                        "UNMATCHED",
                        "CONFLICT",
                        "CONFIRMED",
                        "UNKNOWN"
                      ]
                    },
                    "matchedAt": {
                      "type": "string",
                      "nullable": true,
                      "format": "date-time"
                    }
                  }
                }
              }
            }
          }
        }
      },
      "PaymentAllocationPreviewResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "data"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/PaymentAllocationPreview"
          }
        }
      },
      "PaymentAllocationPreview": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "paymentId",
          "expectedRevision",
          "amount",
          "devise",
          "assoc",
          "contactId",
          "beforeContactId",
          "contactChanged",
          "dettes",
          "balances",
          "unallocatedAmount",
          "fiscal",
          "receiptSnapshotChanged",
          "bankVerified"
        ],
        "properties": {
          "paymentId": {
            "type": "string",
            "format": "uuid"
          },
          "expectedRevision": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "amount": {
            "type": "integer",
            "minimum": 1
          },
          "devise": {
            "type": "string",
            "pattern": "^[a-z]{3}$"
          },
          "assoc": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "pattern": "^\\S(?:.*\\S)?$"
          },
          "contactId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "pattern": "^\\S(?:.*\\S)?$"
          },
          "beforeContactId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "pattern": "^\\S(?:.*\\S)?$"
          },
          "contactChanged": {
            "type": "boolean"
          },
          "dettes": {
            "type": "array",
            "maxItems": 50,
            "items": {
              "type": "object",
              "additionalProperties": false,
              "required": [
                "id",
                "montant"
              ],
              "properties": {
                "id": {
                  "type": "string",
                  "format": "uuid"
                },
                "montant": {
                  "type": "number",
                  "minimum": 0,
                  "exclusiveMinimum": true,
                  "description": "Unités majeures positives, exactement deux décimales ; les montants de réponse sont des entiers en unités mineures."
                }
              }
            }
          },
          "balances": {
            "type": "array",
            "maxItems": 50,
            "items": {
              "type": "object",
              "additionalProperties": false,
              "required": [
                "id",
                "amount",
                "remainingBefore",
                "remainingAfter"
              ],
              "properties": {
                "id": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 255,
                  "pattern": "^\\S(?:.*\\S)?$"
                },
                "amount": {
                  "type": "integer",
                  "minimum": 1
                },
                "remainingBefore": {
                  "type": "integer",
                  "minimum": 0
                },
                "remainingAfter": {
                  "type": "integer",
                  "minimum": 0
                }
              }
            }
          },
          "unallocatedAmount": {
            "type": "integer",
            "minimum": 0
          },
          "fiscal": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "recordedAmount",
              "expectedForNewAllocation",
              "exception",
              "snapshotChanged"
            ],
            "properties": {
              "recordedAmount": {
                "type": "integer",
                "minimum": 0
              },
              "expectedForNewAllocation": {
                "type": "integer",
                "minimum": 0
              },
              "exception": {
                "type": "boolean"
              },
              "snapshotChanged": {
                "type": "boolean",
                "enum": [
                  false
                ]
              }
            }
          },
          "receiptSnapshotChanged": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "bankVerified": {
            "type": "boolean",
            "enum": [
              false
            ]
          }
        }
      },
      "PaymentAllocationCommandResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "data"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/PaymentAllocationCommand"
          }
        }
      },
      "PaymentAllocationCommand": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "requestId",
          "paymentId",
          "status",
          "outcome",
          "error",
          "retryable",
          "warnings",
          "receiptSnapshotChanged",
          "bankVerified"
        ],
        "properties": {
          "requestId": {
            "type": "string",
            "format": "uuid"
          },
          "paymentId": {
            "type": "string",
            "format": "uuid"
          },
          "status": {
            "type": "string",
            "enum": [
              "PENDING",
              "SUCCEEDED",
              "REFUSED",
              "UNCERTAIN"
            ]
          },
          "outcome": {
            "type": "string",
            "nullable": true,
            "enum": [
              "ACCOUNTING_UPDATED",
              null
            ]
          },
          "error": {
            "type": "string",
            "nullable": true
          },
          "retryable": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "warnings": {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "CACHE_REFRESH_PENDING",
                "CONTACT_TAG_PENDING"
              ]
            }
          },
          "receiptSnapshotChanged": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "bankVerified": {
            "type": "boolean",
            "enum": [
              false
            ]
          }
        }
      },
      "UnisoftRequest_882f91996439f2ac9d1f": {
        "type": "object",
        "properties": {
          "dettes": {
            "type": "array",
            "maxItems": 50,
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string",
                  "format": "uuid"
                },
                "montant": {
                  "type": "number",
                  "description": "Unités majeures positives, exactement deux décimales ; les montants de réponse sont des entiers en unités mineures.",
                  "minimum": 0,
                  "exclusiveMinimum": true
                }
              },
              "required": [
                "id",
                "montant"
              ],
              "additionalProperties": false
            }
          },
          "contactId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "pattern": "^\\S(?:.*\\S)?$"
          },
          "idempotencyKey": {
            "type": "string",
            "format": "uuid"
          },
          "expectedRevision": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "confirmFiscalException": {
            "type": "boolean",
            "description": "Acquittement explicite de l’exception fiscale d’aperçu. Doit être true si le montant fiscal historique enregistré diffère de la politique de l’affectation proposée. Autorise une réaffectation comptable, jamais une réécriture documentaire fiscale."
          }
        },
        "required": [
          "dettes",
          "idempotencyKey",
          "expectedRevision",
          "confirmFiscalException"
        ],
        "additionalProperties": false
      },
      "PaymentManualResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "data"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/PaymentManualResult"
          }
        }
      },
      "PaymentManualResult": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "requestId",
          "status",
          "paymentId",
          "outcome",
          "error",
          "bankVerified",
          "retryable",
          "requestedAt",
          "completedAt"
        ],
        "properties": {
          "requestId": {
            "type": "string",
            "format": "uuid"
          },
          "status": {
            "type": "string",
            "enum": [
              "PENDING",
              "SUCCEEDED",
              "REFUSED",
              "UNCERTAIN"
            ]
          },
          "paymentId": {
            "type": "string",
            "format": "uuid",
            "nullable": true
          },
          "outcome": {
            "type": "string",
            "enum": [
              "MANUALLY_RECORDED",
              null
            ],
            "nullable": true
          },
          "error": {
            "type": "string",
            "nullable": true
          },
          "bankVerified": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "retryable": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "requestedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "completedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          }
        }
      },
      "UnisoftRequest_1d110747a2ca9004259d": {
        "type": "object",
        "properties": {
          "idempotencyKey": {
            "type": "string",
            "format": "uuid",
            "description": "UUID stable pour une intention de saisie manuelle ; réutiliser exactement le même corps après une réponse perdue. Une autre clé peut doubler des fonds déjà enregistrés."
          },
          "confirmation": {
            "type": "string",
            "enum": [
              "FUNDS_OBSERVED"
            ],
            "description": "Déclaration explicite de l’appelant que les fonds ont été constatés hors de cette API. Cette opération ne vérifie pas la banque et ne déclenche ni débit, ni virement, ni mandat, ni paiement par carte."
          },
          "type": {
            "type": "string",
            "enum": [
              "GENERAL",
              "CAISSE",
              "CAMPAGNE"
            ]
          },
          "typeId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "pattern": "^\\S(?:.*\\S)?$",
            "nullable": true
          },
          "contactId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "pattern": "^\\S(?:.*\\S)?$"
          },
          "montant": {
            "type": "number",
            "maximum": 1000000,
            "description": "Unités majeures positives, exactement représentables avec deux décimales : 125.5 devient amount 12550.",
            "minimum": 0,
            "exclusiveMinimum": true
          },
          "datetime": {
            "type": "string",
            "pattern": "^\\d{4}-\\d{2}-\\d{2}(?:T.*)?$",
            "description": "Date réelle explicite YYYY-MM-DD interprétée à minuit UTC, ou horodatage RFC3339 avec décalage. Le jour historique enregistré est conservé ; pas plus de 24 heures dans le futur."
          },
          "assoc": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "pattern": "^\\S(?:.*\\S)?$"
          },
          "devise": {
            "type": "string",
            "pattern": "^[a-z]{3}$",
            "description": "Explicit lower-case currency matching the legal association and target. For MAIN only, a missing or null association currency inherits the organisation currency, as returned by GET /associations. An explicit association currency remains authoritative. Missing or invalid effective currency, mismatches and secondary associations without their own currency are refused; country never determines currency."
          },
          "method": {
            "type": "string",
            "enum": [
              "CASH",
              "CHEQUE",
              "VIREMENT",
              "PRELEVEMENT",
              "CB",
              "NATURE"
            ]
          },
          "info": {
            "type": "object",
            "properties": {
              "nom": {
                "type": "string",
                "maxLength": 255
              },
              "prenom": {
                "type": "string",
                "maxLength": 255
              },
              "email": {
                "type": "string",
                "maxLength": 320,
                "pattern": "^(?:$|[^\\s@]+@[^\\s@]+\\.[^\\s@]+)$"
              },
              "tel": {
                "type": "string",
                "maxLength": 255
              }
            },
            "required": [
              "nom",
              "prenom",
              "email",
              "tel"
            ],
            "additionalProperties": false
          },
          "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",
              "nom",
              "prenom",
              "civilite",
              "raison",
              "siren",
              "adresse",
              "postal",
              "ville",
              "etat",
              "pays",
              "social_id"
            ],
            "additionalProperties": false
          },
          "cerfa": {
            "type": "boolean",
            "description": "Demande explicite de document fiscal, soumise à la politique native de l’émetteur juridique. Refusée si l’association interdit les reçus fiscaux. Aucun numéro de document ni livraison n’est acquitté ici."
          },
          "dontSendReceipt": {
            "type": "boolean",
            "description": "true supprime l’email de reçu natif ; false active son parcours asynchrone habituel et exige un email de donateur valide. Ce choix ne supprime pas la génération documentaire et ne garantit pas la livraison."
          },
          "name": {
            "type": "string",
            "minLength": 1,
            "maxLength": 500
          },
          "commentaire": {
            "type": "string",
            "maxLength": 4000
          }
        },
        "required": [
          "idempotencyKey",
          "confirmation",
          "type",
          "contactId",
          "montant",
          "datetime",
          "assoc",
          "devise",
          "method",
          "info",
          "facturation",
          "cerfa",
          "dontSendReceipt"
        ],
        "additionalProperties": false
      },
      "PaymentCommandResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "data"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/PaymentCommandResult"
          }
        }
      },
      "PaymentCommandResult": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "requestId",
          "action",
          "status",
          "paymentId",
          "url",
          "outcome",
          "error",
          "retryable",
          "requestedAt",
          "completedAt"
        ],
        "properties": {
          "requestId": {
            "type": "string",
            "format": "uuid"
          },
          "action": {
            "type": "string",
            "enum": [
              "CREATE",
              "REVOKE"
            ]
          },
          "status": {
            "type": "string",
            "enum": [
              "PENDING",
              "SUCCEEDED",
              "REFUSED",
              "UNCERTAIN"
            ],
            "description": "État du journal de commande, pas l’état financier du paiement. PENDING et UNCERTAIN ne permettent jamais un rejeu automatique avec une autre clé. SUCCEEDED acquitte seulement le résultat documenté du propriétaire."
          },
          "paymentId": {
            "type": "string",
            "format": "uuid",
            "nullable": true
          },
          "url": {
            "type": "string",
            "nullable": true,
            "format": "uri"
          },
          "outcome": {
            "type": "string",
            "nullable": true,
            "enum": [
              "REQUEST_CREATED",
              "CANCELED",
              "RECORDED_COMPLETED",
              null
            ]
          },
          "error": {
            "type": "string",
            "nullable": true
          },
          "retryable": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "requestedAt": {
            "type": "string",
            "nullable": true,
            "format": "date-time"
          },
          "completedAt": {
            "type": "string",
            "nullable": true,
            "format": "date-time"
          }
        }
      },
      "UnisoftRequest_c6721c5be3f91d5f9f68": {
        "allOf": [
          {
            "$ref": "#/components/schemas/UnisoftRequest_28438f371d8fbf6a8149"
          },
          {
            "type": "object",
            "properties": {
              "type": {
                "type": "string",
                "enum": [
                  "GENERAL",
                  "FORM",
                  "DETTE",
                  "CAISSE",
                  "CAMPAGNE"
                ]
              },
              "abo": {
                "type": "boolean",
                "enum": [
                  false
                ]
              },
              "update": {
                "type": "boolean",
                "enum": [
                  false
                ]
              }
            },
            "not": {
              "anyOf": [
                {
                  "required": [
                    "nbMonth"
                  ]
                },
                {
                  "required": [
                    "maxAmount"
                  ]
                },
                {
                  "required": [
                    "id"
                  ]
                }
              ]
            }
          }
        ],
        "type": "object",
        "properties": {
          "externalRef": {},
          "externalMetadata": {},
          "type": {},
          "typeId": {},
          "montant": {},
          "devise": {},
          "name": {},
          "info": {},
          "facturation": {},
          "returnUrl": {},
          "platform": {},
          "abo": {},
          "nbMonth": {},
          "maxAmount": {},
          "assoc": {},
          "cerfa": {},
          "update": {},
          "id": {},
          "service": {},
          "dettes": {}
        },
        "additionalProperties": false,
        "description": "Config du parcours de paiement existant, limitée à une nouvelle demande ponctuelle. montant est en unités majeures, exactement convertible en unités mineures. Les intentions récurrentes, les complétions d’identité et le legacy SERVICE sont exclus. La façade stricte existante admet la cible, l’association, la devise et la facturation."
      },
      "UnisoftRequest_28438f371d8fbf6a8149": {
        "type": "object",
        "properties": {
          "externalRef": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "pattern": "\\S",
            "description": "Référence facultative dans votre système. Non vide, enregistrée telle quelle ; correspondance exacte sensible à la casse. Non unique et ne constitue PAS une clé d’idempotence. À distinguer de externalId (dédoublonnage à l’import). Renvoyée lors de la lecture des paiements et dans les webhooks de paiement si elle est fournie. Héritée par les paiements récurrents.",
            "example": "commande-1234"
          },
          "externalMetadata": {
            "type": "object",
            "maxProperties": 50,
            "additionalProperties": {
              "type": "string",
              "maxLength": 500
            },
            "description": "Carte facultative de chaînes clé-valeur gérée par l’appelant. Jusqu’à 50 clés (1–64 caractères chacune), valeurs de 500 caractères maximum. Les clés ne peuvent contenir . ou $, ni le caractère NUL, et ne peuvent être égales à __proto__, prototype ou constructor. Les valeurs null, tableaux, objets imbriqués et valeurs non textuelles sont refusés. Enregistrée telle quelle et renvoyée lors de la lecture des paiements et dans les webhooks ; héritée par les paiements récurrents. Distincte des métadonnées du fournisseur ; évitez d’y placer des secrets. Aucun de ces champs n’est obligatoire pour les paiements historiques.",
            "example": {
              "registrationId": "inscription-567",
              "eventId": "chabbat-890"
            }
          },
          "type": {
            "type": "string",
            "enum": [
              "GENERAL",
              "FORM",
              "DETTE",
              "CAISSE",
              "SERVICE",
              "CAMPAGNE"
            ]
          },
          "typeId": {
            "type": "string",
            "nullable": true,
            "description": "Identifiant de l’entité cible (obligatoire sauf si type=GENERAL)."
          },
          "montant": {
            "type": "number",
            "minimum": 0.01,
            "maximum": 1000000,
            "multipleOf": 0.01,
            "description": "Montant en unités majeures (par ex. euros)."
          },
          "devise": {
            "type": "string",
            "nullable": true
          },
          "name": {
            "type": "string",
            "nullable": true
          },
          "info": {
            "$ref": "#/components/schemas/UnisoftRequest_b6eaf8c17ece06a2ed03"
          },
          "facturation": {
            "$ref": "#/components/schemas/UnisoftRequest_ef522362195300ba7557"
          },
          "returnUrl": {
            "type": "string",
            "nullable": true
          },
          "platform": {
            "type": "string",
            "nullable": true,
            "description": "Forcer une plateforme spécifique (par ex. STRIPE.SEPA, PAYME.IDD, PAYPAL)."
          },
          "abo": {
            "type": "boolean",
            "enum": [
              false
            ],
            "description": "Seule une demande ponctuelle est prise en charge ici. Pour un abonnement pris en charge, utiliser prepare_subscription."
          },
          "nbMonth": {
            "type": "integer",
            "nullable": true
          },
          "maxAmount": {
            "type": "integer",
            "nullable": true
          },
          "assoc": {
            "type": "string",
            "minLength": 1,
            "maxLength": 200,
            "description": "Association bénéficiaire explicite d’un don GENERAL, identifiée avec list_associations. L’omission conserve le choix du service métier, qui peut utiliser defaultAssoc, sans garantie qu’il s’agisse de MAIN. L’association d’un paiement lié à une cible est déterminée par le service métier responsable de cette cible."
          },
          "cerfa": {
            "type": "boolean"
          },
          "update": {
            "type": "boolean",
            "enum": [
              false
            ],
            "description": "La modification de paiements existants, y compris le complément d’identité, est indisponible dans cette opération. Omettre ce champ ou transmettre false."
          },
          "id": {
            "type": "string",
            "minLength": 1,
            "maxLength": 200,
            "description": "Identifiant historique de paiement. Sa présence n’autorise pas la modification d’un paiement existant ; update et le mode UPDATE sont indisponibles."
          },
          "service": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "minLength": 1,
                "maxLength": 200
              }
            },
            "required": [
              "id"
            ],
            "additionalProperties": false,
            "description": "Référence historique de cible SERVICE. Elle n’est pas acceptée pour les autres types de paiement."
          },
          "dettes": {
            "type": "array",
            "maxItems": 200,
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 200
                },
                "montant": {
                  "type": "number",
                  "minimum": 0.01,
                  "maximum": 90071992547409,
                  "multipleOf": 0.01
                }
              },
              "required": [
                "id",
                "montant"
              ],
              "additionalProperties": false
            },
            "description": "Ventilations autorisées sur des promesses, en unités majeures ; pour une demande récurrente, il s’agit de budgets contractuels de ventilation, pas d’une échéance unique."
          }
        },
        "required": [
          "type",
          "montant"
        ],
        "description": "Intention de paiement pour l’organisation authentifiée. Le contexte d’organisation est fourni par le serveur ; config.organisation n’est pas un champ d’entrée admis."
      },
      "PaymentExistingLinkResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "data"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/PaymentExistingLink"
          }
        }
      },
      "PaymentExistingLink": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "paymentId",
          "state",
          "url",
          "source",
          "expiresAt",
          "validity",
          "reason",
          "revocation",
          "providerVerified",
          "notificationSent"
        ],
        "properties": {
          "paymentId": {
            "type": "string",
            "format": "uuid"
          },
          "state": {
            "type": "string",
            "nullable": true
          },
          "url": {
            "type": "string",
            "nullable": true,
            "format": "uri"
          },
          "source": {
            "type": "string",
            "nullable": true,
            "enum": [
              "EXTERNAL_COMMAND_JOURNAL",
              "PAYGREEN_NATIVE_GATEWAY",
              null
            ]
          },
          "expiresAt": {
            "type": "string",
            "nullable": true,
            "format": "date-time"
          },
          "validity": {
            "type": "string",
            "enum": [
              "UNAVAILABLE",
              "RECORDED_UNEXPIRED",
              "UNKNOWN"
            ]
          },
          "reason": {
            "type": "string",
            "nullable": true
          },
          "revocation": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "supported",
              "expectedRevision",
              "reason"
            ],
            "properties": {
              "supported": {
                "type": "boolean"
              },
              "expectedRevision": {
                "type": "string",
                "nullable": true,
                "pattern": "^[a-f0-9]{64}$"
              },
              "reason": {
                "type": "string",
                "nullable": true
              }
            }
          },
          "providerVerified": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "notificationSent": {
            "type": "boolean",
            "enum": [
              false
            ]
          }
        }
      }
    },
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "API Key",
        "description": "Format : `ke_live_xxx`"
      },
      "apiKeyHeader": {
        "type": "apiKey",
        "in": "header",
        "name": "X-API-Key"
      }
    }
  }
}
```
