tupay 0.15.0 → 0.16.0

package/dist/cjs/resources/balance.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BalanceResource = void 0;
+/**
+ * Votre solde : ce que vous avez, et ce qui arrive.
+ *
+ * ```ts
+ * const solde = await tupay.balance.retrieve()
+ * solde.available.amountXpf   // encaissable, commission déduite
+ * solde.pending.amountXpf     // pas encore
+ * solde.nextAvailableAt       // quand la plus proche bascule
+ * ```
+ *
+ * Le solde n'a ni identifiant ni date de création : c'est un état
+ * instantané, pas un objet stocké. Ce sont les écritures qui en ont.
+ */
+class BalanceResource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    async retrieve() {
+        const { data } = await this.client.request({
+            method: 'GET',
+            path: '/balance',
+        });
+        return data;
+    }
+}
+exports.BalanceResource = BalanceResource;
+//# sourceMappingURL=balance.js.map

package/dist/cjs/resources/balance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"balance.js","sourceRoot":"","sources":["../../../src/resources/balance.ts"],"names":[],"mappings":";;;AAGA;;;;;;;;;;;;GAYG;AACH,MAAa,eAAe;IACG;IAA7B,YAA6B,MAAmB;QAAnB,WAAM,GAAN,MAAM,CAAa;IAAG,CAAC;IAEpD,KAAK,CAAC,QAAQ;QACZ,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAoB;YAC5D,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,UAAU;SACjB,CAAC,CAAA;QACF,OAAO,IAAI,CAAA;IACb,CAAC;CACF;AAVD,0CAUC"}

package/dist/cjs/resources/disputes.d.ts

@@ -0,0 +1,71 @@
+import { type ListParams } from '../liste.js';
+import { TupayClient } from '../client.js';
+import type { Dispute, DisputeEvidence, DisputeStatus, ListResult } from '../types.js';
+export interface ListDisputesParams extends ListParams {
+    status?: DisputeStatus;
+}
+export interface SubmitDisputeEvidenceParams {
+    /**
+     * Ce que vous affirmez, en texte libre (5 000 signes au plus).
+     * Décrivez la commande, la livraison, et vos échanges avec le client.
+     */
+    explanation: string;
+    /** Omise, le SDK génère un UUID v4 — la requête devient rejouable. */
+    idempotencyKey?: string;
+}
+/**
+ * Les contestations ouvertes par vos clients auprès de leur banque.
+ *
+ * ```ts
+ * const { data } = await tupay.disputes.list({ status: 'needs_response' })
+ * data[0].evidenceDueBy          // la date limite
+ * data[0].responseStillPossible  // est-il encore temps ?
+ * ```
+ *
+ * ⚠️ **Un litige non traité est perdu par défaut.** Pas rejeté, pas mis
+ * en attente : perdu, avec l'argent qui part. Branchez
+ * `dispute.created` et `dispute.reminder`.
+ *
+ * Aucune méthode pour en créer : un litige vient du réseau. En mode
+ * test, `POST /test/simulate` avec `disputeReason` en ouvre un.
+ *
+ * Ce que vous POUVEZ écrire, en revanche, c'est votre réponse :
+ * `submitEvidence()`. C'est la seule chose d'un litige qui vous
+ * appartienne.
+ */
+export declare class Disputes {
+    private readonly client;
+    constructor(client: TupayClient);
+    retrieve(id: string): Promise<Dispute>;
+    list(params?: ListDisputesParams): Promise<ListResult<Dispute>>;
+    /**
+     * Répond à un litige, et le fait passer en examen.
+     *
+     * ```ts
+     * const preuve = await tupay.disputes.submitEvidence(dp.id, {
+     *   explanation: 'Commande livrée le 12/09, signée par le client.',
+     * })
+     * preuve.dispute.status   // 'under_review'
+     * ```
+     *
+     * ⚠️ **Avant `evidenceDueBy`, jamais après.** Passée la date limite,
+     * l'appel rend `409` et cite la date : le litige est perdu par défaut,
+     * et le réseau n'accepte plus rien.
+     *
+     * Vous pouvez soumettre plusieurs fois tant que l'échéance n'est pas
+     * passée : chaque appel AJOUTE au journal, il n'écrase pas le
+     * précédent.
+     */
+    submitEvidence(id: string, params: SubmitDisputeEvidenceParams): Promise<DisputeEvidence & {
+        dispute: Dispute;
+    }>;
+    /**
+     * Ce que vous avez transmis sur ce litige, le plus récent d'abord.
+     *
+     * Rien ne s'y écrase : vous relisez exactement ce qui est parti, et
+     * quand. Un litige sans réponse rend une liste vide ; un litige qui
+     * n'existe pas lève une erreur `404`.
+     */
+    listEvidence(id: string, params?: ListParams): Promise<ListResult<DisputeEvidence>>;
+}
+//# sourceMappingURL=disputes.d.ts.map

