stripe 22.2.0 → 22.3.0-alpha.2

package/esm/resources/Capital/FinancingOffers.d.ts

@@ -0,0 +1,191 @@
+import { StripeResource } from '../../StripeResource.js';
+import { PaginationParams, RangeQueryParam, Metadata } from '../../shared.js';
+import { RequestOptions, ApiListPromise, Response } from '../../lib.js';
+export declare class FinancingOfferResource extends StripeResource {
+    /**
+     * Retrieves the financing offers available for Connected accounts that belong to your platform.
+     */
+    list(params?: Capital.FinancingOfferListParams, options?: RequestOptions): ApiListPromise<FinancingOffer>;
+    /**
+     * Get the details of the financing offer
+     */
+    retrieve(id: string, params?: Capital.FinancingOfferRetrieveParams, options?: RequestOptions): Promise<Response<FinancingOffer>>;
+    /**
+     * Acknowledges that platform has received and delivered the financing_offer to
+     * the intended merchant recipient.
+     */
+    markDelivered(id: string, params?: Capital.FinancingOfferMarkDeliveredParams, options?: RequestOptions): Promise<Response<FinancingOffer>>;
+}
+export interface FinancingOffer {
+    /**
+     * A unique identifier for the financing object.
+     */
+    id: string;
+    /**
+     * The object type: financing_offer.
+     */
+    object: 'capital.financing_offer';
+    /**
+     * This is an object representing the terms of an offer of financing from
+     * Stripe Capital to a Connected account. This resource represents
+     * the terms accepted by the Connected account, which may differ from those
+     * offered.
+     */
+    accepted_terms?: Capital.FinancingOffer.AcceptedTerms;
+    /**
+     * The ID of the merchant associated with this financing object.
+     */
+    account: string;
+    /**
+     * The time at which this financing offer was charged off, if applicable. Given in seconds since unix epoch.
+     */
+    charged_off_at?: number;
+    /**
+     * Time at which the offer was created. Given in seconds since unix epoch.
+     */
+    created: number;
+    /**
+     * Time at which the offer expires. Given in seconds since unix epoch.
+     */
+    expires_after: number;
+    /**
+     * The type of financing being offered.
+     */
+    financing_type?: Capital.FinancingOffer.FinancingType;
+    /**
+     * If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`.
+     */
+    livemode: boolean;
+    /**
+     * Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
+     */
+    metadata?: Metadata;
+    /**
+     * This is an object representing the terms of an offer of financing from
+     * Stripe Capital to a Connected account. This resource represents
+     * both the terms offered to the Connected account.
+     */
+    offered_terms?: Capital.FinancingOffer.OfferedTerms;
+    /**
+     * Financing product identifier.
+     */
+    product_type?: Capital.FinancingOffer.ProductType;
+    /**
+     * The ID of the financing offer that replaced this offer.
+     */
+    replacement?: string;
+    /**
+     * The ID of the financing offer that this offer is a replacement for.
+     */
+    replacement_for?: string;
+    /**
+     * The current status of the offer.
+     */
+    status: Capital.FinancingOffer.Status;
+    /**
+     * See [financing_type](https://docs.stripe.com/api/capital/connect_financing_object#financing_offer_object-financing_type).
+     */
+    type?: Capital.FinancingOffer.Type;
+}
+export declare namespace Capital {
+    namespace FinancingOffer {
+        interface AcceptedTerms {
+            /**
+             * Amount of financing offered, in minor units. For example, 1,000 USD is represented as 100000.
+             */
+            advance_amount: number;
+            /**
+             * Currency that the financing offer is transacted in. For example, `usd`.
+             */
+            currency: string;
+            /**
+             * Fixed fee amount, in minor units. For example, 100 USD is represented as 10000.
+             */
+            fee_amount: number;
+            /**
+             * Populated when the `product_type` of the `financingoffer` is `refill`.
+             * Represents the discount amount on remaining premium for the existing loan at payout time.
+             */
+            previous_financing_fee_discount_amount: number | null;
+            /**
+             * Per-transaction rate at which Stripe withholds funds to repay the financing.
+             */
+            withhold_rate: number;
+        }
+        type FinancingType = 'cash_advance' | 'flex_loan';
+        interface OfferedTerms {
+            /**
+             * Amount of financing offered, in minor units. For example, 1,000 USD is represented as 100000.
+             */
+            advance_amount: number;
+            /**
+             * Describes the type of user the offer is being extended to.
+             */
+            campaign_type: OfferedTerms.CampaignType;
+            /**
+             * Currency that the financing offer is transacted in. For example, `usd`.
+             */
+            currency: string;
+            /**
+             * Fixed fee amount, in minor units. For example, 100 USD is represented as 10000.
+             */
+            fee_amount: number;
+            /**
+             * Populated when the `product_type` of the `financingoffer` is `refill`.
+             * Represents the discount rate percentage on remaining fee on the existing loan. When the `financing_offer`
+             * is paid out, the `previous_financing_fee_discount_amount` will be computed as the multiple of this rate
+             * and the remaining fee.
+             */
+            previous_financing_fee_discount_rate: number | null;
+            /**
+             * Per-transaction rate at which Stripe withholds funds to repay the financing.
+             */
+            withhold_rate: number;
+        }
+        type ProductType = 'refill' | 'standard';
+        type Status = 'accepted' | 'canceled' | 'completed' | 'delivered' | 'expired' | 'fully_repaid' | 'paid_out' | 'rejected' | 'replaced' | 'undelivered';
+        type Type = 'cash_advance' | 'fixed_term_loan' | 'flex_loan';
+        namespace OfferedTerms {
+            type CampaignType = 'newly_eligible_user' | 'previously_eligible_user' | 'repeat_user';
+        }
+    }
+}
+export declare namespace Capital {
+    interface FinancingOfferRetrieveParams {
+        /**
+         * Specifies which fields in the response should be expanded.
+         */
+        expand?: Array<string>;
+    }
+}
+export declare namespace Capital {
+    interface FinancingOfferListParams extends PaginationParams {
+        /**
+         * limit list to offers belonging to given connected account
+         */
+        connected_account?: string;
+        /**
+         * Only return offers that were created during the given date interval.
+         */
+        created?: RangeQueryParam | number;
+        /**
+         * Specifies which fields in the response should be expanded.
+         */
+        expand?: Array<string>;
+        /**
+         * limit list to offers with given status
+         */
+        status?: FinancingOfferListParams.Status;
+    }
+    namespace FinancingOfferListParams {
+        type Status = 'accepted' | 'canceled' | 'completed' | 'delivered' | 'expired' | 'fully_repaid' | 'paid_out' | 'rejected' | 'revoked' | 'undelivered';
+    }
+}
+export declare namespace Capital {
+    interface FinancingOfferMarkDeliveredParams {
+        /**
+         * Specifies which fields in the response should be expanded.
+         */
+        expand?: Array<string>;
+    }
+}

