@delopay/sdk 0.78.0 → 0.80.0

package/dist/index.d.ts

@@ -474,8 +474,17 @@ interface PaymentAttemptsListResponse {
     /** Every attempt made on this payment, including failed retries across connectors. */
     data: PaymentAttemptResponse[];
 }
-/** Which entity a status-history event belongs to. */
-type PaymentStatusHistoryEntityType = 'payment' | 'attempt' | 'refund' | 'dispute';
+/**
+ * Which entity a status-history event belongs to.
+ *
+ * `risk` and `checkout` are timeline events with no underlying status change:
+ * `risk` carries a processor risk signal (early fraud warning, manual review)
+ * and `checkout` a buyer-side checkout event (native-pane selection, external
+ * tab opened/blocked, abandonment). For both, `status` holds the event name
+ * rather than a payment state, and `entity_id` names what it is about (the
+ * processor's signal id, or the native-pane method key).
+ */
+type PaymentStatusHistoryEntityType = 'payment' | 'attempt' | 'refund' | 'dispute' | 'risk' | 'checkout';
 /**
  * One event on a payment's status timeline: the creation of, or a status
  * transition on, the payment intent or one of its attempts / refunds /
@@ -1291,6 +1300,44 @@ interface ConnectorWebhookListResponse {
     connector: string;
     webhooks: ConnectorWebhookEntry[];
 }
+/**
+ * Body for
+ * `POST /account/{merchantId}/connectors/{connectorId}/stripe/payment-method-domains`.
+ *
+ * Registers the hosts of `urls` as Stripe *payment method domains* on the
+ * connector's credential set for `environment`, so Apple Pay renders on those
+ * pages (Stripe hides the button silently on unregistered domains). Call once
+ * per environment to cover both Stripe modes. Stripe connectors only.
+ */
+interface StripePaymentMethodDomainsRegisterRequest {
+    /** Credential set to register with. Defaults to `'live'`. */
+    environment?: WebhookRegistrationEnvironment;
+    /**
+     * Absolute URLs (or bare hostnames) whose hosts are registered — the hosted
+     * checkout origin first, plus any of the merchant's own shop URLs. At most
+     * 10 per request; duplicates by resolved host are collapsed server-side but
+     * still receive their own result row.
+     */
+    urls: string[];
+}
+/** Outcome of registering one URL as a Stripe payment method domain. */
+type StripePaymentMethodDomainStatus = 'registered' | 'already_registered' | 'invalid_url' | 'failed';
+/** Per-URL outcome of a {@link StripePaymentMethodDomainsRegisterRequest}. */
+interface StripePaymentMethodDomainResult {
+    /** The URL exactly as sent. */
+    url: string;
+    /** Host actually registered with Stripe; absent when the URL failed to parse. */
+    domain?: string | null;
+    status: StripePaymentMethodDomainStatus;
+    /** Stripe's `apple_pay.status` for the domain (`active`, `inactive`), when reported. */
+    apple_pay_status?: string | null;
+    /** Human-readable failure or duplicate detail. Never contains credentials. */
+    message?: string | null;
+}
+interface StripePaymentMethodDomainsRegisterResponse {
+    environment: WebhookRegistrationEnvironment;
+    results: StripePaymentMethodDomainResult[];
+}
 interface PaymentLinkBackgroundImageConfig {
     url: string;
     position?: 'top-left' | 'top-center' | 'top-right' | 'center-left' | 'center' | 'center-right' | 'bottom-left' | 'bottom-center' | 'bottom-right' | null;
@@ -3682,6 +3729,17 @@ declare class Connectors {
      *   to a single event.
      */
     registerWebhook(merchantId: string, connectorId: string, params?: ConnectorWebhookRegisterRequest): Promise<ConnectorWebhookRegisterResponse>;
+    /**
+     * Register checkout/shop domains as Stripe payment method domains, so Apple
+     * Pay renders on those pages.
+     * `POST /account/{merchantId}/connectors/{connectorId}/stripe/payment-method-domains`
+     *
+     * Stripe connectors only. One call registers against a single credential set
+     * (`environment`, default `'live'`) — call twice to cover live and sandbox.
+     * Per-URL outcomes come back in `results`; a missing sandbox credential set
+     * is a request-level 400.
+     */
+    registerStripePaymentMethodDomains(merchantId: string, connectorId: string, params: StripePaymentMethodDomainsRegisterRequest): Promise<StripePaymentMethodDomainsRegisterResponse>;
     /** Get registered webhooks for a connector. `GET /account/{merchantId}/connectors/webhooks/{connectorId}` */
     getWebhook(merchantId: string, connectorId: string): Promise<ConnectorWebhookListResponse>;
     /** List available payment methods. `GET /account/payment-methods` */
@@ -6196,4 +6254,233 @@ declare function parseImportedBranding(raw: unknown): CheckoutBranding;
 declare function applyBrandingVariables(el: HTMLElement, b: CheckoutBranding): void;
 declare function shadowFor(style: SurfaceStyle): string;
 
-export { ALL_CUSTOM_FIELD_CONDITION_SOURCES, ALL_CUSTOM_FIELD_OPERATORS, ALL_CUSTOM_FIELD_TYPES, type AddUserRequest, type AddUserResponse, type Address, type AddressDetails, type AllocationListResponse, type AllocationResponse, type AllocationTransferRequest, type AllocationTransferResponse, type AmountRange, Analytics, type AnalyticsChild, type AnalyticsConnectorDay, type AnalyticsConnectorSeries, AnalyticsDashboard, type AnalyticsDayBucket, type AnalyticsMethodSlice, type AnalyticsScopeRequest, type AnalyticsScopeResponse, type ApiKeyCreateRequest, type ApiKeyCreateResponse, type ApiKeyExpiration, type ApiKeyListConstraints, type ApiKeyResponse, type ApiKeyRevokeResponse, type ApiKeyUpdateRequest, type ApplePayVerificationRequest, type ApplePayVerificationResponse, type ApplePayVerifiedDomainsResponse, type AttemptStatus, type AuthResponse, type AuthenticationCreateRequest, type AuthenticationResponse, type AuthenticationStatus, type AuthenticationType, type AutoRechargeConfig, type AutoRechargeUpdateRequest, type AvailabilityOverrideCreateRequest, type AvailabilityOverrideResponse, AvailabilityOverrides, type AvailabilityPreviewMethod, type AvailabilityPreviewParams, type AvailabilityPreviewResponse, BRANDING_EXPORT_FORMAT, BRANDING_EXPORT_VERSION, type BankCodeResponse, type BankDebitTypes, type BankTransferTypes, type BillingCompleteSetupRequest, type BillingProfileResponse, type BillingSetupRequest, type BillingSetupResponse, type BlockedAttempt, type BlockedAttemptListParams, type BlockedAttemptListResponse, type BlocklistAddRequest, type BlocklistDataKind, type BlocklistResponse, type BrandingExport, type BrandingSource, type BuiltInRegionGroupResponse, type BusinessPaymentLinkConfig, CHECKBOX_CHECKED, CHECKBOX_UNCHECKED, CUSTOM_CSS_MAX_LENGTH, CUSTOM_FIELDS_MAX, CUSTOM_FIELD_CONDITIONS_MAX, CUSTOM_FIELD_KEY_PATTERN, CUSTOM_FIELD_OPERATORS_BY_SOURCE, CUSTOM_FIELD_VALUELESS_OPERATORS, type CancelSubscriptionRequest, type CancelSubscriptionResponse, type CaptureMethod, type CardDetail, type CardDetailFromLocker, type CardNetworkTypes, Cards, type ChangePasswordRequest, type CheckoutBranding, type CheckoutCustomField, type ConditionNode, type ConfirmSubscriptionPaymentDetails, type ConfirmSubscriptionRequest, type ConfirmSubscriptionResponse, type Connector, type ConnectorCloneRequest, type ConnectorCreateRequest, type ConnectorListResponse, type ConnectorResponse, type ConnectorSelection, type ConnectorType, type ConnectorUpdateRequest, type ConnectorVolumeSplit, type ConnectorWebhookEntry, type ConnectorWebhookEventType, type ConnectorWebhookListResponse, type ConnectorWebhookRegisterRequest, type ConnectorWebhookRegisterResponse, type CornerRadius, type CreateAndConfirmSubscriptionRequest, type CreateSubscriptionPaymentDetails, type CreateSubscriptionRequest, type Currency, type CurrencyRevenue, type CustomFieldCondition, type CustomFieldConditionSource, type CustomFieldContext, type CustomFieldOperator, type CustomFieldOption, type CustomFieldTranslations, type CustomFieldType, type CustomFieldVisibility, type CustomerCreateRequest, type CustomerListParams, type CustomerPaymentMethodsListParams, type CustomerPaymentMethodsListResponse, type CustomerResponse, type CustomerUpdateRequest, DEFAULT_BADGES, DEFAULT_BADGES_DARK, DEFAULT_BRANDING, DEFAULT_BRANDING_DARK, type DeleteAccountRequest, type DeleteUserRoleRequest, Delopay, DelopayAuthenticationError, DelopayError, type DelopayLogger, type DelopayOptions, type DisputeEvidenceBlock, type DisputeEvidenceRequest, type DisputeEvidenceType, type DisputeListParams, type DisputeResponse, type DisputeStage, type DisputeStatus, type EncodedBranding, type EphemeralKeyCreateRequest, type EphemeralKeyCreateResponse, type EuclidComparison, type EuclidComparisonType, type EuclidIfStatement, type EuclidValue, type EventClass, type EventDeliveryAttemptResponse, type EventDetailResponse, type EventListParams, type EventListResponse, type EventResponse, type EventType, Export, FeatureMatrix, type FeeOwner, FeeProgramBuilder, type FeeRuleConditions, type FeeRuleInput, type FeeRulePreviewRequest, type FeeRulePreviewResponse, type FeeScheduleCreateRequest, type FeeScheduleResponse, type FeeScheduleUpdateRequest, type FeeSpecInput, type FeeType, Files, type FontFamily, type FontWeight, Forex, type ForgotPasswordRequest, type FromEmailRequest, type FutureUsage, type GatewayConnectRequest, type GatewayResponse, type GetSubscriptionItemsParams, type GetSubscriptionItemsResponse, type GlobalSearchRequest, type GroupNode, type ImpersonateEmployeeRequest, type IntentStatus, type InviteUsersRequest, type InviteUsersResponse, type InvoiceStatus, type LabelStyle, type LayoutStyle, type LeafNode, type LedgerEntry, type LedgerListParams, type LedgerResponse, type LinkedRoutingConfigRetrieveResponse, type ListInvitableRolesParams, type ListUsersInLineageParams, type LoginHistoryEntry, type LoginHistoryParams, type LoginHistoryResponse, type LogoShape, type LogoSize, type MandateListParams, type MandateResponse, type MandateRevokedResponse, type MandateStatus, type MandateType, type MerchantAccountCreateRequest, type MerchantAccountResponse, type MerchantAccountType, type MerchantAccountUpdateRequest, type MerchantOverviewResponse, type MerchantOverviewStat, type MerchantRoutingAlgorithm, type MethodSurcharge, type MinimalRoleInfo, type NonPillRadius, type OverrideAction, type OverrideScope, type ParentGroup, type ParentGroupInfo, type PauseSubscriptionRequest, type PauseSubscriptionResponse, type PaymentAttemptResponse, type PaymentAttemptsListResponse, type PaymentCancelRequest, type PaymentCaptureRequest, type PaymentConfirmRequest, type PaymentCreateRequest, type PaymentErrorDetails, type PaymentExperience, type PaymentExperienceTypes, type PaymentIdFormatConfig, type PaymentIdStyle, type PaymentIntentStateMetadata, type PaymentLayout, type PaymentLinkBackgroundImageConfig, type PaymentLinkConfigRequest, type PaymentLinkListParams, type PaymentLinkListResponse, type PaymentLinkResponse, type PaymentLinkTransactionDetails, type PaymentListParams, type PaymentListResponse, type PaymentMethod, type PaymentMethodAmountLimits, type PaymentMethodCreateRequest, type PaymentMethodDeleteResponse, type PaymentMethodDisplayInfo, type PaymentMethodListInstallmentAmountDetails, type PaymentMethodListInstallmentOption, type PaymentMethodListInstallmentPlan, type PaymentMethodListIntentData, type PaymentMethodListParams, type PaymentMethodListResponse, type PaymentMethodResponse, type PaymentMethodType, type PaymentMethodUpdateRequest, type PaymentResponse, type PaymentRetrieveOptions, type PaymentStatusHistoryEntityType, type PaymentStatusHistoryEvent, type PaymentStatusHistoryResponse, type PaymentUpdateRequest, type PayoutCreateRequest, type PayoutListParams, type PayoutListResponse, type PayoutResponse, type PayoutStatus, type PayoutType, type PayoutUpdateRequest, type PerMethodSurchargeItem, type PermissionScope, type PhoneDetails, type PhoneOtpRequest, type PhoneOtpResponse, type PhoneOtpVerifyRequest, type PhoneOtpVerifyResponse, type PlatformFeeKind, type PlatformFeeOutput, type PlatformFeeProgram, type PlatformFeeRule, type PlatformFeeRuleInput, type PlatformFeeRuleOutput, type PlatformFeeRuleRecord, type PlatformFeeRuleRequest, type PollStatus, type PollStatusResponse, type ProfileAcquirerCreateRequest, type ProfileAcquirerResponse, type ProfileAcquirerUpdateRequest, type ProfileCreateRequest, type ProfileDefaultRoutingConfig, type ProfileDeniedConnectorsResponse, type ProfileLogoUploadResponse, type ProfileResponse, type ProfileUpdateRequest, type ProgramConnectorSelection, type ProjectCreateRequest, type ProjectResponse, type ProjectStats, type ProjectStatsResponse, type ProjectUpdateRequest, type RecoveryCodesResponse, type RefundAggregateResponse, type RefundCreateRequest, type RefundListParams, type RefundListResponse, type RefundResponse, type RefundStatus, type RefundType, type RefundUpdateRequest, type RegionCountriesResponse, type RegionCreateRequest, type RegionResponse, type RegionSetCountriesRequest, type RegionUpdateRequest, Regions, type RelayRequest, type RelayResponse, type RelayStatus, type RelayType, type RequestExtras, type RequestFn, type RequestOptions, type RequiredFieldInfo, type ResetPasswordRequest, type ResponsePaymentMethodTypes, type ResponsePaymentMethodsEnabled, type ResumeSubscriptionRequest, type ResumeSubscriptionResponse, type RoutableConnectorChoice, type RoutingActivatePayload, type RoutingConfigCreateRequest, type RoutingConfigResponse, type RoutingDeactivateRequest, type RoutingDictionary, type RoutingDictionaryRecord, type RuleConnectorSelection, Search, type SearchGroupResponse, type SearchIndex, type SearchStatus, type ShopCreateRequest, type ShopResponse, type ShopStats, type ShopStatsResponse, type ShopUpdateRequest, type SignInRequest, type SignUpRequest, type SignUpWithMerchantIdRequest, type SignUpWithMerchantRequest, type SizeScale, type SpacingScale, type StaticRoutingAlgorithm, type StatsPeriod, type StripeConnectAccountRequest, type StripeConnectAccountResponse, type StripeConnectLinkRequest, type StripeConnectLinkResponse, type SubscriptionEstimateParams, type SubscriptionEstimateResponse, type SubscriptionInvoice, type SubscriptionItem, type SubscriptionItemPrice, type SubscriptionItemType, type SubscriptionLineItem, type SubscriptionListParams, type SubscriptionPaymentData, type SubscriptionPaymentDetails, type SubscriptionPeriodUnit, type SubscriptionResponse, type SubscriptionStatus, Subscriptions, type SummaryPosition, type SurchargeDetailsResponse, type SurchargeResponse, type SurchargeRuleRequest, type SurchargeRuleResponse, type SurfaceStyle, type SwitchMerchantRequest, type SwitchProfileRequest, type Terminate2faQueryParams, type ThreeDSDecision, type ThreeDsRuleExecuteRequest, type ThreeDsRuleResponse, type TierSummary, type TokenPurpose, type TokenResponse, type TopupRequest, type TopupResponse, type TotpResponse, type TransactionType, type TrustBadge, type UpdateSubscriptionRequest, type UpdateUserDetailsRequest, type UpdateUserRoleRequest, type UserInLineage, type UserResponse, type UserSessionEntry, type UserSessionListResponse, type UserSessionRevokeResponse, type VerifyTotpRequest, type WebhookDeliveryAttempt, type WebhookEvent, type WebhookRegistrationEnvironment, Webhooks, allOf, anyOf, applyBrandingVariables, buildBrandingExport, buttonPadValue, cloneBranding, cloneCustomField, customFieldContextFromMetadata, customFieldIsTextLike, customFieldOperatorTakesValue, customFieldOptionLabel, customFieldText, decodeBadges, decodeBranding, decodeCustomFields, defaultBranding, defaultCustomFieldVisibility, defaultOperatorForSource, encodeBadges, encodeBranding, encodeCustomFields, evaluateCustomFieldCondition, evaluateCustomFieldVisibility, feeProgram, fontStack, fontWeightValue, inputPadValue, isCheckboxChecked, isDarkSurface, isHexColor, leaf, logoDimensions, parseCustomFieldsLoose, parseImportedBranding, programToTree, radiusValue, ruleMatchToTree, sanitizeCustomCss, shadowFor, surfacePadValue, verticalGapValue, visibleCustomFields };
+/**
+ * How the focused external checkout charges a paned method. Decided
+ * server-side; the browser never picks.
+ *
+ * - `wallet` — the method rides inside Stripe's `card` rail (Apple Pay, Google
+ *   Pay, Link). The focused view charges the **same** PaymentIntent the
+ *   embedded checkout already holds, so no second intent is ever created.
+ * - `redirect` — the method has its own `payment_method_types[]` entry. The
+ *   focused view confirms through the standard `/payments/{id}/confirm` rail
+ *   and follows `next_action.redirect_to_url`.
+ */
+type NativePaneRail = 'wallet' | 'redirect';
+/**
+ * Where a pane's tile is offered. Wallet rail only — a redirect pane is
+ * suppressed server-side, before any render knows whether it is framed, so
+ * `embedded_only` there would leave the method unpayable at top level and the
+ * router forces it back to `always`.
+ */
+type NativePaneVisibility = 'always' | 'embedded_only';
+/**
+ * How the embedded checkout opens a pane's focused view: a new browser tab
+ * (`tab`, the historical behaviour) or a centred popup window (`popup`).
+ * Only meaningful when the checkout renders inside an iframe — a top-level
+ * render always navigates in place. Browsers that refuse popup windows fall
+ * back to a tab on their own.
+ */
+type NativePaneOpenTarget = 'tab' | 'popup';
+/**
+ * One native pane exactly as the merchant configures it. Persisted (JSON) under
+ * `metadata.native_panes` on the Stripe merchant connector account.
+ *
+ * Field names are the wire contract — renaming one is a migration. The router
+ * decodes strictly row by row: a row that fails strict decoding (e.g. a
+ * wrong-typed field like `display_order: "3"`) is dropped whole with a server
+ * log, and the remaining rows still render. This SDK's
+ * {@link decodeNativePanes} is additionally per-property tolerant — including
+ * clamping `display_order` into the router's `i32` range — so a decode→encode
+ * round-trip through the SDK repairs a blob the router would partially drop.
+ */
+interface StripeNativePane {
+    /** Catalog key of the promoted method — see {@link STRIPE_NATIVE_PANE_METHODS}. */
+    method: string;
+    /** Disabled rows keep their tuning but never reach a buyer. */
+    enabled: boolean;
+    /** Default-language tile label. Empty falls back to the catalog name. */
+    label: string;
+    /** Per-locale overrides of `label`, keyed by checkout locale (`de`, `de-AT`). */
+    labelTranslations: Record<string, string>;
+    /**
+     * Secondary line under the label. `null` means "use the catalog default";
+     * an empty string means the merchant deliberately hid the line. That
+     * distinction is the whole reason this is nullable and `label` is not.
+     */
+    sublabel: string | null;
+    /** Per-locale overrides of `sublabel`. */
+    sublabelTranslations: Record<string, string>;
+    /** Section the tile groups under. Empty falls back to the catalog category. */
+    category: string;
+    /** Built-in icon key — see {@link NATIVE_PANE_ICON_KEYS}. */
+    icon: string;
+    /** Custom inline SVG. Sanitized server-side before it reaches a buyer; a
+     *  rejected payload falls back to the built-in `icon`. */
+    iconSvg: string;
+    /** Lower renders first; ties break on catalog order. */
+    displayOrder: number;
+    /** `embedded_only` keeps the wallet inside Stripe's form at top level. */
+    visibility: NativePaneVisibility;
+    /** How the embedded checkout opens the focused view — see {@link NativePaneOpenTarget}. */
+    openIn: NativePaneOpenTarget;
+}
+/**
+ * One resolved native pane as the buyer-facing checkout receives it on the
+ * payment-link payload (`native_panes`). Labels are already localized for the
+ * render's locale and icons already sanitized — snake_case because this is the
+ * API wire shape, not the editor's.
+ */
+interface NativePaneView {
+    method: string;
+    rail: NativePaneRail;
+    label: string;
+    sublabel: string;
+    category: string;
+    icon?: string | null;
+    icon_svg?: string | null;
+    display_order: number;
+    /** Redirect rail only — echo verbatim on confirm, never derive. */
+    payment_method?: string | null;
+    /** Redirect rail only — echo verbatim on confirm, never derive. */
+    payment_method_type?: string | null;
+    /** Redirect rail only — echo verbatim on confirm, never derive. */
+    payment_method_data?: Record<string, unknown> | null;
+    /**
+     * The confirm body needs the buyer's country: merged into
+     * `billing.address.country` and echoed into the single `payment_method_data`
+     * variant's `billing_country`.
+     */
+    requires_billing_country?: boolean;
+    /** `true` when the tile is only offered inside an iframe. Wallet rail only. */
+    embedded_only?: boolean;
+    /**
+     * How the embedded checkout opens this tile's focused view. Absent on
+     * payloads from older backends — treat as `tab`.
+     */
+    open_in?: NativePaneOpenTarget;
+}
+/**
+ * Methods that may be promoted to a native pane.
+ *
+ * **The router owns this list** — `core::payment_link::native_panes::CATALOG` in
+ * delopay-backend. This is a mirror so SDK consumers can validate or offer the
+ * promotable methods without a round-trip; keep it in sync when the router's
+ * catalog changes (the control-center keeps its own copy in
+ * `native-panes.model.ts`). Drift is safe in one direction only: the backend
+ * silently drops a key it does not know, so a stale entry here produces a row
+ * that never renders rather than a broken checkout.
+ */
+interface NativePaneMethodInfo {
+    key: string;
+    rail: NativePaneRail;
+    /** Catalog default label, shown as the editor's placeholder. */
+    defaultLabel: string;
+    /** Catalog default sub-text. */
+    defaultSublabel: string;
+    /** Catalog default section. */
+    defaultCategory: string;
+    /** Catalog default icon key. */
+    defaultIcon: string;
+}
+declare const STRIPE_NATIVE_PANE_METHODS: readonly NativePaneMethodInfo[];
+/** Built-in tile icon keys the buyer-facing checkout ships a glyph for. */
+declare const NATIVE_PANE_ICON_KEYS: readonly string[];
+/** Section keys the checkout knows a translated header for. */
+declare const NATIVE_PANE_CATEGORY_KEYS: readonly string[];
+/**
+ * Mirror of the router's per-connector cap. Counted differently on each side:
+ * {@link decodeNativePanes} stops after 12 *decoded* rows (entries with a
+ * usable, non-duplicate `method` — junk and duplicate entries don't consume a
+ * slot), while the router caps *accepted* panes (enabled, known,
+ * deduplicated) at 12 — so an oversized hand-written blob may render a pane
+ * this decoder drops. Blobs the SDK itself encodes never exceed the cap.
+ */
+declare const NATIVE_PANES_MAX = 12;
+declare function nativePaneMethodInfo(method: string): NativePaneMethodInfo | undefined;
+declare function defaultNativePane(method: string): StripeNativePane;
+declare function cloneNativePane(pane: StripeNativePane): StripeNativePane;
+/**
+ * Decode the stored `metadata.native_panes` blob into editor rows.
+ *
+ * Tolerant like the branding codecs: anything malformed falls back per
+ * property, rows without a usable `method` are dropped, duplicates keep the
+ * first occurrence — except that an enabled row wins over an earlier disabled
+ * one for the same method, because that is the row the router renders — and
+ * decoding stops after {@link NATIVE_PANES_MAX} decoded
+ * rows (dropped junk/duplicate entries don't consume a slot). That is more
+ * forgiving than the router, which drops a strict-decode-failing row whole
+ * (keeping the rest) and caps accepted panes rather than decoded rows — see
+ * {@link StripeNativePane} and {@link NATIVE_PANES_MAX}. Returns `null` when
+ * the input is not an array so the caller can distinguish "never configured"
+ * from "cleared".
+ */
+declare function decodeNativePanes(raw: unknown): StripeNativePane[] | null;
+/**
+ * Encode editor rows back into the snake_case blob the connector account
+ * stores. Empty optional strings are omitted so the metadata stays small and a
+ * merchant who typed nothing round-trips as "use the catalog default" rather
+ * than as an explicit empty override.
+ *
+ * `sublabel` is the exception: an explicitly-empty value is preserved (as `""`)
+ * because that is how a merchant hides the second line.
+ */
+declare function encodeNativePanes(panes: StripeNativePane[]): Record<string, unknown>[];
+interface FocusedCheckoutUrlParams {
+    /** Base URL of the DeloPay hosted checkout, e.g. `https://checkout.delopay.net`. */
+    checkoutBaseUrl: string;
+    merchantId: string;
+    paymentId: string;
+    /** Native-pane method key to focus on (`apple_pay`, `klarna`, …). */
+    method: string;
+    /** Optional buyer locale, forwarded as `?locale=`. */
+    locale?: string;
+    /**
+     * Set when the merchant's checkout-custom-field answers are already
+     * persisted on the payment — forwarded as `cf=1` so the focused view skips
+     * asking a second time. Purely a UI hint: the values live on the intent
+     * either way, and the backend only accepts the merchant's configured field
+     * keys from a client, so a wrongly-set flag can at worst skip an
+     * informational prompt. This is the same hint the embedded pane sets when
+     * it opens the focused view.
+     */
+    customFieldsCollected?: boolean;
+}
+/**
+ * Build the link to the **focused single-method checkout**: the DeloPay hosted
+ * checkout rendered with one payment method, one button, no picker.
+ *
+ * Two callers:
+ *   - the embedded checkout, which opens this in a new tab when a buyer clicks
+ *     a native pane tile, and
+ *   - a merchant running their own checkout, who puts it behind their own
+ *     button — the same mechanism without an iframe.
+ *
+ * `method` is not limited to configured native panes. A configured Stripe
+ * native pane gets the focused one-button view; `card`, `paypal`,
+ * `crypto_currency` and the local-methods catalogs (by method key or vendor
+ * code) open the checkout pinned to that method. Methods that exist only as a
+ * tab inside Stripe's Payment Element — iDEAL, Bancontact, P24 and the like,
+ * unless promoted to a native pane — cannot be isolated, because Stripe owns
+ * that surface. An unknown or unavailable method is never a dead end: the
+ * checkout shows a notice with a visible "show all payment methods" action.
+ *
+ * Open it **at the top level** (a new tab or a full-page navigation). The whole
+ * point is that the top-level domain is the registered payment method domain;
+ * rendering it in an iframe puts you back where you started.
+ *
+ * If you open it with `window.open`, call that **synchronously inside the click
+ * handler** or the popup blocker will eat it, and make sure any iframe you
+ * render DeloPay in permits popups (`allow-popups`, plus
+ * `allow-popups-to-escape-sandbox` under a restrictive `sandbox`).
+ */
+declare function focusedCheckoutUrl(params: FocusedCheckoutUrlParams): string;
+/**
+ * The closed vocabulary of buyer-side checkout events recorded on the payment's
+ * status timeline. Written through
+ * `POST /payment-link/{merchant_id}/{payment_id}/checkout-events`, authorized
+ * with the payment's `client_secret` as a bearer token.
+ */
+declare const CHECKOUT_EVENT_KINDS: readonly ["native_pane_selected", "native_pane_tab_opened", "native_pane_tab_blocked", "native_pane_abandoned", "native_pane_returned"];
+type CheckoutEventKind = (typeof CHECKOUT_EVENT_KINDS)[number];
+
+export { ALL_CUSTOM_FIELD_CONDITION_SOURCES, ALL_CUSTOM_FIELD_OPERATORS, ALL_CUSTOM_FIELD_TYPES, type AddUserRequest, type AddUserResponse, type Address, type AddressDetails, type AllocationListResponse, type AllocationResponse, type AllocationTransferRequest, type AllocationTransferResponse, type AmountRange, Analytics, type AnalyticsChild, type AnalyticsConnectorDay, type AnalyticsConnectorSeries, AnalyticsDashboard, type AnalyticsDayBucket, type AnalyticsMethodSlice, type AnalyticsScopeRequest, type AnalyticsScopeResponse, type ApiKeyCreateRequest, type ApiKeyCreateResponse, type ApiKeyExpiration, type ApiKeyListConstraints, type ApiKeyResponse, type ApiKeyRevokeResponse, type ApiKeyUpdateRequest, type ApplePayVerificationRequest, type ApplePayVerificationResponse, type ApplePayVerifiedDomainsResponse, type AttemptStatus, type AuthResponse, type AuthenticationCreateRequest, type AuthenticationResponse, type AuthenticationStatus, type AuthenticationType, type AutoRechargeConfig, type AutoRechargeUpdateRequest, type AvailabilityOverrideCreateRequest, type AvailabilityOverrideResponse, AvailabilityOverrides, type AvailabilityPreviewMethod, type AvailabilityPreviewParams, type AvailabilityPreviewResponse, BRANDING_EXPORT_FORMAT, BRANDING_EXPORT_VERSION, type BankCodeResponse, type BankDebitTypes, type BankTransferTypes, type BillingCompleteSetupRequest, type BillingProfileResponse, type BillingSetupRequest, type BillingSetupResponse, type BlockedAttempt, type BlockedAttemptListParams, type BlockedAttemptListResponse, type BlocklistAddRequest, type BlocklistDataKind, type BlocklistResponse, type BrandingExport, type BrandingSource, type BuiltInRegionGroupResponse, type BusinessPaymentLinkConfig, CHECKBOX_CHECKED, CHECKBOX_UNCHECKED, CHECKOUT_EVENT_KINDS, CUSTOM_CSS_MAX_LENGTH, CUSTOM_FIELDS_MAX, CUSTOM_FIELD_CONDITIONS_MAX, CUSTOM_FIELD_KEY_PATTERN, CUSTOM_FIELD_OPERATORS_BY_SOURCE, CUSTOM_FIELD_VALUELESS_OPERATORS, type CancelSubscriptionRequest, type CancelSubscriptionResponse, type CaptureMethod, type CardDetail, type CardDetailFromLocker, type CardNetworkTypes, Cards, type ChangePasswordRequest, type CheckoutBranding, type CheckoutCustomField, type CheckoutEventKind, type ConditionNode, type ConfirmSubscriptionPaymentDetails, type ConfirmSubscriptionRequest, type ConfirmSubscriptionResponse, type Connector, type ConnectorCloneRequest, type ConnectorCreateRequest, type ConnectorListResponse, type ConnectorResponse, type ConnectorSelection, type ConnectorType, type ConnectorUpdateRequest, type ConnectorVolumeSplit, type ConnectorWebhookEntry, type ConnectorWebhookEventType, type ConnectorWebhookListResponse, type ConnectorWebhookRegisterRequest, type ConnectorWebhookRegisterResponse, type CornerRadius, type CreateAndConfirmSubscriptionRequest, type CreateSubscriptionPaymentDetails, type CreateSubscriptionRequest, type Currency, type CurrencyRevenue, type CustomFieldCondition, type CustomFieldConditionSource, type CustomFieldContext, type CustomFieldOperator, type CustomFieldOption, type CustomFieldTranslations, type CustomFieldType, type CustomFieldVisibility, type CustomerCreateRequest, type CustomerListParams, type CustomerPaymentMethodsListParams, type CustomerPaymentMethodsListResponse, type CustomerResponse, type CustomerUpdateRequest, DEFAULT_BADGES, DEFAULT_BADGES_DARK, DEFAULT_BRANDING, DEFAULT_BRANDING_DARK, type DeleteAccountRequest, type DeleteUserRoleRequest, Delopay, DelopayAuthenticationError, DelopayError, type DelopayLogger, type DelopayOptions, type DisputeEvidenceBlock, type DisputeEvidenceRequest, type DisputeEvidenceType, type DisputeListParams, type DisputeResponse, type DisputeStage, type DisputeStatus, type EncodedBranding, type EphemeralKeyCreateRequest, type EphemeralKeyCreateResponse, type EuclidComparison, type EuclidComparisonType, type EuclidIfStatement, type EuclidValue, type EventClass, type EventDeliveryAttemptResponse, type EventDetailResponse, type EventListParams, type EventListResponse, type EventResponse, type EventType, Export, FeatureMatrix, type FeeOwner, FeeProgramBuilder, type FeeRuleConditions, type FeeRuleInput, type FeeRulePreviewRequest, type FeeRulePreviewResponse, type FeeScheduleCreateRequest, type FeeScheduleResponse, type FeeScheduleUpdateRequest, type FeeSpecInput, type FeeType, Files, type FocusedCheckoutUrlParams, type FontFamily, type FontWeight, Forex, type ForgotPasswordRequest, type FromEmailRequest, type FutureUsage, type GatewayConnectRequest, type GatewayResponse, type GetSubscriptionItemsParams, type GetSubscriptionItemsResponse, type GlobalSearchRequest, type GroupNode, type ImpersonateEmployeeRequest, type IntentStatus, type InviteUsersRequest, type InviteUsersResponse, type InvoiceStatus, type LabelStyle, type LayoutStyle, type LeafNode, type LedgerEntry, type LedgerListParams, type LedgerResponse, type LinkedRoutingConfigRetrieveResponse, type ListInvitableRolesParams, type ListUsersInLineageParams, type LoginHistoryEntry, type LoginHistoryParams, type LoginHistoryResponse, type LogoShape, type LogoSize, type MandateListParams, type MandateResponse, type MandateRevokedResponse, type MandateStatus, type MandateType, type MerchantAccountCreateRequest, type MerchantAccountResponse, type MerchantAccountType, type MerchantAccountUpdateRequest, type MerchantOverviewResponse, type MerchantOverviewStat, type MerchantRoutingAlgorithm, type MethodSurcharge, type MinimalRoleInfo, NATIVE_PANES_MAX, NATIVE_PANE_CATEGORY_KEYS, NATIVE_PANE_ICON_KEYS, type NativePaneMethodInfo, type NativePaneOpenTarget, type NativePaneRail, type NativePaneView, type NativePaneVisibility, type NonPillRadius, type OverrideAction, type OverrideScope, type ParentGroup, type ParentGroupInfo, type PauseSubscriptionRequest, type PauseSubscriptionResponse, type PaymentAttemptResponse, type PaymentAttemptsListResponse, type PaymentCancelRequest, type PaymentCaptureRequest, type PaymentConfirmRequest, type PaymentCreateRequest, type PaymentErrorDetails, type PaymentExperience, type PaymentExperienceTypes, type PaymentIdFormatConfig, type PaymentIdStyle, type PaymentIntentStateMetadata, type PaymentLayout, type PaymentLinkBackgroundImageConfig, type PaymentLinkConfigRequest, type PaymentLinkListParams, type PaymentLinkListResponse, type PaymentLinkResponse, type PaymentLinkTransactionDetails, type PaymentListParams, type PaymentListResponse, type PaymentMethod, type PaymentMethodAmountLimits, type PaymentMethodCreateRequest, type PaymentMethodDeleteResponse, type PaymentMethodDisplayInfo, type PaymentMethodListInstallmentAmountDetails, type PaymentMethodListInstallmentOption, type PaymentMethodListInstallmentPlan, type PaymentMethodListIntentData, type PaymentMethodListParams, type PaymentMethodListResponse, type PaymentMethodResponse, type PaymentMethodType, type PaymentMethodUpdateRequest, type PaymentResponse, type PaymentRetrieveOptions, type PaymentStatusHistoryEntityType, type PaymentStatusHistoryEvent, type PaymentStatusHistoryResponse, type PaymentUpdateRequest, type PayoutCreateRequest, type PayoutListParams, type PayoutListResponse, type PayoutResponse, type PayoutStatus, type PayoutType, type PayoutUpdateRequest, type PerMethodSurchargeItem, type PermissionScope, type PhoneDetails, type PhoneOtpRequest, type PhoneOtpResponse, type PhoneOtpVerifyRequest, type PhoneOtpVerifyResponse, type PlatformFeeKind, type PlatformFeeOutput, type PlatformFeeProgram, type PlatformFeeRule, type PlatformFeeRuleInput, type PlatformFeeRuleOutput, type PlatformFeeRuleRecord, type PlatformFeeRuleRequest, type PollStatus, type PollStatusResponse, type ProfileAcquirerCreateRequest, type ProfileAcquirerResponse, type ProfileAcquirerUpdateRequest, type ProfileCreateRequest, type ProfileDefaultRoutingConfig, type ProfileDeniedConnectorsResponse, type ProfileLogoUploadResponse, type ProfileResponse, type ProfileUpdateRequest, type ProgramConnectorSelection, type ProjectCreateRequest, type ProjectResponse, type ProjectStats, type ProjectStatsResponse, type ProjectUpdateRequest, type RecoveryCodesResponse, type RefundAggregateResponse, type RefundCreateRequest, type RefundListParams, type RefundListResponse, type RefundResponse, type RefundStatus, type RefundType, type RefundUpdateRequest, type RegionCountriesResponse, type RegionCreateRequest, type RegionResponse, type RegionSetCountriesRequest, type RegionUpdateRequest, Regions, type RelayRequest, type RelayResponse, type RelayStatus, type RelayType, type RequestExtras, type RequestFn, type RequestOptions, type RequiredFieldInfo, type ResetPasswordRequest, type ResponsePaymentMethodTypes, type ResponsePaymentMethodsEnabled, type ResumeSubscriptionRequest, type ResumeSubscriptionResponse, type RoutableConnectorChoice, type RoutingActivatePayload, type RoutingConfigCreateRequest, type RoutingConfigResponse, type RoutingDeactivateRequest, type RoutingDictionary, type RoutingDictionaryRecord, type RuleConnectorSelection, STRIPE_NATIVE_PANE_METHODS, Search, type SearchGroupResponse, type SearchIndex, type SearchStatus, type ShopCreateRequest, type ShopResponse, type ShopStats, type ShopStatsResponse, type ShopUpdateRequest, type SignInRequest, type SignUpRequest, type SignUpWithMerchantIdRequest, type SignUpWithMerchantRequest, type SizeScale, type SpacingScale, type StaticRoutingAlgorithm, type StatsPeriod, type StripeConnectAccountRequest, type StripeConnectAccountResponse, type StripeConnectLinkRequest, type StripeConnectLinkResponse, type StripeNativePane, type StripePaymentMethodDomainResult, type StripePaymentMethodDomainStatus, type StripePaymentMethodDomainsRegisterRequest, type StripePaymentMethodDomainsRegisterResponse, type SubscriptionEstimateParams, type SubscriptionEstimateResponse, type SubscriptionInvoice, type SubscriptionItem, type SubscriptionItemPrice, type SubscriptionItemType, type SubscriptionLineItem, type SubscriptionListParams, type SubscriptionPaymentData, type SubscriptionPaymentDetails, type SubscriptionPeriodUnit, type SubscriptionResponse, type SubscriptionStatus, Subscriptions, type SummaryPosition, type SurchargeDetailsResponse, type SurchargeResponse, type SurchargeRuleRequest, type SurchargeRuleResponse, type SurfaceStyle, type SwitchMerchantRequest, type SwitchProfileRequest, type Terminate2faQueryParams, type ThreeDSDecision, type ThreeDsRuleExecuteRequest, type ThreeDsRuleResponse, type TierSummary, type TokenPurpose, type TokenResponse, type TopupRequest, type TopupResponse, type TotpResponse, type TransactionType, type TrustBadge, type UpdateSubscriptionRequest, type UpdateUserDetailsRequest, type UpdateUserRoleRequest, type UserInLineage, type UserResponse, type UserSessionEntry, type UserSessionListResponse, type UserSessionRevokeResponse, type VerifyTotpRequest, type WebhookDeliveryAttempt, type WebhookEvent, type WebhookRegistrationEnvironment, Webhooks, allOf, anyOf, applyBrandingVariables, buildBrandingExport, buttonPadValue, cloneBranding, cloneCustomField, cloneNativePane, customFieldContextFromMetadata, customFieldIsTextLike, customFieldOperatorTakesValue, customFieldOptionLabel, customFieldText, decodeBadges, decodeBranding, decodeCustomFields, decodeNativePanes, defaultBranding, defaultCustomFieldVisibility, defaultNativePane, defaultOperatorForSource, encodeBadges, encodeBranding, encodeCustomFields, encodeNativePanes, evaluateCustomFieldCondition, evaluateCustomFieldVisibility, feeProgram, focusedCheckoutUrl, fontStack, fontWeightValue, inputPadValue, isCheckboxChecked, isDarkSurface, isHexColor, leaf, logoDimensions, nativePaneMethodInfo, parseCustomFieldsLoose, parseImportedBranding, programToTree, radiusValue, ruleMatchToTree, sanitizeCustomCss, shadowFor, surfacePadValue, verticalGapValue, visibleCustomFields };

package/dist/index.js

@@ -9,6 +9,7 @@ import {
   BRANDING_EXPORT_VERSION,
   CHECKBOX_CHECKED,
   CHECKBOX_UNCHECKED,
+  CHECKOUT_EVENT_KINDS,
   CUSTOM_CSS_MAX_LENGTH,
   CUSTOM_FIELDS_MAX,
   CUSTOM_FIELD_CONDITIONS_MAX,
@@ -28,7 +29,11 @@ import {
   FeeProgramBuilder,
   Files,
   Forex,
+  NATIVE_PANES_MAX,
+  NATIVE_PANE_CATEGORY_KEYS,
+  NATIVE_PANE_ICON_KEYS,
   Regions,
+  STRIPE_NATIVE_PANE_METHODS,
   Search,
   Subscriptions,
   Webhooks,
@@ -39,6 +44,7 @@ import {
   buttonPadValue,
   cloneBranding,
   cloneCustomField,
+  cloneNativePane,
   customFieldContextFromMetadata,
   customFieldIsTextLike,
   customFieldOperatorTakesValue,
@@ -47,15 +53,19 @@ import {
   decodeBadges,
   decodeBranding,
   decodeCustomFields,
+  decodeNativePanes,
   defaultBranding,
   defaultCustomFieldVisibility,
+  defaultNativePane,
   defaultOperatorForSource,
   encodeBadges,
   encodeBranding,
   encodeCustomFields,
+  encodeNativePanes,
   evaluateCustomFieldCondition,
   evaluateCustomFieldVisibility,
   feeProgram,
+  focusedCheckoutUrl,
   fontStack,
   fontWeightValue,
   inputPadValue,
@@ -64,6 +74,7 @@ import {
   isHexColor,
   leaf,
   logoDimensions,
+  nativePaneMethodInfo,
   parseCustomFieldsLoose,
   parseImportedBranding,
   programToTree,
@@ -74,7 +85,7 @@ import {
   surfacePadValue,
   verticalGapValue,
   visibleCustomFields
-} from "./chunk-MX26LF5P.js";
+} from "./chunk-PHKXFVHZ.js";
 export {
   ALL_CUSTOM_FIELD_CONDITION_SOURCES,
   ALL_CUSTOM_FIELD_OPERATORS,
@@ -86,6 +97,7 @@ export {
   BRANDING_EXPORT_VERSION,
   CHECKBOX_CHECKED,
   CHECKBOX_UNCHECKED,
+  CHECKOUT_EVENT_KINDS,
   CUSTOM_CSS_MAX_LENGTH,
   CUSTOM_FIELDS_MAX,
   CUSTOM_FIELD_CONDITIONS_MAX,
@@ -105,7 +117,11 @@ export {
   FeeProgramBuilder,
   Files,
   Forex,
+  NATIVE_PANES_MAX,
+  NATIVE_PANE_CATEGORY_KEYS,
+  NATIVE_PANE_ICON_KEYS,
   Regions,
+  STRIPE_NATIVE_PANE_METHODS,
   Search,
   Subscriptions,
   Webhooks,
@@ -116,6 +132,7 @@ export {
   buttonPadValue,
   cloneBranding,
   cloneCustomField,
+  cloneNativePane,
   customFieldContextFromMetadata,
   customFieldIsTextLike,
   customFieldOperatorTakesValue,
@@ -124,15 +141,19 @@ export {
   decodeBadges,
   decodeBranding,
   decodeCustomFields,
+  decodeNativePanes,
   defaultBranding,
   defaultCustomFieldVisibility,
+  defaultNativePane,
   defaultOperatorForSource,
   encodeBadges,
   encodeBranding,
   encodeCustomFields,
+  encodeNativePanes,
   evaluateCustomFieldCondition,
   evaluateCustomFieldVisibility,
   feeProgram,
+  focusedCheckoutUrl,
   fontStack,
   fontWeightValue,
   inputPadValue,
@@ -141,6 +162,7 @@ export {
   isHexColor,
   leaf,
   logoDimensions,
+  nativePaneMethodInfo,
   parseCustomFieldsLoose,
   parseImportedBranding,
   programToTree,