package/dist/cjs/resources/disputes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"disputes.d.ts","sourceRoot":"","sources":["../../../src/resources/disputes.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,UAAU,EAChB,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAC1C,OAAO,KAAK,EACV,OAAO,EACP,eAAe,EACf,aAAa,EACb,UAAU,EACX,MAAM,aAAa,CAAA;AAEpB,MAAM,WAAW,kBAAmB,SAAQ,UAAU;IACpD,MAAM,CAAC,EAAE,aAAa,CAAA;CACvB;AAED,MAAM,WAAW,2BAA2B;IAC1C;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAA;IACnB,sEAAsE;IACtE,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,QAAQ;IACP,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,WAAW;IAE1C,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAQtC,IAAI,CAAC,MAAM,GAAE,kBAAuB,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IAUzE;;;;;;;;;;;;;;;;;OAiBG;IACG,cAAc,CAClB,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,2BAA2B,GAClC,OAAO,CAAC,eAAe,GAAG;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAalD;;;;;;OAMG;IACG,YAAY,CAChB,EAAE,EAAE,MAAM,EACV,MAAM,GAAE,UAAe,GACtB,OAAO,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC;CASxC"}

package/dist/cjs/resources/disputes.js

@@ -0,0 +1,89 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Disputes = void 0;
+const liste_js_1 = require("../liste.js");
+const client_js_1 = require("../client.js");
+/**
+ * Les contestations ouvertes par vos clients auprès de leur banque.
+ *
+ * ```ts
+ * const { data } = await tupay.disputes.list({ status: 'needs_response' })
+ * data[0].evidenceDueBy          // la date limite
+ * data[0].responseStillPossible  // est-il encore temps ?
+ * ```
+ *
+ * ⚠️ **Un litige non traité est perdu par défaut.** Pas rejeté, pas mis
+ * en attente : perdu, avec l'argent qui part. Branchez
+ * `dispute.created` et `dispute.reminder`.
+ *
+ * Aucune méthode pour en créer : un litige vient du réseau. En mode
+ * test, `POST /test/simulate` avec `disputeReason` en ouvre un.
+ *
+ * Ce que vous POUVEZ écrire, en revanche, c'est votre réponse :
+ * `submitEvidence()`. C'est la seule chose d'un litige qui vous
+ * appartienne.
+ */
+class Disputes {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    async retrieve(id) {
+        const { data } = await this.client.request({
+            method: 'GET',
+            path: `/disputes/${encodeURIComponent(id)}`,
+        });
+        return data;
+    }
+    async list(params = {}) {
+        return (0, liste_js_1.normaliserListe)(await this.client.request({
+            method: 'GET',
+            path: '/disputes',
+            query: { ...(0, liste_js_1.parametresListe)(params), status: params.status },
+        }));
+    }
+    /**
+     * Répond à un litige, et le fait passer en examen.
+     *
+     * ```ts
+     * const preuve = await tupay.disputes.submitEvidence(dp.id, {
+     *   explanation: 'Commande livrée le 12/09, signée par le client.',
+     * })
+     * preuve.dispute.status   // 'under_review'
+     * ```
+     *
+     * ⚠️ **Avant `evidenceDueBy`, jamais après.** Passée la date limite,
+     * l'appel rend `409` et cite la date : le litige est perdu par défaut,
+     * et le réseau n'accepte plus rien.
+     *
+     * Vous pouvez soumettre plusieurs fois tant que l'échéance n'est pas
+     * passée : chaque appel AJOUTE au journal, il n'écrase pas le
+     * précédent.
+     */
+    async submitEvidence(id, params) {
+        const { idempotencyKey, ...body } = params;
+        const { data } = await this.client.request({
+            method: 'POST',
+            path: `/disputes/${encodeURIComponent(id)}/evidence`,
+            body,
+            idempotencyKey: idempotencyKey ?? client_js_1.TupayClient.idempotencyKey(),
+        });
+        return data;
+    }
+    /**
+     * Ce que vous avez transmis sur ce litige, le plus récent d'abord.
+     *
+     * Rien ne s'y écrase : vous relisez exactement ce qui est parti, et
+     * quand. Un litige sans réponse rend une liste vide ; un litige qui
+     * n'existe pas lève une erreur `404`.
+     */
+    async listEvidence(id, params = {}) {
+        return (0, liste_js_1.normaliserListe)(await this.client.request({
+            method: 'GET',
+            path: `/disputes/${encodeURIComponent(id)}/evidence`,
+            query: (0, liste_js_1.parametresListe)(params),
+        }));
+    }
+}
+exports.Disputes = Disputes;
+//# sourceMappingURL=disputes.js.map

