tupay 0.15.0 → 0.17.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (73) hide show
  1. package/dist/cjs/client.d.ts +16 -0
  2. package/dist/cjs/client.d.ts.map +1 -1
  3. package/dist/cjs/client.js +4 -0
  4. package/dist/cjs/client.js.map +1 -1
  5. package/dist/cjs/index.d.ts +40 -0
  6. package/dist/cjs/index.d.ts.map +1 -1
  7. package/dist/cjs/index.js +53 -1
  8. package/dist/cjs/index.js.map +1 -1
  9. package/dist/cjs/resources/accounts.d.ts +94 -0
  10. package/dist/cjs/resources/accounts.d.ts.map +1 -0
  11. package/dist/cjs/resources/accounts.js +106 -0
  12. package/dist/cjs/resources/accounts.js.map +1 -0
  13. package/dist/cjs/resources/balance-transactions.d.ts +44 -0
  14. package/dist/cjs/resources/balance-transactions.d.ts.map +1 -0
  15. package/dist/cjs/resources/balance-transactions.js +40 -0
  16. package/dist/cjs/resources/balance-transactions.js.map +1 -0
  17. package/dist/cjs/resources/balance.d.ts +21 -0
  18. package/dist/cjs/resources/balance.d.ts.map +1 -0
  19. package/dist/cjs/resources/balance.js +31 -0
  20. package/dist/cjs/resources/balance.js.map +1 -0
  21. package/dist/cjs/resources/disputes.d.ts +71 -0
  22. package/dist/cjs/resources/disputes.d.ts.map +1 -0
  23. package/dist/cjs/resources/disputes.js +89 -0
  24. package/dist/cjs/resources/disputes.js.map +1 -0
  25. package/dist/cjs/resources/payment-intents.d.ts +30 -0
  26. package/dist/cjs/resources/payment-intents.d.ts.map +1 -1
  27. package/dist/cjs/resources/payment-intents.js.map +1 -1
  28. package/dist/cjs/resources/payouts.d.ts +53 -0
  29. package/dist/cjs/resources/payouts.d.ts.map +1 -0
  30. package/dist/cjs/resources/payouts.js +72 -0
  31. package/dist/cjs/resources/payouts.js.map +1 -0
  32. package/dist/cjs/types.d.ts +259 -0
  33. package/dist/cjs/types.d.ts.map +1 -1
  34. package/dist/cjs/webhooks.d.ts.map +1 -1
  35. package/dist/cjs/webhooks.js +14 -9
  36. package/dist/cjs/webhooks.js.map +1 -1
  37. package/dist/esm/client.d.ts +16 -0
  38. package/dist/esm/client.d.ts.map +1 -1
  39. package/dist/esm/client.js +4 -0
  40. package/dist/esm/client.js.map +1 -1
  41. package/dist/esm/index.d.ts +40 -0
  42. package/dist/esm/index.d.ts.map +1 -1
  43. package/dist/esm/index.js +47 -0
  44. package/dist/esm/index.js.map +1 -1
  45. package/dist/esm/resources/accounts.d.ts +94 -0
  46. package/dist/esm/resources/accounts.d.ts.map +1 -0
  47. package/dist/esm/resources/accounts.js +102 -0
  48. package/dist/esm/resources/accounts.js.map +1 -0
  49. package/dist/esm/resources/balance-transactions.d.ts +44 -0
  50. package/dist/esm/resources/balance-transactions.d.ts.map +1 -0
  51. package/dist/esm/resources/balance-transactions.js +36 -0
  52. package/dist/esm/resources/balance-transactions.js.map +1 -0
  53. package/dist/esm/resources/balance.d.ts +21 -0
  54. package/dist/esm/resources/balance.d.ts.map +1 -0
  55. package/dist/esm/resources/balance.js +27 -0
  56. package/dist/esm/resources/balance.js.map +1 -0
  57. package/dist/esm/resources/disputes.d.ts +71 -0
  58. package/dist/esm/resources/disputes.d.ts.map +1 -0
  59. package/dist/esm/resources/disputes.js +85 -0
  60. package/dist/esm/resources/disputes.js.map +1 -0
  61. package/dist/esm/resources/payment-intents.d.ts +30 -0
  62. package/dist/esm/resources/payment-intents.d.ts.map +1 -1
  63. package/dist/esm/resources/payment-intents.js.map +1 -1
  64. package/dist/esm/resources/payouts.d.ts +53 -0
  65. package/dist/esm/resources/payouts.d.ts.map +1 -0
  66. package/dist/esm/resources/payouts.js +68 -0
  67. package/dist/esm/resources/payouts.js.map +1 -0
  68. package/dist/esm/types.d.ts +259 -0
  69. package/dist/esm/types.d.ts.map +1 -1
  70. package/dist/esm/webhooks.d.ts.map +1 -1
  71. package/dist/esm/webhooks.js +14 -9
  72. package/dist/esm/webhooks.js.map +1 -1
  73. package/package.json +1 -1
