pi-spi-sdk 0.1.0

package/dist/generated/services/NotificationService.d.ts

@@ -0,0 +1,80 @@
+import type { WebhookCreationRequest } from '../models/WebhookCreationRequest';
+import type { WebhookCreationResponse } from '../models/WebhookCreationResponse';
+import type { WebhookData } from '../models/WebhookData';
+import type { WebhookList } from '../models/WebhookList';
+import type { WebhookModificationRequest } from '../models/WebhookModificationRequest';
+import type { CancelablePromise } from '../core/CancelablePromise';
+export declare class NotificationService {
+    /**
+     * Créer un lien de rappel.
+     * Cet endpoint permet au client de configurer des webhooks (liens de rappel) pour recevoir des notifications en temps réel.
+     *
+     * Le client dispose d'une grande flexibilité dans la configuration de ses webhooks et peut choisir parmi plusieurs stratégies :
+     *
+     * **1. Callback URL général**
+     * - Un seul point de rappel pour toutes les notifications
+     * - Tous les événements de tous les comptes/alias sont envoyés à la même URL
+     * - Configuration simple, idéale pour centraliser toutes les notifications
+     *
+     * **2. Callback URL par alias**
+     * - Un point de rappel distinct pour chaque alias de compte
+     * - Permet de router les notifications vers des systèmes différents selon le compte concerné
+     * - Utile pour isoler les flux de notifications par compte ou par service
+     *
+     * **3. Callback URL par événement**
+     * - Un point de rappel spécifique pour chaque type d'événement (PAIEMENT_RECU, RTP_RECU, etc.)
+     * - Permet de traiter différemment chaque catégorie d'événement
+     * - Facilite la séparation des traitements métier (paiements vs demandes vs retours)
+     *
+     * **4. Callback URL par événement et alias**
+     * - Granularité maximale : un point de rappel pour chaque combinaison événement/alias
+     * - Configuration la plus fine pour des besoins très spécifiques
+     * - Permet de router précisément chaque notification vers le système approprié
+     *
+     * Cette flexibilité permet aux clients d'adapter la configuration des webhooks à leur architecture technique et à leurs besoins métier.
+     *
+     * @returns WebhookCreationResponse Webhook créé avec succès
+     * @throws ApiError
+     */
+    static webhookCreer({ requestBody, }: {
+        requestBody: WebhookCreationRequest;
+    }): CancelablePromise<WebhookCreationResponse>;
+    /**
+     * Lister les webhooks
+     * Endpoint pour lister les webhooks
+     *
+     * @returns WebhookList Liste des webhooks configurés
+     * @throws ApiError
+     */
+    static webhookLister(): CancelablePromise<WebhookList>;
+    /**
+     * Modifier un Webhook
+     * Endpoint pour la modification d'un webhook.
+     *
+     * @returns any Le Webhook a été modifié avec succès
+     * @throws ApiError
+     */
+    static webhookModifier({ id, requestBody, }: {
+        id: string;
+        requestBody: WebhookModificationRequest;
+    }): CancelablePromise<any>;
+    /**
+     * Supprimer un Webhook
+     * Endpoint pour la suppression d'un webhook.
+     *
+     * @returns void
+     * @throws ApiError
+     */
+    static webhookSupprimer({ id, }: {
+        id: string;
+    }): CancelablePromise<void>;
+    /**
+     * Recuperer un webhook
+     * Endpoint pour la consultation des informations d'un Webhook
+     * @returns WebhookData Details du webhook
+     * @throws ApiError
+     */
+    static webhookConsulter({ id, }: {
+        id: string;
+    }): CancelablePromise<WebhookData>;
+}

package/dist/generated/services/NotificationService.js