package/dist/cjs/resources/disputes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"disputes.js","sourceRoot":"","sources":["../../../src/resources/disputes.ts"],"names":[],"mappings":";;;AAAA,0CAKoB;AACpB,4CAA0C;AAsB1C;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAa,QAAQ;IACU;IAA7B,YAA6B,MAAmB;QAAnB,WAAM,GAAN,MAAM,CAAa;IAAG,CAAC;IAEpD,KAAK,CAAC,QAAQ,CAAC,EAAU;QACvB,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAoB;YAC5D,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,aAAa,kBAAkB,CAAC,EAAE,CAAC,EAAE;SAC5C,CAAC,CAAA;QACF,OAAO,IAAI,CAAA;IACb,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,SAA6B,EAAE;QACxC,OAAO,IAAA,0BAAe,EACpB,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAsB;YAC7C,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,WAAW;YACjB,KAAK,EAAE,EAAE,GAAG,IAAA,0BAAe,EAAC,MAAM,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE;SAC7D,CAAC,CACH,CAAA;IACH,CAAC;IAED;;;;;;;;;;;;;;;;;OAiBG;IACH,KAAK,CAAC,cAAc,CAClB,EAAU,EACV,MAAmC;QAEnC,MAAM,EAAE,cAAc,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAA;QAC1C,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAEvC;YACD,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,aAAa,kBAAkB,CAAC,EAAE,CAAC,WAAW;YACpD,IAAI;YACJ,cAAc,EAAE,cAAc,IAAI,uBAAW,CAAC,cAAc,EAAE;SAC/D,CAAC,CAAA;QACF,OAAO,IAAI,CAAA;IACb,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,YAAY,CAChB,EAAU,EACV,SAAqB,EAAE;QAEvB,OAAO,IAAA,0BAAe,EACpB,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAA8B;YACrD,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,aAAa,kBAAkB,CAAC,EAAE,CAAC,WAAW;YACpD,KAAK,EAAE,IAAA,0BAAe,EAAC,MAAM,CAAC;SAC/B,CAAC,CACH,CAAA;IACH,CAAC;CACF;AA1ED,4BA0EC"}

package/dist/cjs/resources/payment-intents.d.ts