package/esm/resources/Capital/FinancingOffers.js

@@ -0,0 +1,26 @@
+// File generated from our OpenAPI spec
+import { StripeResource } from '../../StripeResource.js';
+export class FinancingOfferResource extends StripeResource {
+    /**
+     * Retrieves the financing offers available for Connected accounts that belong to your platform.
+     */
+    list(params, options) {
+        return this._makeRequest('GET', '/v1/capital/financing_offers', params, options, {
+            methodType: 'list',
+        });
+    }
+    /**
+     * Get the details of the financing offer
+     */
+    retrieve(id, params, options) {
+        return this._makeRequest('GET', `/v1/capital/financing_offers/${id}`, params, options);
+    }
+    /**
+     * Acknowledges that platform has received and delivered the financing_offer to
+     * the intended merchant recipient.
+     */
+    markDelivered(id, params, options) {
+        return this._makeRequest('POST', `/v1/capital/financing_offers/${id}/mark_delivered`, params, options);
+    }
+}
+//# sourceMappingURL=FinancingOffers.js.map

package/esm/resources/Capital/FinancingOffers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FinancingOffers.js","sourceRoot":"","sources":["../../../src/resources/Capital/FinancingOffers.ts"],"names":[],"mappings":"AAAA,uCAAuC;AAEvC,OAAO,EAAC,cAAc,EAAC,MAAM,yBAAyB,CAAC;AAIvD,MAAM,OAAO,sBAAuB,SAAQ,cAAc;IACxD;;OAEG;IACH,IAAI,CACF,MAAyC,EACzC,OAAwB;QAExB,OAAO,IAAI,CAAC,YAAY,CACtB,KAAK,EACL,8BAA8B,EAC9B,MAAM,EACN,OAAO,EACP;YACE,UAAU,EAAE,MAAM;SACnB,CACK,CAAC;IACX,CAAC;IACD;;OAEG;IACH,QAAQ,CACN,EAAU,EACV,MAA6C,EAC7C,OAAwB;QAExB,OAAO,IAAI,CAAC,YAAY,CACtB,KAAK,EACL,gCAAgC,EAAE,EAAE,EACpC,MAAM,EACN,OAAO,CACD,CAAC;IACX,CAAC;IACD;;;OAGG;IACH,aAAa,CACX,EAAU,EACV,MAAkD,EAClD,OAAwB;QAExB,OAAO,IAAI,CAAC,YAAY,CACtB,MAAM,EACN,gCAAgC,EAAE,iBAAiB,EACnD,MAAM,EACN,OAAO,CACD,CAAC;IACX,CAAC;CACF"}

