@delopay/sdk 0.113.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';
 
 /**
@@ -582,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;
 }
@@ -1418,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>;
 }
 
 /**
@@ -1510,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 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 };
+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';
 
 /**
@@ -582,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;
 }
@@ -1418,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>;
 }
 
 /**
@@ -1510,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 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 };
+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-NY5O6S5X.js";
+} from "./chunk-VH5NCMH6.js";
 
 // src/internal/resources/admin.ts
 var Admin = class {
@@ -898,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