@billkit-eu/sdk 0.7.0 → 0.8.0

package/dist/index.d.cts

@@ -260,6 +260,20 @@ interface PaymentsListParams extends BaseListParams {
     /** Expandable here: `customer`, `subscription`. */
     expand?: string[];
 }
+/**
+ * `oneShotPayments.list` params. `payments.list` lists subscription
+ * payments only; one-off charges are listed here, newest first.
+ * Failed, expired and still-open charges are included, so check `status`
+ * before counting a row as revenue.
+ */
+interface OneShotPaymentsListParams extends BaseListParams {
+    customer_id?: string;
+    /**
+     * One of `open`, `pending`, `authorized`, `paid`, `failed`, `expired`,
+     * `canceled`, `refunded`. Anything else is a `400` on `status`.
+     */
+    status?: string;
+}
 /**
  * `invoices.list` params. The three id filters each narrow to one row's
  * worth of invoices: `payment_id` answers "which invoice did this charge
@@ -328,7 +342,8 @@ interface CreateCustomerParams extends IdempotencyOptions {
 }
 interface UpdateCustomerParams extends IdempotencyOptions {
     email?: string;
-    name?: string;
+    /** An explicit `null` **clears** it and is sent as a JSON null rather than pruned (only `undefined` is dropped); omit the field to leave it alone. */
+    name?: string | null;
     country_code?: string;
     metadata?: Record<string, string>;
 }
@@ -344,7 +359,7 @@ interface CustomerListParams extends BaseListParams {
 }
 /** Query parameters accepted by `GET /v1/products`. */
 interface ProductsListParams extends BaseListParams {
-    /** Expandable here: `prices`, `stats`. */
+    /** Expandable here: `prices`, `stats`, `default_price`. */
     expand?: string[];
 }
 /**
@@ -391,13 +406,22 @@ interface CreateProductParams extends IdempotencyOptions {
 }
 interface UpdateProductParams extends IdempotencyOptions {
     name?: string;
-    description?: string;
+    /** An explicit `null` **clears** it and is sent as a JSON null rather than pruned (only `undefined` is dropped); omit the field to leave it alone. */
+    description?: string | null;
     marketing_features?: string[];
     metadata?: Record<string, string>;
     /** Set false to stop selling a product without deleting history. */
     active?: boolean;
     /** See {@link CreateProductParams.allow_promotion_codes}. */
     allow_promotion_codes?: boolean;