package/esm/resources/Capital/FinancingSummary.d.ts

@@ -0,0 +1,98 @@
+import { StripeResource } from '../../StripeResource.js';
+import { RequestOptions, Response } from '../../lib.js';
+export declare class FinancingSummaryResource extends StripeResource {
+    /**
+     * Retrieve the financing summary object for the account.
+     */
+    retrieve(params?: Capital.FinancingSummaryRetrieveParams, options?: RequestOptions): Promise<Response<FinancingSummary>>;
+}
+export interface FinancingSummary {
+    /**
+     * The object type: financing_summary
+     */
+    object: 'capital.financing_summary';
+    /**
+     * Additional information about the financing summary. Describes currency, advance amount,
+     * fee amount, withhold rate, remaining amount, paid amount, current repayment interval,
+     * repayment start date, and advance payout date.
+     *
+     * Only present for financing offers with the `paid_out` status.
+     */
+    details: Capital.FinancingSummary.Details | null;
+    /**
+     * The unique identifier of the Financing Offer object that corresponds to the Financing Summary object.
+     */
+    financing_offer: string | null;
+    /**
+     * The financing status of the connected account.
+     */
+    status: Capital.FinancingSummary.Status | null;
+}
+export declare namespace Capital {
+    namespace FinancingSummary {
+        interface Details {
+            /**
+             * Amount of financing offered, in minor units. For example, 1,000 USD is represented as 100000.
+             */
+            advance_amount: number;
+            /**
+             * The time at which the funds were paid out to the connected account's Stripe balance. Given in milliseconds since unix epoch.
+             */
+            advance_paid_out_at: number | null;
+            /**
+             * Currency that the financing offer is transacted in. For example, `usd`.
+             */
+            currency: string;
+            /**
+             * The chronologically current repayment interval for the financing offer.
+             */
+            current_repayment_interval: Details.CurrentRepaymentInterval | null;
+            /**
+             * Fixed fee amount, in minor units. For example, 100 USD is represented as 10000.
+             */
+            fee_amount: number;
+            /**
+             * The amount the Connected account has paid toward the financing debt so far, in minor units. For example, 1,000 USD is represented as 100000.
+             */
+            paid_amount: number;
+            /**
+             * The balance remaining to be paid on the financing, in minor units. For example, 1,000 USD is represented as 100000.
+             */
+            remaining_amount: number;
+            /**
+             * The time at which Capital will begin withholding from payments. Given in seconds since unix epoch.
+             */
+            repayments_begin_at: number | null;
+            /**
+             * Per-transaction rate at which Stripe withholds funds to repay the financing.
+             */
+            withhold_rate: number;
+        }
+        type Status = 'accepted' | 'delivered' | 'none';
+        namespace Details {
+            interface CurrentRepaymentInterval {
+                /**
+                 * The time at which the minimum payment amount will be due. If not met through withholding, the Connected account's linked bank account or account balance will be debited.
+                 * Given in seconds since unix epoch.
+                 */
+                due_at: number;
+                /**
+                 * The amount that has already been paid in the current repayment interval, in minor units. For example, 100 USD is represented as 10000.
+                 */
+                paid_amount: number | null;
+                /**
+                 * The amount that is yet to be paid in the current repayment interval, in minor units. For example, 100 USD is represented as 10000.
+                 */
+                remaining_amount: number;
+            }
+        }
+    }
+}
+export declare namespace Capital {
+    interface FinancingSummaryRetrieveParams {
+        /**
+         * Specifies which fields in the response should be expanded.
+         */
+        expand?: Array<string>;
+    }
+}

