@usebillow/sdk 0.11.0 → 0.12.0

package/dist/{index.d-DSEYhV2c.d.ts → index.d-D5v2ETKF.d.cts}

@@ -246,7 +246,7 @@ declare const invoicePaymentResponseSchema: z.ZodObject<{
         failed: "failed";
         processing: "processing";
     }>;
-    expiresAt: z.ZodString;
+    expiresAt: z.ZodCustomStringFormat<"datetime">;
 }, z.core.$strip>;
 type PayInvoiceInput = z.infer<typeof payInvoiceSchema>;
 type InvoicePaymentResult = z.infer<typeof invoicePaymentResponseSchema>;
@@ -285,6 +285,8 @@ declare const createPortalSessionSchema: z.ZodObject<{
     }>>;
     productId: z.ZodOptional<z.ZodString>;
     returnUrl: z.ZodOptional<z.ZodString>;
+    domain: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    hostedOnly: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
 type CreatePortalSessionInput = z.infer<typeof createPortalSessionSchema>;
 declare const createProductSchema: z.ZodObject<{
@@ -574,6 +576,10 @@ declare const subscriptionResponseSchema: z.ZodObject<{
         productSlug: z.ZodString;
         productName: z.ZodString;
         effectiveAt: z.ZodNullable<z.ZodString>;
+        blocked: z.ZodNullable<z.ZodObject<{
+            reason: z.ZodString;
+            since: z.ZodString;
+        }, z.core.$strict>>;
     }, z.core.$strict>>;
     canceledAt: z.ZodNullable<z.ZodString>;
     remainingCycles: z.ZodNullable<z.ZodNumber>;
@@ -610,6 +616,10 @@ declare const subscriptionDetailResponseSchema: z.ZodObject<{
         productSlug: z.ZodString;
         productName: z.ZodString;
         effectiveAt: z.ZodNullable<z.ZodString>;
+        blocked: z.ZodNullable<z.ZodObject<{
+            reason: z.ZodString;
+            since: z.ZodString;
+        }, z.core.$strict>>;
     }, z.core.$strict>>;
     canceledAt: z.ZodNullable<z.ZodString>;
     remainingCycles: z.ZodNullable<z.ZodNumber>;
@@ -645,6 +655,10 @@ declare const activatedSubscriptionResponseSchema: z.ZodObject<{
         productSlug: z.ZodString;
         productName: z.ZodString;
         effectiveAt: z.ZodNullable<z.ZodString>;
+        blocked: z.ZodNullable<z.ZodObject<{
+            reason: z.ZodString;
+            since: z.ZodString;
+        }, z.core.$strict>>;
     }, z.core.$strict>>;
     canceledAt: z.ZodNullable<z.ZodString>;
     remainingCycles: z.ZodNullable<z.ZodNumber>;
@@ -700,6 +714,10 @@ declare const createSubscriptionResponseSchema: z.ZodUnion<readonly [z.ZodObject
         productSlug: z.ZodString;
         productName: z.ZodString;
         effectiveAt: z.ZodNullable<z.ZodString>;
+        blocked: z.ZodNullable<z.ZodObject<{
+            reason: z.ZodString;
+            since: z.ZodString;
+        }, z.core.$strict>>;
     }, z.core.$strict>>;
     canceledAt: z.ZodNullable<z.ZodString>;
     remainingCycles: z.ZodNullable<z.ZodNumber>;
@@ -765,6 +783,7 @@ declare const createWebhookEndpointSchema: z.ZodObject<{
         "charge.succeeded": "charge.succeeded";
         "charge.failed": "charge.failed";
         "charge.refunded": "charge.refunded";
+        "charge.refund_reversed": "charge.refund_reversed";
         "charge.disputed": "charge.disputed";
         "charge.dispute_resolved": "charge.dispute_resolved";
         "invoice.paid": "invoice.paid";
@@ -812,6 +831,7 @@ declare const updateWebhookEndpointSchema: z.ZodObject<{
         "charge.succeeded": "charge.succeeded";
         "charge.failed": "charge.failed";
         "charge.refunded": "charge.refunded";
+        "charge.refund_reversed": "charge.refund_reversed";
         "charge.disputed": "charge.disputed";
         "charge.dispute_resolved": "charge.dispute_resolved";
         "invoice.paid": "invoice.paid";

package/dist/{index.d-DSEYhV2c.d.cts → index.d-D5v2ETKF.d.ts}

@@ -246,7 +246,7 @@ declare const invoicePaymentResponseSchema: z.ZodObject<{
         failed: "failed";
         processing: "processing";
     }>;
-    expiresAt: z.ZodString;
+    expiresAt: z.ZodCustomStringFormat<"datetime">;
 }, z.core.$strip>;
 type PayInvoiceInput = z.infer<typeof payInvoiceSchema>;
 type InvoicePaymentResult = z.infer<typeof invoicePaymentResponseSchema>;
@@ -285,6 +285,8 @@ declare const createPortalSessionSchema: z.ZodObject<{
     }>>;
     productId: z.ZodOptional<z.ZodString>;
     returnUrl: z.ZodOptional<z.ZodString>;
+    domain: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    hostedOnly: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
 type CreatePortalSessionInput = z.infer<typeof createPortalSessionSchema>;
 declare const createProductSchema: z.ZodObject<{
@@ -574,6 +576,10 @@ declare const subscriptionResponseSchema: z.ZodObject<{
         productSlug: z.ZodString;
         productName: z.ZodString;
         effectiveAt: z.ZodNullable<z.ZodString>;
+        blocked: z.ZodNullable<z.ZodObject<{
+            reason: z.ZodString;
+            since: z.ZodString;
+        }, z.core.$strict>>;
     }, z.core.$strict>>;
     canceledAt: z.ZodNullable<z.ZodString>;
     remainingCycles: z.ZodNullable<z.ZodNumber>;
@@ -610,6 +616,10 @@ declare const subscriptionDetailResponseSchema: z.ZodObject<{
         productSlug: z.ZodString;
         productName: z.ZodString;
         effectiveAt: z.ZodNullable<z.ZodString>;
+        blocked: z.ZodNullable<z.ZodObject<{
+            reason: z.ZodString;
+            since: z.ZodString;
+        }, z.core.$strict>>;
     }, z.core.$strict>>;
     canceledAt: z.ZodNullable<z.ZodString>;
     remainingCycles: z.ZodNullable<z.ZodNumber>;
@@ -645,6 +655,10 @@ declare const activatedSubscriptionResponseSchema: z.ZodObject<{
         productSlug: z.ZodString;
         productName: z.ZodString;
         effectiveAt: z.ZodNullable<z.ZodString>;
+        blocked: z.ZodNullable<z.ZodObject<{
+            reason: z.ZodString;
+            since: z.ZodString;
+        }, z.core.$strict>>;
     }, z.core.$strict>>;
     canceledAt: z.ZodNullable<z.ZodString>;
     remainingCycles: z.ZodNullable<z.ZodNumber>;
@@ -700,6 +714,10 @@ declare const createSubscriptionResponseSchema: z.ZodUnion<readonly [z.ZodObject
         productSlug: z.ZodString;
         productName: z.ZodString;
         effectiveAt: z.ZodNullable<z.ZodString>;
+        blocked: z.ZodNullable<z.ZodObject<{
+            reason: z.ZodString;
+            since: z.ZodString;
+        }, z.core.$strict>>;
     }, z.core.$strict>>;
     canceledAt: z.ZodNullable<z.ZodString>;
     remainingCycles: z.ZodNullable<z.ZodNumber>;
@@ -765,6 +783,7 @@ declare const createWebhookEndpointSchema: z.ZodObject<{
         "charge.succeeded": "charge.succeeded";
         "charge.failed": "charge.failed";
         "charge.refunded": "charge.refunded";
+        "charge.refund_reversed": "charge.refund_reversed";
         "charge.disputed": "charge.disputed";
         "charge.dispute_resolved": "charge.dispute_resolved";
         "invoice.paid": "invoice.paid";
@@ -812,6 +831,7 @@ declare const updateWebhookEndpointSchema: z.ZodObject<{
         "charge.succeeded": "charge.succeeded";
         "charge.failed": "charge.failed";
         "charge.refunded": "charge.refunded";
+        "charge.refund_reversed": "charge.refund_reversed";
         "charge.disputed": "charge.disputed";
         "charge.dispute_resolved": "charge.dispute_resolved";
         "invoice.paid": "invoice.paid";

package/dist/index.d.cts

@@ -1,13 +1,13 @@
-import { f as SavedPaymentMethod, g as CreateHostedDomainInput, h as PayInvoiceInput } from './index.d-DSEYhV2c.cjs';
-export { i as ContractAddSubscriptionItemInput, j as ContractApplySubscriptionCouponInput, k as ContractCancelSubscriptionInput, l as ContractChangeSubscriptionPlanInput, m as ContractCreateChargeInput, n as ContractCreateCustomerInput, o as ContractCreateMerchantInitiatedChargeInput, p as ContractCreatePortalSessionInput, q as ContractCreateProductInput, r as ContractCreateSubscriptionInput, s as ContractCreateWebhookEndpointInput, M as ContractMigrateSubscribersInput, R as ContractRefundChargeInput, t as ContractResolveRefundInput, U as ContractUpdateProductInput, u as ContractUpdateSubscriptionItemInput, v as ContractUpdateWebhookEndpointInput, H as HostedDomain, w as HostedDomainList, I as InvoicePaymentResult } from './index.d-DSEYhV2c.cjs';
+import { f as SavedPaymentMethod, g as CreateHostedDomainInput, h as PayInvoiceInput } from './index.d-D5v2ETKF.cjs';
+export { i as ContractAddSubscriptionItemInput, j as ContractApplySubscriptionCouponInput, k as ContractCancelSubscriptionInput, l as ContractChangeSubscriptionPlanInput, m as ContractCreateChargeInput, n as ContractCreateCustomerInput, o as ContractCreateMerchantInitiatedChargeInput, p as ContractCreatePortalSessionInput, q as ContractCreateProductInput, r as ContractCreateSubscriptionInput, s as ContractCreateWebhookEndpointInput, M as ContractMigrateSubscribersInput, R as ContractRefundChargeInput, t as ContractResolveRefundInput, U as ContractUpdateProductInput, u as ContractUpdateSubscriptionItemInput, v as ContractUpdateWebhookEndpointInput, H as HostedDomain, w as HostedDomainList, I as InvoicePaymentResult } from './index.d-D5v2ETKF.cjs';
 import { C as ChargeStatus, P as PaymentMethodStatus, I as InvoiceStatus, R as RefundStatus, W as WebhookDeliveryStatus } from './billing-status-DZkB0VPK.cjs';
 export { a as CHARGE_STATUSES, b as INVOICE_STATUSES, c as PAYMENT_METHOD_STATUSES, d as REFUND_STATUSES, e as WEBHOOK_DELIVERY_STATUSES } from './billing-status-DZkB0VPK.cjs';
 import { SubscriptionStatus } from './status.cjs';
 export { ACTIVE_SUBSCRIPTION_STATUSES, NEVER_ACTIVATED_SUBSCRIPTION_STATUSES, SUBSCRIPTION_STATUSES, TERMINAL_SUBSCRIPTION_STATUSES, grantsAccess, isTerminal } from './status.cjs';
-import { c as TaxBehavior, d as Customer, U as UnappliedPaymentReason, e as CreateChargeInput, R as RequestOptions, f as Charge, g as CreateMerchantInitiatedChargeInput, I as IdempotentRequestOptions, h as CallOptions, C as CreateProductInput, i as UpdateProductInput, j as MigrationResult, k as CreateSubscriptionInput, B as BillowOptions, a as CreateCouponInput, l as Coupon, F as FeatureKind, M as MeterConfig, m as Feature, n as UpdateFeatureInput, o as UsageAlert, p as CreateUsageAlertInput, b as CheckResult, T as TrackResult, E as EntitlementView, A as AttachResult } from './billing-8ug1Gw05.cjs';
-export { q as ActivatedSubscriptionResult, r as BillingInterval, s as CouponDuration, t as CouponKind, u as CreateSubscriptionResult, v as EntitlementInput, w as MeterAggregation, x as MeterFilter, y as MeterRoundingMode, z as PendingSubscriptionCheckoutResult, D as PriceInput, P as Product, G as ProductEntitlement, H as ProductPrice, S as Subscription, J as SubscriptionDetail, K as SubscriptionItem, L as UpdatePriceInput, N as UsageAlertKind, O as UsageAlertMetric, Q as UsageModel, V as UsageTier } from './billing-8ug1Gw05.cjs';
-import { a as CreditThresholdLevel, e as CreditGrant, f as CreditTopUp, g as CreditIncludedWindow, h as CreateCreditGrantInput, i as CreditGrantRequestResult, j as CreditAccount, k as CreditPacks, l as CreateCreditPackInput, m as CreditPack, U as UpdateCreditPackInput, n as CreateCreditIncludedRuleInput, o as CreditIncludedRule, p as UpdateCreditIncludedRuleInput, q as CreditIncludedWindowListParams, r as CreateCreditTopUpInput, s as CreditTopUpRequestResult, t as CreditTopUpListParams, u as CreditBalance, v as CreditLedgerEntry, w as CreditUsageParams, x as CreditUsage } from './hosted-domains-zWm2srOk.cjs';
-export { y as CreditAccountStatus, z as CreditAllocationInterval, C as CreditGrantKind, A as CreditMoney, B as CreditPackBreakdown, D as CreditPackListItem, E as CreditTopUpStatus, F as CreditTransactionType, G as CreditUsageGroupBy, I as CreditWindowState, H as HostedDomainActivatedData, d as HostedDomainDisabledData, b as HostedDomainDnsFailingData, J as HostedDomainEventBase, c as HostedDomainReassignmentPendingData, K as HostedDomainStatus, L as HostedDomainStatusReason, M as IncludedCredits, N as IncludedPeriod } from './hosted-domains-zWm2srOk.cjs';
+import { c as TaxBehavior, d as Customer, U as UnappliedPaymentReason, e as CreateChargeInput, R as RequestOptions, f as Charge, g as CreateMerchantInitiatedChargeInput, I as IdempotentRequestOptions, h as CallOptions, C as CreateProductInput, i as UpdateProductInput, j as MigrationResult, k as CreateSubscriptionInput, B as BillowOptions, a as CreateCouponInput, l as Coupon, F as FeatureKind, M as MeterConfig, m as Feature, n as UpdateFeatureInput, o as UsageAlert, p as CreateUsageAlertInput, b as CheckResult, T as TrackResult, E as EntitlementView, A as AttachResult } from './billing-CDEO8Jqv.cjs';
+export { q as ActivatedSubscriptionResult, r as BillingInterval, s as CouponDuration, t as CouponKind, u as CreateSubscriptionResult, v as EntitlementInput, w as MeterAggregation, x as MeterFilter, y as MeterRoundingMode, z as PendingSubscriptionCheckoutResult, D as PriceInput, P as Product, G as ProductEntitlement, H as ProductPrice, S as Subscription, J as SubscriptionDetail, K as SubscriptionItem, L as UpdatePriceInput, N as UsageAlertKind, O as UsageAlertMetric, Q as UsageModel, V as UsageTier } from './billing-CDEO8Jqv.cjs';
+import { a as CreditThresholdLevel, e as CreditGrant, f as CreditTopUp, g as CreditIncludedWindow, h as CreateCreditGrantInput, i as CreditGrantRequestResult, j as CreditAccount, k as CreditPacks, l as CreateCreditPackInput, m as CreditPack, U as UpdateCreditPackInput, n as CreateCreditIncludedRuleInput, o as CreditIncludedRule, p as UpdateCreditIncludedRuleInput, q as CreditIncludedWindowListParams, r as CreateCreditTopUpInput, s as CreditTopUpRequestResult, t as CreditTopUpListParams, u as CreditBalance, v as CreditLedgerEntry, w as CreditUsageParams, x as CreditUsage } from './hosted-domains-Cuk3j04R.cjs';
+export { y as CreditAccountStatus, z as CreditAllocationInterval, C as CreditGrantKind, A as CreditMoney, B as CreditPackBreakdown, D as CreditPackListItem, E as CreditTopUpStatus, F as CreditTransactionType, G as CreditUsageGroupBy, I as CreditWindowState, H as HostedDomainActivatedData, d as HostedDomainDisabledData, b as HostedDomainDnsFailingData, J as HostedDomainEventBase, c as HostedDomainReassignmentPendingData, K as HostedDomainStatus, L as HostedDomainStatusReason, M as IncludedCredits, N as IncludedPeriod } from './hosted-domains-Cuk3j04R.cjs';
 import 'zod';
 
 /**
@@ -19,7 +19,7 @@ import 'zod';
  * differently). The `code` field stays widened to `string` for forward-compatibility, so a code a
  * newer server adds never breaks type-checking against an older SDK.
  */
-declare const BILLOW_ERROR_CODES: readonly ["not_found", "validation_error", "authentication_error", "api_key_expired", "permission_denied", "conflict", "invalid_state_transition", "provider_error", "rate_limited", "quota_exceeded", "internal_error", "insufficient_credits", "account_frozen", "account_closed", "idempotency_conflict", "commit_exceeds_hold", "reversal_exceeds_consumption"];
+declare const BILLOW_ERROR_CODES: readonly ["not_found", "validation_error", "authentication_error", "api_key_expired", "permission_denied", "conflict", "invalid_state_transition", "provider_error", "rate_limited", "quota_exceeded", "internal_error", "insufficient_credits", "account_frozen", "account_closed", "idempotency_conflict", "commit_exceeds_hold", "reversal_exceeds_consumption", "hosted_domain_unavailable"];
 type BillowErrorCode = (typeof BILLOW_ERROR_CODES)[number];
 
 /** Public SDK types for this domain. Re-exported by ../types.ts. */
@@ -329,7 +329,7 @@ interface OutboxEventListItem {
 interface OutboxEventListParams extends ListParams {
     status?: OutboxEventStatus;
 }
-type InboundWebhookOutcome = "signature_failed" | "shape_rejected" | "replayed" | "matched" | "unmatched" | "dispute_matched" | "dispute_unknown" | "dispute_deferred" | "accepted";
+type InboundWebhookOutcome = "signature_failed" | "shape_rejected" | "replayed" | "matched" | "unmatched" | "dispute_matched" | "dispute_unknown" | "dispute_deferred" | "card_deferred" | "accepted";
 interface InboundWebhookListItem {
     id: string;
     provider: string;
@@ -349,6 +349,8 @@ interface InboundWebhookListParams extends ListParams {
 interface CustomerUsage {
     /** The metered feature's slug. */
     feature: string;
+    /** The metered feature's display name, as you named it (`API calls` for `api_calls`). */
+    featureName: string;
     /** Granted units this period; null = unlimited. */
     allowance: number | null;
     /** Gross units used this period (sum of positive events in the period). */
@@ -443,6 +445,15 @@ interface ScheduledSubscriptionChange {
     productSlug: string;
     productName: string;
     effectiveAt: string | null;
+    /**
+     * Set while the change cannot land at renewal - the customer has since subscribed to its
+     * product, or to one billing its usage: why, and since when. The subscription renews on its
+     * current plan meanwhile; each renewal tries the change again until it lands or is cleared.
+     */
+    blocked: {
+        reason: string;
+        since: string;
+    } | null;
 }
 interface SubscriptionListParams extends ListParams {
     status?: SubscriptionStatus;
@@ -729,13 +740,18 @@ interface CreditRateCardItem {
     /** How many units `unitPrice` buys. */
     perUnits: string;
 }
-/** An immutable Rate Card version: a price change is a new version. */
+/**
+ * An immutable Rate Card version: a price change is a new version. One scheduled for the future
+ * may be retracted until it takes effect.
+ */
 interface CreditRateCard {
     id: string;
     /** 1, 2, 3... in the order versions were published (and take effect). */
     version: number;
-    /** From when it prices new quotes and reservations made from items. */
+    /** From when it prices new quotes and reservations made from items, unless retracted before. */
     effectiveAt: string;
+    /** When it was retracted, before `effectiveAt`; null unless retracted. It never takes effect. */
+    retractedAt: string | null;
     /** Its prices, by action. */
     items: CreditRateCardItem[];
     createdAt: string;
@@ -744,7 +760,7 @@ interface CreditRateCard {
 interface PublishCreditRateCardInput {
     /**
      * When it takes effect (ISO 8601 with a timezone): now when omitted; never in the past, nor
-     * before the version before it takes effect.
+     * before the last version before it not retracted takes effect.
      */
     effectiveAt?: string;
     items: Array<{
@@ -933,6 +949,20 @@ interface CreatePortalSessionInput {
      * `localhost` is also accepted over `http`, on any port, in either environment.
      */
     returnUrl?: string;
+    /**
+     * The host to open the session on. Omitted: the Project's primary custom domain when it can take
+     * sessions right now, otherwise the shared portal host - so a merchant's DNS trouble never stops
+     * billing from opening. A hostname: that custom domain of the Project, or a 422
+     * `hosted_domain_unavailable` when it cannot take sessions. `null`: the shared portal host.
+     * Sandbox sessions always use the shared portal host.
+     */
+    domain?: string | null;
+    /**
+     * Mint for Billow's hosted portal only: the URL's token opens the portal link once and is good
+     * for nothing else - never a bearer for your own surface's `/portal` calls. Sessions on a custom
+     * domain always behave this way.
+     */
+    hostedOnly?: boolean;
 }
 /**
  * The minted portal session: redirect the Customer to `url` at once. Its token is a single-use
@@ -996,17 +1026,30 @@ interface PortalView {
     };
     flow: PortalSessionFlow;
     returnUrl: string | null;
-    subscriptions: SubscriptionListItem[];
+    subscriptions: PortalSubscription[];
     usage: CustomerUsage[];
     paymentMethods: SavedPaymentMethod[];
 }
+/**
+ * A scheduled plan change as the Customer sees it: `blocked` says only that it is on hold and
+ * since when - the reason is for the Operator (`ScheduledSubscriptionChange.blocked`).
+ */
+type PortalScheduledChange = Omit<ScheduledSubscriptionChange, "blocked"> & {
+    blocked: {
+        since: string;
+    } | null;
+};
+/** A subscription as the portal lists it. */
+type PortalSubscription = Omit<SubscriptionListItem, "scheduledChange"> & {
+    scheduledChange: PortalScheduledChange | null;
+};
 /** The subscription's state after a portal cancel (scheduled at period end). */
 interface PortalSubscriptionStatus {
     id: string;
     status: string;
     cancelAtPeriodEnd: boolean;
     currentPeriodEnd: string | null;
-    scheduledChange: ScheduledSubscriptionChange | null;
+    scheduledChange: PortalScheduledChange | null;
 }
 /** The outcome of a portal-driven plan change (PRD-15). */
 interface PortalPlanChange {
@@ -1156,6 +1199,18 @@ interface CustomerDataExport {
         createdAt: string;
         updatedAt: string;
     }>;
+    /** Credit notes voided on those refunds (the provider reversed the refund), as issued. */
+    voidedCreditNotes: Array<{
+        id: string;
+        refundId: string;
+        number: string;
+        amount: number;
+        subtotal: number;
+        tax: number;
+        currency: string;
+        issuedAt: string;
+        voidedAt: string;
+    }>;
     usageEvents: Array<{
         id: string;
         featureId: string;
@@ -1237,6 +1292,15 @@ interface CustomerAnonymizationResult {
  * - `conflict_on_charge`: another refund of the charge has an unresolved provider conflict.
  */
 type RefundReviewReason = "unconfirmed" | "unconfirmable_without_provider_id" | "provider_conflict" | "conflict_on_charge";
+/** A credit note voided on a refund, exactly as it was issued (see `Refund.voidedCreditNotes`). */
+interface VoidedCreditNote {
+    number: string;
+    amount: number;
+    subtotal: number;
+    tax: number;
+    issuedAt: string;
+    voidedAt: string;
+}
 interface Refund {
     id: string;
     chargeId: string;
@@ -1257,12 +1321,20 @@ interface Refund {
     /** Why it needs (or needed) review - see `RefundReviewReason`. */
     reviewReason: RefundReviewReason | null;
     providerRefundId: string | null;
+    /** The refund's credit note in force (null when it has none, e.g. once it was voided). */
     creditNoteNumber: string | null;
+    /**
+     * Credit notes issued for this refund and voided since: the provider reversed the refund after it
+     * succeeded (the customer's bank returned the money) and it was resolved as not refunded. Each is
+     * kept exactly as issued; download one with `charges.voidedCreditNote`, badged VOID.
+     */
+    voidedCreditNotes: VoidedCreditNote[];
     /**
      * Set while the provider's own answer, which arrived after the refund was already settled the
-     * other way (e.g. `succeeded` for a refund resolved as not refunded), is unresolved: the money
-     * moved differently from what `status` says. The charge is held (no new refunds) until it is
-     * resolved as refunded with `charges.resolveRefund`, which clears it.
+     * other way (e.g. `succeeded` for a refund resolved as not refunded, or `failed` for a refund
+     * the provider reversed after it succeeded), is unresolved: the money moved differently from
+     * what `status` says. The charge is held (no new refunds) until it is resolved with
+     * `charges.resolveRefund`, which clears it.
      */
     providerConflictStatus: RefundStatus | null;
     /** When that contrary answer arrived (kept after the conflict is resolved). */
@@ -1418,6 +1490,11 @@ declare function createChargesResource(ctx: RequestContext): {
     receipt: (id: string, options?: CallOptions) => Promise<ArrayBuffer>;
     /** Download the immutable credit note for a succeeded refund. */
     creditNote: (chargeId: string, refundId: string, options?: CallOptions) => Promise<ArrayBuffer>;
+    /**
+     * Download a credit note voided on a refund (one of its `voidedCreditNotes`), exactly as it was
+     * issued and badged VOID.
+     */
+    voidedCreditNote: (chargeId: string, refundId: string, creditNoteNumber: string, options?: CallOptions) => Promise<ArrayBuffer>;
     /**
      * Refund a succeeded charge: `{ amount }` (minor units) for a partial, `{}` for its whole
      * remaining balance. The `idempotencyKey` is required and must identify this one refund
@@ -1442,7 +1519,10 @@ declare function createChargesResource(ctx: RequestContext): {
     /**
      * Record the outcome you verified in the provider dashboard for a refund awaiting review
      * (`needsReview`): `succeeded` settles it with a credit note, `failed` releases its amount.
-     * A refund with a provider conflict (`providerConflictStatus`) resolves only as `succeeded`.
+     * A refund with a provider conflict (`providerConflictStatus`) recorded `failed` resolves only
+     * as `succeeded`; one recorded `succeeded` that the provider later reported failed (a reversal:
+     * the customer's bank returned the money) resolves either way, `failed` making its amount
+     * refundable again.
      */
     resolveRefund: (chargeId: string, refundId: string, input: ResolveRefundInput, options?: CallOptions) => Promise<Refund>;
 };
@@ -1588,13 +1668,22 @@ declare function createCreditsResource(ctx: RequestContext): {
         /**
          * Publish a new Rate Card version: what each Credit Action costs, as
          * `ceil(units * unitPrice / perUnits)` microcredits a line. Versions are immutable - a price
-         * change is a new version - and take effect in order, at `effectiveAt` (now when omitted).
+         * change is a new version - and take effect in order, at `effectiveAt` (now when omitted),
+         * unless retracted before then.
          */
         publish: (input: PublishCreditRateCardInput, options?: CallOptions) => Promise<CreditRateCard>;
         /** The version in effect now (`not_found` before the first takes effect). */
         current: (options?: CallOptions) => Promise<CreditRateCard>;
         /** One version, by its number. */
         get: (version: number, options?: CallOptions) => Promise<CreditRateCard>;
+        /**
+         * Retract a version before it takes effect: it never does (`retractedAt` is set), and
+         * versions published after it take effect in order after the last one not retracted - so a
+         * scheduled price change no longer holds back an earlier correction. Safe to retry: a
+         * retracted version answers as retracted. A version already in effect, current or
+         * superseded, throws `conflict` (409, `details.reason: "already_effective"`).
+         */
+        retract: (version: number, options?: CallOptions) => Promise<CreditRateCard>;
         /**
          * The published versions, newest first. Auto-paginating by cursor: `await` the first page,
          * `for await (…)` every version, or `.listAll()` to collect them.
@@ -2321,6 +2410,10 @@ declare function createSubscriptionsResource(ctx: RequestContext): {
             productSlug: string;
             productName: string;
             effectiveAt: string | null;
+            blocked: {
+                reason: string;
+                since: string;
+            } | null;
         } | null;
         canceledAt: string | null;
         remainingCycles: number | null;
@@ -2371,6 +2464,10 @@ declare function createSubscriptionsResource(ctx: RequestContext): {
             productSlug: string;
             productName: string;
             effectiveAt: string | null;
+            blocked: {
+                reason: string;
+                since: string;
+            } | null;
         } | null;
         canceledAt: string | null;
         remainingCycles: number | null;
@@ -2399,6 +2496,10 @@ declare function createSubscriptionsResource(ctx: RequestContext): {
             productSlug: string;
             productName: string;
             effectiveAt: string | null;
+            blocked: {
+                reason: string;
+                since: string;
+            } | null;
         } | null;
         canceledAt: string | null;
         remainingCycles: number | null;
@@ -2433,6 +2534,10 @@ declare function createSubscriptionsResource(ctx: RequestContext): {
             productSlug: string;
             productName: string;
             effectiveAt: string | null;
+            blocked: {
+                reason: string;
+                since: string;
+            } | null;
         } | null;
         canceledAt: string | null;
         remainingCycles: number | null;
@@ -2462,6 +2567,10 @@ declare function createSubscriptionsResource(ctx: RequestContext): {
             productSlug: string;
             productName: string;
             effectiveAt: string | null;
+            blocked: {
+                reason: string;
+                since: string;
+            } | null;
         } | null;
         canceledAt: string | null;
         remainingCycles: number | null;
@@ -2485,6 +2594,10 @@ declare function createSubscriptionsResource(ctx: RequestContext): {
             productSlug: string;
             productName: string;
             effectiveAt: string | null;
+            blocked: {
+                reason: string;
+                since: string;
+            } | null;
         } | null;
         canceledAt: string | null;
         remainingCycles: number | null;
@@ -2511,6 +2624,10 @@ declare function createSubscriptionsResource(ctx: RequestContext): {
             productSlug: string;
             productName: string;
             effectiveAt: string | null;
+            blocked: {
+                reason: string;
+                since: string;
+            } | null;
         } | null;
         canceledAt: string | null;
         remainingCycles: number | null;
@@ -2540,6 +2657,10 @@ declare function createSubscriptionsResource(ctx: RequestContext): {
             productSlug: string;
             productName: string;
             effectiveAt: string | null;
+            blocked: {
+                reason: string;
+                since: string;
+            } | null;
         } | null;
         canceledAt: string | null;
         remainingCycles: number | null;
@@ -2569,6 +2690,10 @@ declare function createSubscriptionsResource(ctx: RequestContext): {
             productSlug: string;
             productName: string;
             effectiveAt: string | null;
+            blocked: {
+                reason: string;
+                since: string;
+            } | null;
         } | null;
         canceledAt: string | null;
         remainingCycles: number | null;
@@ -2596,6 +2721,10 @@ declare function createSubscriptionsResource(ctx: RequestContext): {
             productSlug: string;
             productName: string;
             effectiveAt: string | null;
+            blocked: {
+                reason: string;
+                since: string;
+            } | null;
         } | null;
         canceledAt: string | null;
         remainingCycles: number | null;
@@ -3024,4 +3153,4 @@ declare class BillowPortal {
     };
 }
 
-export { AttachResult, BILLOW_ERROR_CODES, Billow, BillowApiError, type BillowErrorCode, BillowOptions, BillowPortal, BillowPublishable, type BusinessProfile, CallOptions, type CatalogItem, Charge, type ChargeListItem, type ChargeListParams, type ChargeSearchHit, ChargeStatus, CheckResult, type CheckoutMethodInfo, type ConfigField, type ConfigFieldOption, type ConfigFieldType, Coupon, CreateChargeInput, CreateCouponInput, CreateCreditGrantInput, CreateCreditIncludedRuleInput, CreateCreditPackInput, type CreateCreditQuoteInput, type CreateCreditReservationInput, CreateCreditTopUpInput, CreateHostedDomainInput, CreateMerchantInitiatedChargeInput, type CreatePortalSessionInput, CreateProductInput, CreateSubscriptionInput, CreateUsageAlertInput, type CreateWebhookEndpointInput, type CredentialSet, CreditAccount, CreditBalance, type CreditDimensions, CreditGrant, CreditGrantRequestResult, CreditIncludedRule, CreditIncludedWindow, CreditIncludedWindowListParams, CreditLedgerEntry, type CreditLineItem, CreditPack, CreditPacks, type CreditPricedLine, type CreditQuote, type CreditRateCard, type CreditRateCardItem, type CreditReservation, type CreditReservationListParams, type CreditReservationPage, type CreditReservationRequestResult, type CreditReservationStatus, type CreditReversal, type CreditReversalRequestResult, CreditThresholdLevel, CreditTopUp, CreditTopUpListParams, CreditTopUpRequestResult, CreditUsage, CreditUsageParams, type CursorListParams, type CursorListPromise, type CursorPaginated, Customer, type CustomerAnonymizationResult, type CustomerCreditsExport, type CustomerDataExport, type CustomerListItem, type CustomerListParams, type CustomerOverview, type CustomerSearchHit, type CustomerUsage, type CustomerUsageDetail, type EmailDeliveryListItem, type EmailDeliveryListParams, type EmailDeliveryStatus, type EmailTemplateSetting, EntitlementView, type ExchangeRate, type ExportJsonValue, type ExternalPaymentMethod, type ExternalPaymentResult, Feature, FeatureKind, IdempotentRequestOptions, type InboundWebhookListItem, type InboundWebhookListParams, type InboundWebhookOutcome, type IntegrationDefinition, type IntegrationKind, type IntegrationTier, type Invoice, type InvoiceDetail, type InvoiceLineItem, type InvoiceListItem, type InvoiceListParams, type InvoiceSearchHit, InvoiceStatus, type ListParams, type ListPromise, MeterConfig, type MetricsOverview, type MetricsParams, type MetricsRollup, MigrationResult, type OutboxEventListItem, type OutboxEventListParams, type OutboxEventStatus, type Paginated, PayInvoiceInput, type PaymentMethod, PaymentMethodStatus, type PaymentProviderDefinition, type PortalCardSetupResult, type PortalCheckout, type PortalPlanChange, type PortalSession, type PortalSessionExchange, type PortalSessionExchangeInput, type PortalSessionFlow, type PortalSessionInfo, type PortalSubscriptionStatus, type PortalView, type ProviderCredentialSummary, type ProviderVerifyResult, type ProviderVerifyTarget, type ProviderVerifyTargetResult, type PublishCreditRateCardInput, type RecordExternalPaymentInput, type Refund, type RefundChargeInput, type RefundRequestResult, type RefundReviewReason, RefundStatus, RequestOptions, type ResolveRefundInput, type ReverseCreditConsumptionInput, SavedPaymentMethod, type ScheduledSubscriptionChange, type SearchResults, type SubscriptionListItem, type SubscriptionListParams, type SubscriptionSearchHit, SubscriptionStatus, TaxBehavior, type TimeseriesInterval, type TimeseriesMetric, type TimeseriesParams, type TimeseriesPoint, type TimeseriesResult, TrackResult, UnappliedPaymentReason, type UpdateBusinessProfileInput, UpdateCreditIncludedRuleInput, UpdateCreditPackInput, type UpdateEmailTemplateInput, UpdateFeatureInput, UpdateProductInput, type UpdateWebhookEndpointInput, type UpsertCredentialsInput, UsageAlert, type WebhookDelivery, WebhookDeliveryStatus, type WebhookEndpoint, type WebhookEndpointWithSecret, type Whoami, currencyExponent, formatMoney, isSecretField, toMajorUnits, toMinorUnits };
+export { AttachResult, BILLOW_ERROR_CODES, Billow, BillowApiError, type BillowErrorCode, BillowOptions, BillowPortal, BillowPublishable, type BusinessProfile, CallOptions, type CatalogItem, Charge, type ChargeListItem, type ChargeListParams, type ChargeSearchHit, ChargeStatus, CheckResult, type CheckoutMethodInfo, type ConfigField, type ConfigFieldOption, type ConfigFieldType, Coupon, CreateChargeInput, CreateCouponInput, CreateCreditGrantInput, CreateCreditIncludedRuleInput, CreateCreditPackInput, type CreateCreditQuoteInput, type CreateCreditReservationInput, CreateCreditTopUpInput, CreateHostedDomainInput, CreateMerchantInitiatedChargeInput, type CreatePortalSessionInput, CreateProductInput, CreateSubscriptionInput, CreateUsageAlertInput, type CreateWebhookEndpointInput, type CredentialSet, CreditAccount, CreditBalance, type CreditDimensions, CreditGrant, CreditGrantRequestResult, CreditIncludedRule, CreditIncludedWindow, CreditIncludedWindowListParams, CreditLedgerEntry, type CreditLineItem, CreditPack, CreditPacks, type CreditPricedLine, type CreditQuote, type CreditRateCard, type CreditRateCardItem, type CreditReservation, type CreditReservationListParams, type CreditReservationPage, type CreditReservationRequestResult, type CreditReservationStatus, type CreditReversal, type CreditReversalRequestResult, CreditThresholdLevel, CreditTopUp, CreditTopUpListParams, CreditTopUpRequestResult, CreditUsage, CreditUsageParams, type CursorListParams, type CursorListPromise, type CursorPaginated, Customer, type CustomerAnonymizationResult, type CustomerCreditsExport, type CustomerDataExport, type CustomerListItem, type CustomerListParams, type CustomerOverview, type CustomerSearchHit, type CustomerUsage, type CustomerUsageDetail, type EmailDeliveryListItem, type EmailDeliveryListParams, type EmailDeliveryStatus, type EmailTemplateSetting, EntitlementView, type ExchangeRate, type ExportJsonValue, type ExternalPaymentMethod, type ExternalPaymentResult, Feature, FeatureKind, IdempotentRequestOptions, type InboundWebhookListItem, type InboundWebhookListParams, type InboundWebhookOutcome, type IntegrationDefinition, type IntegrationKind, type IntegrationTier, type Invoice, type InvoiceDetail, type InvoiceLineItem, type InvoiceListItem, type InvoiceListParams, type InvoiceSearchHit, InvoiceStatus, type ListParams, type ListPromise, MeterConfig, type MetricsOverview, type MetricsParams, type MetricsRollup, MigrationResult, type OutboxEventListItem, type OutboxEventListParams, type OutboxEventStatus, type Paginated, PayInvoiceInput, type PaymentMethod, PaymentMethodStatus, type PaymentProviderDefinition, type PortalCardSetupResult, type PortalCheckout, type PortalPlanChange, type PortalScheduledChange, type PortalSession, type PortalSessionExchange, type PortalSessionExchangeInput, type PortalSessionFlow, type PortalSessionInfo, type PortalSubscription, type PortalSubscriptionStatus, type PortalView, type ProviderCredentialSummary, type ProviderVerifyResult, type ProviderVerifyTarget, type ProviderVerifyTargetResult, type PublishCreditRateCardInput, type RecordExternalPaymentInput, type Refund, type RefundChargeInput, type RefundRequestResult, type RefundReviewReason, RefundStatus, RequestOptions, type ResolveRefundInput, type ReverseCreditConsumptionInput, SavedPaymentMethod, type ScheduledSubscriptionChange, type SearchResults, type SubscriptionListItem, type SubscriptionListParams, type SubscriptionSearchHit, SubscriptionStatus, TaxBehavior, type TimeseriesInterval, type TimeseriesMetric, type TimeseriesParams, type TimeseriesPoint, type TimeseriesResult, TrackResult, UnappliedPaymentReason, type UpdateBusinessProfileInput, UpdateCreditIncludedRuleInput, UpdateCreditPackInput, type UpdateEmailTemplateInput, UpdateFeatureInput, UpdateProductInput, type UpdateWebhookEndpointInput, type UpsertCredentialsInput, UsageAlert, type VoidedCreditNote, type WebhookDelivery, WebhookDeliveryStatus, type WebhookEndpoint, type WebhookEndpointWithSecret, type Whoami, currencyExponent, formatMoney, isSecretField, toMajorUnits, toMinorUnits };