@@ -40,6 +40,36 @@ export interface CreatePaymentIntentParams {
      */
     offSession?: boolean;
     metadata?: Record<string, string>;
+    /**
+     * **Encaisser pour un compte connecté** — `<uuid>` ou `acct_<uuid>`.
+     *
+     * Le paiement appartient alors au VENDEUR : son solde, ses écritures,
+     * ses virements, ses litiges. Vous n'êtes que celle qui a passé
+     * l'appel.
+     *
+     * ⚠️ En mode **live**, un compte dont la vérification d'activité n'est
+     * pas validée lève une erreur `account_not_ready`, dont `requirement`
+     * nomme ce qui manque. En mode test rien n'est bridé — branchez tout
+     * votre parcours avant d'avoir fait valider votre premier vendeur.
+     */
+    onBehalfOf?: string;
+    /**
+     * **La commission que vous prélevez** sur ce paiement, en francs
+     * entiers. Exige `onBehalfOf`.
+     *
+     * Le net va au vendeur, la commission à vous, et deux écritures
+     * distinctes sont créées — une dans chaque journal de solde.
+     *
+     * ⚠️ Refusée si elle dépasse le montant, et refusée aussi si,
+     * **commission Tupay déduite**, elle laisserait votre vendeur en
+     * négatif. La seconde règle est plus stricte : notre commission se
+     * prélève aussi, et vous ne connaissez pas le barème de votre vendeur.
+     *
+     * ⚠️ **Elle n'est pas rendue sur un remboursement.** Même règle que
+     * la commission Tupay : elle paie un apport d'affaires, et l'affaire
+     * a eu lieu.
+     */
+    applicationFeeXpf?: number;
     /**
      * Clé d'idempotence. Omise, le SDK en génère une (UUID v4) : la requête
      * devient rejouable sans risque de double débit. Fournissez la vôtre si

package/dist/cjs/resources/payment-intents.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"payment-intents.d.ts","sourceRoot":"","sources":["../../../src/resources/payment-intents.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAC1C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAEhD,MAAM,WAAW,yBAAyB;IACxC,2CAA2C;IAC3C,SAAS,EAAE,MAAM,CAAA;IACjB;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;;;;;;;;;OASG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACjC;;;;;OAKG;IACH,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,qBAAa,cAAc;IACb,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,WAAW;IAE1C,MAAM,CAAC,MAAM,EAAE,yBAAyB,GAAG,OAAO,CAAC,aAAa,CAAC;CAUxE"}
+{"version":3,"file":"payment-intents.d.ts","sourceRoot":"","sources":["../../../src/resources/payment-intents.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAC1C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAEhD,MAAM,WAAW,yBAAyB;IACxC,2CAA2C;IAC3C,SAAS,EAAE,MAAM,CAAA;IACjB;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;;;;;;;;;OASG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACjC;;;;;;;;;;;OAWG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB;;;;;;;;;;;;;;;OAeG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B;;;;;OAKG;IACH,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,qBAAa,cAAc;IACb,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,WAAW;IAE1C,MAAM,CAAC,MAAM,EAAE,yBAAyB,GAAG,OAAO,CAAC,aAAa,CAAC;CAUxE"}

package/dist/cjs/resources/payment-intents.js.map

@@ -1 +1 @@
-{"version":3,"file":"payment-intents.js","sourceRoot":"","sources":["../../../src/resources/payment-intents.ts"],"names":[],"mappings":";;;AAAA,4CAA0C;AAoD1C,MAAa,cAAc;IACI;IAA7B,YAA6B,MAAmB;QAAnB,WAAM,GAAN,MAAM,CAAa;IAAG,CAAC;IAEpD,KAAK,CAAC,MAAM,CAAC,MAAiC;QAC5C,MAAM,EAAE,cAAc,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAA;QAC1C,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAA0B;YAClE,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,kBAAkB;YACxB,IAAI;YACJ,cAAc,EAAE,cAAc,IAAI,uBAAW,CAAC,cAAc,EAAE;SAC/D,CAAC,CAAA;QACF,OAAO,IAAI,CAAA;IACb,CAAC;CACF;AAbD,wCAaC"}
+{"version":3,"file":"payment-intents.js","sourceRoot":"","sources":["../../../src/resources/payment-intents.ts"],"names":[],"mappings":";;;AAAA,4CAA0C;AAkF1C,MAAa,cAAc;IACI;IAA7B,YAA6B,MAAmB;QAAnB,WAAM,GAAN,MAAM,CAAa;IAAG,CAAC;IAEpD,KAAK,CAAC,MAAM,CAAC,MAAiC;QAC5C,MAAM,EAAE,cAAc,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAA;QAC1C,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAA0B;YAClE,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,kBAAkB;YACxB,IAAI;YACJ,cAAc,EAAE,cAAc,IAAI,uBAAW,CAAC,cAAc,EAAE;SAC/D,CAAC,CAAA;QACF,OAAO,IAAI,CAAA;IACb,CAAC;CACF;AAbD,wCAaC"}

package/dist/cjs/resources/payouts.d.ts

@@ -0,0 +1,53 @@
+import type { TupayClient } from '../client.js';
+import { type ListParams } from '../liste.js';
+import type { ListResult, Payout, PayoutStatus } from '../types.js';
+export interface ListPayoutsParams extends ListParams {
+    /** N'obtenir que les virements dans cet état. */
+    status?: PayoutStatus;
+}
+/**
+ * Vos virements vers votre compte bancaire.
+ *
+ * ```ts
+ * const { data } = await tupay.payouts.list({ status: 'failed' })
+ * data[0].failureMessage   // la cause, en français
+ * ```
+ *
+ * ⚠️ **Aucun virement n'est émis aujourd'hui** : Tupay n'a pas encore
+ * de prestataire capable de transférer des fonds. La liste est vide, et
+ * c'est la vérité — pas une panne.
+ *
+ * Un virement **débite votre solde à l'émission**, pas à l'arrivée.
+ * S'il échoue, les fonds reviennent : une seconde écriture les rend,
+ * sans effacer la première.
+ *
+ * Aucune méthode pour en créer : un virement part du calendrier, pas
+ * d'un appel.
+ */
+export declare class Payouts {
+    private readonly client;
+    constructor(client: TupayClient);
+    retrieve(id: string): Promise<Payout>;
+    /**
+     * Le détail d'un virement, en **CSV** : le fichier que vous posez à
+     * côté de votre relevé bancaire.
+     *
+     * ```ts
+     * const csv = await tupay.payouts.export(virement.id)
+     * ```
+     *
+     * Une ligne par écriture, puis deux lignes de contrôle — le TOTAL des
+     * écritures et le montant VIRÉ. S'ils ne coïncident pas, le fichier
+     * est incomplet.
+     *
+     * BOM UTF-8 et séparateur `;` : Excel en français l'ouvre sans
+     * assistant d'importation. Montants en francs entiers, sans
+     * séparateur de milliers — c'est ce qu'un tableur sait additionner.
+     *
+     * Les mêmes lignes en JSON :
+     * `balanceTransactions.list({ payout: id })`.
+     */
+    export(id: string): Promise<string>;
+    list(params?: ListPayoutsParams): Promise<ListResult<Payout>>;
+}
+//# sourceMappingURL=payouts.d.ts.map