@@ -0,0 +1,132 @@
+import { OpenAPI } from '../core/OpenAPI';
+import { request as __request } from '../core/request';
+export class NotificationService {
+    /**
+     * Créer un lien de rappel.
+     * Cet endpoint permet au client de configurer des webhooks (liens de rappel) pour recevoir des notifications en temps réel.
+     *
+     * Le client dispose d'une grande flexibilité dans la configuration de ses webhooks et peut choisir parmi plusieurs stratégies :
+     *
+     * **1. Callback URL général**
+     * - Un seul point de rappel pour toutes les notifications
+     * - Tous les événements de tous les comptes/alias sont envoyés à la même URL
+     * - Configuration simple, idéale pour centraliser toutes les notifications
+     *
+     * **2. Callback URL par alias**
+     * - Un point de rappel distinct pour chaque alias de compte
+     * - Permet de router les notifications vers des systèmes différents selon le compte concerné
+     * - Utile pour isoler les flux de notifications par compte ou par service
+     *
+     * **3. Callback URL par événement**
+     * - Un point de rappel spécifique pour chaque type d'événement (PAIEMENT_RECU, RTP_RECU, etc.)
+     * - Permet de traiter différemment chaque catégorie d'événement
+     * - Facilite la séparation des traitements métier (paiements vs demandes vs retours)
+     *
+     * **4. Callback URL par événement et alias**
+     * - Granularité maximale : un point de rappel pour chaque combinaison événement/alias
+     * - Configuration la plus fine pour des besoins très spécifiques
+     * - Permet de router précisément chaque notification vers le système approprié
+     *
+     * Cette flexibilité permet aux clients d'adapter la configuration des webhooks à leur architecture technique et à leurs besoins métier.
+     *
+     * @returns WebhookCreationResponse Webhook créé avec succès
+     * @throws ApiError
+     */
+    static webhookCreer({ requestBody, }) {
+        return __request(OpenAPI, {
+            method: 'POST',
+            url: '/webhooks',
+            body: requestBody,
+            mediaType: 'application/json',
+            errors: {
+                400: `La requête est malformée`,
+                401: `Autorisations manquantes`,
+                429: `Erreur inattendue`,
+                503: `Erreur inattendue du serveur`,
+            },
+        });
+    }
+    /**
+     * Lister les webhooks
+     * Endpoint pour lister les webhooks
+     *
+     * @returns WebhookList Liste des webhooks configurés
+     * @throws ApiError
+     */
+    static webhookLister() {
+        return __request(OpenAPI, {
+            method: 'GET',
+            url: '/webhooks',
+            errors: {
+                400: `La requête est malformée`,
+                401: `Autorisations manquantes`,
+                429: `Erreur inattendue`,
+                503: `Erreur inattendue du serveur`,
+            },
+        });
+    }
+    /**
+     * Modifier un Webhook
+     * Endpoint pour la modification d'un webhook.
+     *
+     * @returns any Le Webhook a été modifié avec succès
+     * @throws ApiError
+     */
+    static webhookModifier({ id, requestBody, }) {
+        return __request(OpenAPI, {
+            method: 'PUT',
+            url: '/webhooks/{id}',
+            path: {
+                'id': id,
+            },
+            body: requestBody,
+            mediaType: 'application/json',
+            errors: {
+                401: `Autorisations manquantes`,
+                429: `Erreur inattendue`,
+                503: `Erreur inattendue du serveur`,
+            },
+        });
+    }
+    /**
+     * Supprimer un Webhook
+     * Endpoint pour la suppression d'un webhook.
+     *
+     * @returns void
+     * @throws ApiError
+     */
+    static webhookSupprimer({ id, }) {
+        return __request(OpenAPI, {
+            method: 'DELETE',
+            url: '/webhooks/{id}',
+            path: {
+                'id': id,
+            },
+            errors: {
+                401: `Autorisations manquantes`,
+                429: `Erreur inattendue`,
+                503: `Erreur inattendue du serveur`,
+            },
+        });
+    }
+    /**
+     * Recuperer un webhook
+     * Endpoint pour la consultation des informations d'un Webhook
+     * @returns WebhookData Details du webhook
+     * @throws ApiError
+     */
+    static webhookConsulter({ id, }) {
+        return __request(OpenAPI, {
+            method: 'GET',
+            url: '/webhooks/{id}',
+            path: {
+                'id': id,
+            },
+            errors: {
+                401: `Autorisations manquantes`,
+                429: `Erreur inattendue`,
+                503: `Erreur inattendue du serveur`,
+            },
+        });
+    }
+}

package/dist/generated/services/PaiementEnMasseService.d.ts

