@fantastic.dev/better-stripe 0.20.1 → 0.22.0

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

@@ -14,7 +14,11 @@ export declare const get: import("convex/server").RegisteredQuery<"public", {
     amount: number;
     attemptedAt?: number | undefined;
     currency: string;
+    debitFee?: number | undefined;
+    debitTransactionId?: string | undefined;
+    destinationId?: string | undefined;
     expectedRevision: number;
+    feeRevision?: number | undefined;
     observations: {
         currency: string;
         ledgerFingerprint: string;
@@ -26,6 +30,7 @@ export declare const get: import("convex/server").RegisteredQuery<"public", {
     }[];
     operationKey: string;
     ownerKey: string;
+    providerFee?: number | undefined;
     rejection?: {
         code: "amount_too_small" | "balance_insufficient";
         requestId: string;
@@ -58,7 +63,11 @@ export declare const pending: import("convex/server").RegisteredQuery<"public",
         amount: number;
         attemptedAt?: number | undefined;
         currency: string;
+        debitFee?: number | undefined;
+        debitTransactionId?: string | undefined;
+        destinationId?: string | undefined;
         expectedRevision: number;
+        feeRevision?: number | undefined;
         observations: {
             currency: string;
             ledgerFingerprint: string;
@@ -70,6 +79,7 @@ export declare const pending: import("convex/server").RegisteredQuery<"public",
         }[];
         operationKey: string;
         ownerKey: string;
+        providerFee?: number | undefined;
         rejection?: {
             code: "amount_too_small" | "balance_insufficient";
             requestId: string;
@@ -81,4 +91,81 @@ export declare const pending: import("convex/server").RegisteredQuery<"public",
     continueCursor: string;
     isDone: boolean;
 }>>;
+export declare const fees: import("convex/server").RegisteredQuery<"public", {
+    accountId: string;
+    currency: string;
+    ownerKey: string;
+}, Promise<{
+    amount: number;
+    revision: number;
+}>>;
+/** Complete bounded input for package qualification. Partial membership never qualifies. */
+export declare const snapshot: import("convex/server").RegisteredQuery<"public", {
+    accountId: string;
+    ownerKey: string;
+}, Promise<{
+    status: "held";
+    reason: "snapshot_limit";
+    transfers?: undefined;
+    claims?: undefined;
+} | {
+    reason?: undefined;
+    status: "ready";
+    transfers: {
+        _creationTime: number;
+        _id: import("convex/values").GenericId<"transfers">;
+        amount: number;
+        currency: string;
+        destinationAccountId: string;
+        metadata?: any;
+        paymentId?: string | undefined;
+        reinstatement?: boolean | undefined;
+        reversalClaimedAmount?: number | undefined;
+        reversalStatus?: "fully_reversed" | "partially_reversed" | undefined;
+        reversedAmount?: number | undefined;
+        role?: "affiliate" | "other" | "store" | undefined;
+        sourceChargeId?: string | undefined;
+        sourceInvoiceId?: string | undefined;
+        status: "failed" | "paid" | "pending" | "reversed";
+        stripeTransferId: string;
+        totalsRecorded?: true | undefined;
+    }[];
+    claims: {
+        _creationTime: number;
+        _id: import("convex/values").GenericId<"payoutReleaseClaims">;
+        accountId: string;
+        allocations: {
+            amount: number;
+            role?: "affiliate" | "other" | "store" | undefined;
+            stripeTransferId: string;
+        }[];
+        amount: number;
+        attemptedAt?: number | undefined;
+        currency: string;
+        debitFee?: number | undefined;
+        debitTransactionId?: string | undefined;
+        destinationId?: string | undefined;
+        expectedRevision: number;
+        feeRevision?: number | undefined;
+        observations: {
+            currency: string;
+            ledgerFingerprint: string;
+            matureNet: number;
+            observedAt: number;
+            pendingCredits: number;
+            stripeTransferId: string;
+            transactionIds: string[];
+        }[];
+        operationKey: string;
+        ownerKey: string;
+        providerFee?: number | undefined;
+        rejection?: {
+            code: "amount_too_small" | "balance_insufficient";
+            requestId: string;
+        } | undefined;
+        returnTransactionId?: string | undefined;
+        status: "canceled" | "paid" | "rejected" | "reserved" | "returned" | "submitted";
+        stripePayoutId?: string | undefined;
+    }[];
+}>>;
 //# sourceMappingURL=queries.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"queries.d.ts","sourceRoot":"","sources":["../../../src/component/payoutRelease/queries.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UAiBd,CAAC;AACH,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BlB,CAAC"}
+{"version":3,"file":"queries.d.ts","sourceRoot":"","sources":["../../../src/component/payoutRelease/queries.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UAiBd,CAAC;AACH,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BlB,CAAC;AAEH,eAAO,MAAM,IAAI;;;;;;;GAQf,CAAC;AAEH,4FAA4F;AAC5F,eAAO,MAAM,QAAQ;;;;YA0BE,MAAM;YAAmB,gBAAgB;;;;;YAG3C,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAE1B,CAAC"}

package/dist/component/payoutRelease/queries.js

@@ -1,3 +1,5 @@
+import { transferDocValidator } from "../connect/validators.js";
+import { readFees } from "./fees.js";
 import { paginationOptsValidator } from "convex/server";
 import { v } from "convex/values";
 import { query } from "../_generated/server.js";
@@ -48,4 +50,41 @@ export const pending = query({
         };
     },
 });
+export const fees = query({
+    args: { accountId: v.string(), ownerKey: v.string(), currency: v.string() },
+    returns: v.object({ amount: v.number(), revision: v.number() }),
+    handler: async (ctx, args) => {
+        await readPolicy(ctx, args);
+        const balance = await readFees(ctx, args);
+        return { amount: balance?.amount ?? 0, revision: balance?.revision ?? 0 };
+    },
+});
+/** Complete bounded input for package qualification. Partial membership never qualifies. */
+export const snapshot = query({
+    args: { accountId: v.string(), ownerKey: v.string() },
+    returns: v.union(v.object({
+        status: v.literal("held"),
+        reason: v.literal("snapshot_limit"),
+    }), v.object({
+        status: v.literal("ready"),
+        transfers: v.array(transferDocValidator),
+        claims: v.array(claimDoc),
+    })),
+    handler: async (ctx, args) => {
+        await readPolicy(ctx, args);
+        const transfers = await ctx.db
+            .query("transfers")
+            .withIndex("by_destination_account_id", (q) => q.eq("destinationAccountId", args.accountId))
+            .take(101);
+        const claims = await ctx.db
+            .query("payoutReleaseClaims")
+            .withIndex("by_account_status", (q) => q.eq("accountId", args.accountId))
+            .take(101);
+        if (transfers.length > 100 || claims.length > 100)
+            return { status: "held", reason: "snapshot_limit" };
+        if (claims.some((c) => c.ownerKey !== args.ownerKey))
+            throw new Error("Payout history owner does not match.");
+        return { status: "ready", transfers, claims };
+    },
+});
 //# sourceMappingURL=queries.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"queries.js","sourceRoot":"","sources":["../../../src/component/payoutRelease/queries.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,CAAC,EAAE,MAAM,eAAe,CAAC;AAClC,OAAO,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACxD,MAAM,CAAC,MAAM,GAAG,GAAG,KAAK,CAAC;IACvB,IAAI,EAAE,QAAQ;IACd,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACpC,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QAC3B,gBAAgB,CAAC,IAAI,CAAC,CAAC;QACvB,MAAM,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC5B,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,EAAE;aACvB,KAAK,CAAC,qBAAqB,CAAC;aAC5B,SAAS,CAAC,cAAc,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,cAAc,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;aACzE,MAAM,EAAE,CAAC;QACZ,IACE,KAAK;YACL,CAAC,KAAK,CAAC,SAAS,KAAK,IAAI,CAAC,SAAS,IAAI,KAAK,CAAC,QAAQ,KAAK,IAAI,CAAC,QAAQ,CAAC;YAExE,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;QAC3D,OAAO,KAAK,CAAC;IACf,CAAC;CACF,CAAC,CAAC;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,KAAK,CAAC;IAC3B,IAAI,EAAE;QACJ,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;QACrB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;QACpB,cAAc,EAAE,uBAAuB;KACxC;IACD,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC;QAChB,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC;QACvB,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE;QAC1B,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE;KACpB,CAAC;IACF,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QAC3B,MAAM,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC5B,IACE,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC;YAC/C,IAAI,CAAC,cAAc,CAAC,QAAQ,GAAG,CAAC;YAChC,IAAI,CAAC,cAAc,CAAC,QAAQ,GAAG,GAAG;YAElC,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAChD,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,EAAE;aACxB,KAAK,CAAC,qBAAqB,CAAC;aAC5B,SAAS,CAAC,mBAAmB,EAAE,CAAC,CAAC,EAAE,EAAE,CACpC,CAAC,CAAC,EAAE,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,QAAQ,EAAE,UAAU,CAAC,CAC3D;aACA,QAAQ,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QACjC,OAAO;YACL,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,cAAc,EAAE,MAAM,CAAC,cAAc;YACrC,MAAM,EAAE,MAAM,CAAC,MAAM;SACtB,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}
+{"version":3,"file":"queries.js","sourceRoot":"","sources":["../../../src/component/payoutRelease/queries.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,CAAC,EAAE,MAAM,eAAe,CAAC;AAClC,OAAO,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACxD,MAAM,CAAC,MAAM,GAAG,GAAG,KAAK,CAAC;IACvB,IAAI,EAAE,QAAQ;IACd,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACpC,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QAC3B,gBAAgB,CAAC,IAAI,CAAC,CAAC;QACvB,MAAM,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC5B,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,EAAE;aACvB,KAAK,CAAC,qBAAqB,CAAC;aAC5B,SAAS,CAAC,cAAc,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,cAAc,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;aACzE,MAAM,EAAE,CAAC;QACZ,IACE,KAAK;YACL,CAAC,KAAK,CAAC,SAAS,KAAK,IAAI,CAAC,SAAS,IAAI,KAAK,CAAC,QAAQ,KAAK,IAAI,CAAC,QAAQ,CAAC;YAExE,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;QAC3D,OAAO,KAAK,CAAC;IACf,CAAC;CACF,CAAC,CAAC;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,KAAK,CAAC;IAC3B,IAAI,EAAE;QACJ,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;QACrB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;QACpB,cAAc,EAAE,uBAAuB;KACxC;IACD,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC;QAChB,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC;QACvB,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE;QAC1B,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE;KACpB,CAAC;IACF,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QAC3B,MAAM,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC5B,IACE,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC;YAC/C,IAAI,CAAC,cAAc,CAAC,QAAQ,GAAG,CAAC;YAChC,IAAI,CAAC,cAAc,CAAC,QAAQ,GAAG,GAAG;YAElC,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAChD,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,EAAE;aACxB,KAAK,CAAC,qBAAqB,CAAC;aAC5B,SAAS,CAAC,mBAAmB,EAAE,CAAC,CAAC,EAAE,EAAE,CACpC,CAAC,CAAC,EAAE,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,QAAQ,EAAE,UAAU,CAAC,CAC3D;aACA,QAAQ,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QACjC,OAAO;YACL,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,cAAc,EAAE,MAAM,CAAC,cAAc;YACrC,MAAM,EAAE,MAAM,CAAC,MAAM;SACtB,CAAC;IACJ,CAAC;CACF,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,IAAI,GAAG,KAAK,CAAC;IACxB,IAAI,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE;IAC3E,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;IAC/D,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QAC3B,MAAM,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC5B,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC1C,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,IAAI,CAAC,EAAE,CAAC;IAC5E,CAAC;CACF,CAAC,CAAC;AAEH,4FAA4F;AAC5F,MAAM,CAAC,MAAM,QAAQ,GAAG,KAAK,CAAC;IAC5B,IAAI,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE;IACrD,OAAO,EAAE,CAAC,CAAC,KAAK,CACd,CAAC,CAAC,MAAM,CAAC;QACP,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;QACzB,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC;KACpC,CAAC,EACF,CAAC,CAAC,MAAM,CAAC;QACP,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;QAC1B,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,oBAAoB,CAAC;QACxC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC;KAC1B,CAAC,CACH;IACD,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QAC3B,MAAM,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC5B,MAAM,SAAS,GAAG,MAAM,GAAG,CAAC,EAAE;aAC3B,KAAK,CAAC,WAAW,CAAC;aAClB,SAAS,CAAC,2BAA2B,EAAE,CAAC,CAAC,EAAE,EAAE,CAC5C,CAAC,CAAC,EAAE,CAAC,sBAAsB,EAAE,IAAI,CAAC,SAAS,CAAC,CAC7C;aACA,IAAI,CAAC,GAAG,CAAC,CAAC;QACb,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,EAAE;aACxB,KAAK,CAAC,qBAAqB,CAAC;aAC5B,SAAS,CAAC,mBAAmB,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;aACxE,IAAI,CAAC,GAAG,CAAC,CAAC;QACb,IAAI,SAAS,CAAC,MAAM,GAAG,GAAG,IAAI,MAAM,CAAC,MAAM,GAAG,GAAG;YAC/C,OAAO,EAAE,MAAM,EAAE,MAAe,EAAE,MAAM,EAAE,gBAAyB,EAAE,CAAC;QACxE,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,IAAI,CAAC,QAAQ,CAAC;YAClD,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC1D,OAAO,EAAE,MAAM,EAAE,OAAgB,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;IACzD,CAAC;CACF,CAAC,CAAC"}

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

@@ -31,6 +31,7 @@ export declare const claimFields: {
     expectedRevision: import("convex/values").VFloat64<number, "required">;
     currency: import("convex/values").VString<string, "required">;
     amount: import("convex/values").VFloat64<number, "required">;
+    destinationId: import("convex/values").VString<string | undefined, "optional">;
     allocations: import("convex/values").VArray<{
         amount: number;
         role?: "affiliate" | "other" | "store" | undefined;
@@ -73,6 +74,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 +98,11 @@ export declare const claimDoc: import("convex/values").VObject<{
     amount: number;
     attemptedAt?: number | undefined;
     currency: string;
+    debitFee?: number | undefined;
+    debitTransactionId?: string | undefined;
+    destinationId?: string | undefined;
     expectedRevision: number;
+    feeRevision?: number | undefined;
     observations: {
         currency: string;
         ledgerFingerprint: string;
@@ -105,6 +114,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;
@@ -119,6 +129,7 @@ export declare const claimDoc: import("convex/values").VObject<{
     expectedRevision: import("convex/values").VFloat64<number, "required">;
     currency: import("convex/values").VString<string, "required">;
     amount: import("convex/values").VFloat64<number, "required">;
+    destinationId: import("convex/values").VString<string | undefined, "optional">;
     allocations: import("convex/values").VArray<{
         amount: number;
         role?: "affiliate" | "other" | "store" | undefined;
@@ -161,6 +172,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 +185,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" | "destinationId" | "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 +196,11 @@ export declare const claimsTable: import("convex/server").TableDefinition<import
     amount: number;
     attemptedAt?: number | undefined;
     currency: string;
+    debitFee?: number | undefined;
+    debitTransactionId?: string | undefined;
+    destinationId?: string | undefined;
     expectedRevision: number;
+    feeRevision?: number | undefined;
     observations: {
         currency: string;
         ledgerFingerprint: string;
@@ -193,6 +212,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;
@@ -207,6 +227,7 @@ export declare const claimsTable: import("convex/server").TableDefinition<import
     expectedRevision: import("convex/values").VFloat64<number, "required">;
     currency: import("convex/values").VString<string, "required">;
     amount: import("convex/values").VFloat64<number, "required">;
+    destinationId: import("convex/values").VString<string | undefined, "optional">;
     allocations: import("convex/values").VArray<{
         amount: number;
         role?: "affiliate" | "other" | "store" | undefined;
@@ -249,6 +270,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 +281,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" | "destinationId" | "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 +312,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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiCvB,CAAC;AACF,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sXAInB,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

@@ -21,12 +21,17 @@ export const claimFields = {
     expectedRevision: v.number(),
     currency: v.string(),
     amount: v.number(),
+    destinationId: v.optional(v.string()),
     allocations: v.array(allocation),
     observations: v.array(observation),
     status: v.union(v.literal("reserved"), v.literal("submitted"), v.literal("paid"), v.literal("returned"), v.literal("canceled"), v.literal("rejected")),
     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 +46,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 +59,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,11 @@ declare const _default: import("convex/server").SchemaDefinition<{
         amount: number;
         attemptedAt?: number | undefined;
         currency: string;
+        debitFee?: number | undefined;
+        debitTransactionId?: string | undefined;
+        destinationId?: string | undefined;
         expectedRevision: number;
+        feeRevision?: number | undefined;
         observations: {
             currency: string;
             ledgerFingerprint: string;
@@ -21,6 +40,7 @@ declare const _default: import("convex/server").SchemaDefinition<{
         }[];
         operationKey: string;
         ownerKey: string;
+        providerFee?: number | undefined;
         rejection?: {
             code: "amount_too_small" | "balance_insufficient";
             requestId: string;
@@ -35,6 +55,7 @@ declare const _default: import("convex/server").SchemaDefinition<{
         expectedRevision: import("convex/values").VFloat64<number, "required">;
         currency: import("convex/values").VString<string, "required">;
         amount: import("convex/values").VFloat64<number, "required">;
+        destinationId: import("convex/values").VString<string | undefined, "optional">;
         allocations: import("convex/values").VArray<{
             amount: number;
             role?: "affiliate" | "other" | "store" | undefined;
@@ -77,6 +98,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 +109,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" | "destinationId" | "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,134 @@ 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 receipt APIs reconcile existing claims. Use the release API below for
+qualification and creation; receipt reconciliation by itself does not enforce a
+minimum.
+
+## Combined recipient release
+
+After authorized custom policy activation, a host scheduled action can call:
+
+```ts
+const result = await stripe.payoutPolicy.release(ctx, {
+  accountId,
+  ownerKey,
+  operationKey, // stable unique identity for this scheduled operation
+  currency: "usd",
+  independentLiabilities, // authorized outstanding off-provider debts/reserves
+  maxPages: 10,
+});
+```
+
+Authenticate the recipient and policy, and read all known off-provider debts and
+reserves before invoking this server-only method. Never pass an untrusted client
+amount or assume that an omitted debt is zero. Provider source refunds and payout
+fees are already reconciled by the package and must not be counted again in
+`independentLiabilities`. The host must install the recurring release and expiry
+jobs before offering custom scheduling. This method does not install a cron.
+
+The package verifies live manual schedule controls, reads every account source,
+retrieves transfer and payout receipts, and compares the complete settlement
+currency balance history with those verified receipts. Unknown credits, refunds,
+fees and prior payouts return `held/unallocated_history`. A current balance is
+never treated as proof of unpaid ownership. History must reconcile to the live
+available and pending balance; changing or incomplete snapshots stay held.
+
+Mature unpaid creator and affiliate sources qualify together in integer minor
+units. Pending credits do not qualify. Outstanding source reservations, prior
+paid allocations, actual refunds, payout fees and supplied independent liabilities
+reduce eligibility. The cap uses the available card-source balance, since the
+immutable provider request explicitly selects `source_type: "card"` and a
+standard bank payout. The complete bank-account listing must identify one
+default bank for the settlement currency. Its ID is persisted with the claim,
+passed explicitly to Stripe, and checked again in the payout receipt. Other rails and currencies cannot increase that cap.
+
+A qualifying operation reserves its exact source allocations in a component
+transaction, verifies live controls again, and records the attempted marker before
+calling Stripe. The provider idempotency key and request are fixed by the durable
+claim. Concurrent callers therefore share one financial operation. Subsequent
+calls to an attempted operation only reconcile provider receipts, including when
+the original call timed out. They never blindly recreate an unidentified payout.
+A verified no-object `balance_insufficient` or `amount_too_small` rejection releases
+reservations; unknown errors keep them held. An interrupted unattempted operation
+is canceled on replay, and a new scheduled operation can collect fresh receipts.
+Below-threshold money remains owed. The numeric provider floor remains `null`
+unless a supported provider contract exposes it.
+
+Current atomic collection accepts up to 100 account transfers and 100 historical
+claims. Larger accounts return `held/snapshot_limit`, without paying a partial
+page. Provider history uses a 1–100 page budget, default 10; exhaustion stays held.
+Explicit prior-payout/source adoption, resumable larger-account collection,
+independent provider-debit allocation, recurring example jobs and React controls
+remain integration work. Existing funded accounts still follow the policy
+migration safeguards; do not bypass `migration_required` to activate this API.
+
+Sources: [payout creation and source balance selection](https://docs.stripe.com/api/payouts/create),
+[complete balance history and automatic-only payout filtering](https://docs.stripe.com/api/balance_transactions/list).