@fantastic.dev/better-stripe 0.20.1 → 0.21.0

package/dist/component/payoutRelease/schema.d.ts

@@ -73,6 +73,10 @@ export declare const claimFields: {
     attemptedAt: import("convex/values").VFloat64<number | undefined, "optional">;
     stripePayoutId: import("convex/values").VString<string | undefined, "optional">;
     returnTransactionId: import("convex/values").VString<string | undefined, "optional">;
+    feeRevision: import("convex/values").VFloat64<number | undefined, "optional">;
+    debitTransactionId: import("convex/values").VString<string | undefined, "optional">;
+    debitFee: import("convex/values").VFloat64<number | undefined, "optional">;
+    providerFee: import("convex/values").VFloat64<number | undefined, "optional">;
     rejection: import("convex/values").VObject<{
         code: "amount_too_small" | "balance_insufficient";
         requestId: string;
@@ -93,7 +97,10 @@ export declare const claimDoc: import("convex/values").VObject<{
     amount: number;
     attemptedAt?: number | undefined;
     currency: string;
+    debitFee?: number | undefined;
+    debitTransactionId?: string | undefined;
     expectedRevision: number;
+    feeRevision?: number | undefined;
     observations: {
         currency: string;
         ledgerFingerprint: string;
@@ -105,6 +112,7 @@ export declare const claimDoc: import("convex/values").VObject<{
     }[];
     operationKey: string;
     ownerKey: string;
+    providerFee?: number | undefined;
     rejection?: {
         code: "amount_too_small" | "balance_insufficient";
         requestId: string;
@@ -161,6 +169,10 @@ export declare const claimDoc: import("convex/values").VObject<{
     attemptedAt: import("convex/values").VFloat64<number | undefined, "optional">;
     stripePayoutId: import("convex/values").VString<string | undefined, "optional">;
     returnTransactionId: import("convex/values").VString<string | undefined, "optional">;
+    feeRevision: import("convex/values").VFloat64<number | undefined, "optional">;
+    debitTransactionId: import("convex/values").VString<string | undefined, "optional">;
+    debitFee: import("convex/values").VFloat64<number | undefined, "optional">;
+    providerFee: import("convex/values").VFloat64<number | undefined, "optional">;
     rejection: import("convex/values").VObject<{
         code: "amount_too_small" | "balance_insufficient";
         requestId: string;
@@ -170,7 +182,7 @@ export declare const claimDoc: import("convex/values").VObject<{
     }, "optional", "code" | "requestId">;
     _id: import("convex/values").VId<import("convex/values").GenericId<"payoutReleaseClaims">, "required">;
     _creationTime: import("convex/values").VFloat64<number, "required">;
-}, "required", "_creationTime" | "_id" | "accountId" | "allocations" | "amount" | "attemptedAt" | "currency" | "expectedRevision" | "observations" | "operationKey" | "ownerKey" | "rejection" | "rejection.code" | "rejection.requestId" | "returnTransactionId" | "status" | "stripePayoutId">;
+}, "required", "_creationTime" | "_id" | "accountId" | "allocations" | "amount" | "attemptedAt" | "currency" | "debitFee" | "debitTransactionId" | "expectedRevision" | "feeRevision" | "observations" | "operationKey" | "ownerKey" | "providerFee" | "rejection" | "rejection.code" | "rejection.requestId" | "returnTransactionId" | "status" | "stripePayoutId">;
 export declare const claimsTable: import("convex/server").TableDefinition<import("convex/values").VObject<{
     accountId: string;
     allocations: {
@@ -181,7 +193,10 @@ export declare const claimsTable: import("convex/server").TableDefinition<import
     amount: number;
     attemptedAt?: number | undefined;
     currency: string;
+    debitFee?: number | undefined;
+    debitTransactionId?: string | undefined;
     expectedRevision: number;
+    feeRevision?: number | undefined;
     observations: {
         currency: string;
         ledgerFingerprint: string;
@@ -193,6 +208,7 @@ export declare const claimsTable: import("convex/server").TableDefinition<import
     }[];
     operationKey: string;
     ownerKey: string;
+    providerFee?: number | undefined;
     rejection?: {
         code: "amount_too_small" | "balance_insufficient";
         requestId: string;
@@ -249,6 +265,10 @@ export declare const claimsTable: import("convex/server").TableDefinition<import
     attemptedAt: import("convex/values").VFloat64<number | undefined, "optional">;
     stripePayoutId: import("convex/values").VString<string | undefined, "optional">;
     returnTransactionId: import("convex/values").VString<string | undefined, "optional">;
+    feeRevision: import("convex/values").VFloat64<number | undefined, "optional">;
+    debitTransactionId: import("convex/values").VString<string | undefined, "optional">;
+    debitFee: import("convex/values").VFloat64<number | undefined, "optional">;
+    providerFee: import("convex/values").VFloat64<number | undefined, "optional">;
     rejection: import("convex/values").VObject<{
         code: "amount_too_small" | "balance_insufficient";
         requestId: string;
@@ -256,8 +276,9 @@ export declare const claimsTable: import("convex/server").TableDefinition<import
         requestId: import("convex/values").VString<string, "required">;
         code: import("convex/values").VUnion<"amount_too_small" | "balance_insufficient", [import("convex/values").VLiteral<"balance_insufficient", "required">, import("convex/values").VLiteral<"amount_too_small", "required">], "required", never>;
     }, "optional", "code" | "requestId">;
-}, "required", "accountId" | "allocations" | "amount" | "attemptedAt" | "currency" | "expectedRevision" | "observations" | "operationKey" | "ownerKey" | "rejection" | "rejection.code" | "rejection.requestId" | "returnTransactionId" | "status" | "stripePayoutId">, {
+}, "required", "accountId" | "allocations" | "amount" | "attemptedAt" | "currency" | "debitFee" | "debitTransactionId" | "expectedRevision" | "feeRevision" | "observations" | "operationKey" | "ownerKey" | "providerFee" | "rejection" | "rejection.code" | "rejection.requestId" | "returnTransactionId" | "status" | "stripePayoutId">, {
     by_account_status: ["accountId", "status", "_creationTime"];
+    by_debit_receipt: ["debitTransactionId", "_creationTime"];
     by_operation: ["operationKey", "_creationTime"];
     by_provider_payout: ["stripePayoutId", "_creationTime"];
     by_rejection_request: ["rejection.requestId", "_creationTime"];
@@ -286,4 +307,19 @@ export declare const identity: {
     ownerKey: import("convex/values").VString<string, "required">;
     operationKey: import("convex/values").VString<string, "required">;
 };
+export declare const feeBalancesTable: import("convex/server").TableDefinition<import("convex/values").VObject<{
+    accountId: string;
+    amount: number;
+    currency: string;
+    ownerKey: string;
+    revision: number;
+}, {
+    accountId: import("convex/values").VString<string, "required">;
+    ownerKey: import("convex/values").VString<string, "required">;
+    currency: import("convex/values").VString<string, "required">;
+    amount: import("convex/values").VFloat64<number, "required">;
+    revision: import("convex/values").VFloat64<number, "required">;
+}, "required", "accountId" | "amount" | "currency" | "ownerKey" | "revision">, {
+    by_account_currency: ["accountId", "currency", "_creationTime"];
+}, {}, {}>;
 //# sourceMappingURL=schema.d.ts.map

package/dist/component/payoutRelease/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/component/payoutRelease/schema.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;wIAQtB,CAAC;AACH,eAAO,MAAM,UAAU;;;;;;;;sDAMrB,CAAC;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4BvB,CAAC;AACF,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gSAInB,CAAC;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UAKiC,CAAC;AAC1D,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;UAQY,CAAC;AACtC,eAAO,MAAM,QAAQ;;;;CAA+C,CAAC"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/component/payoutRelease/schema.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;wIAQtB,CAAC;AACH,eAAO,MAAM,UAAU;;;;;;;;sDAMrB,CAAC;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgCvB,CAAC;AACF,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oWAInB,CAAC;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UAMiC,CAAC;AAC1D,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;UAQY,CAAC;AACtC,eAAO,MAAM,QAAQ;;;;CAA+C,CAAC;AAErE,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;UAK6B,CAAC"}

package/dist/component/payoutRelease/schema.js

@@ -27,6 +27,10 @@ export const claimFields = {
     attemptedAt: v.optional(v.number()),
     stripePayoutId: v.optional(v.string()),
     returnTransactionId: v.optional(v.string()),
+    feeRevision: v.optional(v.number()),
+    debitTransactionId: v.optional(v.string()),
+    debitFee: v.optional(v.number()),
+    providerFee: v.optional(v.number()),
     rejection: v.optional(v.object({
         requestId: v.string(),
         code: v.union(v.literal("balance_insufficient"), v.literal("amount_too_small")),
@@ -41,6 +45,7 @@ export const claimsTable = defineTable(claimFields)
     .index("by_operation", ["operationKey"])
     .index("by_account_status", ["accountId", "status"])
     .index("by_provider_payout", ["stripePayoutId"])
+    .index("by_debit_receipt", ["debitTransactionId"])
     .index("by_return_receipt", ["returnTransactionId"])
     .index("by_rejection_request", ["rejection.requestId"]);
 export const sourcesTable = defineTable({
@@ -53,4 +58,10 @@ export const sourcesTable = defineTable({
     .index("by_transfer", ["stripeTransferId"])
     .index("by_account", ["accountId"]);
 export const identity = { ...scopeFields, operationKey: v.string() };
+export const feeBalancesTable = defineTable({
+    ...scopeFields,
+    currency: v.string(),
+    amount: v.number(),
+    revision: v.number(),
+}).index("by_account_currency", ["accountId", "currency"]);
 //# sourceMappingURL=schema.js.map

package/dist/component/payoutRelease/schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/component/payoutRelease/schema.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/component/payoutRelease/schema.ts"],"names":[],"mappings":"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"}

package/dist/component/schema.d.ts

@@ -1,4 +1,19 @@
 declare const _default: import("convex/server").SchemaDefinition<{
+    payoutFeeBalances: import("convex/server").TableDefinition<import("convex/values").VObject<{
+        accountId: string;
+        amount: number;
+        currency: string;
+        ownerKey: string;
+        revision: number;
+    }, {
+        accountId: import("convex/values").VString<string, "required">;
+        ownerKey: import("convex/values").VString<string, "required">;
+        currency: import("convex/values").VString<string, "required">;
+        amount: import("convex/values").VFloat64<number, "required">;
+        revision: import("convex/values").VFloat64<number, "required">;
+    }, "required", "accountId" | "amount" | "currency" | "ownerKey" | "revision">, {
+        by_account_currency: ["accountId", "currency", "_creationTime"];
+    }, {}, {}>;
     payoutReleaseClaims: import("convex/server").TableDefinition<import("convex/values").VObject<{
         accountId: string;
         allocations: {
@@ -9,7 +24,10 @@ declare const _default: import("convex/server").SchemaDefinition<{
         amount: number;
         attemptedAt?: number | undefined;
         currency: string;
+        debitFee?: number | undefined;
+        debitTransactionId?: string | undefined;
         expectedRevision: number;
+        feeRevision?: number | undefined;
         observations: {
             currency: string;
             ledgerFingerprint: string;
@@ -21,6 +39,7 @@ declare const _default: import("convex/server").SchemaDefinition<{
         }[];
         operationKey: string;
         ownerKey: string;
+        providerFee?: number | undefined;
         rejection?: {
             code: "amount_too_small" | "balance_insufficient";
             requestId: string;
@@ -77,6 +96,10 @@ declare const _default: import("convex/server").SchemaDefinition<{
         attemptedAt: import("convex/values").VFloat64<number | undefined, "optional">;
         stripePayoutId: import("convex/values").VString<string | undefined, "optional">;
         returnTransactionId: import("convex/values").VString<string | undefined, "optional">;
+        feeRevision: import("convex/values").VFloat64<number | undefined, "optional">;
+        debitTransactionId: import("convex/values").VString<string | undefined, "optional">;
+        debitFee: import("convex/values").VFloat64<number | undefined, "optional">;
+        providerFee: import("convex/values").VFloat64<number | undefined, "optional">;
         rejection: import("convex/values").VObject<{
             code: "amount_too_small" | "balance_insufficient";
             requestId: string;
@@ -84,8 +107,9 @@ declare const _default: import("convex/server").SchemaDefinition<{
             requestId: import("convex/values").VString<string, "required">;
             code: import("convex/values").VUnion<"amount_too_small" | "balance_insufficient", [import("convex/values").VLiteral<"balance_insufficient", "required">, import("convex/values").VLiteral<"amount_too_small", "required">], "required", never>;
         }, "optional", "code" | "requestId">;
-    }, "required", "accountId" | "allocations" | "amount" | "attemptedAt" | "currency" | "expectedRevision" | "observations" | "operationKey" | "ownerKey" | "rejection" | "rejection.code" | "rejection.requestId" | "returnTransactionId" | "status" | "stripePayoutId">, {
+    }, "required", "accountId" | "allocations" | "amount" | "attemptedAt" | "currency" | "debitFee" | "debitTransactionId" | "expectedRevision" | "feeRevision" | "observations" | "operationKey" | "ownerKey" | "providerFee" | "rejection" | "rejection.code" | "rejection.requestId" | "returnTransactionId" | "status" | "stripePayoutId">, {
         by_account_status: ["accountId", "status", "_creationTime"];
+        by_debit_receipt: ["debitTransactionId", "_creationTime"];
         by_operation: ["operationKey", "_creationTime"];
         by_provider_payout: ["stripePayoutId", "_creationTime"];
         by_rejection_request: ["rejection.requestId", "_creationTime"];

package/dist/component/schema.js

@@ -1,4 +1,4 @@
-import { claimsTable as payoutReleaseClaimsTable, sourcesTable as payoutSourceAllocationsTable, } from "./payoutRelease/schema.js";
+import { feeBalancesTable as payoutFeeBalancesTable, claimsTable as payoutReleaseClaimsTable, sourcesTable as payoutSourceAllocationsTable, } from "./payoutRelease/schema.js";
 import { policiesTable, operationsTable } from "./payoutPolicy/schema.js";
 import { currencyTotalsTable } from "./earnings/schema.js";
 import { claimsTable, balancesTable, groupsTable, reservationsTable, } from "./costRecovery/schema";
@@ -10,6 +10,7 @@ import { accountsTable } from "./core/schema";
 import { pricesTable, productsTable } from "./products/schema";
 import { webhookEventsTable } from "./webhooks/schema";
 export default defineSchema({
+    payoutFeeBalances: payoutFeeBalancesTable,
     payoutReleaseClaims: payoutReleaseClaimsTable,
     payoutSourceAllocations: payoutSourceAllocationsTable,
     payoutPolicies: policiesTable,

package/dist/component/schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/component/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,IAAI,wBAAwB,EACvC,YAAY,IAAI,4BAA4B,GAC7C,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC1E,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EACL,WAAW,EACX,aAAa,EACb,WAAW,EACX,iBAAiB,GAClB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,wBAAwB,GACzB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,OAAO,EACL,qBAAqB,EACrB,aAAa,EACb,kBAAkB,GACnB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,aAAa,EACb,aAAa,EACb,YAAY,EACZ,sBAAsB,EACtB,YAAY,EACZ,wBAAwB,EACxB,cAAc,GACf,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD,eAAe,YAAY,CAAC;IAC1B,mBAAmB,EAAE,wBAAwB;IAC7C,uBAAuB,EAAE,4BAA4B;IACrD,cAAc,EAAE,aAAa;IAC7B,sBAAsB,EAAE,eAAe;IACvC,cAAc,EAAE,mBAAmB;IACnC,cAAc,EAAE,WAAW;IAC3B,gBAAgB,EAAE,aAAa;IAC/B,cAAc,EAAE,WAAW;IAC3B,oBAAoB,EAAE,iBAAiB;IACvC,qBAAqB,EAAE,gBAAgB;IACvC,eAAe,EAAE,oBAAoB;IACrC,mBAAmB,EAAE,wBAAwB;IAC7C,OAAO;IACP,QAAQ,EAAE,aAAa;IAEvB,WAAW;IACX,QAAQ,EAAE,aAAa;IACvB,MAAM,EAAE,WAAW;IAEnB,UAAU;IACV,aAAa,EAAE,kBAAkB;IACjC,gBAAgB,EAAE,qBAAqB;IACvC,QAAQ,EAAE,aAAa;IAEvB,UAAU;IACV,QAAQ,EAAE,aAAa;IACvB,OAAO,EAAE,YAAY;IACrB,iBAAiB,EAAE,sBAAsB;IACzC,OAAO,EAAE,YAAY;IACrB,QAAQ,EAAE,aAAa;IACvB,SAAS,EAAE,cAAc;IACzB,mBAAmB,EAAE,wBAAwB;IAE7C,WAAW;IACX,aAAa,EAAE,kBAAkB;CAClC,CAAC,CAAC"}
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/component/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,IAAI,sBAAsB,EAC1C,WAAW,IAAI,wBAAwB,EACvC,YAAY,IAAI,4BAA4B,GAC7C,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC1E,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EACL,WAAW,EACX,aAAa,EACb,WAAW,EACX,iBAAiB,GAClB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,wBAAwB,GACzB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,OAAO,EACL,qBAAqB,EACrB,aAAa,EACb,kBAAkB,GACnB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,aAAa,EACb,aAAa,EACb,YAAY,EACZ,sBAAsB,EACtB,YAAY,EACZ,wBAAwB,EACxB,cAAc,GACf,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD,eAAe,YAAY,CAAC;IAC1B,iBAAiB,EAAE,sBAAsB;IACzC,mBAAmB,EAAE,wBAAwB;IAC7C,uBAAuB,EAAE,4BAA4B;IACrD,cAAc,EAAE,aAAa;IAC7B,sBAAsB,EAAE,eAAe;IACvC,cAAc,EAAE,mBAAmB;IACnC,cAAc,EAAE,WAAW;IAC3B,gBAAgB,EAAE,aAAa;IAC/B,cAAc,EAAE,WAAW;IAC3B,oBAAoB,EAAE,iBAAiB;IACvC,qBAAqB,EAAE,gBAAgB;IACvC,eAAe,EAAE,oBAAoB;IACrC,mBAAmB,EAAE,wBAAwB;IAC7C,OAAO;IACP,QAAQ,EAAE,aAAa;IAEvB,WAAW;IACX,QAAQ,EAAE,aAAa;IACvB,MAAM,EAAE,WAAW;IAEnB,UAAU;IACV,aAAa,EAAE,kBAAkB;IACjC,gBAAgB,EAAE,qBAAqB;IACvC,QAAQ,EAAE,aAAa;IAEvB,UAAU;IACV,QAAQ,EAAE,aAAa;IACvB,OAAO,EAAE,YAAY;IACrB,iBAAiB,EAAE,sBAAsB;IACzC,OAAO,EAAE,YAAY;IACrB,QAAQ,EAAE,aAAa;IACvB,SAAS,EAAE,cAAc;IACzB,mBAAmB,EAAE,wBAAwB;IAE7C,WAAW;IACX,aAAa,EAAE,kBAAkB;CAClC,CAAC,CAAC"}

package/docs/settlement.md

@@ -222,8 +222,8 @@ Sources: [payout schedules](https://docs.stripe.com/connect/manage-payout-schedu
 ### Transactional claim ledger implementation status
 
 The component contains `payoutRelease` claim and source-allocation tables. These
-are server-side building blocks for the release boundary, with no public client
-executor or scheduled bank-payout integration yet. Do not call the claim
+are server-side building blocks for the release boundary, with no automatic
+payout-creation or scheduled bank-payout integration yet. Do not call the claim
 mutation with UI totals or a transfer receipt alone. Its trusted upstream caller
 must establish complete provider history, still-unpaid ownership, adoption of
 prior payouts, independent liabilities, and live payout controls first.
@@ -245,7 +245,7 @@ held. This window stays below Stripe's [24-hour v1 idempotency retention minimum
 The current claim snapshot is deliberately bounded to 100 account transfer rows
 and 1,000 receipt IDs per source. Larger or incomplete histories reject the whole
 claim, without using partial totals. A resumable reconciliation/adoption process,
-provider payout creation and receipt verification, payout-fee accounting, and
+provider payout creation and receipt verification, historical fee adoption, other account debit allocation, and
 recurring release/expiry integration remain required before custom payout
 minimums can be presented as an operational feature. In-memory claim tests are
 not evidence of a completed Stripe bank payout.
@@ -299,3 +299,74 @@ remains intact for retries.
 Sources: [transfer provenance](https://docs.stripe.com/api/transfers/object),
 [receipt maturity](https://docs.stripe.com/api/balance_transactions/object), and
 [history pagination and payout-filter limits](https://docs.stripe.com/api/balance_transactions/list).
+
+## Verified payout receipts and reconciliation
+
+In an authorized server action, read a Connect Stripe-balance payout with:
+
+```ts
+const receipt = await stripe.payoutPolicy.payoutReceipt({
+  accountId,
+  stripePayoutId,
+});
+```
+
+The reader retrieves the payout and its actual account-scoped balance
+transactions, including a failed/canceled payout's return transaction. It checks
+transaction identity, currency, exact principal, signed fees, net amounts and
+maturity, then re-reads the payout to detect changes. Expanded transaction
+objects are not trusted in place of scoped retrieval. Automatic and manual
+history can both be inspected; a manual payout receipt does not identify the
+transfers that funded it. Changed snapshots, missing debit/return receipts,
+pending debits or returns, unsupported currency allocation and bank-payout reversals return
+`not_ready` without partial financial totals.
+
+A ready receipt preserves `providerStatus`, original `debit`, optional returned
+`credit`, `returnedPrincipal` and `returnedNet`. A returned principal can differ
+from net cash because payout fees are retained or credited separately. This data
+alone does not authorize releasing a reservation, identify still-unpaid earnings,
+or prove that a pending payout reached the bank. Global Payouts requires a
+separate receipt and capability implementation.
+
+To reconcile an already attempted durable claim:
+
+```ts
+const outcome = await stripe.payoutPolicy.reconcilePayout(ctx, {
+  accountId,
+  ownerKey,
+  operationKey,
+  // stripePayoutId, // optional when the provider ID is already known
+  maxPages: 10,
+});
+```
+
+The host authenticates the account/owner/operation before this call. Reconciliation
+requires `ctx.runMutation`. It never creates or retries a bank payout. A stored
+provider ID must agree with any supplied ID. Otherwise, bounded provider history
+is scanned for the exact reserved `bsPayoutClaim` marker. Discovery must finish;
+partial history, duplicate matches and a changed history head stay held. The
+page budget is 1 to 100, default 10. No match, including after idempotency expiry,
+never proves that money did not move.
+
+Adoption verifies the claim marker, amount, currency, creation window and
+standard manual bank-payout type. Current claims use the card source balance;
+other source rails return an explicit allocation limitation. A missing or
+immature return keeps allocations reserved. Verified paid and returned outcomes
+update source allocations and payout fees in one component transaction. Unknown
+provider and persistence errors propagate so the host can retry reconciliation.
+Canceled/rejected claim states are returned as terminal states, not as bank
+payment confirmation.
+
+Net non-refundable payout fees are retained per recipient/currency and deducted
+from later mature unpaid entitlement. They are not deducted again from fresh
+provider availability, which already reflects the debit. A newly observed fee
+invalidates an unattempted claim prepared against an older fee revision. Fee
+credits after a return reduce only the verified original fee; excess credits
+require explicit allocation. Original debit receipts and their fees remain
+immutable. Older returned claims can receive verified fee evidence without
+releasing their principal again.
+
+These APIs reconcile existing claims; full automatic qualification/creation,
+historical source adoption, large-history collection, other account debit
+allocation and recurring/UI integration remain separate work. Do not expose a
+custom minimum as fully enforced solely because reconciliation is available.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fantastic.dev/better-stripe",
-  "version": "0.20.1",
+  "version": "0.21.0",
   "description": "A Convex component for Stripe V2 Accounts API integration.",
   "keywords": [
     "stripe",

package/src/client/connect/payoutAllocation.test.ts

@@ -139,7 +139,7 @@ describe("combined recipient payout allocation", () => {
     expect(result).toMatchObject({
       status: "qualified",
       amount: 1300,
-      matureUnpaid: 2000,
+      matureUnpaid: 1800,
     });
     expect(
       planRecipientPayout({
@@ -149,8 +149,8 @@ describe("combined recipient payout allocation", () => {
       }),
     ).toMatchObject({
       status: "held",
-      reason: "insufficient_available",
-      matureUnpaid: 1000,
+      reason: "below_threshold",
+      matureUnpaid: 999,
     });
   });
   it("does not subtract reservations again from an already debited provider balance", () => {
@@ -290,3 +290,36 @@ describe("combined recipient payout allocation", () => {
 function awaitInvalid(action: () => unknown) {
   expect(action).toThrow(/Invalid|Unsafe|Duplicate/);
 }
+it("deducts confirmed payout fees from entitlement without deducting them twice from provider availability", () => {
+  expect(
+    planRecipientPayout({
+      ...options([source("tr_one", 1500)]),
+      providerAvailable: 1470,
+      confirmedFees: 30,
+    }),
+  ).toMatchObject({ status: "qualified", amount: 1470, matureUnpaid: 1470 });
+  expect(
+    planRecipientPayout({
+      ...options([source("tr_one", 1000)]),
+      providerAvailable: 5000,
+      confirmedFees: 30,
+    }),
+  ).toMatchObject({
+    status: "held",
+    reason: "below_threshold",
+    matureUnpaid: 970,
+  });
+});
+it("does not qualify the gross threshold while known independent liabilities remain", () => {
+  expect(
+    planRecipientPayout({
+      ...options(),
+      providerAvailable: 5000,
+      independentLiabilities: 1,
+    }),
+  ).toMatchObject({
+    status: "held",
+    reason: "below_threshold",
+    matureUnpaid: 999,
+  });
+});