package/dist/cjs/resources/payouts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payouts.d.ts","sourceRoot":"","sources":["../../../src/resources/payouts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAC/C,OAAO,EAIL,KAAK,UAAU,EAChB,MAAM,aAAa,CAAA;AACpB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAEnE,MAAM,WAAW,iBAAkB,SAAQ,UAAU;IACnD,iDAAiD;IACjD,MAAM,CAAC,EAAE,YAAY,CAAA;CACtB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,OAAO;IACN,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,WAAW;IAE1C,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAQ3C;;;;;;;;;;;;;;;;;;OAkBG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IASnC,IAAI,CAAC,MAAM,GAAE,iBAAsB,GAAG,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;CASxE"}

package/dist/cjs/resources/payouts.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Payouts = void 0;
+const liste_js_1 = require("../liste.js");
+/**
+ * Vos virements vers votre compte bancaire.
+ *
+ * ```ts
+ * const { data } = await tupay.payouts.list({ status: 'failed' })
+ * data[0].failureMessage   // la cause, en français
+ * ```
+ *
+ * ⚠️ **Aucun virement n'est émis aujourd'hui** : Tupay n'a pas encore
+ * de prestataire capable de transférer des fonds. La liste est vide, et
+ * c'est la vérité — pas une panne.
+ *
+ * Un virement **débite votre solde à l'émission**, pas à l'arrivée.
+ * S'il échoue, les fonds reviennent : une seconde écriture les rend,
+ * sans effacer la première.
+ *
+ * Aucune méthode pour en créer : un virement part du calendrier, pas
+ * d'un appel.
+ */
+class Payouts {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    async retrieve(id) {
+        const { data } = await this.client.request({
+            method: 'GET',
+            path: `/payouts/${encodeURIComponent(id)}`,
+        });
+        return data;
+    }
+    /**
+     * Le détail d'un virement, en **CSV** : le fichier que vous posez à
+     * côté de votre relevé bancaire.
+     *
+     * ```ts
+     * const csv = await tupay.payouts.export(virement.id)
+     * ```
+     *
+     * Une ligne par écriture, puis deux lignes de contrôle — le TOTAL des
+     * écritures et le montant VIRÉ. S'ils ne coïncident pas, le fichier
+     * est incomplet.
+     *
+     * BOM UTF-8 et séparateur `;` : Excel en français l'ouvre sans
+     * assistant d'importation. Montants en francs entiers, sans
+     * séparateur de milliers — c'est ce qu'un tableur sait additionner.
+     *
+     * Les mêmes lignes en JSON :
+     * `balanceTransactions.list({ payout: id })`.
+     */
+    async export(id) {
+        return this.client.request({
+            method: 'GET',
+            path: `/payouts/${encodeURIComponent(id)}/export`,
+            raw: true,
+            accept: 'text/csv',
+        });
+    }
+    async list(params = {}) {
+        return (0, liste_js_1.normaliserListe)(await this.client.request({
+            method: 'GET',
+            path: '/payouts',
+            query: { ...(0, liste_js_1.parametresListe)(params), status: params.status },
+        }));
+    }
+}
+exports.Payouts = Payouts;
+//# sourceMappingURL=payouts.js.map