@@ -0,0 +1,159 @@
+import type { PaiementEnMasseConfirmationRequest } from '../models/PaiementEnMasseConfirmationRequest';
+import type { PaiementEnMasseReponseStatut } from '../models/PaiementEnMasseReponseStatut';
+import type { PaiementEnMasseRequest } from '../models/PaiementEnMasseRequest';
+import type { CancelablePromise } from '../core/CancelablePromise';
+export declare class PaiementEnMasseService {
+    /**
+     * Envoyer un paiement en masse
+     * Ce point de terminaison permet au client d'envoyer des paiements en masse.
+     *
+     * **Traitement asynchrone :** La création d'un paiement en masse retourne immédiatement `202 Accepted`. Le traitement des transactions se fait de manière asynchrone.
+     *
+     * **Sans confirmation (`confirmation: false` ou non spécifié) :**
+     * - Les transactions sont créées et validées (unicité des txId)
+     * - Les paiements sont exécutés directement
+     * - Les transactions invalides (txId dupliqué) sont automatiquement rejetées avec le code `DU03`
+     * - Le business peut suivre la progression via `GET /paiements-groupes/{instructionId}` et `GET /paiements?instructionId={instructionId}`
+     *
+     * **Avec confirmation (`confirmation: true`) :**
+     * - Les transactions sont créées et validées (unicité des txId + recherche d'alias)
+     * - Les transactions avec alias invalide sont automatiquement rejetées avec le code `BE23`
+     * - Les transactions avec txId dupliqué sont rejetées avec le code `DU03`
+     * - Les transactions valides passent à l'état `INITIE` et peuvent être consultées via `GET /paiements?instructionId={instructionId}&statut=INITIE`
+     * - Le business dispose d'un **délai adaptatif** pour confirmer ou annuler via `PUT /paiements-groupes/{instructionId}/confirmations` :
+     * - **1 à 500 transactions** : 24 heures
+     * - **501 à 1000 transactions** : 48 heures
+     * - **Plus de 1000 transactions** : 72 heures
+     * - Lors de la confirmation, seules les transactions `INITIE` sont envoyées (les transactions `REJETE` sont automatiquement exclues)
+     * - Passé le délai, la demande expire automatiquement
+     *
+     * **Consultation des détails :**
+     * - Statut global du bulk : `GET /paiements-groupes/{instructionId}`
+     * - Liste de toutes les transactions : `GET /paiements?instructionId={instructionId}`
+     * - Seulement les rejetées (validation) : `GET /paiements?instructionId={instructionId}&statut=REJETE`
+     * - Seulement les valides (avec noms/pays) : `GET /paiements?instructionId={instructionId}&statut=INITIE`
+     *
+     * **Convention de nommage des instructionId (important) :**
+     *
+     * L'`instructionId` doit être **unique** pour chaque création de bulk. Pour faciliter le suivi métier, nous recommandons la convention suivante :
+     *
+     * ```
+     * <IDENTIFIANT_METIER>-<NUMERO_TENTATIVE>
+     * ```
+     *
+     * **Exemples :**
+     * - Première tentative : `SALAIRES-2025-01-1` (salaires de janvier 2025, tentative 1)
+     * - Deuxième tentative : `SALAIRES-2025-01-2` (corrections après échecs)
+     * - Troisième tentative : `SALAIRES-2025-01-3` (nouvelles corrections)
+     *
+     * **Avantages :**
+     * - ✅ Chaque bulk a un statut indépendant (INITIE, CONFIRME, ANNULE)
+     * - ✅ Traçabilité claire des tentatives successives
+     * - ✅ Possibilité de filtrer par identifiant métier : `GET /paiements?instructionId[beginsWith]=SALAIRES-2025-01`
+     * - ✅ Respect de l'unicité de l'instructionId
+     *
+     * @returns string La demande a été acceptée et est en cours de traitement.
+     *
+     * Consultez le statut via `GET /paiements-groupes/{instructionId}`.
+     *
+     * @throws ApiError
+     */
+    static paiementGroupeCreer({ requestBody, }: {
+        requestBody: PaiementEnMasseRequest;
+    }): CancelablePromise<string>;
+    /**
+     * Détails d'un paiement en masse
+     * Ce point de terminaison permet de consulter les détails d'un paiement en masse.
+     *
+     * **Statut du bulk :**
+     * - `INITIE` : Créé avec confirmation demandée, en attente de confirmation
+     * - `CONFIRME` : Confirmé par le business (si confirmation demandée) ou en cours de traitement (si sans confirmation)
+     * - `ANNULE` : Annulé par le business avant confirmation (seulement si confirmation demandée)
+     *
+     * **Note :**
+     * - Si créé **avec confirmation** (`confirmation: true`) : Le statut évolue de `INITIE` → `CONFIRME` ou `ANNULE`
+     * - Si créé **sans confirmation** (`confirmation: false`) : Le statut est directement `CONFIRME` (aucune action requise du business)
+     *
+     * **Vérification de fin de validation (important pour confirmation) :**
+     *
+     * Lorsque `confirmation: true`, la validation des transactions se fait de manière asynchrone.
+     * Pour savoir si la validation est terminée et si vous pouvez confirmer, vérifiez que :
+     *
+     * ```
+     * transactionsInitiees + transactionsRejetees = transactionsTotal
+     * ```
+     *
+     * - Si égalité → Validation terminée, vous pouvez confirmer ✅
+     * - Si inégalité → Validation en cours, attendez encore (consultez à nouveau dans quelques secondes) ⏳
+     *
+     * La progression détaillée de chaque transaction se consulte via `GET /paiements?txId={txId}`.
+     *
+     * **Consultation des transactions individuelles :**
+     * Pour obtenir la liste détaillée des transactions (avec noms des bénéficiaires, codes d'erreur, etc.), utilisez :
+     * - Toutes les transactions : `GET /paiements?instructionId={instructionId}`
+     * - Seulement les rejetées : `GET /paiements?instructionId={instructionId}&statut=REJETE`
+     * - Seulement les réussies : `GET /paiements?instructionId={instructionId}&statut=IRREVOCABLE`
+     *
+     * @returns PaiementEnMasseReponseStatut Opération effectuée avec succès
+     * @throws ApiError
+     */
+    static paiementGroupeConsulter({ instructionId, }: {
+        /**
+         * L'identifiant du paiement en masse dans le SI du client
+         */
+        instructionId: string;
+    }): CancelablePromise<PaiementEnMasseReponseStatut>;
+    /**
+     * Confirmer le paiement en masse
+     * Ce point de terminaison permet de confirmer ou d'annuler un paiement en masse créé avec `confirmation: true`.
+     *
+     * **Processus de vérification :**
+     * 1. Après la création (`POST /paiements-groupes`), le participant valide asynchronement toutes les transactions (unicité des txId + recherche d'alias)
+     * 2. Les transactions invalides sont automatiquement rejetées (`statut: REJETE`) avec codes `BE23` (alias invalide) ou `DU03` (txId dupliqué)
+     * 3. Les transactions valides passent à l'état `INITIE` avec les noms et pays des bénéficiaires
+     * 4. Le business consulte via `GET /paiements-groupes/{instructionId}` pour vérifier la progression de la validation
+     * 5. **La validation est terminée quand** : `transactionsInitiees + transactionsRejetees = transactionsTotal`
+     * 6. Le business peut alors confirmer ou annuler
+     *
+     * **Important :** La confirmation n'est possible que lorsque la validation de toutes les transactions est terminée.
+     * Si le business tente de confirmer pendant que la validation est en cours, une erreur 403 sera retournée avec la progression actuelle.
+     *
+     * **Comportement de la confirmation :**
+     * - `decision: true` → Le système envoie **automatiquement SEULEMENT** les transactions avec `statut: INITIE`
+     * - Les transactions `REJETE` (erreurs de validation) sont **automatiquement exclues** (pas besoin de les lister)
+     * - Le statut du bulk passe de `INITIE` à `CONFIRME`
+     *
+     * **Idempotence** : Cet endpoint est idempotent.
+     * - Premier appel avec `decision: true` → Lance les paiements, retourne `200 OK {statut: "CONFIRME"}`
+     * - Appels suivants avec `decision: true` → Retourne `200 OK {statut: "CONFIRME"}` (idempotent, ne relance pas)
+     * - Premier appel avec `decision: false` → Annule, retourne `200 OK {statut: "ANNULE"}`
+     * - Appels suivants avec `decision: false` → Retourne `200 OK {statut: "ANNULE"}` (idempotent)
+     * - `decision: true` après `decision: false` → Retourne `403 Forbidden` (déjà annulé)
+     * - `decision: false` après `decision: true` → Retourne `403 Forbidden` (déjà confirmé)
+     *
+     * **Timeout adaptatif** : Le délai pour confirmer dépend automatiquement du nombre de transactions :
+     * - **1 à 500 transactions** : 24 heures
+     * - **501 à 1000 transactions** : 48 heures
+     * - **Plus de 1000 transactions** : 72 heures
+     *
+     * Passé ce délai, la demande expire automatiquement et ne peut plus être confirmée. Le délai exact est indiqué dans le champ `dateExpiration` retourné par `GET /paiements-groupes/{instructionId}`.
+     *
+     * **Changement de décision** : Une fois une décision prise, elle est définitive. Impossible de confirmer après avoir annulé, et vice-versa.
+     *
+     * @returns PaiementEnMasseReponseStatut Confirmation enregistrée avec succès.
+     * - Si `decision: true`, le statut passe à `CONFIRME` et les paiements sont lancés
+     * - Si `decision: false`, le statut passe à `ANNULE`
+     *
+     * @throws ApiError
+     */
+    static paiementGroupeConfirmer({ instructionId, requestBody, }: {
+        /**
+         * L'identifiant du paiement en masse dans le SI du client
+         */
+        instructionId: string;
+        /**
+         * Le client envoie oui ou non s'il confirme l'envoi du paiement en masse.
+         */
+        requestBody: PaiementEnMasseConfirmationRequest;
+    }): CancelablePromise<PaiementEnMasseReponseStatut>;
+}