package/esm/resources/Capital/FinancingSummary.js

@@ -0,0 +1,11 @@
+// File generated from our OpenAPI spec
+import { StripeResource } from '../../StripeResource.js';
+export class FinancingSummaryResource extends StripeResource {
+    /**
+     * Retrieve the financing summary object for the account.
+     */
+    retrieve(params, options) {
+        return this._makeRequest('GET', '/v1/capital/financing_summary', params, options);
+    }
+}
+//# sourceMappingURL=FinancingSummary.js.map

package/esm/resources/Capital/FinancingSummary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FinancingSummary.js","sourceRoot":"","sources":["../../../src/resources/Capital/FinancingSummary.ts"],"names":[],"mappings":"AAAA,uCAAuC;AAEvC,OAAO,EAAC,cAAc,EAAC,MAAM,yBAAyB,CAAC;AAGvD,MAAM,OAAO,wBAAyB,SAAQ,cAAc;IAC1D;;OAEG;IACH,QAAQ,CACN,MAA+C,EAC/C,OAAwB;QAExB,OAAO,IAAI,CAAC,YAAY,CACtB,KAAK,EACL,+BAA+B,EAC/B,MAAM,EACN,OAAO,CACD,CAAC;IACX,CAAC;CACF"}

package/esm/resources/Capital/FinancingTransactions.d.ts

@@ -0,0 +1,143 @@
+import { StripeResource } from '../../StripeResource.js';
+import { PaginationParams } from '../../shared.js';
+import { RequestOptions, ApiListPromise, Response } from '../../lib.js';
+export declare class FinancingTransactionResource extends StripeResource {
+    /**
+     * Returns a list of financing transactions. The transactions are returned in sorted order,
+     * with the most recent transactions appearing first.
+     */
+    list(params?: Capital.FinancingTransactionListParams, options?: RequestOptions): ApiListPromise<FinancingTransaction>;
+    /**
+     * Retrieves a financing transaction for a financing offer.
+     */
+    retrieve(id: string, params?: Capital.FinancingTransactionRetrieveParams, options?: RequestOptions): Promise<Response<FinancingTransaction>>;
+}
+export interface FinancingTransaction {
+    /**
+     * A unique identifier for the financing transaction object.
+     */
+    id: string;
+    /**
+     * The object type: financing_transaction
+     */
+    object: 'capital.financing_transaction';
+    /**
+     * The ID of the merchant associated with this financing transaction.
+     */
+    account: string;
+    /**
+     * Time at which the financing transaction was created. Given in seconds since unix epoch.
+     */
+    created_at: number;
+    /**
+     * This is an object representing a transaction on a Capital financing offer.
+     */
+    details: Capital.FinancingTransaction.Details;
+    /**
+     * The Capital financing offer for this financing transaction.
+     */
+    financing_offer: string | null;
+    /**
+     * The Capital transaction object that predates the Financing Transactions API and
+     * corresponds with the balance transaction that was created as a result of this
+     * financing transaction.
+     */
+    legacy_balance_transaction_source?: string;
+    /**
+     * If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`.
+     */
+    livemode: boolean;
+    /**
+     * The type of the financing transaction.
+     */
+    type: Capital.FinancingTransaction.Type;
+    /**
+     * A human-friendly description of the financing transaction.
+     */
+    user_facing_description: string | null;
+}
+export declare namespace Capital {
+    namespace FinancingTransaction {
+        interface Details {
+            /**
+             * The advance amount being repaid, paid out, or reversed in minor units.
+             */
+            advance_amount: number;
+            /**
+             * The currency of the financing transaction.
+             */
+            currency: string;
+            /**
+             * The fee amount being repaid, paid out, or reversed in minor units.
+             */
+            fee_amount: number;
+            /**
+             * The linked payment for the transaction. This field only applies to financing transactions of type `paydown` and reason `automatic_withholding`.
+             */
+            linked_payment?: string;
+            /**
+             * The reason for the financing transaction (if applicable).
+             */
+            reason?: Details.Reason;
+            /**
+             * The reversed transaction. This field only applies to financing
+             * transactions of type `reversal`.
+             */
+            reversed_transaction?: string;
+            /**
+             * The advance and fee amount being repaid, paid out, or reversed in minor units.
+             */
+            total_amount: number;
+            /**
+             * This is an object representing a linked transaction on a Capital Financing Transaction.
+             */
+            transaction?: Details.Transaction;
+        }
+        type Type = 'payment' | 'payout' | 'reversal';
+        namespace Details {
+            type Reason = 'automatic_withholding' | 'automatic_withholding_refund' | 'collection' | 'collection_failure' | 'financing_cancellation' | 'refill' | 'requested_by_user' | 'user_initiated';
+            interface Transaction {
+                /**
+                 * The linked payment ID.
+                 */
+                charge?: string;
+                /**
+                 * The linked Treasury Financing Transaction ID.
+                 */
+                treasury_transaction?: string;
+            }
+        }
+    }
+}
+export declare namespace Capital {
+    interface FinancingTransactionRetrieveParams {
+        /**
+         * Specifies which fields in the response should be expanded.
+         */
+        expand?: Array<string>;
+    }
+}
+export declare namespace Capital {
+    interface FinancingTransactionListParams extends PaginationParams {
+        /**
+         * For transactions of type `paydown` and reason `automatic_withholding` only, only returns transactions that were created as a result of this charge.
+         */
+        charge?: string;
+        /**
+         * Specifies which fields in the response should be expanded.
+         */
+        expand?: Array<string>;
+        /**
+         * Returns transactions that were created that apply to this financing offer ID.
+         */
+        financing_offer?: string;
+        /**
+         * Only returns transactions that are responsible for reversing this financing transaction ID.
+         */
+        reversed_transaction?: string;
+        /**
+         * For transactions of type `paydown` and reason `automatic_withholding` only, only returns transactions that were created as a result of this Treasury Transaction.
+         */
+        treasury_transaction?: string;
+    }
+}