package/dist/cjs/resources/payouts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payouts.js","sourceRoot":"","sources":["../../../src/resources/payouts.ts"],"names":[],"mappings":";;;AACA,0CAKoB;AAQpB;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAa,OAAO;IACW;IAA7B,YAA6B,MAAmB;QAAnB,WAAM,GAAN,MAAM,CAAa;IAAG,CAAC;IAEpD,KAAK,CAAC,QAAQ,CAAC,EAAU;QACvB,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAmB;YAC3D,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,YAAY,kBAAkB,CAAC,EAAE,CAAC,EAAE;SAC3C,CAAC,CAAA;QACF,OAAO,IAAI,CAAA;IACb,CAAC;IAED;;;;;;;;;;;;;;;;;;OAkBG;IACH,KAAK,CAAC,MAAM,CAAC,EAAU;QACrB,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAS;YACjC,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,YAAY,kBAAkB,CAAC,EAAE,CAAC,SAAS;YACjD,GAAG,EAAE,IAAI;YACT,MAAM,EAAE,UAAU;SACnB,CAAC,CAAA;IACJ,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,SAA4B,EAAE;QACvC,OAAO,IAAA,0BAAe,EACpB,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAqB;YAC5C,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,UAAU;YAChB,KAAK,EAAE,EAAE,GAAG,IAAA,0BAAe,EAAC,MAAM,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE;SAC7D,CAAC,CACH,CAAA;IACH,CAAC;CACF;AAhDD,0BAgDC"}

package/dist/cjs/types.d.ts

@@ -426,6 +426,265 @@ export interface InvoicePaymentAttempt extends Invoice {
         failureMessage: string | null;
     };
 }