package/dist/generated/services/PaiementEnMasseService.js

@@ -0,0 +1,187 @@
+import { OpenAPI } from '../core/OpenAPI';
+import { request as __request } from '../core/request';
+export class PaiementEnMasseService {
+    /**
+     * Envoyer un paiement en masse
+     * Ce point de terminaison permet au client d'envoyer des paiements en masse.
+     *
+     * **Traitement asynchrone :** La création d'un paiement en masse retourne immédiatement `202 Accepted`. Le traitement des transactions se fait de manière asynchrone.
+     *
+     * **Sans confirmation (`confirmation: false` ou non spécifié) :**
+     * - Les transactions sont créées et validées (unicité des txId)
+     * - Les paiements sont exécutés directement
+     * - Les transactions invalides (txId dupliqué) sont automatiquement rejetées avec le code `DU03`
+     * - Le business peut suivre la progression via `GET /paiements-groupes/{instructionId}` et `GET /paiements?instructionId={instructionId}`
+     *
+     * **Avec confirmation (`confirmation: true`) :**
+     * - Les transactions sont créées et validées (unicité des txId + recherche d'alias)
+     * - Les transactions avec alias invalide sont automatiquement rejetées avec le code `BE23`
+     * - Les transactions avec txId dupliqué sont rejetées avec le code `DU03`
+     * - Les transactions valides passent à l'état `INITIE` et peuvent être consultées via `GET /paiements?instructionId={instructionId}&statut=INITIE`
+     * - Le business dispose d'un **délai adaptatif** pour confirmer ou annuler via `PUT /paiements-groupes/{instructionId}/confirmations` :
+     * - **1 à 500 transactions** : 24 heures
+     * - **501 à 1000 transactions** : 48 heures
+     * - **Plus de 1000 transactions** : 72 heures
+     * - Lors de la confirmation, seules les transactions `INITIE` sont envoyées (les transactions `REJETE` sont automatiquement exclues)
+     * - Passé le délai, la demande expire automatiquement
+     *
+     * **Consultation des détails :**
+     * - Statut global du bulk : `GET /paiements-groupes/{instructionId}`
+     * - Liste de toutes les transactions : `GET /paiements?instructionId={instructionId}`
+     * - Seulement les rejetées (validation) : `GET /paiements?instructionId={instructionId}&statut=REJETE`
+     * - Seulement les valides (avec noms/pays) : `GET /paiements?instructionId={instructionId}&statut=INITIE`
+     *
+     * **Convention de nommage des instructionId (important) :**
+     *
+     * L'`instructionId` doit être **unique** pour chaque création de bulk. Pour faciliter le suivi métier, nous recommandons la convention suivante :
+     *
+     * ```
+     * <IDENTIFIANT_METIER>-<NUMERO_TENTATIVE>
+     * ```
+     *
+     * **Exemples :**
+     * - Première tentative : `SALAIRES-2025-01-1` (salaires de janvier 2025, tentative 1)
+     * - Deuxième tentative : `SALAIRES-2025-01-2` (corrections après échecs)
+     * - Troisième tentative : `SALAIRES-2025-01-3` (nouvelles corrections)
+     *
+     * **Avantages :**
+     * - ✅ Chaque bulk a un statut indépendant (INITIE, CONFIRME, ANNULE)
+     * - ✅ Traçabilité claire des tentatives successives
+     * - ✅ Possibilité de filtrer par identifiant métier : `GET /paiements?instructionId[beginsWith]=SALAIRES-2025-01`
+     * - ✅ Respect de l'unicité de l'instructionId
+     *
+     * @returns string La demande a été acceptée et est en cours de traitement.
+     *
+     * Consultez le statut via `GET /paiements-groupes/{instructionId}`.
+     *
+     * @throws ApiError
+     */
+    static paiementGroupeCreer({ requestBody, }) {
+        return __request(OpenAPI, {
+            method: 'POST',
+            url: '/paiements-groupes',
+            body: requestBody,
+            mediaType: 'application/json',
+            responseHeader: 'Location',
+            errors: {
+                400: `La requête est malformée`,
+                401: `Autorisations manquantes`,
+                409: `Conflit - instructionId déjà utilisé`,
+                429: `Erreur inattendue`,
+                503: `Erreur inattendue du serveur`,
+            },
+        });
+    }
+    /**
+     * Détails d'un paiement en masse
+     * Ce point de terminaison permet de consulter les détails d'un paiement en masse.
+     *
+     * **Statut du bulk :**
+     * - `INITIE` : Créé avec confirmation demandée, en attente de confirmation
+     * - `CONFIRME` : Confirmé par le business (si confirmation demandée) ou en cours de traitement (si sans confirmation)
+     * - `ANNULE` : Annulé par le business avant confirmation (seulement si confirmation demandée)
+     *
+     * **Note :**
+     * - Si créé **avec confirmation** (`confirmation: true`) : Le statut évolue de `INITIE` → `CONFIRME` ou `ANNULE`
+     * - Si créé **sans confirmation** (`confirmation: false`) : Le statut est directement `CONFIRME` (aucune action requise du business)
+     *
+     * **Vérification de fin de validation (important pour confirmation) :**
+     *
+     * Lorsque `confirmation: true`, la validation des transactions se fait de manière asynchrone.
+     * Pour savoir si la validation est terminée et si vous pouvez confirmer, vérifiez que :
+     *
+     * ```
+     * transactionsInitiees + transactionsRejetees = transactionsTotal
+     * ```
+     *
+     * - Si égalité → Validation terminée, vous pouvez confirmer ✅
+     * - Si inégalité → Validation en cours, attendez encore (consultez à nouveau dans quelques secondes) ⏳
+     *
+     * La progression détaillée de chaque transaction se consulte via `GET /paiements?txId={txId}`.
+     *
+     * **Consultation des transactions individuelles :**
+     * Pour obtenir la liste détaillée des transactions (avec noms des bénéficiaires, codes d'erreur, etc.), utilisez :
+     * - Toutes les transactions : `GET /paiements?instructionId={instructionId}`
+     * - Seulement les rejetées : `GET /paiements?instructionId={instructionId}&statut=REJETE`
+     * - Seulement les réussies : `GET /paiements?instructionId={instructionId}&statut=IRREVOCABLE`
+     *
+     * @returns PaiementEnMasseReponseStatut Opération effectuée avec succès
+     * @throws ApiError
+     */
+    static paiementGroupeConsulter({ instructionId, }) {
+        return __request(OpenAPI, {
+            method: 'GET',
+            url: '/paiements-groupes/{instructionId}',
+            path: {
+                'instructionId': instructionId,
+            },
+            errors: {
+                401: `Autorisations manquantes`,
+                404: `La ressource n'existe pas dans le système`,
+                429: `Erreur inattendue`,
+                503: `Erreur inattendue du serveur`,
+            },
+        });
+    }
+    /**
+     * Confirmer le paiement en masse
+     * Ce point de terminaison permet de confirmer ou d'annuler un paiement en masse créé avec `confirmation: true`.
+     *
+     * **Processus de vérification :**
+     * 1. Après la création (`POST /paiements-groupes`), le participant valide asynchronement toutes les transactions (unicité des txId + recherche d'alias)
+     * 2. Les transactions invalides sont automatiquement rejetées (`statut: REJETE`) avec codes `BE23` (alias invalide) ou `DU03` (txId dupliqué)
+     * 3. Les transactions valides passent à l'état `INITIE` avec les noms et pays des bénéficiaires
+     * 4. Le business consulte via `GET /paiements-groupes/{instructionId}` pour vérifier la progression de la validation
+     * 5. **La validation est terminée quand** : `transactionsInitiees + transactionsRejetees = transactionsTotal`
+     * 6. Le business peut alors confirmer ou annuler
+     *
+     * **Important :** La confirmation n'est possible que lorsque la validation de toutes les transactions est terminée.
+     * Si le business tente de confirmer pendant que la validation est en cours, une erreur 403 sera retournée avec la progression actuelle.
+     *
+     * **Comportement de la confirmation :**
+     * - `decision: true` → Le système envoie **automatiquement SEULEMENT** les transactions avec `statut: INITIE`
+     * - Les transactions `REJETE` (erreurs de validation) sont **automatiquement exclues** (pas besoin de les lister)
+     * - Le statut du bulk passe de `INITIE` à `CONFIRME`
+     *
+     * **Idempotence** : Cet endpoint est idempotent.
+     * - Premier appel avec `decision: true` → Lance les paiements, retourne `200 OK {statut: "CONFIRME"}`
+     * - Appels suivants avec `decision: true` → Retourne `200 OK {statut: "CONFIRME"}` (idempotent, ne relance pas)
+     * - Premier appel avec `decision: false` → Annule, retourne `200 OK {statut: "ANNULE"}`
+     * - Appels suivants avec `decision: false` → Retourne `200 OK {statut: "ANNULE"}` (idempotent)
+     * - `decision: true` après `decision: false` → Retourne `403 Forbidden` (déjà annulé)
+     * - `decision: false` après `decision: true` → Retourne `403 Forbidden` (déjà confirmé)
+     *
+     * **Timeout adaptatif** : Le délai pour confirmer dépend automatiquement du nombre de transactions :
+     * - **1 à 500 transactions** : 24 heures
+     * - **501 à 1000 transactions** : 48 heures
+     * - **Plus de 1000 transactions** : 72 heures
+     *
+     * Passé ce délai, la demande expire automatiquement et ne peut plus être confirmée. Le délai exact est indiqué dans le champ `dateExpiration` retourné par `GET /paiements-groupes/{instructionId}`.
+     *
+     * **Changement de décision** : Une fois une décision prise, elle est définitive. Impossible de confirmer après avoir annulé, et vice-versa.
+     *
+     * @returns PaiementEnMasseReponseStatut Confirmation enregistrée avec succès.
+     * - Si `decision: true`, le statut passe à `CONFIRME` et les paiements sont lancés
+     * - Si `decision: false`, le statut passe à `ANNULE`
+     *
+     * @throws ApiError
+     */
+    static paiementGroupeConfirmer({ instructionId, requestBody, }) {
+        return __request(OpenAPI, {
+            method: 'PUT',
+            url: '/paiements-groupes/{instructionId}/confirmations',
+            path: {
+                'instructionId': instructionId,
+            },
+            body: requestBody,
+            mediaType: 'application/json',
+            errors: {
+                401: `Autorisations manquantes`,
+                403: `Opération interdite`,
+                404: `La ressource n'existe pas dans le système`,
+                429: `Erreur inattendue`,
+                503: `Erreur inattendue du serveur`,
+            },
+        });
+    }
+}