package/esm/resources/Capital/FinancingTransactions.js

@@ -0,0 +1,20 @@
+// File generated from our OpenAPI spec
+import { StripeResource } from '../../StripeResource.js';
+export class FinancingTransactionResource extends StripeResource {
+    /**
+     * Returns a list of financing transactions. The transactions are returned in sorted order,
+     * with the most recent transactions appearing first.
+     */
+    list(params, options) {
+        return this._makeRequest('GET', '/v1/capital/financing_transactions', params, options, {
+            methodType: 'list',
+        });
+    }
+    /**
+     * Retrieves a financing transaction for a financing offer.
+     */
+    retrieve(id, params, options) {
+        return this._makeRequest('GET', `/v1/capital/financing_transactions/${id}`, params, options);
+    }
+}
+//# sourceMappingURL=FinancingTransactions.js.map

package/esm/resources/Capital/FinancingTransactions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FinancingTransactions.js","sourceRoot":"","sources":["../../../src/resources/Capital/FinancingTransactions.ts"],"names":[],"mappings":"AAAA,uCAAuC;AAEvC,OAAO,EAAC,cAAc,EAAC,MAAM,yBAAyB,CAAC;AAIvD,MAAM,OAAO,4BAA6B,SAAQ,cAAc;IAC9D;;;OAGG;IACH,IAAI,CACF,MAA+C,EAC/C,OAAwB;QAExB,OAAO,IAAI,CAAC,YAAY,CACtB,KAAK,EACL,oCAAoC,EACpC,MAAM,EACN,OAAO,EACP;YACE,UAAU,EAAE,MAAM;SACnB,CACK,CAAC;IACX,CAAC;IACD;;OAEG;IACH,QAAQ,CACN,EAAU,EACV,MAAmD,EACnD,OAAwB;QAExB,OAAO,IAAI,CAAC,YAAY,CACtB,KAAK,EACL,sCAAsC,EAAE,EAAE,EAC1C,MAAM,EACN,OAAO,CACD,CAAC;IACX,CAAC;CACF"}

package/esm/resources/Capital/index.d.ts