+/** Les régimes de TGC de Polynésie française. */
+export type TgcRate = 'exempt' | '5' | '10' | '16';
+/** Ce qui manque à un compte connecté pour servir. */
+export type AccountRequirement = 'kyb.validation' | 'bank_account.iban_xpf';
+/**
+ * Un vendeur hébergé par une plateforme (Connect).
+ *
+ * **C'est un marchand à part entière** : son solde, ses écritures, ses
+ * virements et ses litiges sont les mêmes objets que ceux de n'importe
+ * quel compte.
+ */
+export interface Account {
+    id: string;
+    object: 'account';
+    /** Secondes Unix. */
+    created: number;
+    name: string;
+    email: string;
+    /** La plateforme qui héberge ce compte — vous. */
+    platformId: string;
+    /**
+     * `true` quand ce compte peut encaisser **en mode live**. En mode
+     * test, rien n'est bridé quelle que soit sa valeur.
+     */
+    chargesEnabled: boolean;
+    /** `true` quand un virement peut partir vers ce compte. */
+    payoutsEnabled: boolean;
+    /**
+     * Ce qui manque, dans l'ordre où il faut le traiter.
+     *
+     * ⚠️ Rendu **même quand `chargesEnabled` est vrai** : il peut rester
+     * une exigence de virement alors que l'encaissement est déjà ouvert.
+     */
+    requirements: AccountRequirement[];
+    /** La phrase française de chaque exigence, dans le même ordre. */
+    requirementsDescriptions: string[];
+    livemode: boolean;
+    /** @deprecated Lisez `created`. */
+    createdAt: string;
+}
+export type DisputeStatus = 'needs_response' | 'under_review' | 'won' | 'lost';
+/**
+ * Une contestation de paiement par le porteur.
+ *
+ * **Le montant, le motif et la date limite viennent du réseau** : ils ne
+ * se réécrivent pas.
+ */
+export interface Dispute {
+    id: string;
+    object: 'dispute';
+    /** Secondes Unix. Même instant que `createdAt`. */
+    created: number;
+    status: DisputeStatus;
+    /** Le paiement contesté. Développable — `expand[]=transaction`. */
+    transactionId: string;
+    transaction?: Transaction;
+    /**
+     * Ce qui est contesté, en francs entiers. Peut être **inférieur** au
+     * paiement : un porteur conteste parfois une partie de sa commande.
+     */
+    amountXpf: number;
+    currency: 'XPF';
+    /**
+     * Le motif tel que le réseau le qualifie, **non traduit** : le
+     * traduire ferait perdre le terme que vous retrouverez dans la lettre
+     * de votre banque.
+     */
+    reason: string;
+    /**
+     * Secondes Unix : la **date limite de réponse**.
+     *
+     * ⚠️ Passée, le litige est perdu par défaut. C'est le champ le plus
+     * important de cet objet.
+     */
+    evidenceDueBy: number;
+    /** `true` tant qu'il est encore temps de répondre. */
+    responseStillPossible: boolean;
+    /**
+     * Secondes Unix de votre **dernière** soumission de preuves, `null` si
+     * vous n'avez rien transmis. Le détail de ce qui est parti se lit par
+     * `disputes.listEvidence(id)` — ce champ n'en est que la date.
+     */
+    evidenceSubmittedAt: number | null;
+    livemode: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * Une soumission de preuves sur un litige.
+ *
+ * **Elle ne se réécrit pas** : pour compléter votre réponse, soumettez-en
+ * une autre, le journal conserve les deux. C'est pour ça qu'il n'y a ni
+ * `updatedAt` ni `createdAt` ici — le premier promettrait une révision
+ * qui n'existe pas, le second est déprécié partout ailleurs.
+ */
+export interface DisputeEvidence {
+    id: string;
+    object: 'dispute_evidence';
+    /** Secondes Unix de la soumission. */
+    created: number;
+    /** Le litige auquel cette preuve répond. */
+    disputeId: string;
+    /** Ce que vous avez affirmé, tel que vous l'avez écrit. */
+    explanation: string;
+    livemode: boolean;
+}
+export type PayoutStatus = 'pending' | 'in_transit' | 'paid' | 'failed';
+/**
+ * Un ordre de versement vers votre compte bancaire.
+ *
+ * Le montant, la destination et la date d'arrivée sont **figés** à
+ * l'émission.
+ */
+export interface Payout {
+    id: string;
+    object: 'payout';
+    /** Secondes Unix. Même instant que `createdAt`. */
+    created: number;
+    status: PayoutStatus;
+    /** Ce qui part, en francs entiers. **Toujours positif.** */
+    amountXpf: number;
+    currency: 'XPF';
+    /**
+     * Les **quatre derniers** caractères de votre IBAN, et rien d'autre.
+     * Assez pour reconnaître le compte ; pas assez pour que nos journaux
+     * portent vos coordonnées bancaires.
+     */
+    destinationLast4: string | null;
+    /**
+     * Secondes Unix : l'arrivée **estimée**, figée à l'émission.
+     * Distincte de `created` — l'ordre part un jour, l'argent arrive un
+     * autre.
+     */
+    arrivalEstimate: number;
+    /** Code machine de l'échec. `null` si tout va bien. */
+    failureCode: string | null;
+    /** Le même échec, en français, à montrer tel quel. */
+    failureMessage: string | null;
+    livemode: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+export type BalanceTransactionType = 'payment' | 'refund' | 'fee' | 'payout' | 'dispute' | 'adjustment'
+/** La commission qu'une plateforme a gagnée sur la vente d'un tiers. */
+ | 'application_fee';
+/**
+ * Une ligne du journal de votre solde.
+ *
+ * **Immuable** : elle naît d'un mouvement réel et ne se corrige qu'en
+ * écrivant un ajustement.
+ */
+export interface BalanceTransaction {
+    id: string;
+    object: 'balance_transaction';
+    /** Secondes Unix. Même instant que `createdAt`. */
+    created: number;
+    /**
+     * Numéro séquentiel par compte, par mode et par année, **sans
+     * rupture**. Une ligne manquante laisse un trou visible.
+     */
+    sequence: number;
+    type: BalanceTransactionType;
+    /** Le paiement à l'origine. Développable — `expand[]=transaction`. */
+    transactionId: string | null;
+    transaction?: Transaction;
+    refundId: string | null;
+    refund?: Refund;
+    /** Le virement à l'origine. Développable — `expand[]=payout`. */
+    payoutId: string | null;
+    payout?: Payout;
+    /** Ce que le client a payé, **TTC**. **Négatif** sur un remboursement. */
+    grossXpf: number;
+    /** Notre commission. **Zéro** sur un remboursement : elle n'est pas rendue. */
+    feeXpf: number;
+    /**
+     * Part allée à la **plateforme**, sur un paiement encaissé pour un
+     * compte connecté. Zéro partout ailleurs.
+     *
+     * Séparée de `feeXpf` à dessein : fondues, vous liriez un montant de
+     * frais sans pouvoir dire ce qui est allé à Tupay et ce qui est allé
+     * à votre plateforme.
+     */
+    applicationFeeXpf: number;
+    /**
+     * La vente **d'un autre marchand** qui a produit cette écriture — le
+     * paiement de votre vendeur, vu depuis votre journal. Renseignée
+     * uniquement sur `type: application_fee`.
+     */
+    sourceTransactionId: string | null;
+    /** `grossXpf − feeXpf − applicationFeeXpf`. C'est lui qui rejoint votre solde. */
+    netXpf: number;
+    /** La TGC transportée, de même signe que le brut. **Indicative**. */
+    tgcXpf: number;
+    /** Le taux **figé** au moment de l'écriture. */
+    tgcRate: 'exempt' | '5' | '10' | '16';
+    /** « TGC 10 % incluse : 4 091 XPF », ou l'exonération. */
+    tgcLabel: string;
+    /** Le barème appliqué, **figé**. 250 = 2,5 %. */
+    feeBps: number;
+    feeFixedXpf: number;
+    /** Secondes Unix : quand ce montant bascule en `available`. Figée. */
+    availableAt: number;
+    currency: 'XPF';
+    livemode: boolean;
+    createdAt: string;
+}
+/** Une part du solde — disponible, ou en attente. */
+export interface PartDeSolde {
+    /** Ce qui vous revient, **commission déduite**, en francs entiers. */
+    amountXpf: number;
+    /**
+     * La TGC contenue dans `amountXpf`.
+     *
+     * ⚠️ **Indication, pas déclaration.** Tupay applique le taux déclaré
+     * sur votre compte ; si vous vendez à plusieurs taux, ce chiffre ne
+     * peut pas être exact.
+     */
+    tgcXpf: number;
+    /** `amountXpf − tgcXpf` — ce qui reste une fois la taxe réservée. */
+    netOfTgcXpf: number;
+    /** Nombre d'écritures dans cette part. */
+    count: number;
+}
+/**
+ * Le solde, à l'instant de l'appel.
+ *
+ * Ni `id` ni `created` : c'est un état instantané, la somme de vos
+ * écritures, pas un objet stocké.
+ */
+export interface Balance {
+    object: 'balance';
+    available: PartDeSolde;
+    pending: PartDeSolde;
+    /**
+     * Secondes Unix : quand la plus proche écriture en attente bascule.
+     * `null` quand rien n'est en attente.
+     */
+    nextAvailableAt: number | null;
+    currency: 'XPF';
+    livemode: boolean;
+}
+/**
+ * Le solde d'un de vos vendeurs (Connect).
+ *
+ * Le même objet que votre propre solde, avec deux champs de plus : de
+ * QUI il est, et s'il peut partir.
+ */
+export interface AccountBalance extends Balance {
+    /** Le compte dont ce solde est le solde. */
+    account: string;
+    /**
+     * `true` quand un virement peut partir vers ce compte. Exige la
+     * validation **et** des coordonnées bancaires.
+     *
+     * Rendu ici parce que c'est la question qui suit immédiatement
+     * « combien a-t-il ? ».
+     */
+    payoutsEnabled: boolean;
+}
 export interface Invoice {
     id: string;
     object: 'invoice';