@@ -0,0 +1,44 @@
1
+ import type { TupayClient } from '../client.js';
2
+ import { type ListParams } from '../liste.js';
3
+ import type { BalanceTransaction, BalanceTransactionType, ListResult } from '../types.js';
4
+ export interface ListBalanceTransactionsParams extends ListParams {
5
+ /** N'obtenir qu'un type de mouvement. */
6
+ type?: BalanceTransactionType;
7
+ /**
8
+ * `true` pour ce qui est encaissable, `false` pour ce qui attend.
9
+ *
10
+ * La bascule est une comparaison de dates, pas un statut : rien n'a
11
+ * besoin de tourner pour qu'elle ait lieu.
12
+ */
13
+ available?: boolean;
14
+ /**
15
+ * N'obtenir que les écritures **soldées par ce virement** — de quoi
16
+ * il est composé. Leur somme vaut son montant.
17
+ *
18
+ * À ne pas confondre avec `payoutId` sur une écriture, qui désigne la
19
+ * ligne de **contrepartie** du virement.
20
+ */
21
+ payout?: string;
22
+ }
23
+ /**
24
+ * Le journal de votre solde : une ligne par mouvement.
25
+ *
26
+ * ```ts
27
+ * const { data } = await tupay.balanceTransactions.list({ available: false })
28
+ * data[0].grossXpf // ce que le client a payé
29
+ * data[0].feeXpf // notre commission
30
+ * data[0].netXpf // ce qui rejoint votre solde
31
+ * ```
32
+ *
33
+ * La somme des `netXpf` est exactement votre solde.
34
+ *
35
+ * ⚠️ **Aucune méthode pour créer, modifier ou supprimer.** Ce n'est pas
36
+ * un oubli : une écriture comptable est immuable. Une correction s'écrit
37
+ * en ajustement, une ligne de plus qui laisse la première visible.
38
+ */
39
+ export declare class BalanceTransactions {
40
+ private readonly client;
41
+ constructor(client: TupayClient);
42
+ list(params?: ListBalanceTransactionsParams): Promise<ListResult<BalanceTransaction>>;
43
+ }
44
+ //# sourceMappingURL=balance-transactions.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"balance-transactions.d.ts","sourceRoot":"","sources":["../../../src/resources/balance-transactions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAC/C,OAAO,EAAqD,KAAK,UAAU,EAAE,MAAM,aAAa,CAAA;AAChG,OAAO,KAAK,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAEzF,MAAM,WAAW,6BAA8B,SAAQ,UAAU;IAC/D,yCAAyC;IACzC,IAAI,CAAC,EAAE,sBAAsB,CAAA;IAC7B;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,mBAAmB;IAClB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,WAAW;IAE1C,IAAI,CACR,MAAM,GAAE,6BAAkC,GACzC,OAAO,CAAC,UAAU,CAAC,kBAAkB,CAAC,CAAC;CAc3C"}
@@ -0,0 +1,36 @@
1
+ import { normaliserListe, parametresListe } from '../liste.js';
2
+ /**
3
+ * Le journal de votre solde : une ligne par mouvement.
4
+ *
5
+ * ```ts
6
+ * const { data } = await tupay.balanceTransactions.list({ available: false })
7
+ * data[0].grossXpf // ce que le client a payé
8
+ * data[0].feeXpf // notre commission
9
+ * data[0].netXpf // ce qui rejoint votre solde
10
+ * ```
11
+ *
12
+ * La somme des `netXpf` est exactement votre solde.
13
+ *
14
+ * ⚠️ **Aucune méthode pour créer, modifier ou supprimer.** Ce n'est pas
15
+ * un oubli : une écriture comptable est immuable. Une correction s'écrit
16
+ * en ajustement, une ligne de plus qui laisse la première visible.
17
+ */
18
+ export class BalanceTransactions {
19
+ client;
20
+ constructor(client) {
21
+ this.client = client;
22
+ }
23
+ async list(params = {}) {
24
+ return normaliserListe(await this.client.request({
25
+ method: 'GET',
26
+ path: '/balance-transactions',
27
+ query: {
28
+ ...parametresListe(params),
29
+ type: params.type,
30
+ available: params.available,
31
+ payout: params.payout,
32
+ },
33
+ }));
34
+ }
35
+ }
36
+ //# sourceMappingURL=balance-transactions.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"balance-transactions.js","sourceRoot":"","sources":["../../../src/resources/balance-transactions.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,eAAe,EAAoC,MAAM,aAAa,CAAA;AAuBhG;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAO,mBAAmB;IACD;IAA7B,YAA6B,MAAmB;QAAnB,WAAM,GAAN,MAAM,CAAa;IAAG,CAAC;IAEpD,KAAK,CAAC,IAAI,CACR,SAAwC,EAAE;QAE1C,OAAO,eAAe,CACpB,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAiC;YACxD,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,uBAAuB;YAC7B,KAAK,EAAE;gBACL,GAAG,eAAe,CAAC,MAAM,CAAC;gBAC1B,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,SAAS,EAAE,MAAM,CAAC,SAAS;gBAC3B,MAAM,EAAE,MAAM,CAAC,MAAM;aACtB;SACF,CAAC,CACH,CAAA;IACH,CAAC;CACF"}
@@ -0,0 +1,21 @@
1
+ import type { TupayClient } from '../client.js';
2
+ import type { Balance } from '../types.js';
3
+ /**
4
+ * Votre solde : ce que vous avez, et ce qui arrive.
5
+ *
6
+ * ```ts
7
+ * const solde = await tupay.balance.retrieve()
8
+ * solde.available.amountXpf // encaissable, commission déduite
9
+ * solde.pending.amountXpf // pas encore
10
+ * solde.nextAvailableAt // quand la plus proche bascule
11
+ * ```
12
+ *
13
+ * Le solde n'a ni identifiant ni date de création : c'est un état
14
+ * instantané, pas un objet stocké. Ce sont les écritures qui en ont.
15
+ */
16
+ export declare class BalanceResource {
17
+ private readonly client;
18
+ constructor(client: TupayClient);
19
+ retrieve(): Promise<Balance>;
20
+ }
21
+ //# sourceMappingURL=balance.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"balance.d.ts","sourceRoot":"","sources":["../../../src/resources/balance.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAC/C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAE1C;;;;;;;;;;;;GAYG;AACH,qBAAa,eAAe;IACd,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,WAAW;IAE1C,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC;CAOnC"}
@@ -0,0 +1,27 @@
1
+ /**
2
+ * Votre solde : ce que vous avez, et ce qui arrive.
3
+ *
4
+ * ```ts
5
+ * const solde = await tupay.balance.retrieve()
6
+ * solde.available.amountXpf // encaissable, commission déduite
7
+ * solde.pending.amountXpf // pas encore
8
+ * solde.nextAvailableAt // quand la plus proche bascule
9
+ * ```
10
+ *
11
+ * Le solde n'a ni identifiant ni date de création : c'est un état
12
+ * instantané, pas un objet stocké. Ce sont les écritures qui en ont.
13
+ */
14
+ export class BalanceResource {
15
+ client;
16
+ constructor(client) {
17
+ this.client = client;
18
+ }
19
+ async retrieve() {
20
+ const { data } = await this.client.request({
21
+ method: 'GET',
22
+ path: '/balance',
23
+ });
24
+ return data;
25
+ }
26
+ }
27
+ //# sourceMappingURL=balance.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"balance.js","sourceRoot":"","sources":["../../../src/resources/balance.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,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"}
@@ -0,0 +1,71 @@
1
+ import { type ListParams } from '../liste.js';
2
+ import { TupayClient } from '../client.js';
3
+ import type { Dispute, DisputeEvidence, DisputeStatus, ListResult } from '../types.js';
4
+ export interface ListDisputesParams extends ListParams {
5
+ status?: DisputeStatus;
6
+ }
7
+ export interface SubmitDisputeEvidenceParams {
8
+ /**
9
+ * Ce que vous affirmez, en texte libre (5 000 signes au plus).
10
+ * Décrivez la commande, la livraison, et vos échanges avec le client.
11
+ */
12
+ explanation: string;
13
+ /** Omise, le SDK génère un UUID v4 — la requête devient rejouable. */
14
+ idempotencyKey?: string;
15
+ }
16
+ /**
17
+ * Les contestations ouvertes par vos clients auprès de leur banque.
18
+ *
19
+ * ```ts
20
+ * const { data } = await tupay.disputes.list({ status: 'needs_response' })
21
+ * data[0].evidenceDueBy // la date limite
22
+ * data[0].responseStillPossible // est-il encore temps ?
23
+ * ```
24
+ *
25
+ * ⚠️ **Un litige non traité est perdu par défaut.** Pas rejeté, pas mis
26
+ * en attente : perdu, avec l'argent qui part. Branchez
27
+ * `dispute.created` et `dispute.reminder`.
28
+ *
29
+ * Aucune méthode pour en créer : un litige vient du réseau. En mode
30
+ * test, `POST /test/simulate` avec `disputeReason` en ouvre un.
31
+ *
32
+ * Ce que vous POUVEZ écrire, en revanche, c'est votre réponse :
33
+ * `submitEvidence()`. C'est la seule chose d'un litige qui vous
34
+ * appartienne.
35
+ */
36
+ export declare class Disputes {
37
+ private readonly client;
38
+ constructor(client: TupayClient);
39
+ retrieve(id: string): Promise<Dispute>;
40
+ list(params?: ListDisputesParams): Promise<ListResult<Dispute>>;
41
+ /**
42
+ * Répond à un litige, et le fait passer en examen.
43
+ *
44
+ * ```ts
45
+ * const preuve = await tupay.disputes.submitEvidence(dp.id, {
46
+ * explanation: 'Commande livrée le 12/09, signée par le client.',
47
+ * })
48
+ * preuve.dispute.status // 'under_review'
49
+ * ```
50
+ *
51
+ * ⚠️ **Avant `evidenceDueBy`, jamais après.** Passée la date limite,
52
+ * l'appel rend `409` et cite la date : le litige est perdu par défaut,
53
+ * et le réseau n'accepte plus rien.
54
+ *
55
+ * Vous pouvez soumettre plusieurs fois tant que l'échéance n'est pas
56
+ * passée : chaque appel AJOUTE au journal, il n'écrase pas le
57
+ * précédent.
58
+ */
59
+ submitEvidence(id: string, params: SubmitDisputeEvidenceParams): Promise<DisputeEvidence & {
60
+ dispute: Dispute;
61
+ }>;
62
+ /**
63
+ * Ce que vous avez transmis sur ce litige, le plus récent d'abord.
64
+ *
65
+ * Rien ne s'y écrase : vous relisez exactement ce qui est parti, et
66
+ * quand. Un litige sans réponse rend une liste vide ; un litige qui
67
+ * n'existe pas lève une erreur `404`.
68
+ */
69
+ listEvidence(id: string, params?: ListParams): Promise<ListResult<DisputeEvidence>>;
70
+ }
71
+ //# sourceMappingURL=disputes.d.ts.map
@@ -0,0 +1 @@
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"}
@@ -0,0 +1,85 @@
1
+ import { normaliserListe, parametresListe, } from '../liste.js';
2
+ import { TupayClient } from '../client.js';
3
+ /**
4
+ * Les contestations ouvertes par vos clients auprès de leur banque.
5
+ *
6
+ * ```ts
7
+ * const { data } = await tupay.disputes.list({ status: 'needs_response' })
8
+ * data[0].evidenceDueBy // la date limite
9
+ * data[0].responseStillPossible // est-il encore temps ?
10
+ * ```
11
+ *
12
+ * ⚠️ **Un litige non traité est perdu par défaut.** Pas rejeté, pas mis
13
+ * en attente : perdu, avec l'argent qui part. Branchez
14
+ * `dispute.created` et `dispute.reminder`.
15
+ *
16
+ * Aucune méthode pour en créer : un litige vient du réseau. En mode
17
+ * test, `POST /test/simulate` avec `disputeReason` en ouvre un.
18
+ *
19
+ * Ce que vous POUVEZ écrire, en revanche, c'est votre réponse :
20
+ * `submitEvidence()`. C'est la seule chose d'un litige qui vous
21
+ * appartienne.
22
+ */
23
+ export class Disputes {
24
+ client;
25
+ constructor(client) {
26
+ this.client = client;
27
+ }
28
+ async retrieve(id) {
29
+ const { data } = await this.client.request({
30
+ method: 'GET',
31
+ path: `/disputes/${encodeURIComponent(id)}`,
32
+ });
33
+ return data;
34
+ }
35
+ async list(params = {}) {
36
+ return normaliserListe(await this.client.request({
37
+ method: 'GET',
38
+ path: '/disputes',
39
+ query: { ...parametresListe(params), status: params.status },
40
+ }));
41
+ }
42
+ /**
43
+ * Répond à un litige, et le fait passer en examen.
44
+ *
45
+ * ```ts
46
+ * const preuve = await tupay.disputes.submitEvidence(dp.id, {
47
+ * explanation: 'Commande livrée le 12/09, signée par le client.',
48
+ * })
49
+ * preuve.dispute.status // 'under_review'
50
+ * ```
51
+ *
52
+ * ⚠️ **Avant `evidenceDueBy`, jamais après.** Passée la date limite,
53
+ * l'appel rend `409` et cite la date : le litige est perdu par défaut,
54
+ * et le réseau n'accepte plus rien.
55
+ *
56
+ * Vous pouvez soumettre plusieurs fois tant que l'échéance n'est pas
57
+ * passée : chaque appel AJOUTE au journal, il n'écrase pas le
58
+ * précédent.
59
+ */
60
+ async submitEvidence(id, params) {
61
+ const { idempotencyKey, ...body } = params;
62
+ const { data } = await this.client.request({
63
+ method: 'POST',
64
+ path: `/disputes/${encodeURIComponent(id)}/evidence`,
65
+ body,
66
+ idempotencyKey: idempotencyKey ?? TupayClient.idempotencyKey(),
67
+ });
68
+ return data;
69
+ }
70
+ /**
71
+ * Ce que vous avez transmis sur ce litige, le plus récent d'abord.
72
+ *
73
+ * Rien ne s'y écrase : vous relisez exactement ce qui est parti, et
74
+ * quand. Un litige sans réponse rend une liste vide ; un litige qui
75
+ * n'existe pas lève une erreur `404`.
76
+ */
77
+ async listEvidence(id, params = {}) {
78
+ return normaliserListe(await this.client.request({
79
+ method: 'GET',
80
+ path: `/disputes/${encodeURIComponent(id)}/evidence`,
81
+ query: parametresListe(params),
82
+ }));
83
+ }
84
+ }
85
+ //# sourceMappingURL=disputes.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"disputes.js","sourceRoot":"","sources":["../../../src/resources/disputes.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,eAAe,GAGhB,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAsB1C;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,OAAO,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,eAAe,CACpB,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAsB;YAC7C,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,WAAW;YACjB,KAAK,EAAE,EAAE,GAAG,eAAe,CAAC,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,WAAW,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,eAAe,CACpB,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAA8B;YACrD,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,aAAa,kBAAkB,CAAC,EAAE,CAAC,WAAW;YACpD,KAAK,EAAE,eAAe,CAAC,MAAM,CAAC;SAC/B,CAAC,CACH,CAAA;IACH,CAAC;CACF"}
@@ -40,6 +40,36 @@ export interface CreatePaymentIntentParams {
40
40
  */
41
41
  offSession?: boolean;
42
42
  metadata?: Record<string, string>;
43
+ /**
44
+ * **Encaisser pour un compte connecté** — `<uuid>` ou `acct_<uuid>`.
45
+ *
46
+ * Le paiement appartient alors au VENDEUR : son solde, ses écritures,
47
+ * ses virements, ses litiges. Vous n'êtes que celle qui a passé
48
+ * l'appel.
49
+ *
50
+ * ⚠️ En mode **live**, un compte dont la vérification d'activité n'est
51
+ * pas validée lève une erreur `account_not_ready`, dont `requirement`
52
+ * nomme ce qui manque. En mode test rien n'est bridé — branchez tout
53
+ * votre parcours avant d'avoir fait valider votre premier vendeur.
54
+ */
55
+ onBehalfOf?: string;
56
+ /**
57
+ * **La commission que vous prélevez** sur ce paiement, en francs
58
+ * entiers. Exige `onBehalfOf`.
59
+ *
60
+ * Le net va au vendeur, la commission à vous, et deux écritures
61
+ * distinctes sont créées — une dans chaque journal de solde.
62
+ *
63
+ * ⚠️ Refusée si elle dépasse le montant, et refusée aussi si,
64
+ * **commission Tupay déduite**, elle laisserait votre vendeur en
65
+ * négatif. La seconde règle est plus stricte : notre commission se
66
+ * prélève aussi, et vous ne connaissez pas le barème de votre vendeur.
67
+ *
68
+ * ⚠️ **Elle n'est pas rendue sur un remboursement.** Même règle que
69
+ * la commission Tupay : elle paie un apport d'affaires, et l'affaire
70
+ * a eu lieu.
71
+ */
72
+ applicationFeeXpf?: number;
43
73
  /**
44
74
  * Clé d'idempotence. Omise, le SDK en génère une (UUID v4) : la requête
45
75
  * devient rejouable sans risque de double débit. Fournissez la vôtre si
@@ -1 +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"}
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;;;;;;;;;;;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"}
@@ -1 +1 @@
1
- {"version":3,"file":"payment-intents.js","sourceRoot":"","sources":["../../../src/resources/payment-intents.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAoD1C,MAAM,OAAO,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,WAAW,CAAC,cAAc,EAAE;SAC/D,CAAC,CAAA;QACF,OAAO,IAAI,CAAA;IACb,CAAC;CACF"}
1
+ {"version":3,"file":"payment-intents.js","sourceRoot":"","sources":["../../../src/resources/payment-intents.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAkF1C,MAAM,OAAO,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,WAAW,CAAC,cAAc,EAAE;SAC/D,CAAC,CAAA;QACF,OAAO,IAAI,CAAA;IACb,CAAC;CACF"}
@@ -0,0 +1,53 @@
1
+ import type { TupayClient } from '../client.js';
2
+ import { type ListParams } from '../liste.js';
3
+ import type { ListResult, Payout, PayoutStatus } from '../types.js';
4
+ export interface ListPayoutsParams extends ListParams {
5
+ /** N'obtenir que les virements dans cet état. */
6
+ status?: PayoutStatus;
7
+ }
8
+ /**
9
+ * Vos virements vers votre compte bancaire.
10
+ *
11
+ * ```ts
12
+ * const { data } = await tupay.payouts.list({ status: 'failed' })
13
+ * data[0].failureMessage // la cause, en français
14
+ * ```
15
+ *
16
+ * ⚠️ **Aucun virement n'est émis aujourd'hui** : Tupay n'a pas encore
17
+ * de prestataire capable de transférer des fonds. La liste est vide, et
18
+ * c'est la vérité — pas une panne.
19
+ *
20
+ * Un virement **débite votre solde à l'émission**, pas à l'arrivée.
21
+ * S'il échoue, les fonds reviennent : une seconde écriture les rend,
22
+ * sans effacer la première.
23
+ *
24
+ * Aucune méthode pour en créer : un virement part du calendrier, pas
25
+ * d'un appel.
26
+ */
27
+ export declare class Payouts {
28
+ private readonly client;
29
+ constructor(client: TupayClient);
30
+ retrieve(id: string): Promise<Payout>;
31
+ /**
32
+ * Le détail d'un virement, en **CSV** : le fichier que vous posez à
33
+ * côté de votre relevé bancaire.
34
+ *
35
+ * ```ts
36
+ * const csv = await tupay.payouts.export(virement.id)
37
+ * ```
38
+ *
39
+ * Une ligne par écriture, puis deux lignes de contrôle — le TOTAL des
40
+ * écritures et le montant VIRÉ. S'ils ne coïncident pas, le fichier
41
+ * est incomplet.
42
+ *
43
+ * BOM UTF-8 et séparateur `;` : Excel en français l'ouvre sans
44
+ * assistant d'importation. Montants en francs entiers, sans
45
+ * séparateur de milliers — c'est ce qu'un tableur sait additionner.
46
+ *
47
+ * Les mêmes lignes en JSON :
48
+ * `balanceTransactions.list({ payout: id })`.
49
+ */
50
+ export(id: string): Promise<string>;
51
+ list(params?: ListPayoutsParams): Promise<ListResult<Payout>>;
52
+ }
53
+ //# sourceMappingURL=payouts.d.ts.map
@@ -0,0 +1 @@
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"}
@@ -0,0 +1,68 @@
1
+ import { normaliserListe, parametresListe, } from '../liste.js';
2
+ /**
3
+ * Vos virements vers votre compte bancaire.
4
+ *
5
+ * ```ts
6
+ * const { data } = await tupay.payouts.list({ status: 'failed' })
7
+ * data[0].failureMessage // la cause, en français
8
+ * ```
9
+ *
10
+ * ⚠️ **Aucun virement n'est émis aujourd'hui** : Tupay n'a pas encore
11
+ * de prestataire capable de transférer des fonds. La liste est vide, et
12
+ * c'est la vérité — pas une panne.
13
+ *
14
+ * Un virement **débite votre solde à l'émission**, pas à l'arrivée.
15
+ * S'il échoue, les fonds reviennent : une seconde écriture les rend,
16
+ * sans effacer la première.
17
+ *
18
+ * Aucune méthode pour en créer : un virement part du calendrier, pas
19
+ * d'un appel.
20
+ */
21
+ export class Payouts {
22
+ client;
23
+ constructor(client) {
24
+ this.client = client;
25
+ }
26
+ async retrieve(id) {
27
+ const { data } = await this.client.request({
28
+ method: 'GET',
29
+ path: `/payouts/${encodeURIComponent(id)}`,
30
+ });
31
+ return data;
32
+ }
33
+ /**
34
+ * Le détail d'un virement, en **CSV** : le fichier que vous posez à
35
+ * côté de votre relevé bancaire.
36
+ *
37
+ * ```ts
38
+ * const csv = await tupay.payouts.export(virement.id)
39
+ * ```
40
+ *
41
+ * Une ligne par écriture, puis deux lignes de contrôle — le TOTAL des
42
+ * écritures et le montant VIRÉ. S'ils ne coïncident pas, le fichier
43
+ * est incomplet.
44
+ *
45
+ * BOM UTF-8 et séparateur `;` : Excel en français l'ouvre sans
46
+ * assistant d'importation. Montants en francs entiers, sans
47
+ * séparateur de milliers — c'est ce qu'un tableur sait additionner.
48
+ *
49
+ * Les mêmes lignes en JSON :
50
+ * `balanceTransactions.list({ payout: id })`.
51
+ */
52
+ async export(id) {
53
+ return this.client.request({
54
+ method: 'GET',
55
+ path: `/payouts/${encodeURIComponent(id)}/export`,
56
+ raw: true,
57
+ accept: 'text/csv',
58
+ });
59
+ }
60
+ async list(params = {}) {
61
+ return normaliserListe(await this.client.request({
62
+ method: 'GET',
63
+ path: '/payouts',
64
+ query: { ...parametresListe(params), status: params.status },
65
+ }));
66
+ }
67
+ }
68
+ //# sourceMappingURL=payouts.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"payouts.js","sourceRoot":"","sources":["../../../src/resources/payouts.ts"],"names":[],"mappings":"AACA,OAAO,EACL,eAAe,EACf,eAAe,GAGhB,MAAM,aAAa,CAAA;AAQpB;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,OAAO,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,eAAe,CACpB,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAqB;YAC5C,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,UAAU;YAChB,KAAK,EAAE,EAAE,GAAG,eAAe,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE;SAC7D,CAAC,CACH,CAAA;IACH,CAAC;CACF"}