@delopay/sdk 0.112.0 → 0.115.0

package/dist/internal.d.cts

@@ -1,4 +1,4 @@
-import { ProjectResponse, ShopResponse, PaymentResponse, VaultEnvironment, RequestFn, AuthResponse, SignUpWithMerchantIdRequest, PaymentAttemptsListResponse, PaymentStatusHistoryResponse, RefundListResponse, AnalyticsScopeRequest, AnalyticsScopeResponse, ClientAnalyticsRequest, DevicesAnalyticsResponse, GeoAnalyticsResponse, GeoDrillRequest, DrillResponse, DeviceDrillRequest, ScopeDrillRequest, SubscriptionAnalyticsRequest, SubscriptionAnalyticsResponse, SubscriptionDrillRequest, MerchantAccountResponse, MerchantAccountUpdateRequest, ProfileResponse, PaymentsDeleteResponse, PaymentClientContextListResponse, SettlementStatementListParams, SettlementStatementListResponse, FeeStatementDetail, StatementPdfParams, SettlementOverviewParams, SettlementOverviewResponse, SettlementCurrentParams, SettlementCurrentResponse, BillingProfileResponse, PlatformFeeRuleInput, PlatformFeeRuleRecord, FeeRulePreviewRequest, FeeRulePreviewResponse, FeeScheduleCreateRequest, FeeScheduleResponse, FeeScheduleUpdateRequest, Delopay } from './index.cjs';
+import { BillingProfileResponse, ProjectResponse, ShopResponse, PaymentResponse, VaultEnvironment, RequestFn, AuthResponse, SignUpWithMerchantIdRequest, PaymentAttemptsListResponse, PaymentStatusHistoryResponse, RefundListResponse, AnalyticsScopeRequest, AnalyticsScopeResponse, ClientAnalyticsRequest, DevicesAnalyticsResponse, GeoAnalyticsResponse, GeoDrillRequest, DrillResponse, DeviceDrillRequest, ScopeDrillRequest, SubscriptionAnalyticsRequest, SubscriptionAnalyticsResponse, SubscriptionDrillRequest, MerchantAccountResponse, MerchantAccountUpdateRequest, ProfileResponse, PaymentsDeleteResponse, PaymentClientContextListResponse, SettlementStatementListParams, SettlementStatementListResponse, FeeStatementDetail, StatementPdfParams, SettlementOverviewParams, SettlementOverviewResponse, SettlementCurrentParams, SettlementCurrentResponse, PlatformFeeRuleInput, PlatformFeeRuleRecord, FeeRulePreviewRequest, FeeRulePreviewResponse, FeeScheduleCreateRequest, FeeScheduleResponse, FeeScheduleUpdateRequest, Delopay } from './index.cjs';
 export { ALL_CUSTOM_FIELD_CONDITION_SOURCES, ALL_CUSTOM_FIELD_OPERATORS, ALL_CUSTOM_FIELD_TYPES, AddUserRequest, AddUserResponse, Address, AddressDetails, AllocationListResponse, AllocationResponse, AllocationTransferRequest, AllocationTransferResponse, AmountFilter, AmountRange, Analytics, AnalyticsChannel, AnalyticsChild, AnalyticsConnectorDay, AnalyticsConnectorSeries, AnalyticsDashboard, AnalyticsDayBucket, AnalyticsGranularity, AnalyticsMethodSlice, AnalyticsOutcome, ApiKeyCreateRequest, ApiKeyCreateResponse, ApiKeyExpiration, ApiKeyListConstraints, ApiKeyResponse, ApiKeyRevokeResponse, ApiKeyUpdateRequest, ApplePayVerificationRequest, ApplePayVerificationResponse, ApplePayVerifiedDomainsResponse, AttemptStatus, Audit, AuthenticationCreateRequest, AuthenticationResponse, AuthenticationStatus, AuthenticationType, AutoRechargeConfig, AutoRechargeUpdateRequest, AvailabilityOverrideCreateRequest, AvailabilityOverrideResponse, AvailabilityOverrides, AvailabilityPreviewMethod, AvailabilityPreviewParams, AvailabilityPreviewResponse, BRANDING_EXPORT_FORMAT, BRANDING_EXPORT_VERSION, BankCodeResponse, BankDebitTypes, BankTransferTypes, BillingCompleteSetupRequest, BillingSetupRequest, BillingSetupResponse, BlockedAttempt, BlockedAttemptListParams, BlockedAttemptListResponse, BlocklistAddRequest, BlocklistDataKind, BlocklistResponse, BrandingExport, BrandingSource, BuiltInRegionGroupResponse, 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, CancelModeOutcome, CancelSubscriptionRequest, CancelSubscriptionResponse, CaptureMethod, CardDetail, CardDetailFromLocker, CardNetworkTypes, CardSpecificFeatures, Cards, ChangePasswordRequest, CheckoutBranding, CheckoutBrandingResponse, CheckoutBrandingUpdate, CheckoutCustomField, CheckoutEventKind, CheckoutSession, CheckoutSessionOptions, CheckoutThemeComparisonSide, CheckoutThemeConversionCaveat, CheckoutThemeConversionCell, CheckoutThemeConversionComparison, CheckoutThemeConversionQuery, CheckoutThemeConversionResponse, CheckoutThemeConversionSegment, CheckoutThemeDenominatorBasis, CheckoutThemeDimension, CheckoutThemeOutput, CheckoutThemeProgram, CheckoutThemeProgramRequest, CheckoutThemeProgramResponse, CheckoutThemeRule, CheckoutThemeSampleVerdict, ClientAnalyticsCaveat, ClientAnalyticsFilters, ClientDrillSortKey, ConditionNode, ConfirmSubscriptionPaymentDetails, ConfirmSubscriptionRequest, ConfirmSubscriptionResponse, Connector, ConnectorCloneRequest, ConnectorCreateRequest, ConnectorFeatureMatrixEntry, ConnectorIntegrationStatus, ConnectorListResponse, ConnectorOwnership, ConnectorResponse, ConnectorRisk, ConnectorSelection, ConnectorType, ConnectorUpdateRequest, ConnectorVolumeSplit, ConnectorWebhookEntry, ConnectorWebhookEventType, ConnectorWebhookListResponse, ConnectorWebhookRegisterRequest, ConnectorWebhookRegisterResponse, ConnectorWebhookSyncResponse, ConnectorWebhookSyncResult, CornerRadius, CreateAndConfirmSubscriptionRequest, CreateSubscriptionPaymentDetails, CreateSubscriptionRequest, Currency, CurrencyRevenue, CustomFieldCondition, CustomFieldConditionSource, CustomFieldContext, CustomFieldOperator, CustomFieldOption, CustomFieldTranslations, CustomFieldType, CustomFieldVisibility, CustomerCreateRequest, CustomerListParams, CustomerPaymentMethodsListParams, CustomerPaymentMethodsListResponse, CustomerResponse, CustomerUpdateRequest, DEFAULT_BADGES, DEFAULT_BADGES_DARK, DEFAULT_BRANDING, DEFAULT_BRANDING_DARK, DecidePendingOperationRequest, DeleteAccountRequest, DeleteEvidenceRequest, DeleteUserRoleRequest, DelopayAuthenticationError, DelopayConnectorCategory, DelopayError, DelopayLogger, DelopayOptions, DeviceAnalyticsChild, DeviceAnalyticsTotals, DeviceBrowserSlice, DeviceChannelBucket, DeviceClassSlice, DeviceDrillBase, DeviceDrillTarget, DeviceModelSlice, DevicePlatformSlice, DeviceSessionBucket, DisputeEvidenceBlock, DisputeEvidenceRequest, DisputeEvidenceType, DisputeListParams, DisputeOutcomeReporting, DisputeResponse, DisputeStage, DisputeStatus, DrillListControls, DrillPayment, DrillSortKey, DrillSummary, EncodedBranding, EntityType, EpayoutsCatalogEntry, EpayoutsCatalogResponse, EpayoutsLocality, EpayoutsMethod, EpayoutsMethodsResponse, EpayoutsRail, EphemeralKeyCreateRequest, EphemeralKeyCreateResponse, EuclidComparison, EuclidComparisonType, EuclidIfStatement, EuclidValue, EventClass, EventDeliveryAttemptResponse, EventDetailResponse, EventListParams, EventListResponse, EventResponse, EventType, Export, FeatureMatrix, FeatureMatrixResponse, FeatureStatus, FeeOwner, FeeProgramBuilder, FeeRuleConditions, FeeRuleDefaultPrecedence, FeeRuleInput, FeeSpecInput, FeeStatementSummary, FeeType, Files, FocusedCheckoutUrlParams, FontFamily, FontWeight, Forex, ForgotPasswordRequest, FromEmailRequest, FutureUsage, GatewayConnectRequest, GatewayResponse, GeoAnalyticsChild, GeoAnalyticsTotals, GeoCitySlice, GeoCountrySlice, GeoLanguageSlice, GetSubscriptionItemsParams, GetSubscriptionItemsResponse, GlobalSearchRequest, GroupNode, ImpersonateEmployeeRequest, IntentStatus, InviteUsersRequest, InviteUsersResponse, InvoiceAmountState, InvoiceOutcomes, InvoiceStatus, LabelStyle, LayoutStyle, LeafNode, LedgerEntry, LedgerListParams, LedgerResponse, LimitedOperation, LinkedRoutingConfigRetrieveResponse, ListInvitableRolesParams, ListUsersInLineageParams, LoginHistoryEntry, LoginHistoryParams, LoginHistoryResponse, LogoShape, LogoSize, MandateListParams, MandateResponse, MandateRevokedResponse, MandateStatus, MandateType, MarginQuality, MerchantAccountCreateRequest, MerchantAccountType, MerchantAuditActorInfo, MerchantAuditActorKind, MerchantAuditImpersonationKind, MerchantAuditLogEntry, MerchantAuditLogListParams, MerchantAuditLogListResponse, MerchantAuditSessionInfo, MerchantConnectorWebhookDetailsUpdate, MerchantOverviewResponse, MerchantOverviewStat, MerchantRisk, MerchantRoutingAlgorithm, MethodSurcharge, MinimalRoleInfo, NATIVE_PANES_MAX, NATIVE_PANE_CATEGORY_KEYS, NATIVE_PANE_ICON_KEYS, NativePaneCapability, NativePaneMethodInfo, NativePaneOpenTarget, NativePaneRail, NativePaneView, NativePaneVisibility, NativePanesCatalogResponse, NativePanesConnectorCatalog, NonPillRadius, OperationLimitOnExceeded, OperationLimitRule, OperationLimitRuleDeleteResponse, OperationLimitRuleListParams, OperationLimitScope, OperationLimitSettings, OperationLimitWindowMode, OperationLimits, OverrideAction, OverrideScope, PANES_MAX, PANE_CATEGORY_KEYS, PANE_ICON_KEYS, Pane, PaneCapability, PaneDisplayDefaults, PaneIssue, PaneIssueCode, PaneMethodInfo, PaneOpenTarget, PaneRail, PaneView, PaneVisibility, PanesCatalogResponse, PanesConnectorCatalog, ParentGroup, ParentGroupInfo, PauseSubscriptionRequest, PauseSubscriptionResponse, PaymentAttemptResponse, PaymentCancelRequest, PaymentCaptureRequest, PaymentClientContextEntry, PaymentConfirmRequest, PaymentCreateRequest, PaymentErrorDetails, PaymentExperience, PaymentExperienceTypes, PaymentIdFormatConfig, PaymentIdStyle, PaymentIntentStateMetadata, PaymentLayout, PaymentLinkBackgroundImageConfig, PaymentLinkConfigRequest, PaymentLinkListParams, PaymentLinkListResponse, PaymentLinkResponse, PaymentLinkTransactionDetails, PaymentListFilterConstraints, PaymentListFilteredResponse, PaymentListOrder, PaymentListParams, PaymentListResponse, PaymentMethod, PaymentMethodAmountLimits, PaymentMethodCreateRequest, PaymentMethodDeleteResponse, PaymentMethodDisplayInfo, PaymentMethodListInstallmentAmountDetails, PaymentMethodListInstallmentOption, PaymentMethodListInstallmentPlan, PaymentMethodListIntentData, PaymentMethodListParams, PaymentMethodListResponse, PaymentMethodResponse, PaymentMethodType, PaymentMethodUpdateRequest, PaymentRetrieveOptions, PaymentStatusHistoryEntityType, PaymentStatusHistoryEvent, PaymentUpdateRequest, PaymentsDeletePolicyResponse, PayoutCreateRequest, PayoutListParams, PayoutListResponse, PayoutResponse, PayoutStatus, PayoutType, PayoutUpdateRequest, PayseproMethod, PayseproMethodsResponse, PendingApprovalErrorDetails, PendingOperation, PendingOperationLimitContext, PendingOperationListParams, PendingOperationListResponse, PendingOperationStatus, PendingOperationSummary, PerMethodSurchargeItem, PermissionScope, PhoneDetails, PhoneOtpRequest, PhoneOtpResponse, PhoneOtpVerifyRequest, PhoneOtpVerifyResponse, PlanSlice, PlatformFeeKind, PlatformFeeOutput, PlatformFeeProgram, PlatformFeeRule, PlatformFeeRuleOutput, PlatformFeeRuleRequest, PollStatus, PollStatusResponse, ProcessorCostBasis, ProcessorCostBucket, ProcessorCostSource, ProcessorSlice, ProfileAcquirerCreateRequest, ProfileAcquirerResponse, ProfileAcquirerUpdateRequest, ProfileCreateRequest, ProfileDefaultRoutingConfig, ProfileDeniedConnectorsResponse, ProfileLogoUploadResponse, ProfileUpdateRequest, ProgramConnectorSelection, ProjectCreateRequest, ProjectStats, ProjectStatsResponse, ProjectUpdateRequest, PublishableKey, RecordCheckoutEventRequest, RecordCheckoutEventResponse, RecoveryCodesResponse, RefundAggregateResponse, RefundCreateRequest, RefundListParams, RefundResponse, RefundStatus, RefundType, RefundUpdateRequest, RegionCountriesResponse, RegionCreateRequest, RegionResponse, RegionSetCountriesRequest, RegionUpdateRequest, Regions, RelayRequest, RelayResponse, RelayStatus, RelayType, RequestExtras, RequestOptions, RequiredFieldInfo, ResetPasswordRequest, ResponsePaymentMethodTypes, ResponsePaymentMethodsEnabled, ResumeSubscriptionRequest, ResumeSubscriptionResponse, Risk, RoleConnectorGrant, RoleConnectorGrantEntry, RoutableConnectorChoice, RoutingActivatePayload, RoutingAlgorithmKind, RoutingConfigCreateRequest, RoutingConfigHistoryResponse, RoutingConfigResponse, RoutingConfigUpdateRequest, RoutingConfigVersion, RoutingConnectorCap, RoutingConnectorCaps, RoutingDeactivateRequest, RoutingDictionary, RoutingDictionaryRecord, RoutingHistoryParams, RuleConnectorSelection, STRIPE_FALLBACK_PANE_CATALOG, STRIPE_FALLBACK_PANE_METHODS, STRIPE_NATIVE_PANE_METHODS, ScopeDrillBase, ScopeDrillSortKey, ScopeDrillTarget, Search, SearchGroupResponse, SearchIndex, SearchStatus, SearchTimeRange, Settlement, SettlementBackfillRequest, SettlementBackfillResponse, SettlementBucket, SettlementCostParams, SettlementCostPeriod, SettlementCostResponse, SettlementLine, SettlementLineBase, SettlementLineListParams, SettlementLineListResponse, SettlementLineWithProcessorCost, SettlementLineWithoutProcessorCost, SettlementPayoutStatus, ShopCreateRequest, ShopFeeConfigEntry, ShopFeeConfigParams, ShopFeeConfigResponse, ShopRisk, ShopSettlementOverview, ShopStats, ShopStatsResponse, ShopUpdateRequest, ShopVisibilityResponse, ShopVisibilityUpdateRequest, SignInRequest, SignUpRequest, SignUpWithMerchantRequest, SizeScale, SpacingScale, StatementAdjustment, StatementAdjustmentCreateRequest, StatementAdjustmentListResponse, StatementGenerateRequest, StatementPayoutUpdateRequest, StaticRoutingAlgorithm, StatsPeriod, StripeConnectAccountRequest, StripeConnectAccountResponse, StripeConnectLinkRequest, StripeConnectLinkResponse, StripeNativePane, StripePaymentMethodDomainResult, StripePaymentMethodDomainStatus, StripePaymentMethodDomainsRegisterRequest, StripePaymentMethodDomainsRegisterResponse, SubscriptionBillingProcessorResponse, SubscriptionBucket, SubscriptionCaveat, SubscriptionChild, SubscriptionDrillBase, SubscriptionDrillSortKey, SubscriptionDrillTarget, SubscriptionEstimateParams, SubscriptionEstimateResponse, SubscriptionFilters, SubscriptionInvoice, SubscriptionInvoiceListParams, SubscriptionInvoiceListResponse, SubscriptionItem, SubscriptionItemPrice, SubscriptionItemType, SubscriptionLineItem, SubscriptionListParams, SubscriptionMovement, SubscriptionPaymentData, SubscriptionPaymentDetails, SubscriptionPaymentLink, SubscriptionPaymentLookupRequest, SubscriptionPaymentLookupResponse, SubscriptionPeriodUnit, SubscriptionProcessors, SubscriptionResponse, SubscriptionStatus, SubscriptionTotals, Subscriptions, SummaryPosition, SupportedPaymentMethod, SurchargeDetailsResponse, SurchargeResponse, SurchargeRuleRequest, SurchargeRuleResponse, SurfaceStyle, SwitchMerchantRequest, SwitchProfileRequest, Terminate2faQueryParams, ThemeBrowserLanguage, ThemeCheckoutChannel, ThemeChoice, ThemeCondition, ThemeDeviceClass, ThemeEnumCondition, ThemeIfStatement, ThemeMetadataCondition, ThemeNumberCondition, ThemeTrafficSource, ThreeDSDecision, ThreeDsRuleExecuteRequest, ThreeDsRuleResponse, TierSummary, TimeToPayBucket, TimeToPayBucketLabel, TimeToPayStats, TokenPurpose, TokenResponse, TopupRequest, TopupResponse, TotpResponse, TransactionType, TrustBadge, UpdateMetadataRequest, UpdateOperationLimitSettingsRequest, UpdateRoleConnectorGrantParams, UpdateSubscriptionRequest, UpdateUserDetailsRequest, UpdateUserRoleRequest, UpsertOperationLimitRuleRequest, UpsertRefundLimitRuleRequest, UpsertSettlementAdjustmentLimitRuleRequest, UpsertSettlementPayoutLimitRuleRequest, UserInLineage, UserResponse, UserSessionEntry, UserSessionListResponse, UserSessionRevokeResponse, VaultCheck, VaultCheckId, VaultCheckStatus, VaultCollectSessionResponse, VaultPaymentMethodRequest, VaultPaymentMethodResponse, VaultRouteApplyVerification, VaultRouteChange, VaultRouteChangeKind, VaultRouteFieldChange, VaultRouteIds, VaultRoutePurpose, VaultRouteWarning, VaultRouteWarningCode, VaultRoutesApplyRequest, VaultRoutesApplyResponse, VaultRoutesFingerprint, VaultRoutesPreviewRequest, VaultRoutesPreviewResponse, VaultVerificationResponse, VaultVerifyRequest, VerifyTotpRequest, WCAG_AA_TEXT, WCAG_AA_UI, WebhookDeliveryAttempt, WebhookDeliveryTerminalReason, WebhookDetails, WebhookEvent, WebhookRefundStatus, WebhookRegistrationEnvironment, Webhooks, allOf, anyOf, applyBrandingVariables, buildBrandingExport, buttonPadValue, cloneBranding, cloneCustomField, cloneNativePane, clonePane, contrastRatio, customFieldContextFromMetadata, customFieldIsTextLike, customFieldOperatorTakesValue, customFieldOptionLabel, customFieldText, decodeBadges, decodeBranding, decodeCustomFields, decodeNativePanes, decodePanes, defaultBranding, defaultCustomFieldVisibility, defaultNativePane, defaultOperatorForSource, defaultPane, emptyPaneCatalog, encodeBadges, encodeBranding, encodeCustomFields, encodeNativePanes, encodePanes, evaluateCustomFieldCondition, evaluateCustomFieldVisibility, feeProgram, focusedCheckoutUrl, fontStack, fontWeightValue, inputPadValue, isCheckboxChecked, isDarkSurface, isHexColor, leaf, logoDimensions, nativePaneMethodInfo, offerablePaneMethods, paneCatalogFor, paneDisplayDefaults, paneMethodInfo, paneRailAllowed, paneViewVisibility, parseCustomFieldsLoose, parseImportedBranding, programToTree, radiusValue, ruleMatchToTree, sanitizeCustomCss, shadowFor, surfacePadValue, validatePanes, verticalGapValue, visibleCustomFields } from './index.cjs';
 
 /**
@@ -158,6 +158,46 @@ interface AdminUserResponse {
     is_verified: boolean;
     is_active: boolean;
 }
+/**
+ * Which requested change the last-administrator guard refused.
+ *
+ * Rides in `error.data.route` of a `UR_66` so the caller can say *what* was
+ * refused from its own translations — the message is generic on purpose and
+ * should not be displayed.
+ */
+type LastAdministratorRoute = 
+/** `is_active: false` on the last administrator. */
+'deactivate'
+/**
+ * `role_id` moving the last administrator onto a role that cannot manage
+ * the merchant's users.
+ */
+ | 'demote'
+/**
+ * `is_verified: false` on the last administrator. Not an immediate lockout
+ * — the sign-in flow allows a grace window after `created_at` — but one that
+ * has long since closed for an established account.
+ */
+ | 'unverify'
+/** `DELETE` on the last administrator. */
+ | 'delete';
+/**
+ * `error.data` of a `UR_66`: `updateUser` / `deleteUser` refused a change
+ * because it would leave `merchant_id` with nobody who can manage its users.
+ *
+ * "Administrator" means an active account whose active role binding at the
+ * merchant resolves to a role holding user-write permission at merchant scope
+ * — resolved through the role's permission groups, so a custom role counts the
+ * same as `merchant_admin`. A user who is inactive, or whose role binding is
+ * still a pending invitation, is not one.
+ *
+ * Narrow a caught `DelopayError` onto this by checking `code === 'UR_66'`;
+ * `data` is absent against a router that predates the guard.
+ */
+interface LastAdministratorRefusal {
+    merchant_id: string;
+    route: LastAdministratorRoute;
+}
 interface AdminCustomerDetail {
     customer_id: string;
     organization_id: string;
@@ -542,6 +582,69 @@ interface AdminUnsuspendRequest {
 interface AdminSetTrustedRequest {
     trusted: boolean;
 }
+/**
+ * Admin-only: mark a merchant free (not billed), or put it back on the
+ * prepaid model (delopay-backend#378).
+ *
+ * A union rather than an optional `reason`, on the `SettlementCostPeriod`
+ * precedent: `free: true` without a reason can only earn a 412, so that shape
+ * must not typecheck. Marking free normalises a billing-caused status — `pending_setup`, `delinquent`, or an
+ * `auto_recharge` suspension — to `active`. A sticky `admin` suspension is
+ * refused with 412 until lifted explicitly: the flag must never quietly
+ * unblock a merchant that was stopped for fraud. `free: false` re-derives the
+ * status from the balance the way an unsuspend does.
+ */
+type AdminSetFreeRequest = {
+    free: true;
+    /** Why the merchant is not billed. Required: the router refuses `free: true` without one (412). */
+    reason: string;
+} | {
+    free: false;
+    /** Ignored when clearing the flag; accepted so a caller can carry one through. */
+    reason?: string;
+};
+/**
+ * Admin-only: delete a merchant's **entire** ledger (delopay-backend#378).
+ * Every live entry is soft-deleted (kept for replay protection), the balance
+ * is set to zero and the status re-derived. Refused with 412 while the
+ * merchant has shop allocations.
+ */
+interface AdminResetLedgerRequest {
+    /** Human-readable reason, required for audit. */
+    reason: string;
+}
+interface AdminResetLedgerResponse {
+    /** Live entries removed from the ledger. */
+    deleted_count: number;
+    /** Signed sum of the removed entries' amounts, in the balance currency. */
+    deleted_amount: number;
+    /** The balance before the reset; after it the balance is always zero. */
+    balance_before: number;
+    /** The profile as it stands after the reset. */
+    profile: BillingProfileResponse;
+}
+/**
+ * Admin-only: (re)create a merchant's ledger, optionally seeded with an
+ * opening balance (delopay-backend#378). Ensures the billing profile exists
+ * (created without the welcome promo credit) and, when `opening_balance` is
+ * set, writes one `opening_balance` entry. Refused with 412 while the
+ * merchant still has live ledger entries, or a non-zero balance with none.
+ * Does not clear the free flag.
+ */
+interface AdminCreateLedgerRequest {
+    /** Opening balance in minor units of the balance currency. Omit or `0` for an empty ledger. */
+    opening_balance?: number;
+    /** ISO-4217 currency for a profile that does not exist yet; must match an existing profile's. */
+    balance_currency?: string;
+    /** Human-readable reason, required for audit; also the opening entry's description. */
+    reason: string;
+}
+interface AdminCreateLedgerResponse {
+    /** The opening-balance entry, when one was written. */
+    ledger_entry_id?: string | null;
+    /** The profile as it stands after the call. */
+    profile: BillingProfileResponse;
+}
 interface CardIssuerCreateRequest {
     issuer_name: string;
 }
@@ -1036,12 +1139,22 @@ declare class AdminPortal {
      * against signup policy + JWT blacklist). `reset_2fa` clears TOTP state
      * so the user re-enrolls on next login. `is_active` supports both
      * directions: false soft-disables, true reactivates a soft-disabled user.
+     *
+     * Throws a `400` with `code === 'UR_66'` when the change would leave a
+     * merchant with no administrator — `is_active: false` or `is_verified:
+     * false` on, or a `role_id` demoting, the only active user whose role can
+     * manage that merchant's users. Nothing is written. `error.data` carries a
+     * {@link LastAdministratorRefusal} naming the merchant and which change was
+     * refused; render that rather than the generic message.
      */
     updateUser(userId: string, body: AdminUpdateUserRequest): Promise<AdminUserResponse>;
     /**
      * Soft-delete a user globally: deactivates the row, blacklists existing
      * JWTs, and wipes credentials. Distinct from `deleteUserRole`, which
      * removes a single role binding while leaving the user signed-in elsewhere.
+     *
+     * Throws the same `UR_66` as {@link updateUser} when the user is the last
+     * administrator of any merchant they belong to, with `route: 'delete'`.
      */
     deleteUser(userId: string): Promise<void>;
     /**
@@ -1368,6 +1481,50 @@ declare class PlatformBilling {
      * @returns The updated billing profile.
      */
     setTrusted(merchantId: string, params: AdminSetTrustedRequest): Promise<BillingProfileResponse>;
+    /**
+     * Mark a merchant free (not billed), or put it back on the prepaid model
+     * (delopay-backend#378). While free, no platform fee is deducted, the
+     * payment gate never blocks on billing status, top-ups are refused and
+     * auto-recharge is inert. Marking free needs a `reason` and is refused
+     * (412) while an admin suspension is in force — lift that first.
+     *
+     * Requires a router with delopay-backend#378; older routers answer `404`.
+     *
+     * @param merchantId - The merchant account ID.
+     * @param params - The desired free state and, when marking free, the reason.
+     * @returns The updated billing profile.
+     */
+    setFree(merchantId: string, params: AdminSetFreeRequest): Promise<BillingProfileResponse>;
+    /**
+     * Delete a merchant's **entire** ledger (delopay-backend#378). Every live
+     * entry is soft-deleted — kept, so a replayed fee deduction or top-up
+     * webhook still no-ops — the balance is set to zero and the status
+     * re-derived (`active` for a free merchant; an active paying merchant
+     * lands in `delinquent`). Refused (412) while the merchant has shop
+     * allocations. Audited.
+     *
+     * Requires a router with delopay-backend#378; older routers answer `404`.
+     *
+     * @param merchantId - The merchant account ID.
+     * @param params - The reason, required for audit.
+     * @returns What was removed and the post-reset profile.
+     */
+    resetLedger(merchantId: string, params: AdminResetLedgerRequest): Promise<AdminResetLedgerResponse>;
+    /**
+     * (Re)create a merchant's ledger, optionally seeded with an opening balance
+     * (delopay-backend#378). Ensures the billing profile exists (created
+     * without the welcome promo credit) and, when `opening_balance` is set,
+     * writes one `opening_balance` entry through the same atomic helper an
+     * admin credit uses. Refused (412) while live entries or a non-zero balance
+     * remain — reset first. Does not clear the free flag. Audited.
+     *
+     * Requires a router with delopay-backend#378; older routers answer `404`.
+     *
+     * @param merchantId - The merchant account ID.
+     * @param params - Opening balance (minor units), currency for a new profile, and the reason.
+     * @returns The opening entry id (if one was written) and the profile.
+     */
+    createLedger(merchantId: string, params: AdminCreateLedgerRequest): Promise<AdminCreateLedgerResponse>;
 }
 
 /**
@@ -1460,4 +1617,4 @@ declare class DelopayInternal extends Delopay {
     constructor(...args: ConstructorParameters<typeof Delopay>);
 }
 
-export { Admin, type AdminAdjustmentRequest, type AdminAdjustmentResponse, type AdminAnalyticsRequest, type AdminAttachVaultRequest, type AdminAttachVaultResponse, type AdminCreateUserForMerchantRequest, type AdminCustomerDetail, type AdminCustomerListParams, type AdminCustomerListResponse, type AdminLedgerAnalyticsRequest, type AdminLedgerAnalyticsResponse, AdminPortal, type AdminSetTrustedRequest, type AdminShopVaultState, type AdminSignInRequest, type AdminSuspendRequest, type AdminTransactionListParams, type AdminTransactionListResponse, type AdminUnsuspendRequest, type AdminUpdateUserRequest, type AdminUserResponse, type AdminVaultEntitlementState, type AdminVaultEnvironmentState, type AdminVaultStateResponse, AnalyticsScopeRequest, AnalyticsScopeResponse, type AuditActorInfo, type AuditActorKind, type AuditImpersonationKind, type AuditLogListParams, type AuditLogListResponse, type AuditLogResponse, AuditLogs, type AuditSessionInfo, AuthResponse, type AuthorizeResponse, BillingProfileResponse, Cache, type CardIssuerCreateRequest, type CardIssuerListResponse, type CardIssuerResponse, type CardIssuerUpdateRequest, CardIssuers, ClientAnalyticsRequest, Configs, type ConnectorRestrictionResponse, type ConnectorRestrictionRuleAction, type ConnectorRestrictionRuleResponse, ConnectorRestrictionRules, type ConnectorRestrictionScope, ConnectorRestrictions, type ConnectorVisibility, type CreateConnectorRestrictionRuleRequest, type CreateInternalUserRequest, type CreateTenantUserRequest, type CustomerSummary, type CustomerUser, Delopay, DelopayInternal, DeviceDrillRequest, DevicesAnalyticsResponse, DrillResponse, FeeRulePreviewRequest, FeeRulePreviewResponse, FeeScheduleCreateRequest, FeeScheduleResponse, FeeScheduleUpdateRequest, FeeStatementDetail, type FeeTotalBound, GeoAnalyticsResponse, GeoDrillRequest, Gsm, type GsmDecision, type GsmRuleCreateRequest, type GsmRuleResponse, type GsmRuleUpdateRequest, type LedgerDayBucket, type LedgerMerchant, type ListConnectorRestrictionRulesQuery, MerchantAccountResponse, MerchantAccountUpdateRequest, type OnboardMerchantRequest, type OnboardMerchantResponse, type OverviewStat, type OverviewStatsResponse, type PaymentAnalyticsRequest, type PaymentAnalyticsResponse, PaymentAttemptsListResponse, type PaymentAutoCloseConfigResponse, type PaymentAutoCloseOverrideResponse, PaymentClientContextListResponse, type PaymentPeriodStats, PaymentResponse, PaymentStatusHistoryResponse, PaymentsDeleteResponse, type PlatformAnalyticsResponse, PlatformBilling, PlatformFeeRuleInput, PlatformFeeRuleRecord, PlatformFees, ProfileResponse, ProjectResponse, type PromoConfigResponse, RefundListResponse, RequestFn, ScopeDrillRequest, SettlementCurrentParams, SettlementCurrentResponse, SettlementOverviewParams, SettlementOverviewResponse, SettlementStatementListParams, SettlementStatementListResponse, ShopResponse, SignUpWithMerchantIdRequest, type SignupToggleRequest, type SignupToggleResponse, StatementPdfParams, SubscriptionAnalyticsRequest, SubscriptionAnalyticsResponse, SubscriptionDrillRequest, type TransactionDeleteConfigResponse, type TransactionDeleteOverrideResponse, type UpdateConnectorRestrictionRuleRequest, type UpdateLedgerEntryRequest, type UpdatePaymentAutoCloseConfigRequest, type UpdatePaymentAutoCloseOverrideRequest, type UpdatePromoConfigRequest, type UpdateTransactionDeleteConfigRequest, type UpdateTransactionDeleteOverrideRequest, type UpsertConnectorRestrictionRequest, VaultEnvironment };
+export { Admin, type AdminAdjustmentRequest, type AdminAdjustmentResponse, type AdminAnalyticsRequest, type AdminAttachVaultRequest, type AdminAttachVaultResponse, type AdminCreateLedgerRequest, type AdminCreateLedgerResponse, type AdminCreateUserForMerchantRequest, type AdminCustomerDetail, type AdminCustomerListParams, type AdminCustomerListResponse, type AdminLedgerAnalyticsRequest, type AdminLedgerAnalyticsResponse, AdminPortal, type AdminResetLedgerRequest, type AdminResetLedgerResponse, type AdminSetFreeRequest, type AdminSetTrustedRequest, type AdminShopVaultState, type AdminSignInRequest, type AdminSuspendRequest, type AdminTransactionListParams, type AdminTransactionListResponse, type AdminUnsuspendRequest, type AdminUpdateUserRequest, type AdminUserResponse, type AdminVaultEntitlementState, type AdminVaultEnvironmentState, type AdminVaultStateResponse, AnalyticsScopeRequest, AnalyticsScopeResponse, type AuditActorInfo, type AuditActorKind, type AuditImpersonationKind, type AuditLogListParams, type AuditLogListResponse, type AuditLogResponse, AuditLogs, type AuditSessionInfo, AuthResponse, type AuthorizeResponse, BillingProfileResponse, Cache, type CardIssuerCreateRequest, type CardIssuerListResponse, type CardIssuerResponse, type CardIssuerUpdateRequest, CardIssuers, ClientAnalyticsRequest, Configs, type ConnectorRestrictionResponse, type ConnectorRestrictionRuleAction, type ConnectorRestrictionRuleResponse, ConnectorRestrictionRules, type ConnectorRestrictionScope, ConnectorRestrictions, type ConnectorVisibility, type CreateConnectorRestrictionRuleRequest, type CreateInternalUserRequest, type CreateTenantUserRequest, type CustomerSummary, type CustomerUser, Delopay, DelopayInternal, DeviceDrillRequest, DevicesAnalyticsResponse, DrillResponse, FeeRulePreviewRequest, FeeRulePreviewResponse, FeeScheduleCreateRequest, FeeScheduleResponse, FeeScheduleUpdateRequest, FeeStatementDetail, type FeeTotalBound, GeoAnalyticsResponse, GeoDrillRequest, Gsm, type GsmDecision, type GsmRuleCreateRequest, type GsmRuleResponse, type GsmRuleUpdateRequest, type LastAdministratorRefusal, type LastAdministratorRoute, type LedgerDayBucket, type LedgerMerchant, type ListConnectorRestrictionRulesQuery, MerchantAccountResponse, MerchantAccountUpdateRequest, type OnboardMerchantRequest, type OnboardMerchantResponse, type OverviewStat, type OverviewStatsResponse, type PaymentAnalyticsRequest, type PaymentAnalyticsResponse, PaymentAttemptsListResponse, type PaymentAutoCloseConfigResponse, type PaymentAutoCloseOverrideResponse, PaymentClientContextListResponse, type PaymentPeriodStats, PaymentResponse, PaymentStatusHistoryResponse, PaymentsDeleteResponse, type PlatformAnalyticsResponse, PlatformBilling, PlatformFeeRuleInput, PlatformFeeRuleRecord, PlatformFees, ProfileResponse, ProjectResponse, type PromoConfigResponse, RefundListResponse, RequestFn, ScopeDrillRequest, SettlementCurrentParams, SettlementCurrentResponse, SettlementOverviewParams, SettlementOverviewResponse, SettlementStatementListParams, SettlementStatementListResponse, ShopResponse, SignUpWithMerchantIdRequest, type SignupToggleRequest, type SignupToggleResponse, StatementPdfParams, SubscriptionAnalyticsRequest, SubscriptionAnalyticsResponse, SubscriptionDrillRequest, type TransactionDeleteConfigResponse, type TransactionDeleteOverrideResponse, type UpdateConnectorRestrictionRuleRequest, type UpdateLedgerEntryRequest, type UpdatePaymentAutoCloseConfigRequest, type UpdatePaymentAutoCloseOverrideRequest, type UpdatePromoConfigRequest, type UpdateTransactionDeleteConfigRequest, type UpdateTransactionDeleteOverrideRequest, type UpsertConnectorRestrictionRequest, VaultEnvironment };

package/dist/internal.d.ts

@@ -1,4 +1,4 @@
-import { ProjectResponse, ShopResponse, PaymentResponse, VaultEnvironment, RequestFn, AuthResponse, SignUpWithMerchantIdRequest, PaymentAttemptsListResponse, PaymentStatusHistoryResponse, RefundListResponse, AnalyticsScopeRequest, AnalyticsScopeResponse, ClientAnalyticsRequest, DevicesAnalyticsResponse, GeoAnalyticsResponse, GeoDrillRequest, DrillResponse, DeviceDrillRequest, ScopeDrillRequest, SubscriptionAnalyticsRequest, SubscriptionAnalyticsResponse, SubscriptionDrillRequest, MerchantAccountResponse, MerchantAccountUpdateRequest, ProfileResponse, PaymentsDeleteResponse, PaymentClientContextListResponse, SettlementStatementListParams, SettlementStatementListResponse, FeeStatementDetail, StatementPdfParams, SettlementOverviewParams, SettlementOverviewResponse, SettlementCurrentParams, SettlementCurrentResponse, BillingProfileResponse, PlatformFeeRuleInput, PlatformFeeRuleRecord, FeeRulePreviewRequest, FeeRulePreviewResponse, FeeScheduleCreateRequest, FeeScheduleResponse, FeeScheduleUpdateRequest, Delopay } from './index.js';
+import { BillingProfileResponse, ProjectResponse, ShopResponse, PaymentResponse, VaultEnvironment, RequestFn, AuthResponse, SignUpWithMerchantIdRequest, PaymentAttemptsListResponse, PaymentStatusHistoryResponse, RefundListResponse, AnalyticsScopeRequest, AnalyticsScopeResponse, ClientAnalyticsRequest, DevicesAnalyticsResponse, GeoAnalyticsResponse, GeoDrillRequest, DrillResponse, DeviceDrillRequest, ScopeDrillRequest, SubscriptionAnalyticsRequest, SubscriptionAnalyticsResponse, SubscriptionDrillRequest, MerchantAccountResponse, MerchantAccountUpdateRequest, ProfileResponse, PaymentsDeleteResponse, PaymentClientContextListResponse, SettlementStatementListParams, SettlementStatementListResponse, FeeStatementDetail, StatementPdfParams, SettlementOverviewParams, SettlementOverviewResponse, SettlementCurrentParams, SettlementCurrentResponse, PlatformFeeRuleInput, PlatformFeeRuleRecord, FeeRulePreviewRequest, FeeRulePreviewResponse, FeeScheduleCreateRequest, FeeScheduleResponse, FeeScheduleUpdateRequest, Delopay } from './index.js';
 export { ALL_CUSTOM_FIELD_CONDITION_SOURCES, ALL_CUSTOM_FIELD_OPERATORS, ALL_CUSTOM_FIELD_TYPES, AddUserRequest, AddUserResponse, Address, AddressDetails, AllocationListResponse, AllocationResponse, AllocationTransferRequest, AllocationTransferResponse, AmountFilter, AmountRange, Analytics, AnalyticsChannel, AnalyticsChild, AnalyticsConnectorDay, AnalyticsConnectorSeries, AnalyticsDashboard, AnalyticsDayBucket, AnalyticsGranularity, AnalyticsMethodSlice, AnalyticsOutcome, ApiKeyCreateRequest, ApiKeyCreateResponse, ApiKeyExpiration, ApiKeyListConstraints, ApiKeyResponse, ApiKeyRevokeResponse, ApiKeyUpdateRequest, ApplePayVerificationRequest, ApplePayVerificationResponse, ApplePayVerifiedDomainsResponse, AttemptStatus, Audit, AuthenticationCreateRequest, AuthenticationResponse, AuthenticationStatus, AuthenticationType, AutoRechargeConfig, AutoRechargeUpdateRequest, AvailabilityOverrideCreateRequest, AvailabilityOverrideResponse, AvailabilityOverrides, AvailabilityPreviewMethod, AvailabilityPreviewParams, AvailabilityPreviewResponse, BRANDING_EXPORT_FORMAT, BRANDING_EXPORT_VERSION, BankCodeResponse, BankDebitTypes, BankTransferTypes, BillingCompleteSetupRequest, BillingSetupRequest, BillingSetupResponse, BlockedAttempt, BlockedAttemptListParams, BlockedAttemptListResponse, BlocklistAddRequest, BlocklistDataKind, BlocklistResponse, BrandingExport, BrandingSource, BuiltInRegionGroupResponse, 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, CancelModeOutcome, CancelSubscriptionRequest, CancelSubscriptionResponse, CaptureMethod, CardDetail, CardDetailFromLocker, CardNetworkTypes, CardSpecificFeatures, Cards, ChangePasswordRequest, CheckoutBranding, CheckoutBrandingResponse, CheckoutBrandingUpdate, CheckoutCustomField, CheckoutEventKind, CheckoutSession, CheckoutSessionOptions, CheckoutThemeComparisonSide, CheckoutThemeConversionCaveat, CheckoutThemeConversionCell, CheckoutThemeConversionComparison, CheckoutThemeConversionQuery, CheckoutThemeConversionResponse, CheckoutThemeConversionSegment, CheckoutThemeDenominatorBasis, CheckoutThemeDimension, CheckoutThemeOutput, CheckoutThemeProgram, CheckoutThemeProgramRequest, CheckoutThemeProgramResponse, CheckoutThemeRule, CheckoutThemeSampleVerdict, ClientAnalyticsCaveat, ClientAnalyticsFilters, ClientDrillSortKey, ConditionNode, ConfirmSubscriptionPaymentDetails, ConfirmSubscriptionRequest, ConfirmSubscriptionResponse, Connector, ConnectorCloneRequest, ConnectorCreateRequest, ConnectorFeatureMatrixEntry, ConnectorIntegrationStatus, ConnectorListResponse, ConnectorOwnership, ConnectorResponse, ConnectorRisk, ConnectorSelection, ConnectorType, ConnectorUpdateRequest, ConnectorVolumeSplit, ConnectorWebhookEntry, ConnectorWebhookEventType, ConnectorWebhookListResponse, ConnectorWebhookRegisterRequest, ConnectorWebhookRegisterResponse, ConnectorWebhookSyncResponse, ConnectorWebhookSyncResult, CornerRadius, CreateAndConfirmSubscriptionRequest, CreateSubscriptionPaymentDetails, CreateSubscriptionRequest, Currency, CurrencyRevenue, CustomFieldCondition, CustomFieldConditionSource, CustomFieldContext, CustomFieldOperator, CustomFieldOption, CustomFieldTranslations, CustomFieldType, CustomFieldVisibility, CustomerCreateRequest, CustomerListParams, CustomerPaymentMethodsListParams, CustomerPaymentMethodsListResponse, CustomerResponse, CustomerUpdateRequest, DEFAULT_BADGES, DEFAULT_BADGES_DARK, DEFAULT_BRANDING, DEFAULT_BRANDING_DARK, DecidePendingOperationRequest, DeleteAccountRequest, DeleteEvidenceRequest, DeleteUserRoleRequest, DelopayAuthenticationError, DelopayConnectorCategory, DelopayError, DelopayLogger, DelopayOptions, DeviceAnalyticsChild, DeviceAnalyticsTotals, DeviceBrowserSlice, DeviceChannelBucket, DeviceClassSlice, DeviceDrillBase, DeviceDrillTarget, DeviceModelSlice, DevicePlatformSlice, DeviceSessionBucket, DisputeEvidenceBlock, DisputeEvidenceRequest, DisputeEvidenceType, DisputeListParams, DisputeOutcomeReporting, DisputeResponse, DisputeStage, DisputeStatus, DrillListControls, DrillPayment, DrillSortKey, DrillSummary, EncodedBranding, EntityType, EpayoutsCatalogEntry, EpayoutsCatalogResponse, EpayoutsLocality, EpayoutsMethod, EpayoutsMethodsResponse, EpayoutsRail, EphemeralKeyCreateRequest, EphemeralKeyCreateResponse, EuclidComparison, EuclidComparisonType, EuclidIfStatement, EuclidValue, EventClass, EventDeliveryAttemptResponse, EventDetailResponse, EventListParams, EventListResponse, EventResponse, EventType, Export, FeatureMatrix, FeatureMatrixResponse, FeatureStatus, FeeOwner, FeeProgramBuilder, FeeRuleConditions, FeeRuleDefaultPrecedence, FeeRuleInput, FeeSpecInput, FeeStatementSummary, FeeType, Files, FocusedCheckoutUrlParams, FontFamily, FontWeight, Forex, ForgotPasswordRequest, FromEmailRequest, FutureUsage, GatewayConnectRequest, GatewayResponse, GeoAnalyticsChild, GeoAnalyticsTotals, GeoCitySlice, GeoCountrySlice, GeoLanguageSlice, GetSubscriptionItemsParams, GetSubscriptionItemsResponse, GlobalSearchRequest, GroupNode, ImpersonateEmployeeRequest, IntentStatus, InviteUsersRequest, InviteUsersResponse, InvoiceAmountState, InvoiceOutcomes, InvoiceStatus, LabelStyle, LayoutStyle, LeafNode, LedgerEntry, LedgerListParams, LedgerResponse, LimitedOperation, LinkedRoutingConfigRetrieveResponse, ListInvitableRolesParams, ListUsersInLineageParams, LoginHistoryEntry, LoginHistoryParams, LoginHistoryResponse, LogoShape, LogoSize, MandateListParams, MandateResponse, MandateRevokedResponse, MandateStatus, MandateType, MarginQuality, MerchantAccountCreateRequest, MerchantAccountType, MerchantAuditActorInfo, MerchantAuditActorKind, MerchantAuditImpersonationKind, MerchantAuditLogEntry, MerchantAuditLogListParams, MerchantAuditLogListResponse, MerchantAuditSessionInfo, MerchantConnectorWebhookDetailsUpdate, MerchantOverviewResponse, MerchantOverviewStat, MerchantRisk, MerchantRoutingAlgorithm, MethodSurcharge, MinimalRoleInfo, NATIVE_PANES_MAX, NATIVE_PANE_CATEGORY_KEYS, NATIVE_PANE_ICON_KEYS, NativePaneCapability, NativePaneMethodInfo, NativePaneOpenTarget, NativePaneRail, NativePaneView, NativePaneVisibility, NativePanesCatalogResponse, NativePanesConnectorCatalog, NonPillRadius, OperationLimitOnExceeded, OperationLimitRule, OperationLimitRuleDeleteResponse, OperationLimitRuleListParams, OperationLimitScope, OperationLimitSettings, OperationLimitWindowMode, OperationLimits, OverrideAction, OverrideScope, PANES_MAX, PANE_CATEGORY_KEYS, PANE_ICON_KEYS, Pane, PaneCapability, PaneDisplayDefaults, PaneIssue, PaneIssueCode, PaneMethodInfo, PaneOpenTarget, PaneRail, PaneView, PaneVisibility, PanesCatalogResponse, PanesConnectorCatalog, ParentGroup, ParentGroupInfo, PauseSubscriptionRequest, PauseSubscriptionResponse, PaymentAttemptResponse, PaymentCancelRequest, PaymentCaptureRequest, PaymentClientContextEntry, PaymentConfirmRequest, PaymentCreateRequest, PaymentErrorDetails, PaymentExperience, PaymentExperienceTypes, PaymentIdFormatConfig, PaymentIdStyle, PaymentIntentStateMetadata, PaymentLayout, PaymentLinkBackgroundImageConfig, PaymentLinkConfigRequest, PaymentLinkListParams, PaymentLinkListResponse, PaymentLinkResponse, PaymentLinkTransactionDetails, PaymentListFilterConstraints, PaymentListFilteredResponse, PaymentListOrder, PaymentListParams, PaymentListResponse, PaymentMethod, PaymentMethodAmountLimits, PaymentMethodCreateRequest, PaymentMethodDeleteResponse, PaymentMethodDisplayInfo, PaymentMethodListInstallmentAmountDetails, PaymentMethodListInstallmentOption, PaymentMethodListInstallmentPlan, PaymentMethodListIntentData, PaymentMethodListParams, PaymentMethodListResponse, PaymentMethodResponse, PaymentMethodType, PaymentMethodUpdateRequest, PaymentRetrieveOptions, PaymentStatusHistoryEntityType, PaymentStatusHistoryEvent, PaymentUpdateRequest, PaymentsDeletePolicyResponse, PayoutCreateRequest, PayoutListParams, PayoutListResponse, PayoutResponse, PayoutStatus, PayoutType, PayoutUpdateRequest, PayseproMethod, PayseproMethodsResponse, PendingApprovalErrorDetails, PendingOperation, PendingOperationLimitContext, PendingOperationListParams, PendingOperationListResponse, PendingOperationStatus, PendingOperationSummary, PerMethodSurchargeItem, PermissionScope, PhoneDetails, PhoneOtpRequest, PhoneOtpResponse, PhoneOtpVerifyRequest, PhoneOtpVerifyResponse, PlanSlice, PlatformFeeKind, PlatformFeeOutput, PlatformFeeProgram, PlatformFeeRule, PlatformFeeRuleOutput, PlatformFeeRuleRequest, PollStatus, PollStatusResponse, ProcessorCostBasis, ProcessorCostBucket, ProcessorCostSource, ProcessorSlice, ProfileAcquirerCreateRequest, ProfileAcquirerResponse, ProfileAcquirerUpdateRequest, ProfileCreateRequest, ProfileDefaultRoutingConfig, ProfileDeniedConnectorsResponse, ProfileLogoUploadResponse, ProfileUpdateRequest, ProgramConnectorSelection, ProjectCreateRequest, ProjectStats, ProjectStatsResponse, ProjectUpdateRequest, PublishableKey, RecordCheckoutEventRequest, RecordCheckoutEventResponse, RecoveryCodesResponse, RefundAggregateResponse, RefundCreateRequest, RefundListParams, RefundResponse, RefundStatus, RefundType, RefundUpdateRequest, RegionCountriesResponse, RegionCreateRequest, RegionResponse, RegionSetCountriesRequest, RegionUpdateRequest, Regions, RelayRequest, RelayResponse, RelayStatus, RelayType, RequestExtras, RequestOptions, RequiredFieldInfo, ResetPasswordRequest, ResponsePaymentMethodTypes, ResponsePaymentMethodsEnabled, ResumeSubscriptionRequest, ResumeSubscriptionResponse, Risk, RoleConnectorGrant, RoleConnectorGrantEntry, RoutableConnectorChoice, RoutingActivatePayload, RoutingAlgorithmKind, RoutingConfigCreateRequest, RoutingConfigHistoryResponse, RoutingConfigResponse, RoutingConfigUpdateRequest, RoutingConfigVersion, RoutingConnectorCap, RoutingConnectorCaps, RoutingDeactivateRequest, RoutingDictionary, RoutingDictionaryRecord, RoutingHistoryParams, RuleConnectorSelection, STRIPE_FALLBACK_PANE_CATALOG, STRIPE_FALLBACK_PANE_METHODS, STRIPE_NATIVE_PANE_METHODS, ScopeDrillBase, ScopeDrillSortKey, ScopeDrillTarget, Search, SearchGroupResponse, SearchIndex, SearchStatus, SearchTimeRange, Settlement, SettlementBackfillRequest, SettlementBackfillResponse, SettlementBucket, SettlementCostParams, SettlementCostPeriod, SettlementCostResponse, SettlementLine, SettlementLineBase, SettlementLineListParams, SettlementLineListResponse, SettlementLineWithProcessorCost, SettlementLineWithoutProcessorCost, SettlementPayoutStatus, ShopCreateRequest, ShopFeeConfigEntry, ShopFeeConfigParams, ShopFeeConfigResponse, ShopRisk, ShopSettlementOverview, ShopStats, ShopStatsResponse, ShopUpdateRequest, ShopVisibilityResponse, ShopVisibilityUpdateRequest, SignInRequest, SignUpRequest, SignUpWithMerchantRequest, SizeScale, SpacingScale, StatementAdjustment, StatementAdjustmentCreateRequest, StatementAdjustmentListResponse, StatementGenerateRequest, StatementPayoutUpdateRequest, StaticRoutingAlgorithm, StatsPeriod, StripeConnectAccountRequest, StripeConnectAccountResponse, StripeConnectLinkRequest, StripeConnectLinkResponse, StripeNativePane, StripePaymentMethodDomainResult, StripePaymentMethodDomainStatus, StripePaymentMethodDomainsRegisterRequest, StripePaymentMethodDomainsRegisterResponse, SubscriptionBillingProcessorResponse, SubscriptionBucket, SubscriptionCaveat, SubscriptionChild, SubscriptionDrillBase, SubscriptionDrillSortKey, SubscriptionDrillTarget, SubscriptionEstimateParams, SubscriptionEstimateResponse, SubscriptionFilters, SubscriptionInvoice, SubscriptionInvoiceListParams, SubscriptionInvoiceListResponse, SubscriptionItem, SubscriptionItemPrice, SubscriptionItemType, SubscriptionLineItem, SubscriptionListParams, SubscriptionMovement, SubscriptionPaymentData, SubscriptionPaymentDetails, SubscriptionPaymentLink, SubscriptionPaymentLookupRequest, SubscriptionPaymentLookupResponse, SubscriptionPeriodUnit, SubscriptionProcessors, SubscriptionResponse, SubscriptionStatus, SubscriptionTotals, Subscriptions, SummaryPosition, SupportedPaymentMethod, SurchargeDetailsResponse, SurchargeResponse, SurchargeRuleRequest, SurchargeRuleResponse, SurfaceStyle, SwitchMerchantRequest, SwitchProfileRequest, Terminate2faQueryParams, ThemeBrowserLanguage, ThemeCheckoutChannel, ThemeChoice, ThemeCondition, ThemeDeviceClass, ThemeEnumCondition, ThemeIfStatement, ThemeMetadataCondition, ThemeNumberCondition, ThemeTrafficSource, ThreeDSDecision, ThreeDsRuleExecuteRequest, ThreeDsRuleResponse, TierSummary, TimeToPayBucket, TimeToPayBucketLabel, TimeToPayStats, TokenPurpose, TokenResponse, TopupRequest, TopupResponse, TotpResponse, TransactionType, TrustBadge, UpdateMetadataRequest, UpdateOperationLimitSettingsRequest, UpdateRoleConnectorGrantParams, UpdateSubscriptionRequest, UpdateUserDetailsRequest, UpdateUserRoleRequest, UpsertOperationLimitRuleRequest, UpsertRefundLimitRuleRequest, UpsertSettlementAdjustmentLimitRuleRequest, UpsertSettlementPayoutLimitRuleRequest, UserInLineage, UserResponse, UserSessionEntry, UserSessionListResponse, UserSessionRevokeResponse, VaultCheck, VaultCheckId, VaultCheckStatus, VaultCollectSessionResponse, VaultPaymentMethodRequest, VaultPaymentMethodResponse, VaultRouteApplyVerification, VaultRouteChange, VaultRouteChangeKind, VaultRouteFieldChange, VaultRouteIds, VaultRoutePurpose, VaultRouteWarning, VaultRouteWarningCode, VaultRoutesApplyRequest, VaultRoutesApplyResponse, VaultRoutesFingerprint, VaultRoutesPreviewRequest, VaultRoutesPreviewResponse, VaultVerificationResponse, VaultVerifyRequest, VerifyTotpRequest, WCAG_AA_TEXT, WCAG_AA_UI, WebhookDeliveryAttempt, WebhookDeliveryTerminalReason, WebhookDetails, WebhookEvent, WebhookRefundStatus, WebhookRegistrationEnvironment, Webhooks, allOf, anyOf, applyBrandingVariables, buildBrandingExport, buttonPadValue, cloneBranding, cloneCustomField, cloneNativePane, clonePane, contrastRatio, customFieldContextFromMetadata, customFieldIsTextLike, customFieldOperatorTakesValue, customFieldOptionLabel, customFieldText, decodeBadges, decodeBranding, decodeCustomFields, decodeNativePanes, decodePanes, defaultBranding, defaultCustomFieldVisibility, defaultNativePane, defaultOperatorForSource, defaultPane, emptyPaneCatalog, encodeBadges, encodeBranding, encodeCustomFields, encodeNativePanes, encodePanes, evaluateCustomFieldCondition, evaluateCustomFieldVisibility, feeProgram, focusedCheckoutUrl, fontStack, fontWeightValue, inputPadValue, isCheckboxChecked, isDarkSurface, isHexColor, leaf, logoDimensions, nativePaneMethodInfo, offerablePaneMethods, paneCatalogFor, paneDisplayDefaults, paneMethodInfo, paneRailAllowed, paneViewVisibility, parseCustomFieldsLoose, parseImportedBranding, programToTree, radiusValue, ruleMatchToTree, sanitizeCustomCss, shadowFor, surfacePadValue, validatePanes, verticalGapValue, visibleCustomFields } from './index.js';
 
 /**
@@ -158,6 +158,46 @@ interface AdminUserResponse {
     is_verified: boolean;
     is_active: boolean;
 }
+/**
+ * Which requested change the last-administrator guard refused.
+ *
+ * Rides in `error.data.route` of a `UR_66` so the caller can say *what* was
+ * refused from its own translations — the message is generic on purpose and
+ * should not be displayed.
+ */
+type LastAdministratorRoute = 
+/** `is_active: false` on the last administrator. */
+'deactivate'
+/**
+ * `role_id` moving the last administrator onto a role that cannot manage
+ * the merchant's users.
+ */
+ | 'demote'
+/**
+ * `is_verified: false` on the last administrator. Not an immediate lockout
+ * — the sign-in flow allows a grace window after `created_at` — but one that
+ * has long since closed for an established account.
+ */
+ | 'unverify'
+/** `DELETE` on the last administrator. */
+ | 'delete';
+/**
+ * `error.data` of a `UR_66`: `updateUser` / `deleteUser` refused a change
+ * because it would leave `merchant_id` with nobody who can manage its users.
+ *
+ * "Administrator" means an active account whose active role binding at the
+ * merchant resolves to a role holding user-write permission at merchant scope
+ * — resolved through the role's permission groups, so a custom role counts the
+ * same as `merchant_admin`. A user who is inactive, or whose role binding is
+ * still a pending invitation, is not one.
+ *
+ * Narrow a caught `DelopayError` onto this by checking `code === 'UR_66'`;
+ * `data` is absent against a router that predates the guard.
+ */
+interface LastAdministratorRefusal {
+    merchant_id: string;
+    route: LastAdministratorRoute;
+}
 interface AdminCustomerDetail {
     customer_id: string;
     organization_id: string;
@@ -542,6 +582,69 @@ interface AdminUnsuspendRequest {
 interface AdminSetTrustedRequest {
     trusted: boolean;
 }
+/**
+ * Admin-only: mark a merchant free (not billed), or put it back on the
+ * prepaid model (delopay-backend#378).
+ *
+ * A union rather than an optional `reason`, on the `SettlementCostPeriod`
+ * precedent: `free: true` without a reason can only earn a 412, so that shape
+ * must not typecheck. Marking free normalises a billing-caused status — `pending_setup`, `delinquent`, or an
+ * `auto_recharge` suspension — to `active`. A sticky `admin` suspension is
+ * refused with 412 until lifted explicitly: the flag must never quietly
+ * unblock a merchant that was stopped for fraud. `free: false` re-derives the
+ * status from the balance the way an unsuspend does.
+ */
+type AdminSetFreeRequest = {
+    free: true;
+    /** Why the merchant is not billed. Required: the router refuses `free: true` without one (412). */
+    reason: string;
+} | {
+    free: false;
+    /** Ignored when clearing the flag; accepted so a caller can carry one through. */
+    reason?: string;
+};
+/**
+ * Admin-only: delete a merchant's **entire** ledger (delopay-backend#378).
+ * Every live entry is soft-deleted (kept for replay protection), the balance
+ * is set to zero and the status re-derived. Refused with 412 while the
+ * merchant has shop allocations.
+ */
+interface AdminResetLedgerRequest {
+    /** Human-readable reason, required for audit. */
+    reason: string;
+}
+interface AdminResetLedgerResponse {
+    /** Live entries removed from the ledger. */
+    deleted_count: number;
+    /** Signed sum of the removed entries' amounts, in the balance currency. */
+    deleted_amount: number;
+    /** The balance before the reset; after it the balance is always zero. */
+    balance_before: number;
+    /** The profile as it stands after the reset. */
+    profile: BillingProfileResponse;
+}
+/**
+ * Admin-only: (re)create a merchant's ledger, optionally seeded with an
+ * opening balance (delopay-backend#378). Ensures the billing profile exists
+ * (created without the welcome promo credit) and, when `opening_balance` is
+ * set, writes one `opening_balance` entry. Refused with 412 while the
+ * merchant still has live ledger entries, or a non-zero balance with none.
+ * Does not clear the free flag.
+ */
+interface AdminCreateLedgerRequest {
+    /** Opening balance in minor units of the balance currency. Omit or `0` for an empty ledger. */
+    opening_balance?: number;
+    /** ISO-4217 currency for a profile that does not exist yet; must match an existing profile's. */
+    balance_currency?: string;
+    /** Human-readable reason, required for audit; also the opening entry's description. */
+    reason: string;
+}
+interface AdminCreateLedgerResponse {
+    /** The opening-balance entry, when one was written. */
+    ledger_entry_id?: string | null;
+    /** The profile as it stands after the call. */
+    profile: BillingProfileResponse;
+}
 interface CardIssuerCreateRequest {
     issuer_name: string;
 }
@@ -1036,12 +1139,22 @@ declare class AdminPortal {
      * against signup policy + JWT blacklist). `reset_2fa` clears TOTP state
      * so the user re-enrolls on next login. `is_active` supports both
      * directions: false soft-disables, true reactivates a soft-disabled user.
+     *
+     * Throws a `400` with `code === 'UR_66'` when the change would leave a
+     * merchant with no administrator — `is_active: false` or `is_verified:
+     * false` on, or a `role_id` demoting, the only active user whose role can
+     * manage that merchant's users. Nothing is written. `error.data` carries a
+     * {@link LastAdministratorRefusal} naming the merchant and which change was
+     * refused; render that rather than the generic message.
      */
     updateUser(userId: string, body: AdminUpdateUserRequest): Promise<AdminUserResponse>;
     /**
      * Soft-delete a user globally: deactivates the row, blacklists existing
      * JWTs, and wipes credentials. Distinct from `deleteUserRole`, which
      * removes a single role binding while leaving the user signed-in elsewhere.
+     *
+     * Throws the same `UR_66` as {@link updateUser} when the user is the last
+     * administrator of any merchant they belong to, with `route: 'delete'`.
      */
     deleteUser(userId: string): Promise<void>;
     /**
@@ -1368,6 +1481,50 @@ declare class PlatformBilling {
      * @returns The updated billing profile.
      */
     setTrusted(merchantId: string, params: AdminSetTrustedRequest): Promise<BillingProfileResponse>;
+    /**
+     * Mark a merchant free (not billed), or put it back on the prepaid model
+     * (delopay-backend#378). While free, no platform fee is deducted, the
+     * payment gate never blocks on billing status, top-ups are refused and
+     * auto-recharge is inert. Marking free needs a `reason` and is refused
+     * (412) while an admin suspension is in force — lift that first.
+     *
+     * Requires a router with delopay-backend#378; older routers answer `404`.
+     *
+     * @param merchantId - The merchant account ID.
+     * @param params - The desired free state and, when marking free, the reason.
+     * @returns The updated billing profile.
+     */
+    setFree(merchantId: string, params: AdminSetFreeRequest): Promise<BillingProfileResponse>;
+    /**
+     * Delete a merchant's **entire** ledger (delopay-backend#378). Every live
+     * entry is soft-deleted — kept, so a replayed fee deduction or top-up
+     * webhook still no-ops — the balance is set to zero and the status
+     * re-derived (`active` for a free merchant; an active paying merchant
+     * lands in `delinquent`). Refused (412) while the merchant has shop
+     * allocations. Audited.
+     *
+     * Requires a router with delopay-backend#378; older routers answer `404`.
+     *
+     * @param merchantId - The merchant account ID.
+     * @param params - The reason, required for audit.
+     * @returns What was removed and the post-reset profile.
+     */
+    resetLedger(merchantId: string, params: AdminResetLedgerRequest): Promise<AdminResetLedgerResponse>;
+    /**
+     * (Re)create a merchant's ledger, optionally seeded with an opening balance
+     * (delopay-backend#378). Ensures the billing profile exists (created
+     * without the welcome promo credit) and, when `opening_balance` is set,
+     * writes one `opening_balance` entry through the same atomic helper an
+     * admin credit uses. Refused (412) while live entries or a non-zero balance
+     * remain — reset first. Does not clear the free flag. Audited.
+     *
+     * Requires a router with delopay-backend#378; older routers answer `404`.
+     *
+     * @param merchantId - The merchant account ID.
+     * @param params - Opening balance (minor units), currency for a new profile, and the reason.
+     * @returns The opening entry id (if one was written) and the profile.
+     */
+    createLedger(merchantId: string, params: AdminCreateLedgerRequest): Promise<AdminCreateLedgerResponse>;
 }
 
 /**
@@ -1460,4 +1617,4 @@ declare class DelopayInternal extends Delopay {
     constructor(...args: ConstructorParameters<typeof Delopay>);
 }
 
-export { Admin, type AdminAdjustmentRequest, type AdminAdjustmentResponse, type AdminAnalyticsRequest, type AdminAttachVaultRequest, type AdminAttachVaultResponse, type AdminCreateUserForMerchantRequest, type AdminCustomerDetail, type AdminCustomerListParams, type AdminCustomerListResponse, type AdminLedgerAnalyticsRequest, type AdminLedgerAnalyticsResponse, AdminPortal, type AdminSetTrustedRequest, type AdminShopVaultState, type AdminSignInRequest, type AdminSuspendRequest, type AdminTransactionListParams, type AdminTransactionListResponse, type AdminUnsuspendRequest, type AdminUpdateUserRequest, type AdminUserResponse, type AdminVaultEntitlementState, type AdminVaultEnvironmentState, type AdminVaultStateResponse, AnalyticsScopeRequest, AnalyticsScopeResponse, type AuditActorInfo, type AuditActorKind, type AuditImpersonationKind, type AuditLogListParams, type AuditLogListResponse, type AuditLogResponse, AuditLogs, type AuditSessionInfo, AuthResponse, type AuthorizeResponse, BillingProfileResponse, Cache, type CardIssuerCreateRequest, type CardIssuerListResponse, type CardIssuerResponse, type CardIssuerUpdateRequest, CardIssuers, ClientAnalyticsRequest, Configs, type ConnectorRestrictionResponse, type ConnectorRestrictionRuleAction, type ConnectorRestrictionRuleResponse, ConnectorRestrictionRules, type ConnectorRestrictionScope, ConnectorRestrictions, type ConnectorVisibility, type CreateConnectorRestrictionRuleRequest, type CreateInternalUserRequest, type CreateTenantUserRequest, type CustomerSummary, type CustomerUser, Delopay, DelopayInternal, DeviceDrillRequest, DevicesAnalyticsResponse, DrillResponse, FeeRulePreviewRequest, FeeRulePreviewResponse, FeeScheduleCreateRequest, FeeScheduleResponse, FeeScheduleUpdateRequest, FeeStatementDetail, type FeeTotalBound, GeoAnalyticsResponse, GeoDrillRequest, Gsm, type GsmDecision, type GsmRuleCreateRequest, type GsmRuleResponse, type GsmRuleUpdateRequest, type LedgerDayBucket, type LedgerMerchant, type ListConnectorRestrictionRulesQuery, MerchantAccountResponse, MerchantAccountUpdateRequest, type OnboardMerchantRequest, type OnboardMerchantResponse, type OverviewStat, type OverviewStatsResponse, type PaymentAnalyticsRequest, type PaymentAnalyticsResponse, PaymentAttemptsListResponse, type PaymentAutoCloseConfigResponse, type PaymentAutoCloseOverrideResponse, PaymentClientContextListResponse, type PaymentPeriodStats, PaymentResponse, PaymentStatusHistoryResponse, PaymentsDeleteResponse, type PlatformAnalyticsResponse, PlatformBilling, PlatformFeeRuleInput, PlatformFeeRuleRecord, PlatformFees, ProfileResponse, ProjectResponse, type PromoConfigResponse, RefundListResponse, RequestFn, ScopeDrillRequest, SettlementCurrentParams, SettlementCurrentResponse, SettlementOverviewParams, SettlementOverviewResponse, SettlementStatementListParams, SettlementStatementListResponse, ShopResponse, SignUpWithMerchantIdRequest, type SignupToggleRequest, type SignupToggleResponse, StatementPdfParams, SubscriptionAnalyticsRequest, SubscriptionAnalyticsResponse, SubscriptionDrillRequest, type TransactionDeleteConfigResponse, type TransactionDeleteOverrideResponse, type UpdateConnectorRestrictionRuleRequest, type UpdateLedgerEntryRequest, type UpdatePaymentAutoCloseConfigRequest, type UpdatePaymentAutoCloseOverrideRequest, type UpdatePromoConfigRequest, type UpdateTransactionDeleteConfigRequest, type UpdateTransactionDeleteOverrideRequest, type UpsertConnectorRestrictionRequest, VaultEnvironment };
+export { Admin, type AdminAdjustmentRequest, type AdminAdjustmentResponse, type AdminAnalyticsRequest, type AdminAttachVaultRequest, type AdminAttachVaultResponse, type AdminCreateLedgerRequest, type AdminCreateLedgerResponse, type AdminCreateUserForMerchantRequest, type AdminCustomerDetail, type AdminCustomerListParams, type AdminCustomerListResponse, type AdminLedgerAnalyticsRequest, type AdminLedgerAnalyticsResponse, AdminPortal, type AdminResetLedgerRequest, type AdminResetLedgerResponse, type AdminSetFreeRequest, type AdminSetTrustedRequest, type AdminShopVaultState, type AdminSignInRequest, type AdminSuspendRequest, type AdminTransactionListParams, type AdminTransactionListResponse, type AdminUnsuspendRequest, type AdminUpdateUserRequest, type AdminUserResponse, type AdminVaultEntitlementState, type AdminVaultEnvironmentState, type AdminVaultStateResponse, AnalyticsScopeRequest, AnalyticsScopeResponse, type AuditActorInfo, type AuditActorKind, type AuditImpersonationKind, type AuditLogListParams, type AuditLogListResponse, type AuditLogResponse, AuditLogs, type AuditSessionInfo, AuthResponse, type AuthorizeResponse, BillingProfileResponse, Cache, type CardIssuerCreateRequest, type CardIssuerListResponse, type CardIssuerResponse, type CardIssuerUpdateRequest, CardIssuers, ClientAnalyticsRequest, Configs, type ConnectorRestrictionResponse, type ConnectorRestrictionRuleAction, type ConnectorRestrictionRuleResponse, ConnectorRestrictionRules, type ConnectorRestrictionScope, ConnectorRestrictions, type ConnectorVisibility, type CreateConnectorRestrictionRuleRequest, type CreateInternalUserRequest, type CreateTenantUserRequest, type CustomerSummary, type CustomerUser, Delopay, DelopayInternal, DeviceDrillRequest, DevicesAnalyticsResponse, DrillResponse, FeeRulePreviewRequest, FeeRulePreviewResponse, FeeScheduleCreateRequest, FeeScheduleResponse, FeeScheduleUpdateRequest, FeeStatementDetail, type FeeTotalBound, GeoAnalyticsResponse, GeoDrillRequest, Gsm, type GsmDecision, type GsmRuleCreateRequest, type GsmRuleResponse, type GsmRuleUpdateRequest, type LastAdministratorRefusal, type LastAdministratorRoute, type LedgerDayBucket, type LedgerMerchant, type ListConnectorRestrictionRulesQuery, MerchantAccountResponse, MerchantAccountUpdateRequest, type OnboardMerchantRequest, type OnboardMerchantResponse, type OverviewStat, type OverviewStatsResponse, type PaymentAnalyticsRequest, type PaymentAnalyticsResponse, PaymentAttemptsListResponse, type PaymentAutoCloseConfigResponse, type PaymentAutoCloseOverrideResponse, PaymentClientContextListResponse, type PaymentPeriodStats, PaymentResponse, PaymentStatusHistoryResponse, PaymentsDeleteResponse, type PlatformAnalyticsResponse, PlatformBilling, PlatformFeeRuleInput, PlatformFeeRuleRecord, PlatformFees, ProfileResponse, ProjectResponse, type PromoConfigResponse, RefundListResponse, RequestFn, ScopeDrillRequest, SettlementCurrentParams, SettlementCurrentResponse, SettlementOverviewParams, SettlementOverviewResponse, SettlementStatementListParams, SettlementStatementListResponse, ShopResponse, SignUpWithMerchantIdRequest, type SignupToggleRequest, type SignupToggleResponse, StatementPdfParams, SubscriptionAnalyticsRequest, SubscriptionAnalyticsResponse, SubscriptionDrillRequest, type TransactionDeleteConfigResponse, type TransactionDeleteOverrideResponse, type UpdateConnectorRestrictionRuleRequest, type UpdateLedgerEntryRequest, type UpdatePaymentAutoCloseConfigRequest, type UpdatePaymentAutoCloseOverrideRequest, type UpdatePromoConfigRequest, type UpdateTransactionDeleteConfigRequest, type UpdateTransactionDeleteOverrideRequest, type UpsertConnectorRestrictionRequest, VaultEnvironment };

package/dist/internal.js

@@ -110,7 +110,7 @@ import {
   validatePanes,
   verticalGapValue,
   visibleCustomFields
-} from "./chunk-3O5MU6FP.js";
+} from "./chunk-VH5NCMH6.js";
 
 // src/internal/resources/admin.ts
 var Admin = class {
@@ -373,6 +373,13 @@ var AdminPortal = class {
    * against signup policy + JWT blacklist). `reset_2fa` clears TOTP state
    * so the user re-enrolls on next login. `is_active` supports both
    * directions: false soft-disables, true reactivates a soft-disabled user.
+   *
+   * Throws a `400` with `code === 'UR_66'` when the change would leave a
+   * merchant with no administrator — `is_active: false` or `is_verified:
+   * false` on, or a `role_id` demoting, the only active user whose role can
+   * manage that merchant's users. Nothing is written. `error.data` carries a
+   * {@link LastAdministratorRefusal} naming the merchant and which change was
+   * refused; render that rather than the generic message.
    */
   async updateUser(userId, body) {
     return this.request("PATCH", `/admin-portal/users/${encodeURIComponent(userId)}`, { body });
@@ -381,6 +388,9 @@ var AdminPortal = class {
    * Soft-delete a user globally: deactivates the row, blacklists existing
    * JWTs, and wipes credentials. Distinct from `deleteUserRole`, which
    * removes a single role binding while leaving the user signed-in elsewhere.
+   *
+   * Throws the same `UR_66` as {@link updateUser} when the user is the last
+   * administrator of any merchant they belong to, with `route: 'delete'`.
    */
   async deleteUser(userId) {
     return this.request("DELETE", `/admin-portal/users/${encodeURIComponent(userId)}`);
@@ -888,6 +898,62 @@ var PlatformBilling = class {
       body: params
     });
   }
+  /**
+   * Mark a merchant free (not billed), or put it back on the prepaid model
+   * (delopay-backend#378). While free, no platform fee is deducted, the
+   * payment gate never blocks on billing status, top-ups are refused and
+   * auto-recharge is inert. Marking free needs a `reason` and is refused
+   * (412) while an admin suspension is in force — lift that first.
+   *
+   * Requires a router with delopay-backend#378; older routers answer `404`.
+   *
+   * @param merchantId - The merchant account ID.
+   * @param params - The desired free state and, when marking free, the reason.
+   * @returns The updated billing profile.
+   */
+  async setFree(merchantId, params) {
+    return this.request("PATCH", `/billing/${encodeURIComponent(merchantId)}/admin/free`, {
+      body: params
+    });
+  }
+  /**
+   * Delete a merchant's **entire** ledger (delopay-backend#378). Every live
+   * entry is soft-deleted — kept, so a replayed fee deduction or top-up
+   * webhook still no-ops — the balance is set to zero and the status
+   * re-derived (`active` for a free merchant; an active paying merchant
+   * lands in `delinquent`). Refused (412) while the merchant has shop
+   * allocations. Audited.
+   *
+   * Requires a router with delopay-backend#378; older routers answer `404`.
+   *
+   * @param merchantId - The merchant account ID.
+   * @param params - The reason, required for audit.
+   * @returns What was removed and the post-reset profile.
+   */
+  async resetLedger(merchantId, params) {
+    return this.request("DELETE", `/billing/${encodeURIComponent(merchantId)}/admin/ledger`, {
+      body: params
+    });
+  }
+  /**
+   * (Re)create a merchant's ledger, optionally seeded with an opening balance
+   * (delopay-backend#378). Ensures the billing profile exists (created
+   * without the welcome promo credit) and, when `opening_balance` is set,
+   * writes one `opening_balance` entry through the same atomic helper an
+   * admin credit uses. Refused (412) while live entries or a non-zero balance
+   * remain — reset first. Does not clear the free flag. Audited.
+   *
+   * Requires a router with delopay-backend#378; older routers answer `404`.
+   *
+   * @param merchantId - The merchant account ID.
+   * @param params - Opening balance (minor units), currency for a new profile, and the reason.
+   * @returns The opening entry id (if one was written) and the profile.
+   */
+  async createLedger(merchantId, params) {
+    return this.request("POST", `/billing/${encodeURIComponent(merchantId)}/admin/ledger`, {
+      body: params
+    });
+  }
 };
 
 // src/internal/resources/platformFees.ts