+    /**
+     * The price the billing portal offers on that price's interval. Must be
+     * an active price of this product; anything else is a 400 on
+     * `default_price_id`. An explicit `null` **clears** the default and is
+     * sent as a JSON null rather than pruned (only `undefined` is dropped);
+     * omit the field to leave the default alone.
+     */
+    default_price_id?: string | null;
 }
 /**
  * Body for `POST /v1/prices/{id}`. Every field is optional; omitted ones
@@ -736,7 +760,8 @@ interface CreateWebhookEndpointParams extends IdempotencyOptions {
 interface UpdateWebhookEndpointParams extends IdempotencyOptions {
     url?: string;
     enabled_events?: string[];
-    description?: string;
+    /** An explicit `null` **clears** it and is sent as a JSON null rather than pruned (only `undefined` is dropped); omit the field to leave it alone. */
+    description?: string | null;
     status?: string;
 }
 interface EventsListParams extends BaseListParams {
@@ -778,8 +803,10 @@ interface CreateCouponParams extends IdempotencyOptions {
 }
 interface UpdateCouponParams extends IdempotencyOptions {
     active?: boolean;
-    max_redemptions?: number;
-    redeem_by?: number;
+    /** `null` removes the redemption cap. An explicit `null` **clears** it and is sent as a JSON null rather than pruned (only `undefined` is dropped); omit the field to leave it alone. */
+    max_redemptions?: number | null;
+    /** Epoch seconds. `null` removes the expiry. An explicit `null` **clears** it and is sent as a JSON null rather than pruned (only `undefined` is dropped); omit the field to leave it alone. */
+    redeem_by?: number | null;
     applies_to_price_ids?: string[];
     min_amount_cents?: number;
 }
@@ -806,7 +833,8 @@ interface CreateTaxRateParams extends IdempotencyOptions {
 }
 interface UpdateTaxRateParams extends IdempotencyOptions {
     rate_basis_points?: number;
-    display_name?: string;
+    /** An explicit `null` **clears** it and is sent as a JSON null rather than pruned (only `undefined` is dropped); omit the field to leave it alone. */
+    display_name?: string | null;
     inclusive?: boolean;
     active?: boolean;
 }
@@ -840,15 +868,20 @@ interface CreditNotesListParams extends BaseListParams {
  * VAT is decided against and that an invoice prints.
  *
  * `country_code` is required on every call: there is nothing to leave
- * alone about a jurisdiction. Every other field is partial-update: omit
- * it to leave the stored value alone, or pass an explicit `null` to
- * clear it, because ceasing to be VAT registered (or moving office) is a
- * real event.
+ * alone about a jurisdiction. The address fields and
+ * `registration_number` are partial-update: omit one to leave the stored
+ * value alone, or pass an explicit `null` to clear it, because moving
+ * office is a real event.
+ *
+ * `vat_id` can be set once. After that, a different value or `null` is
+ * refused with a 400 (`param: "vat_id"`, reason `vat_id_locked`) and the
+ * call writes nothing; re-sending the stored number is accepted. BillKit
+ * invoices you reverse-charged against it, so support changes it.
  */
 interface SetTenantBillingProfileParams extends IdempotencyOptions {
     /** ISO-3166-1 alpha-2, e.g. `"NL"`. */
     country_code: string;
-    /** Your own EU VAT registration, or `null` to clear it. */
+    /** Your own EU VAT registration. Set once; support changes or clears it. */
     vat_id?: string | null;
     address_line1?: string | null;
     address_line2?: string | null;
@@ -958,7 +991,10 @@ declare class Customers extends BaseResource {
 declare class Products extends BaseResource {
     /** Create a catalog Product, then attach one or more Prices to it. */
     create<T = unknown>(params: CreateProductParams): Promise<T>;
-    /** Expandable: `prices` (every price on the product), `stats`. */
+    /**
+     * Expandable: `prices` (every price on the product), `stats`, and
+     * `default_price` (the price `default_price_id` names).
+     */
     retrieve<T = unknown>(id: string, options?: ExpandOptions): Promise<T>;
     /**
      * Patch mutable Product fields, or archive it with `active: false`.
@@ -1032,6 +1068,13 @@ declare class OneShotPayments extends BaseResource {
     /** Create a one-off charge; returns the object with a `redirect_url`. */
     create<T = unknown>(params: CreateOneShotPaymentParams): Promise<T>;
     retrieve<T = unknown>(id: string): Promise<T>;
+    /** List one-off charges, newest first. Filter by `customer_id` and `status`. */
+    list<T = unknown>(params?: OneShotPaymentsListParams): Promise<ListResponseEnvelope<T>>;
+    iter<T = unknown>(options?: {
+        pageSize?: number;
+        customer_id?: string;
+        status?: string;
+    }): AsyncIterableIterator<T>;
 }
 declare class Subscriptions extends BaseResource {
     /** Expandable: `customer`, `price`, `refund_eligibility`. */
@@ -1453,7 +1496,20 @@ declare class AuditLogs extends BaseResource {
  * refunds and disputes are separate flows.
  */
 declare class Payments extends BaseResource {
-    /** Expandable: `customer`, `subscription`. */
+    /**
+     * Expandable: `customer`, `subscription`, `refund_eligibility`. The last
+     * is retrieve-only (`list` refuses it with a `400`) and attaches
+     * `refund_eligibility: { object: "refund_eligibility", eligible,
+     * amount_cents, currency, days_remaining, window_ends_at, reason }`:
+     * whether `refunds.create` for the remaining balance would succeed now,
+     * applying the refund window and the price's refund policy, which
+     * `amount_refundable_cents` does not. When `eligible` is false, `reason`
+     * is one of `not_paid`, `unrefundable_type`, `window_expired`,
+     * `fully_refunded`, `disputed`, `operation_pending` or
+     * `plan_change_pending` (a plan change is settling: the full balance
+     * cannot be refunded yet, a partial refund still can); treat any other
+     * value as "not refundable".
+     */
     retrieve<T = unknown>(id: string, options?: ExpandOptions): Promise<T>;
     /**
      * Fetch the provider's own record of this charge, live.
@@ -1610,7 +1666,7 @@ declare class RateLimitError extends BillKitError {
     });
 }
 
-declare const VERSION = "0.7.0";
+declare const VERSION = "0.8.0";
 
 /**
  * Verify `BillKit-Signature: t=<unix>,v1=<hex>` headers.
@@ -1642,4 +1698,4 @@ interface VerifyWebhookOptions {
 }
 declare function verifyWebhookSignature<T = unknown>(options: VerifyWebhookOptions): Promise<T>;
 
-export { APIConnectionError, APIError, type AuditLogsListParams, AuthenticationError, type BaseListParams, BillKit, BillKitError, type BillKitLogger, type BillKitOptions, ConflictError, type CreateApiKeyParams, type CreateBillingPortalSessionParams, type CreateCheckoutSessionParams, type CreateCouponParams, type CreateCustomerParams, type CreateOneShotPaymentParams, type CreatePriceParams, type CreateProductParams, type CreateRefundParams, type CreateTaxRateParams, type CreateUsageRecordParams, type CreateWebhookEndpointParams, type CreditNotesListParams, type CustomerListParams, DEFAULT_RETRY_POLICY, DEFAULT_WEBHOOK_TOLERANCE_SECONDS, type DisputesListParams, type EventsListParams, type ExpandOptions, type IdempotencyOptions, InvalidRequestError, type InvoicesListParams, type ListParams, type ListResponseEnvelope, type LogContext, NOOP_LOGGER, type PaginateOptions, type PaymentsListParams, PermissionError, type PriceTier, type PricesListParams, type ProductsListParams, RateLimitError, ResourceMissingError, type RetryPolicy, type RotateProviderCredentialParams, ServerError, type SetCustomerVatNumberParams, type SetPortalBrandingParams, type SetTenantBillingProfileParams, type SubscriptionsListParams, type UpdateCouponParams, type UpdateCustomerParams, type UpdatePriceParams, type UpdateProductParams, type UpdateTaxRateParams, type UpdateWebhookEndpointParams, type UsageRecordsListParams, VERSION, type ValidateCouponParams, type VerifyWebhookOptions, type VoidInvoiceParams, WebhookVerificationError, paginate, verifyWebhookSignature };
+export { APIConnectionError, APIError, type AuditLogsListParams, AuthenticationError, type BaseListParams, BillKit, BillKitError, type BillKitLogger, type BillKitOptions, ConflictError, type CreateApiKeyParams, type CreateBillingPortalSessionParams, type CreateCheckoutSessionParams, type CreateCouponParams, type CreateCustomerParams, type CreateOneShotPaymentParams, type CreatePriceParams, type CreateProductParams, type CreateRefundParams, type CreateTaxRateParams, type CreateUsageRecordParams, type CreateWebhookEndpointParams, type CreditNotesListParams, type CustomerListParams, DEFAULT_RETRY_POLICY, DEFAULT_WEBHOOK_TOLERANCE_SECONDS, type DisputesListParams, type EventsListParams, type ExpandOptions, type IdempotencyOptions, InvalidRequestError, type InvoicesListParams, type ListParams, type ListResponseEnvelope, type LogContext, NOOP_LOGGER, type OneShotPaymentsListParams, type PaginateOptions, type PaymentsListParams, PermissionError, type PriceTier, type PricesListParams, type ProductsListParams, RateLimitError, ResourceMissingError, type RetryPolicy, type RotateProviderCredentialParams, ServerError, type SetCustomerVatNumberParams, type SetPortalBrandingParams, type SetTenantBillingProfileParams, type SubscriptionsListParams, type UpdateCouponParams, type UpdateCustomerParams, type UpdatePriceParams, type UpdateProductParams, type UpdateTaxRateParams, type UpdateWebhookEndpointParams, type UsageRecordsListParams, VERSION, type ValidateCouponParams, type VerifyWebhookOptions, type VoidInvoiceParams, WebhookVerificationError, paginate, verifyWebhookSignature };

package/dist/index.d.ts

@@ -260,6 +260,20 @@ interface PaymentsListParams extends BaseListParams {
     /** Expandable here: `customer`, `subscription`. */
     expand?: string[];
 }
+/**
+ * `oneShotPayments.list` params. `payments.list` lists subscription
+ * payments only; one-off charges are listed here, newest first.
+ * Failed, expired and still-open charges are included, so check `status`
+ * before counting a row as revenue.
+ */
+interface OneShotPaymentsListParams extends BaseListParams {
+    customer_id?: string;
+    /**
+     * One of `open`, `pending`, `authorized`, `paid`, `failed`, `expired`,
+     * `canceled`, `refunded`. Anything else is a `400` on `status`.
+     */
+    status?: string;
+}
 /**
  * `invoices.list` params. The three id filters each narrow to one row's
  * worth of invoices: `payment_id` answers "which invoice did this charge
@@ -328,7 +342,8 @@ interface CreateCustomerParams extends IdempotencyOptions {
 }
 interface UpdateCustomerParams extends IdempotencyOptions {
     email?: string;
-    name?: string;
+    /** An explicit `null` **clears** it and is sent as a JSON null rather than pruned (only `undefined` is dropped); omit the field to leave it alone. */
+    name?: string | null;
     country_code?: string;
     metadata?: Record<string, string>;
 }
@@ -344,7 +359,7 @@ interface CustomerListParams extends BaseListParams {
 }
 /** Query parameters accepted by `GET /v1/products`. */
 interface ProductsListParams extends BaseListParams {
-    /** Expandable here: `prices`, `stats`. */
+    /** Expandable here: `prices`, `stats`, `default_price`. */
     expand?: string[];
 }
 /**
@@ -391,13 +406,22 @@ interface CreateProductParams extends IdempotencyOptions {
 }
 interface UpdateProductParams extends IdempotencyOptions {
     name?: string;
-    description?: string;
+    /** An explicit `null` **clears** it and is sent as a JSON null rather than pruned (only `undefined` is dropped); omit the field to leave it alone. */
+    description?: string | null;
     marketing_features?: string[];
     metadata?: Record<string, string>;
     /** Set false to stop selling a product without deleting history. */
     active?: boolean;
     /** See {@link CreateProductParams.allow_promotion_codes}. */
     allow_promotion_codes?: boolean;
+    /**
+     * The price the billing portal offers on that price's interval. Must be
+     * an active price of this product; anything else is a 400 on
+     * `default_price_id`. An explicit `null` **clears** the default and is
+     * sent as a JSON null rather than pruned (only `undefined` is dropped);
+     * omit the field to leave the default alone.
+     */
+    default_price_id?: string | null;
 }
 /**
  * Body for `POST /v1/prices/{id}`. Every field is optional; omitted ones
@@ -736,7 +760,8 @@ interface CreateWebhookEndpointParams extends IdempotencyOptions {
 interface UpdateWebhookEndpointParams extends IdempotencyOptions {
     url?: string;
     enabled_events?: string[];
-    description?: string;
+    /** An explicit `null` **clears** it and is sent as a JSON null rather than pruned (only `undefined` is dropped); omit the field to leave it alone. */
+    description?: string | null;
     status?: string;
 }
 interface EventsListParams extends BaseListParams {
@@ -778,8 +803,10 @@ interface CreateCouponParams extends IdempotencyOptions {
 }
 interface UpdateCouponParams extends IdempotencyOptions {
     active?: boolean;
-    max_redemptions?: number;
-    redeem_by?: number;
+    /** `null` removes the redemption cap. An explicit `null` **clears** it and is sent as a JSON null rather than pruned (only `undefined` is dropped); omit the field to leave it alone. */
+    max_redemptions?: number | null;
+    /** Epoch seconds. `null` removes the expiry. An explicit `null` **clears** it and is sent as a JSON null rather than pruned (only `undefined` is dropped); omit the field to leave it alone. */
+    redeem_by?: number | null;
     applies_to_price_ids?: string[];
     min_amount_cents?: number;
 }
@@ -806,7 +833,8 @@ interface CreateTaxRateParams extends IdempotencyOptions {
 }
 interface UpdateTaxRateParams extends IdempotencyOptions {
     rate_basis_points?: number;
-    display_name?: string;
+    /** An explicit `null` **clears** it and is sent as a JSON null rather than pruned (only `undefined` is dropped); omit the field to leave it alone. */
+    display_name?: string | null;
     inclusive?: boolean;
     active?: boolean;
 }
@@ -840,15 +868,20 @@ interface CreditNotesListParams extends BaseListParams {
  * VAT is decided against and that an invoice prints.
  *
  * `country_code` is required on every call: there is nothing to leave
- * alone about a jurisdiction. Every other field is partial-update: omit
- * it to leave the stored value alone, or pass an explicit `null` to
- * clear it, because ceasing to be VAT registered (or moving office) is a
- * real event.
+ * alone about a jurisdiction. The address fields and
+ * `registration_number` are partial-update: omit one to leave the stored
+ * value alone, or pass an explicit `null` to clear it, because moving
+ * office is a real event.
+ *
+ * `vat_id` can be set once. After that, a different value or `null` is
+ * refused with a 400 (`param: "vat_id"`, reason `vat_id_locked`) and the
+ * call writes nothing; re-sending the stored number is accepted. BillKit
+ * invoices you reverse-charged against it, so support changes it.
  */
 interface SetTenantBillingProfileParams extends IdempotencyOptions {
     /** ISO-3166-1 alpha-2, e.g. `"NL"`. */
     country_code: string;
-    /** Your own EU VAT registration, or `null` to clear it. */
+    /** Your own EU VAT registration. Set once; support changes or clears it. */
     vat_id?: string | null;
     address_line1?: string | null;
     address_line2?: string | null;
@@ -958,7 +991,10 @@ declare class Customers extends BaseResource {
 declare class Products extends BaseResource {
     /** Create a catalog Product, then attach one or more Prices to it. */
     create<T = unknown>(params: CreateProductParams): Promise<T>;
-    /** Expandable: `prices` (every price on the product), `stats`. */
+    /**
+     * Expandable: `prices` (every price on the product), `stats`, and
+     * `default_price` (the price `default_price_id` names).
+     */
     retrieve<T = unknown>(id: string, options?: ExpandOptions): Promise<T>;
     /**
      * Patch mutable Product fields, or archive it with `active: false`.
@@ -1032,6 +1068,13 @@ declare class OneShotPayments extends BaseResource {
     /** Create a one-off charge; returns the object with a `redirect_url`. */
     create<T = unknown>(params: CreateOneShotPaymentParams): Promise<T>;
     retrieve<T = unknown>(id: string): Promise<T>;
+    /** List one-off charges, newest first. Filter by `customer_id` and `status`. */
+    list<T = unknown>(params?: OneShotPaymentsListParams): Promise<ListResponseEnvelope<T>>;
+    iter<T = unknown>(options?: {
+        pageSize?: number;
+        customer_id?: string;
+        status?: string;
+    }): AsyncIterableIterator<T>;
 }
 declare class Subscriptions extends BaseResource {
     /** Expandable: `customer`, `price`, `refund_eligibility`. */
@@ -1453,7 +1496,20 @@ declare class AuditLogs extends BaseResource {
  * refunds and disputes are separate flows.
  */
 declare class Payments extends BaseResource {
-    /** Expandable: `customer`, `subscription`. */
+    /**
+     * Expandable: `customer`, `subscription`, `refund_eligibility`. The last
+     * is retrieve-only (`list` refuses it with a `400`) and attaches
+     * `refund_eligibility: { object: "refund_eligibility", eligible,
+     * amount_cents, currency, days_remaining, window_ends_at, reason }`:
+     * whether `refunds.create` for the remaining balance would succeed now,
+     * applying the refund window and the price's refund policy, which
+     * `amount_refundable_cents` does not. When `eligible` is false, `reason`
+     * is one of `not_paid`, `unrefundable_type`, `window_expired`,
+     * `fully_refunded`, `disputed`, `operation_pending` or
+     * `plan_change_pending` (a plan change is settling: the full balance
+     * cannot be refunded yet, a partial refund still can); treat any other
+     * value as "not refundable".
+     */
     retrieve<T = unknown>(id: string, options?: ExpandOptions): Promise<T>;
     /**
      * Fetch the provider's own record of this charge, live.
@@ -1610,7 +1666,7 @@ declare class RateLimitError extends BillKitError {
     });
 }
 
-declare const VERSION = "0.7.0";
+declare const VERSION = "0.8.0";
 
 /**
  * Verify `BillKit-Signature: t=<unix>,v1=<hex>` headers.
@@ -1642,4 +1698,4 @@ interface VerifyWebhookOptions {
 }
 declare function verifyWebhookSignature<T = unknown>(options: VerifyWebhookOptions): Promise<T>;
 
-export { APIConnectionError, APIError, type AuditLogsListParams, AuthenticationError, type BaseListParams, BillKit, BillKitError, type BillKitLogger, type BillKitOptions, ConflictError, type CreateApiKeyParams, type CreateBillingPortalSessionParams, type CreateCheckoutSessionParams, type CreateCouponParams, type CreateCustomerParams, type CreateOneShotPaymentParams, type CreatePriceParams, type CreateProductParams, type CreateRefundParams, type CreateTaxRateParams, type CreateUsageRecordParams, type CreateWebhookEndpointParams, type CreditNotesListParams, type CustomerListParams, DEFAULT_RETRY_POLICY, DEFAULT_WEBHOOK_TOLERANCE_SECONDS, type DisputesListParams, type EventsListParams, type ExpandOptions, type IdempotencyOptions, InvalidRequestError, type InvoicesListParams, type ListParams, type ListResponseEnvelope, type LogContext, NOOP_LOGGER, type PaginateOptions, type PaymentsListParams, PermissionError, type PriceTier, type PricesListParams, type ProductsListParams, RateLimitError, ResourceMissingError, type RetryPolicy, type RotateProviderCredentialParams, ServerError, type SetCustomerVatNumberParams, type SetPortalBrandingParams, type SetTenantBillingProfileParams, type SubscriptionsListParams, type UpdateCouponParams, type UpdateCustomerParams, type UpdatePriceParams, type UpdateProductParams, type UpdateTaxRateParams, type UpdateWebhookEndpointParams, type UsageRecordsListParams, VERSION, type ValidateCouponParams, type VerifyWebhookOptions, type VoidInvoiceParams, WebhookVerificationError, paginate, verifyWebhookSignature };
+export { APIConnectionError, APIError, type AuditLogsListParams, AuthenticationError, type BaseListParams, BillKit, BillKitError, type BillKitLogger, type BillKitOptions, ConflictError, type CreateApiKeyParams, type CreateBillingPortalSessionParams, type CreateCheckoutSessionParams, type CreateCouponParams, type CreateCustomerParams, type CreateOneShotPaymentParams, type CreatePriceParams, type CreateProductParams, type CreateRefundParams, type CreateTaxRateParams, type CreateUsageRecordParams, type CreateWebhookEndpointParams, type CreditNotesListParams, type CustomerListParams, DEFAULT_RETRY_POLICY, DEFAULT_WEBHOOK_TOLERANCE_SECONDS, type DisputesListParams, type EventsListParams, type ExpandOptions, type IdempotencyOptions, InvalidRequestError, type InvoicesListParams, type ListParams, type ListResponseEnvelope, type LogContext, NOOP_LOGGER, type OneShotPaymentsListParams, type PaginateOptions, type PaymentsListParams, PermissionError, type PriceTier, type PricesListParams, type ProductsListParams, RateLimitError, ResourceMissingError, type RetryPolicy, type RotateProviderCredentialParams, ServerError, type SetCustomerVatNumberParams, type SetPortalBrandingParams, type SetTenantBillingProfileParams, type SubscriptionsListParams, type UpdateCouponParams, type UpdateCustomerParams, type UpdatePriceParams, type UpdateProductParams, type UpdateTaxRateParams, type UpdateWebhookEndpointParams, type UsageRecordsListParams, VERSION, type ValidateCouponParams, type VerifyWebhookOptions, type VoidInvoiceParams, WebhookVerificationError, paginate, verifyWebhookSignature };

package/dist/index.js

@@ -166,7 +166,10 @@ var Products = class extends BaseResource {
   create(params) {
     return this.post("/v1/products", params);
   }
-  /** Expandable: `prices` (every price on the product), `stats`. */
+  /**
+   * Expandable: `prices` (every price on the product), `stats`, and
+   * `default_price` (the price `default_price_id` names).
+   */
   retrieve(id, options = {}) {
     return this.get(`/v1/products/${p(id)}`, options);
   }
@@ -260,6 +263,16 @@ var OneShotPayments = class extends BaseResource {
   retrieve(id) {
     return this.get(`/v1/checkout/one_shot/${p(id)}`);
   }
+  /** List one-off charges, newest first. Filter by `customer_id` and `status`. */
+  list(params = {}) {
+    return this.get("/v1/checkout/one_shot", params);
+  }
+  iter(options = {}) {
+    return paginate((page) => this.get("/v1/checkout/one_shot", page), {
+      pageSize: options.pageSize,
+      filters: { customer_id: options.customer_id, status: options.status }
+    });
+  }
 };
 var Subscriptions = class extends BaseResource {
   /** Expandable: `customer`, `price`, `refund_eligibility`. */
@@ -772,7 +785,20 @@ var AuditLogs = class extends BaseResource {
   }
 };
 var Payments = class extends BaseResource {
-  /** Expandable: `customer`, `subscription`. */
+  /**
+   * Expandable: `customer`, `subscription`, `refund_eligibility`. The last
+   * is retrieve-only (`list` refuses it with a `400`) and attaches
+   * `refund_eligibility: { object: "refund_eligibility", eligible,
+   * amount_cents, currency, days_remaining, window_ends_at, reason }`:
+   * whether `refunds.create` for the remaining balance would succeed now,
+   * applying the refund window and the price's refund policy, which
+   * `amount_refundable_cents` does not. When `eligible` is false, `reason`
+   * is one of `not_paid`, `unrefundable_type`, `window_expired`,
+   * `fully_refunded`, `disputed`, `operation_pending` or
+   * `plan_change_pending` (a plan change is settling: the full balance
+   * cannot be refunded yet, a partial refund still can); treat any other
+   * value as "not refundable".
+   */
   retrieve(id, options = {}) {
     return this.get(`/v1/payments/${p(id)}`, options);
   }
@@ -971,7 +997,7 @@ function sleep(ms) {
 }
 
 // src/version.ts
-var VERSION = "0.7.0";
+var VERSION = "0.8.0";
 
 // src/transport.ts
 var DEFAULT_BASE_URL = "https://api.billkit.eu";