@@ -0,0 +1,25 @@
+import { Stripe } from '../../stripe.core.js';
+import { Capital as CapitalNamespace0, FinancingOffer, FinancingOfferResource } from './FinancingOffers.js';
+import { Capital as CapitalNamespace1, FinancingSummary, FinancingSummaryResource } from './FinancingSummary.js';
+import { Capital as CapitalNamespace2, FinancingTransaction, FinancingTransactionResource } from './FinancingTransactions.js';
+export { FinancingOffer } from './FinancingOffers.js';
+export { FinancingSummary } from './FinancingSummary.js';
+export { FinancingTransaction } from './FinancingTransactions.js';
+export declare class Capital {
+    private readonly stripe;
+    financingOffers: FinancingOfferResource;
+    financingSummaries: FinancingSummaryResource;
+    financingTransactions: FinancingTransactionResource;
+    constructor(stripe: Stripe);
+}
+export declare namespace Capital {
+    export import FinancingOfferListParams = CapitalNamespace0.FinancingOfferListParams;
+    export import FinancingOfferRetrieveParams = CapitalNamespace0.FinancingOfferRetrieveParams;
+    export import FinancingOfferMarkDeliveredParams = CapitalNamespace0.FinancingOfferMarkDeliveredParams;
+    export { FinancingOffer };
+    export import FinancingSummaryRetrieveParams = CapitalNamespace1.FinancingSummaryRetrieveParams;
+    export { FinancingSummary };
+    export import FinancingTransactionListParams = CapitalNamespace2.FinancingTransactionListParams;
+    export import FinancingTransactionRetrieveParams = CapitalNamespace2.FinancingTransactionRetrieveParams;
+    export { FinancingTransaction };
+}

package/esm/resources/Capital/index.js

@@ -0,0 +1,13 @@
+// File generated from our OpenAPI spec
+import { FinancingOfferResource, } from './FinancingOffers.js';
+import { FinancingSummaryResource, } from './FinancingSummary.js';
+import { FinancingTransactionResource, } from './FinancingTransactions.js';
+export class Capital {
+    constructor(stripe) {
+        this.stripe = stripe;
+        this.financingOffers = new FinancingOfferResource(stripe);
+        this.financingSummaries = new FinancingSummaryResource(stripe);
+        this.financingTransactions = new FinancingTransactionResource(stripe);
+    }
+}
+//# sourceMappingURL=index.js.map

package/esm/resources/Capital/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/resources/Capital/index.ts"],"names":[],"mappings":"AAAA,uCAAuC;AAGvC,OAAO,EAGL,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAGL,wBAAwB,GACzB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAGL,4BAA4B,GAC7B,MAAM,4BAA4B,CAAC;AAMpC,MAAM,OAAO,OAAO;IAKlB,YAA6B,MAAc;QAAd,WAAM,GAAN,MAAM,CAAQ;QACzC,IAAI,CAAC,eAAe,GAAG,IAAI,sBAAsB,CAAC,MAAM,CAAC,CAAC;QAC1D,IAAI,CAAC,kBAAkB,GAAG,IAAI,wBAAwB,CAAC,MAAM,CAAC,CAAC;QAC/D,IAAI,CAAC,qBAAqB,GAAG,IAAI,4BAA4B,CAAC,MAAM,CAAC,CAAC;IACxE,CAAC;CACF"}

package/esm/resources/Cards.d.ts

@@ -51,10 +51,15 @@ export interface Card {
      * A set of available payout methods for this card. Only values from this set should be passed as the `method` when creating a payout.
      */
     available_payout_methods?: Array<Card.AvailablePayoutMethod> | null;
+    benefits?: Card.Benefits;
     /**
      * Card brand. Can be `American Express`, `Cartes Bancaires`, `Diners Club`, `Discover`, `Eftpos Australia`, `Girocard`, `JCB`, `MasterCard`, `UnionPay`, `Visa`, or `Unknown`.
      */
     brand: string;
+    /**
+     * The [product code](https://stripe.com/docs/card-product-codes) that identifies the specific program or product associated with a card. (For internal use only and not typically available in standard API requests.)
+     */
+    brand_product?: string | null;
     /**
      * Two-letter ISO code representing the country of the card. You could use this attribute to get a sense of the international breakdown of cards you've collected.
      */
@@ -160,6 +165,16 @@ export interface DeletedCard {
 export declare namespace Card {
     type AllowRedisplay = 'always' | 'limited' | 'unspecified';
     type AvailablePayoutMethod = 'instant' | 'standard';
+    interface Benefits {
+        /**
+         * Issuer of this benefit card
+         */
+        issuer: string | null;
+        /**
+         * Available benefit programs for this card
+         */
+        programs: Array<string> | null;
+    }
     interface Networks {
         /**
          * The preferred network for co-branded cards. Can be `cartes_bancaires`, `mastercard`, `visa` or `invalid_preference` if requested network is not valid for the card.