@payclave/sdk-server 0.1.0 → 0.2.0

package/dist/index.d.ts

@@ -3,7 +3,10 @@ import { Buffer } from 'node:buffer';
 type PayclaveMode = "test" | "live" | (string & {});
 type PayclaveInvoiceStatus = "pending" | "processing" | "paid" | "underpaid" | "overpaid" | "expired" | "failed" | "cancelled" | (string & {});
 type PayclavePaymentStatus = "detected" | "validating" | "confirmed" | "failed" | "duplicate" | "underpaid" | "overpaid" | (string & {});
-declare const PAYCLAVE_WEBHOOK_EVENT_TYPES: readonly ["invoice.paid", "invoice.expired", "payment.failed", "payment.underpaid", "payment.overpaid"];
+type PayclaveInvoiceCollectionState = "draft" | "open" | "past_due" | "partially_paid" | "paid" | "void" | "uncollectible" | (string & {});
+type PayclaveMigrationState = "current" | "review_required" | (string & {});
+type PayclaveSourceType = "api" | "dashboard" | "payment_link" | "sdk" | "legacy" | (string & {});
+declare const PAYCLAVE_WEBHOOK_EVENT_TYPES: readonly ["invoice.issued", "invoice.paid", "invoice.partially_paid", "invoice.past_due", "invoice.overpaid", "invoice.voided", "invoice.uncollectible", "invoice.refund_recorded", "invoice.payment_received_after_void", "invoice.payment_received_after_uncollectible", "invoice.expired", "payment_link.completed", "payment_link.expired", "payment.failed", "payment.underpaid", "payment.overpaid"];
 type PayclaveWebhookEventType = (typeof PAYCLAVE_WEBHOOK_EVENT_TYPES)[number];
 type PayclaveWebhookDeliveryStatus = "pending" | "delivering" | "delivered" | "retry_scheduled" | "failed" | (string & {});
 type PayclaveMetadata = Record<string, unknown>;
@@ -17,6 +20,20 @@ type PayclaveServerClientOptions = {
 type PayclaveRequestOptions = {
     signal?: AbortSignal;
 };
+type PayclaveInvoicePDF = {
+    bytes: Uint8Array;
+    contentType: "application/pdf";
+    filename: string;
+    requestId: string | null;
+};
+type PayclaveReconciliationDownload = {
+    stream: ReadableStream<Uint8Array>;
+    contentType: "application/zip";
+    filename: string;
+    byteSize: number | null;
+    sha256: string | null;
+    requestId: string | null;
+};
 type CreateCheckoutSessionInput = PayclaveRequestOptions & {
     amount: string;
     customerEmail?: string;
@@ -34,6 +51,168 @@ type CreateInvoiceInput = PayclaveRequestOptions & {
     expiresInMinutes?: number;
     idempotencyKey?: string;
 };
+type PayclaveInvoiceCustomer = {
+    name?: string;
+    email?: string;
+    company?: string;
+    billingAddress?: string | null;
+};
+type PayclaveInvoiceLineInput = {
+    id?: string;
+    description: string;
+    sku?: string | null;
+    quantity: string;
+    unitAmount: string;
+};
+type PayclaveInvoiceDiscountInput = {
+    type: "fixed";
+    amount: string;
+    percentage?: never;
+} | {
+    type: "percentage";
+    percentage: string;
+    amount?: never;
+};
+type PayclaveInvoiceTaxInput = {
+    id?: string;
+    label: string;
+    jurisdiction?: string | null;
+    registrationReference?: string | null;
+    amount: string;
+};
+type PayclaveInvoiceReminderSchedule = {
+    enabled: boolean;
+    daysBeforeDue?: number[];
+    onDue?: boolean;
+    daysAfterDue?: number[];
+};
+type PayclaveInvoiceDraftFields = {
+    customer: PayclaveInvoiceCustomer;
+    lines: PayclaveInvoiceLineInput[];
+    discount?: PayclaveInvoiceDiscountInput | null;
+    taxes?: PayclaveInvoiceTaxInput[];
+    dueAt?: string | null;
+    paymentTerms?: string;
+    memo?: string;
+    footer?: string;
+    purchaseOrderNumber?: string;
+    externalReference?: string | null;
+    currencyCode?: string;
+    metadata?: PayclaveMetadata;
+    successUrl?: string | null;
+    cancelUrl?: string | null;
+    checkoutExpiresInMinutes?: number;
+    reminderSchedule?: PayclaveInvoiceReminderSchedule;
+};
+type CreateInvoiceDraftInput = PayclaveRequestOptions & PayclaveInvoiceDraftFields & {
+    idempotencyKey?: string;
+};
+type UpdateInvoiceDraftInput = PayclaveRequestOptions & PayclaveInvoiceDraftFields & {
+    version: number;
+    idempotencyKey?: string;
+};
+type IssueInvoiceInput = PayclaveRequestOptions & {
+    version: number;
+    send?: boolean;
+    idempotencyKey?: string;
+};
+type PayclaveInvoiceDelivery = {
+    id: string;
+    type: "issue" | "send" | "reminder" | (string & {});
+    recipient: string;
+    templateVersion: string;
+    status: string;
+    providerMessageId: string | null;
+    lastError: string | null;
+    scheduledFor: string;
+    sentAt: string | null;
+    createdAt: string;
+    reminderKey: string | null;
+};
+type PayclaveInvoiceActivityEvent = {
+    id: string;
+    action: string;
+    actorType: string;
+    actorId: string;
+    changes: Record<string, unknown>;
+    createdAt: string;
+};
+type InvoiceActionInput = PayclaveRequestOptions & {
+    reason?: string;
+    idempotencyKey?: string;
+};
+type CreateInvoiceCheckoutSessionInput = PayclaveRequestOptions & {
+    idempotencyKey?: string;
+};
+type RecordInvoiceRefundReferenceInput = PayclaveRequestOptions & {
+    paymentId: string;
+    amount: string;
+    reason: string;
+    externalTransactionHash: string;
+    chainId: number;
+    tokenContract: string;
+    idempotencyKey?: string;
+};
+type ListInvoicesInput = PayclaveRequestOptions & {
+    limit?: number;
+    startingAfter?: string;
+    collectionState?: PayclaveInvoiceCollectionState;
+};
+type PayclavePaymentLinkStatus = "draft" | "active" | "paused" | "completed" | "expired" | "archived" | (string & {});
+type PayclavePaymentLinkAmountType = "fixed" | "customer_entered";
+type PayclavePaymentLinkUsageType = "single_use" | "reusable";
+type PayclavePaymentLinkCollect = {
+    email: boolean;
+    name: boolean;
+    reference: boolean;
+};
+type PayclavePaymentLinkFields = {
+    mode?: "test" | "live";
+    title: string;
+    description?: string;
+    amountType: PayclavePaymentLinkAmountType;
+    amount?: string;
+    minimumAmount?: string;
+    maximumAmount?: string;
+    currencyCode?: "USDC" | "USDT";
+    usageType?: PayclavePaymentLinkUsageType;
+    activeAt?: string | null;
+    expiresAt?: string | null;
+    collect?: Partial<PayclavePaymentLinkCollect>;
+    referencePrefix?: string;
+    successUrl?: string | null;
+    cancelUrl?: string | null;
+    successMessage?: string;
+    metadata?: PayclaveMetadata;
+};
+type CreatePaymentLinkInput = PayclaveRequestOptions & PayclavePaymentLinkFields & {
+    idempotencyKey?: string;
+};
+type UpdatePaymentLinkInput = PayclaveRequestOptions & PayclavePaymentLinkFields & {
+    version: number;
+    idempotencyKey?: string;
+};
+type PaymentLinkActionInput = PayclaveRequestOptions & {
+    idempotencyKey?: string;
+};
+type ReleasePaymentLinkReservationInput = PayclaveRequestOptions & {
+    acknowledgeLatePaymentRisk: true;
+    idempotencyKey?: string;
+};
+type ListPaymentLinksInput = PayclaveRequestOptions & {
+    limit?: number;
+    startingAfter?: string;
+    status?: PayclavePaymentLinkStatus;
+    amountType?: PayclavePaymentLinkAmountType;
+    usageType?: PayclavePaymentLinkUsageType;
+    currencyCode?: "USDC" | "USDT";
+    search?: string;
+    createdFrom?: string;
+    createdTo?: string;
+};
+type ListPaymentLinkPaymentsInput = PayclaveRequestOptions & {
+    limit?: number;
+};
 type CreateWebhookEndpointInput = PayclaveRequestOptions & {
     url: string;
     eventTypes?: PayclaveWebhookEventType[];
@@ -44,16 +223,186 @@ type CreateTestWebhookInput = PayclaveRequestOptions & {
 };
 type ListWebhookDeliveriesInput = PayclaveRequestOptions & {
     limit?: number;
+    endpointId?: string;
+    eventType?: PayclaveWebhookEventType;
+    status?: PayclaveWebhookDeliveryStatus;
+    createdFrom?: string;
+    createdTo?: string;
+    replayStatus?: "original" | "replay";
+    responseFamily?: "2xx" | "3xx" | "4xx" | "5xx" | "network";
+};
+type ReplayWebhookDeliveryInput = PayclaveRequestOptions & {
+    idempotencyKey: string;
+};
+type UpdateWebhookEndpointInput = PayclaveRequestOptions & {
+    url?: string;
+    enabled?: boolean;
+    eventTypes?: PayclaveWebhookEventType[];
+    alertsEnabled?: boolean;
+    alertThreshold?: number;
+    recoveryAlertsEnabled?: boolean;
+    idempotencyKey: string;
+};
+type WebhookEndpointActionInput = PayclaveRequestOptions & {
+    idempotencyKey: string;
+};
+type ListWebhookIncidentsInput = PayclaveRequestOptions & {
+    status?: "open" | "resolved";
+};
+declare const PAYCLAVE_RECONCILIATION_SCHEMA_VERSION: "2026-08-29.v1";
+type PayclaveReconciliationDateBasis = "invoice_created" | "invoice_issued" | "invoice_paid" | "payment_confirmed" | "transaction_observed";
+type GetReconciliationSummaryInput = PayclaveRequestOptions & {
+    dateBasis: PayclaveReconciliationDateBasis;
+    from: string;
+    to: string;
+    timezone?: string;
+    invoiceStatuses?: PayclaveInvoiceStatus[];
+    paymentStatuses?: PayclavePaymentStatus[];
+    settlementTokens?: Array<"USDC" | "USDT" | (string & {})>;
+    exceptionOnly?: boolean;
+};
+type PayclaveReconciliationTokenSummary = {
+    tokenSymbol: string;
+    tokenContract: string;
+    chainId: number;
+    invoiceCount: number;
+    paymentCount: number;
+    exceptionCount: number;
+    invoiceTotal: string;
+    customerGrossPaid: string;
+    platformFeeExpected: string;
+    platformFeeCollected: string;
+    expectedMerchantSettlement: string;
+    merchantSettled: string;
+    outstanding: string;
+    overpayment: string;
+    nominalStablecoinUsd: string;
+    invoiceStatusCounts: Record<string, number>;
+    paymentStatusCounts: Record<string, number>;
+};
+type PayclaveReconciliationSummary = {
+    schemaVersion: string;
+    dateBasis: PayclaveReconciliationDateBasis;
+    from: string;
+    to: string;
+    cutoffAt: string;
+    timezone: string;
+    rowCounts: Record<string, number>;
+    summaryByToken: PayclaveReconciliationTokenSummary[];
+    exceptions: Array<{
+        invoiceId: string;
+        invoiceNumber: string;
+        state: string;
+        reasonCodes: string[];
+        tokenSymbol: string;
+        customerGrossPaid: string;
+        outstanding: string;
+    }>;
+    warnings: string[];
+};
+type PayclaveReconciliationSchema = {
+    schemaVersion: string;
+    formats: string[];
+    dateBases: PayclaveReconciliationDateBasis[];
+    maximumRangeDays: number;
+    rangeEnd: "exclusive" | (string & {});
+    retention: string;
+    files: Array<{
+        name: string;
+        description: string;
+        columns: Array<{
+            name: string;
+            type: string;
+            description: string;
+            pii: boolean;
+        }>;
+    }>;
+    stateRules: Array<{
+        state: string;
+        description: string;
+    }>;
+};
+type PayclaveReconciliationExportStatus = "queued" | "running" | "ready" | "failed" | "cancelled" | "expired" | (string & {});
+type PayclaveReconciliationFilters = {
+    from: string;
+    to: string;
+    invoiceStatuses?: PayclaveInvoiceStatus[];
+    paymentStatuses?: PayclavePaymentStatus[];
+    settlementTokens?: string[];
+    exceptionOnly: boolean;
+};
+type PayclaveReconciliationFile = {
+    name: string;
+    mediaType: string;
+    rows: number;
+    bytes: number;
+    sha256: string;
+};
+type PayclaveReconciliationExport = {
+    id: string;
+    merchantId: string;
+    mode: PayclaveMode;
+    status: PayclaveReconciliationExportStatus;
+    format: "csv" | "json" | (string & {});
+    schemaVersion: string;
+    filters: PayclaveReconciliationFilters;
+    dateBasis: PayclaveReconciliationDateBasis;
+    cutoffAt?: string | null;
+    timezone: string;
+    requestedBy: string;
+    requestedAt: string;
+    startedAt?: string | null;
+    completedAt?: string | null;
+    cancelledAt?: string | null;
+    expiresAt?: string | null;
+    rowCounts?: Record<string, number>;
+    byteSize?: number;
+    fileManifest?: PayclaveReconciliationFile[];
+    sha256?: string;
+    summaryByToken?: PayclaveReconciliationTokenSummary[];
+    warnings?: string[];
+    errorCategory?: string;
+    attempts: number;
+    includePII: boolean;
+    piiFields?: string[];
+    createdAt: string;
+    updatedAt: string;
+    statusUrl?: string;
+};
+type CreateReconciliationExportInput = GetReconciliationSummaryInput & {
+    mode?: "test" | "live";
+    format: "csv" | "json";
+    includePII?: boolean;
+    idempotencyKey?: string;
+    schemaVersion?: string;
+};
+type ListReconciliationExportsInput = PayclaveRequestOptions & {
+    limit?: number;
+    startingAfter?: string;
+};
+type PayclaveReconciliationExportList = {
+    items: PayclaveReconciliationExport[];
+    hasMore: boolean;
+    nextCursor?: string;
+};
+type ReconciliationExportActionInput = PayclaveRequestOptions & {
+    idempotencyKey?: string;
 };
 type PayclaveCreatedCheckoutSession = {
     id: string;
     checkoutId: string;
     object: "checkout_session";
     mode: PayclaveMode;
+    sourceType?: PayclaveSourceType;
     status: "pending";
+    collectionState: PayclaveInvoiceCollectionState;
     invoiceId: string;
     invoiceNumber: string;
     amountDue: string;
+    amountReceived: string;
+    total: string;
+    customerAmountPaid: string;
+    customerAmountRemaining: string;
     currencyCode: string;
     chainId: number;
     tokenSymbol: string;
@@ -71,9 +420,21 @@ type PayclaveCheckoutSession = {
     checkoutId: string;
     object: "checkout_session";
     mode: PayclaveMode;
+    sourceType?: PayclaveSourceType;
     status: PayclaveInvoiceStatus;
+    collectionState: PayclaveInvoiceCollectionState;
     invoiceId: string | null;
     invoiceNumber: string | null;
+    amountDue: string;
+    amountReceived: string;
+    total: string;
+    customerAmountPaid: string;
+    customerAmountRemaining: string;
+    currencyCode: string;
+    chainId: number;
+    tokenSymbol: string;
+    tokenContract: string;
+    settlementWalletAddress: string;
     externalReference: string | null;
     customerEmail: string | null;
     metadata: PayclaveMetadata;
@@ -81,25 +442,222 @@ type PayclaveCheckoutSession = {
     expiresAt: string;
     completedAt: string | null;
     createdAt: string;
+    /**
+     * Present on secret-key reads only: the merchant-absorbed platform fee and the
+     * net settlement (`amountDue` minus `platformFee`) the merchant receives.
+     */
+    platformFee?: string;
+    netAmount?: string;
+    expectedMerchantSettlement?: string;
+    merchantAmountSettled?: string;
+    overpaymentAmount?: string;
+    /** Present once a payment has been detected for the session. */
+    paymentId?: string;
+    paymentStatus?: PayclavePaymentStatus;
+    txHash?: string;
+    sourceTxHash?: string;
+    settlementTxHash?: string;
+} & PayclavePaymentSource;
+/**
+ * The network and token the customer paid with, which can differ from the
+ * settlement token (`currencyCode`/`chainId`) when the payment was routed
+ * across chains. Each field is present only when the provider reported it.
+ */
+type PayclavePaymentSource = {
+    /** Lowercase network slug, e.g. "base", "polygon", "tron", "solana". */
+    sourceNetwork?: string;
+    /** EVM chain id of the source network; absent for non-EVM networks. */
+    sourceChainId?: number;
+    /** Symbol of the token the customer paid with, e.g. "USDC". */
+    sourceTokenSymbol?: string;
+    sourceTokenAddress?: string;
+    sourceTokenLogoUrl?: string;
 };
 type PayclaveInvoice = {
     id: string;
-    invoiceNumber: string;
+    invoiceNumber: string | null;
     object: "invoice";
     mode: PayclaveMode;
     status: PayclaveInvoiceStatus;
+    collectionState: PayclaveInvoiceCollectionState;
+    subtotal: string;
+    discountTotal: string;
+    taxTotal: string;
+    total: string;
+    customerAmountPaid: string;
+    customerAmountRemaining: string;
+    expectedMerchantSettlement: string;
+    merchantAmountSettled: string;
+    overpaymentAmount: string;
+    migrationState: PayclaveMigrationState;
     amountDue: string;
     amountReceived: string;
+    platformFee: string;
+    netAmount: string;
     currencyCode: string;
     chainId: number;
     tokenContract: string;
     settlementWalletAddress: string;
     externalReference: string | null;
     metadata: PayclaveMetadata;
-    expiresAt: string;
+    expiresAt: string | null;
     paidAt: string | null;
     cancelledAt: string | null;
+    voidedAt?: string | null;
+    uncollectibleAt?: string | null;
     createdAt: string;
+    internalId?: string;
+    sourceType?: PayclaveSourceType;
+    version?: number;
+    calculationVersion?: string;
+    sellerSnapshot?: {
+        displayName: string;
+        businessEmail?: string | null;
+        address?: string | null;
+        taxIdentifier?: string | null;
+    } | null;
+    customer?: PayclaveInvoiceCustomer;
+    lines?: Array<PayclaveInvoiceLineInput & {
+        lineTotal: string;
+    }>;
+    discount?: PayclaveInvoiceDiscountInput | null;
+    taxes?: PayclaveInvoiceTaxInput[];
+    paymentTerms?: string;
+    memo?: string;
+    footer?: string;
+    purchaseOrderNumber?: string;
+    dueAt?: string | null;
+    issuedAt?: string | null;
+    publicToken?: string | null;
+    hostedInvoiceEnabled?: boolean;
+    hostedInvoiceUrl?: string | null;
+    checkoutSessions?: PayclaveInvoiceCheckoutSession[];
+    payments?: PayclaveInvoicePayment[];
+    adjustments?: PayclavePaymentAdjustment[];
+    deliveries?: PayclaveInvoiceDelivery[];
+    activity?: PayclaveInvoiceActivityEvent[];
+    reminderSchedule?: PayclaveInvoiceReminderSchedule;
+    remindersPausedAt?: string | null;
+    lastReminderAt?: string | null;
+    nextReminderAt?: string | null;
+    lastSentAt?: string | null;
+    updatedAt?: string;
+    lastActivityAt?: string | null;
+};
+type PayclaveInvoiceCheckoutSession = {
+    id: string;
+    checkoutId: string;
+    status: string;
+    sourceType?: PayclaveSourceType;
+    amountDue: string;
+    checkoutUrl: string;
+    expiresAt: string;
+    completedAt: string | null;
+    createdAt: string;
+};
+type PayclaveInvoicePayment = {
+    id: string;
+    invoiceId: string;
+    checkoutSessionId?: string;
+    transactionId: string | null;
+    sourceTransactionId: string | null;
+    settlementTransactionId: string | null;
+    mode: PayclaveMode;
+    status: PayclavePaymentStatus;
+    amountExpected: string;
+    amountReceived: string;
+    customerAmountTendered?: string;
+    customerAmountCredited?: string;
+    expectedMerchantSettlement?: string;
+    merchantAmountSettled?: string;
+    platformFeeExpected?: string;
+    platformFeeCollected?: string;
+    platformFee: string;
+    netAmount: string;
+    chainId: number;
+    settlementWalletAddress: string;
+    failureReason: string | null;
+    confirmedAt: string | null;
+    createdAt: string;
+};
+type PayclavePaymentAdjustment = {
+    id: string;
+    merchantId: string;
+    mode: PayclaveMode;
+    invoiceId: string;
+    paymentId?: string;
+    type: "refund_reference" | "write_off" | "correction" | (string & {});
+    amount: string;
+    reason: string;
+    externalTransactionHash?: string;
+    chainId?: number;
+    tokenContract?: string;
+    createdByType: string;
+    createdById: string;
+    createdAt: string;
+};
+type PayclaveInvoiceCheckoutSessionCreated = {
+    invoiceId: string;
+    invoiceNumber: string;
+    checkoutSessionId: string;
+    checkoutUrl: string;
+    amountDue: string;
+    currencyCode: string;
+    expiresAt: string;
+};
+type PayclaveRefundReferenceResult = {
+    adjustment: PayclavePaymentAdjustment;
+    invoice: PayclaveInvoice;
+};
+type PayclaveInvoiceList = {
+    items: PayclaveInvoice[];
+    hasMore: boolean;
+    nextCursor: string | null;
+};
+type PayclavePaymentLink = {
+    id: string;
+    object: "payment_link";
+    publicId: string;
+    url: string;
+    merchantId: string;
+    mode: PayclaveMode;
+    status: PayclavePaymentLinkStatus;
+    version: number;
+    title: string;
+    description: string;
+    amountType: PayclavePaymentLinkAmountType;
+    amount: string | null;
+    minimumAmount: string | null;
+    maximumAmount: string | null;
+    currencyCode: string;
+    chainId: number;
+    tokenContract: string;
+    usageType: PayclavePaymentLinkUsageType;
+    completedPayments: number;
+    startedCheckouts: number;
+    activeAt: string | null;
+    expiresAt: string | null;
+    pausedAt: string | null;
+    archivedAt: string | null;
+    collect: PayclavePaymentLinkCollect;
+    referencePrefix: string;
+    successUrl: string | null;
+    cancelUrl: string | null;
+    successMessage: string;
+    metadata: PayclaveMetadata;
+    reservationInvoiceId: string | null;
+    reservedAt: string | null;
+    createdAt: string;
+    updatedAt: string;
+    lastCheckoutCreatedAt: string | null;
+};
+type PayclavePaymentLinkList = {
+    items: PayclavePaymentLink[];
+    hasMore: boolean;
+    nextCursor: string | null;
+};
+type PayclavePaymentLinkPayments = {
+    items: PayclaveInvoice[];
 };
 type PayclavePayment = {
     id: string;
@@ -111,12 +669,24 @@ type PayclavePayment = {
     status: PayclavePaymentStatus;
     amountExpected: string;
     amountReceived: string;
+    customerAmountTendered: string;
+    customerAmountCredited: string;
+    expectedMerchantSettlement: string;
+    merchantAmountSettled: string;
+    platformFeeExpected: string;
+    platformFeeCollected: string;
+    payerWalletAddress: string;
+    payerWalletEvidence: string;
+    creditEvidenceType: string;
+    migrationState: PayclaveMigrationState;
+    platformFee: string;
+    netAmount: string;
     chainId: number;
     settlementWalletAddress: string;
     failureReason: string | null;
     confirmedAt: string | null;
     createdAt: string;
-};
+} & PayclavePaymentSource;
 type PayclaveWebhookEndpoint = {
     id: string;
     object: "webhook_endpoint";
@@ -124,19 +694,74 @@ type PayclaveWebhookEndpoint = {
     url: string;
     enabled: boolean;
     eventTypes: PayclaveWebhookEventType[];
-    signingSecret: string;
+    signingSecret?: string;
+    copyRequired?: boolean;
+    currentSecretVersion: number;
+    secretVersions: PayclaveWebhookSecretVersion[];
+    secretOverlap: {
+        status: "none" | "active" | (string & {});
+        expiresAt: string | null;
+        previousVersion: number | null;
+    };
     createdAt: string;
+    updatedAt: string;
+};
+type PayclaveWebhookSecretVersion = {
+    version: number;
+    createdAt: string;
+    activatesAt: string;
+    expiresAt: string | null;
+    revokedAt: string | null;
+    testedAt: string | null;
+};
+type PayclaveWebhookIncident = {
+    id: string;
+    object: "webhook_incident";
+    endpointId: string;
+    mode: PayclaveMode;
+    status: "open" | "resolved" | (string & {});
+    reasonFamily: string;
+    failureCount: number;
+    affectedDeliveryCount: number;
+    affectedDeliveryIds: string[];
+    firstFailedAt: string;
+    lastFailedAt: string;
+    openedAt: string;
+    resolvedAt: string | null;
+    lastDeliveryId: string;
+    lastAttemptId: string;
+    createdAt: string;
+    updatedAt: string;
 };
 type PayclaveWebhookDeliveryAttemptSummary = {
     responseStatusCode: number | null;
     errorMessage: string | null;
+    errorCategory?: string | null;
+    attemptedAt: string;
+};
+type PayclaveWebhookDeliveryAttempt = {
+    id: string;
+    attemptNumber: number;
+    responseStatusCode: number | null;
+    responseBody: string | null;
+    responseBodyTruncated: boolean;
+    errorMessage: string | null;
+    errorCategory?: string | null;
+    responseHeaders?: Record<string, string> | null;
+    requestHeaders?: Record<string, string> | null;
+    destinationHost?: string;
+    sanitizedAt?: string;
     attemptedAt: string;
+    startedAt: string;
+    completedAt: string;
+    durationMs: number;
 };
 type PayclaveWebhookDelivery = {
     id: string;
     object: "webhook_delivery";
     endpointId: string;
     invoiceId: string | null;
+    eventId: string;
     eventType: PayclaveWebhookEventType | (string & {});
     status: PayclaveWebhookDeliveryStatus;
     idempotencyKey: string;
@@ -145,6 +770,12 @@ type PayclaveWebhookDelivery = {
     deliveredAt: string | null;
     attemptCount: number;
     latestAttempt: PayclaveWebhookDeliveryAttemptSummary | null;
+    latestErrorCategory?: string | null;
+    replayOfDeliveryId: string | null;
+    replayRootDeliveryId: string | null;
+    replayedBy: string | null;
+    replayedAt: string | null;
+    attempts?: PayclaveWebhookDeliveryAttempt[];
     createdAt: string;
 };
 type PayclaveWebhookData = Record<string, unknown>;
@@ -156,7 +787,7 @@ type PayclaveWebhookEvent<TData = PayclaveWebhookData> = {
     createdAt: string;
     data: TData;
 };
-declare const PAYCLAVE_API_ERROR_CODES: readonly ["API_KEY_FORBIDDEN", "API_KEY_REQUIRED", "AUTH_FORBIDDEN", "AUTH_REQUIRED", "DEFAULT_WALLET_REQUIRED", "INTERNAL_JOB_UNAUTHORIZED", "INTERNAL_SERVER_ERROR", "INVALID_AMOUNT", "INVALID_API_KEY", "INVALID_EXPIRY", "INVALID_IDEMPOTENCY_KEY", "INVALID_DEPOSIT_NETWORK", "INVALID_WALLET_PAYMENT_ATTEMPT", "INVALID_TX_HASH", "INVALID_WALLET_ADDRESS", "NOT_FOUND", "RATE_LIMIT_EXCEEDED", "REQUEST_ERROR", "SCAN_OR_COPY_UNAVAILABLE", "WALLET_PAYMENTS_UNAVAILABLE", "UNSUPPORTED_DEFAULT_WALLET", "VALIDATION_ERROR", "WEBHOOK_DELIVERY_NOT_FOUND", "WEBHOOK_ENDPOINT_NOT_FOUND", "WEBHOOK_EVENT_UNSUPPORTED", "WEBHOOK_SIGNATURE_INVALID", "CHECKOUT_SESSION_NOT_PAYABLE", "INVOICE_NOT_FOUND", "INVOICE_STATE_MISMATCH", "INVOICE_TRANSITION_GUARD_FAILED", "IDEMPOTENCY_KEY_CONFLICT"];
+declare const PAYCLAVE_API_ERROR_CODES: readonly ["ACCOUNT_SUSPENDED", "ACTIVE_MERCHANT_REQUIRED", "API_KEY_FORBIDDEN", "API_KEY_REQUIRED", "AUTH_FORBIDDEN", "GOOGLE_ACCOUNT_CONFLICT", "GOOGLE_AUTH_CANCELLED", "GOOGLE_AUTH_CODE_MISSING", "GOOGLE_EMAIL_UNVERIFIED", "GOOGLE_AUTH_EXCHANGE_FAILED", "GOOGLE_AUTH_FAILED", "GOOGLE_PROFILE_UNAVAILABLE", "GOOGLE_AUTH_STATE_INVALID", "AUTH_PASSWORD_ALREADY_SET", "AUTH_PROXY_UNAUTHORIZED", "AUTH_PROVIDER_UNAVAILABLE", "AUTH_REQUIRED", "USE_SOCIAL_LOGIN", "AUTH_VERIFIED_EMAIL_REQUIRED", "DEFAULT_WALLET_REQUIRED", "INTERNAL_JOB_UNAUTHORIZED", "INTERNAL_SERVER_ERROR", "INVALID_AMOUNT", "INVALID_API_KEY", "INVALID_CREDENTIALS", "INVALID_EXPIRY", "INVALID_IDEMPOTENCY_KEY", "INVALID_DEPOSIT_NETWORK", "INVALID_WALLET_PAYMENT_ATTEMPT", "INVALID_TX_HASH", "INVALID_WALLET_ADDRESS", "MODE_MISMATCH", "MEMBERSHIP_REVOKED", "MEMBER_ALREADY_EXISTS", "MEMBER_LIMIT_REACHED", "LAST_OWNER_REQUIRED", "INVITATION_ALREADY_PENDING", "INVITATION_ALREADY_USED", "INVITATION_EMAIL_MISMATCH", "INVITATION_EXPIRED", "INVITATION_NOT_FOUND", "OWNERSHIP_TRANSFER_REQUIRED", "NOT_FOUND", "PUBLIC_KEY_FIELD_NOT_ALLOWED", "PERMISSION_DENIED", "RATE_LIMIT_EXCEEDED", "REAUTH_REQUIRED", "STEP_UP_REQUIRED", "REQUEST_ERROR", "REQUEST_TOO_LARGE", "SCAN_OR_COPY_UNAVAILABLE", "WALLET_PAYMENTS_UNAVAILABLE", "UNSUPPORTED_DEFAULT_WALLET", "VALIDATION_ERROR", "WEBHOOK_DELIVERY_NOT_FOUND", "WEBHOOK_ENDPOINT_DISABLED", "WEBHOOK_ENDPOINT_NOT_FOUND", "WEBHOOK_EVENT_UNSUPPORTED", "WEBHOOK_INCIDENT_NOT_FOUND", "WEBHOOK_SIGNATURE_INVALID", "SECRET_OVERLAP_ACTIVE", "SECRET_OVERLAP_EXPIRED", "CHECKOUT_SESSION_NOT_PAYABLE", "EVENT_TYPE_UNSUPPORTED", "EVENT_PAYLOAD_TOO_LARGE", "JOURNEY_TOKEN_INVALID", "EVENT_DUPLICATE", "TIMESTAMP_OUT_OF_RANGE", "INVOICE_NOT_FOUND", "INVOICE_STATE_MISMATCH", "INVOICE_TRANSITION_GUARD_FAILED", "INVOICE_NOT_EDITABLE", "INVOICE_ALREADY_ISSUED", "INVOICE_NOT_PAYABLE", "INVOICE_PDF_UNAVAILABLE", "INVOICE_VERSION_CONFLICT", "CURRENCY_MISMATCH", "INVALID_TOTAL", "CUSTOMER_EMAIL_REQUIRED", "IDEMPOTENCY_KEY_CONFLICT", "PAYMENT_LINK_NOT_FOUND", "PAYMENT_LINK_VERSION_CONFLICT", "LINK_INACTIVE", "LINK_EXPIRED", "LINK_ALREADY_USED", "LINK_RESERVED", "AMOUNT_OUT_OF_RANGE", "FIELD_REQUIRED", "FEATURE_UNAVAILABLE", "MODE_UNAVAILABLE", "CONFIG_CHANGED", "RATE_LIMITED", "EXPORT_RANGE_TOO_LARGE", "EXPORT_NOT_READY", "EXPORT_EXPIRED", "EXPORT_CANCELLED", "EXPORT_SCHEMA_UNSUPPORTED", "EXPORT_TOO_LARGE_FOR_SYNC"];
 type PayclaveApiErrorCode = (typeof PAYCLAVE_API_ERROR_CODES)[number];
 declare const PAYCLAVE_SERVER_SDK_ERROR_CODES: readonly ["INVALID_SECRET_KEY", "INVALID_API_BASE_URL", "INVALID_TIMEOUT", "INVALID_ID", "INVALID_AMOUNT", "INVALID_EXPIRY", "INVALID_METADATA", "INVALID_IDEMPOTENCY_KEY", "INVALID_LIMIT", "INVALID_WEBHOOK_URL", "INVALID_REQUEST_BODY", "INVALID_RESPONSE", "NETWORK_ERROR", "TIMEOUT", "ABORTED"];
 type PayclaveServerSdkErrorCode = (typeof PAYCLAVE_SERVER_SDK_ERROR_CODES)[number];
@@ -193,7 +824,7 @@ declare class PayclaveError extends Error {
     };
 }
 declare const PAYCLAVE_SERVER_SDK_NAME = "payclave-sdk-server";
-declare const PAYCLAVE_SERVER_SDK_VERSION = "0.1.0";
+declare const PAYCLAVE_SERVER_SDK_VERSION = "0.2.0";
 declare function assertPayclaveWebhookSignature({ payload, signature, secret, toleranceSeconds, now, }: VerifyWebhookSignatureInput): void;
 declare function verifyPayclaveWebhookSignature(input: VerifyWebhookSignatureInput): boolean;
 declare function constructPayclaveWebhookEvent<TData extends PayclaveWebhookData = PayclaveWebhookData>(input: VerifyWebhookSignatureInput): PayclaveWebhookEvent<TData>;
@@ -201,12 +832,57 @@ declare function createPayclaveServerClient({ secretKey, apiBaseUrl, fetcher, ti
     createCheckoutSession: (input: CreateCheckoutSessionInput) => Promise<PayclaveCreatedCheckoutSession>;
     getCheckoutSession: (id: string, options?: PayclaveRequestOptions) => Promise<PayclaveCheckoutSession>;
     createInvoice: (input: CreateInvoiceInput) => Promise<PayclaveInvoice>;
+    createInvoiceDraft: (input: CreateInvoiceDraftInput) => Promise<PayclaveInvoice>;
+    listInvoices: (input?: ListInvoicesInput) => Promise<PayclaveInvoiceList>;
     getInvoice: (id: string, options?: PayclaveRequestOptions) => Promise<PayclaveInvoice>;
+    downloadInvoicePDF: (id: string, options?: PayclaveRequestOptions) => Promise<PayclaveInvoicePDF>;
+    updateInvoiceDraft: (id: string, input: UpdateInvoiceDraftInput) => Promise<PayclaveInvoice>;
+    issueInvoice: (id: string, input: IssueInvoiceInput) => Promise<PayclaveInvoice>;
+    sendInvoice: (id: string, input?: CreateInvoiceCheckoutSessionInput) => Promise<PayclaveInvoice>;
+    remindInvoice: (id: string, input?: CreateInvoiceCheckoutSessionInput) => Promise<PayclaveInvoice>;
+    createInvoiceCheckoutSession: (id: string, input?: CreateInvoiceCheckoutSessionInput) => Promise<PayclaveInvoiceCheckoutSessionCreated>;
+    voidInvoice: (id: string, input?: InvoiceActionInput) => Promise<PayclaveInvoice>;
+    voidInvoiceRemaining: (id: string, input?: InvoiceActionInput) => Promise<PayclaveInvoice>;
+    markInvoiceUncollectible: (id: string, input?: InvoiceActionInput) => Promise<PayclaveInvoice>;
+    duplicateInvoice: (id: string, input?: CreateInvoiceCheckoutSessionInput) => Promise<PayclaveInvoice>;
+    recordInvoiceRefundReference: (id: string, input: RecordInvoiceRefundReferenceInput) => Promise<PayclaveRefundReferenceResult>;
+    createPaymentLink: (input: CreatePaymentLinkInput) => Promise<PayclavePaymentLink>;
+    listPaymentLinks: (input?: ListPaymentLinksInput) => Promise<PayclavePaymentLinkList>;
+    getPaymentLink: (id: string, options?: PayclaveRequestOptions) => Promise<PayclavePaymentLink>;
+    updatePaymentLink: (id: string, input: UpdatePaymentLinkInput) => Promise<PayclavePaymentLink>;
+    pausePaymentLink: (id: string, input?: PaymentLinkActionInput) => Promise<PayclavePaymentLink>;
+    resumePaymentLink: (id: string, input?: PaymentLinkActionInput) => Promise<PayclavePaymentLink>;
+    archivePaymentLink: (id: string, input?: PaymentLinkActionInput) => Promise<PayclavePaymentLink>;
+    duplicatePaymentLink: (id: string, input?: PaymentLinkActionInput) => Promise<PayclavePaymentLink>;
+    releasePaymentLinkReservation: (id: string, input: ReleasePaymentLinkReservationInput) => Promise<PayclavePaymentLink>;
+    listPaymentLinkPayments: (id: string, input?: ListPaymentLinkPaymentsInput) => Promise<PayclavePaymentLinkPayments>;
     getPayment: (id: string, options?: PayclaveRequestOptions) => Promise<PayclavePayment>;
     createWebhookEndpoint: (input: CreateWebhookEndpointInput) => Promise<PayclaveWebhookEndpoint>;
+    listWebhookEndpoints: (options?: PayclaveRequestOptions) => Promise<PayclaveWebhookEndpoint[]>;
+    getWebhookEndpoint: (id: string, options?: PayclaveRequestOptions) => Promise<PayclaveWebhookEndpoint>;
+    updateWebhookEndpoint: (id: string, input: UpdateWebhookEndpointInput) => Promise<PayclaveWebhookEndpoint>;
+    archiveWebhookEndpoint: (id: string, input: WebhookEndpointActionInput) => Promise<{
+        id: string;
+        object: "webhook_endpoint";
+        archived: true;
+    }>;
+    rotateWebhookSecret: (id: string, input: WebhookEndpointActionInput) => Promise<PayclaveWebhookEndpoint>;
+    endWebhookSecretOverlap: (id: string, input: WebhookEndpointActionInput) => Promise<PayclaveWebhookEndpoint>;
     createTestWebhook: (input: CreateTestWebhookInput) => Promise<PayclaveWebhookDelivery>;
     listWebhookDeliveries: (input?: ListWebhookDeliveriesInput) => Promise<PayclaveWebhookDelivery[]>;
+    getWebhookDelivery: (id: string, options?: PayclaveRequestOptions) => Promise<PayclaveWebhookDelivery>;
+    listWebhookDeliveryAttempts: (id: string, options?: PayclaveRequestOptions) => Promise<PayclaveWebhookDeliveryAttempt[]>;
+    replayWebhookDelivery: (id: string, input: ReplayWebhookDeliveryInput) => Promise<PayclaveWebhookDelivery>;
+    listWebhookIncidents: (input?: ListWebhookIncidentsInput) => Promise<PayclaveWebhookIncident[]>;
+    getWebhookIncident: (id: string, options?: PayclaveRequestOptions) => Promise<PayclaveWebhookIncident>;
+    getReconciliationSchema: (version?: string, options?: PayclaveRequestOptions) => Promise<PayclaveReconciliationSchema>;
+    getReconciliationSummary: (input: GetReconciliationSummaryInput) => Promise<PayclaveReconciliationSummary>;
+    createReconciliationExport: (input: CreateReconciliationExportInput) => Promise<PayclaveReconciliationExport>;
+    listReconciliationExports: (input?: ListReconciliationExportsInput) => Promise<PayclaveReconciliationExportList>;
+    getReconciliationExport: (id: string, options?: PayclaveRequestOptions) => Promise<PayclaveReconciliationExport>;
+    cancelReconciliationExport: (id: string, input?: ReconciliationExportActionInput) => Promise<PayclaveReconciliationExport>;
+    downloadReconciliationExport: (id: string, options?: PayclaveRequestOptions) => Promise<PayclaveReconciliationDownload>;
 };
 type PayclaveServerClient = ReturnType<typeof createPayclaveServerClient>;
 
-export { type CreateCheckoutSessionInput, type CreateInvoiceInput, type CreateTestWebhookInput, type CreateWebhookEndpointInput, type ListWebhookDeliveriesInput, PAYCLAVE_API_ERROR_CODES, PAYCLAVE_SERVER_SDK_ERROR_CODES, PAYCLAVE_SERVER_SDK_NAME, PAYCLAVE_SERVER_SDK_VERSION, PAYCLAVE_WEBHOOK_EVENT_TYPES, PAYCLAVE_WEBHOOK_VERIFICATION_ERROR_CODES, type PayclaveApiErrorCode, type PayclaveCheckoutSession, type PayclaveCreatedCheckoutSession, PayclaveError, type PayclaveErrorCode, type PayclaveFetcher, type PayclaveInvoice, type PayclaveInvoiceStatus, type PayclaveMetadata, type PayclaveMode, type PayclavePayment, type PayclavePaymentStatus, type PayclaveRequestOptions, type PayclaveServerClient, type PayclaveServerClientOptions, type PayclaveServerSdkErrorCode, type PayclaveWebhookData, type PayclaveWebhookDelivery, type PayclaveWebhookDeliveryAttemptSummary, type PayclaveWebhookDeliveryStatus, type PayclaveWebhookEndpoint, type PayclaveWebhookEvent, type PayclaveWebhookEventType, type PayclaveWebhookVerificationErrorCode, type VerifyWebhookSignatureInput, assertPayclaveWebhookSignature, constructPayclaveWebhookEvent, createPayclaveServerClient, verifyPayclaveWebhookSignature };
+export { type CreateCheckoutSessionInput, type CreateInvoiceCheckoutSessionInput, type CreateInvoiceDraftInput, type CreateInvoiceInput, type CreatePaymentLinkInput, type CreateReconciliationExportInput, type CreateTestWebhookInput, type CreateWebhookEndpointInput, type GetReconciliationSummaryInput, type InvoiceActionInput, type IssueInvoiceInput, type ListInvoicesInput, type ListPaymentLinkPaymentsInput, type ListPaymentLinksInput, type ListReconciliationExportsInput, type ListWebhookDeliveriesInput, type ListWebhookIncidentsInput, PAYCLAVE_API_ERROR_CODES, PAYCLAVE_RECONCILIATION_SCHEMA_VERSION, PAYCLAVE_SERVER_SDK_ERROR_CODES, PAYCLAVE_SERVER_SDK_NAME, PAYCLAVE_SERVER_SDK_VERSION, PAYCLAVE_WEBHOOK_EVENT_TYPES, PAYCLAVE_WEBHOOK_VERIFICATION_ERROR_CODES, type PayclaveApiErrorCode, type PayclaveCheckoutSession, type PayclaveCreatedCheckoutSession, PayclaveError, type PayclaveErrorCode, type PayclaveFetcher, type PayclaveInvoice, type PayclaveInvoiceActivityEvent, type PayclaveInvoiceCheckoutSession, type PayclaveInvoiceCheckoutSessionCreated, type PayclaveInvoiceCollectionState, type PayclaveInvoiceCustomer, type PayclaveInvoiceDelivery, type PayclaveInvoiceDiscountInput, type PayclaveInvoiceDraftFields, type PayclaveInvoiceLineInput, type PayclaveInvoiceList, type PayclaveInvoicePDF, type PayclaveInvoicePayment, type PayclaveInvoiceReminderSchedule, type PayclaveInvoiceStatus, type PayclaveInvoiceTaxInput, type PayclaveMetadata, type PayclaveMigrationState, type PayclaveMode, type PayclavePayment, type PayclavePaymentAdjustment, type PayclavePaymentLink, type PayclavePaymentLinkAmountType, type PayclavePaymentLinkCollect, type PayclavePaymentLinkFields, type PayclavePaymentLinkList, type PayclavePaymentLinkPayments, type PayclavePaymentLinkStatus, type PayclavePaymentLinkUsageType, type PayclavePaymentSource, type PayclavePaymentStatus, type PayclaveReconciliationDateBasis, type PayclaveReconciliationDownload, type PayclaveReconciliationExport, type PayclaveReconciliationExportList, type PayclaveReconciliationExportStatus, type PayclaveReconciliationFile, type PayclaveReconciliationFilters, type PayclaveReconciliationSchema, type PayclaveReconciliationSummary, type PayclaveReconciliationTokenSummary, type PayclaveRefundReferenceResult, type PayclaveRequestOptions, type PayclaveServerClient, type PayclaveServerClientOptions, type PayclaveServerSdkErrorCode, type PayclaveSourceType, type PayclaveWebhookData, type PayclaveWebhookDelivery, type PayclaveWebhookDeliveryAttempt, type PayclaveWebhookDeliveryAttemptSummary, type PayclaveWebhookDeliveryStatus, type PayclaveWebhookEndpoint, type PayclaveWebhookEvent, type PayclaveWebhookEventType, type PayclaveWebhookIncident, type PayclaveWebhookSecretVersion, type PayclaveWebhookVerificationErrorCode, type PaymentLinkActionInput, type ReconciliationExportActionInput, type RecordInvoiceRefundReferenceInput, type ReleasePaymentLinkReservationInput, type ReplayWebhookDeliveryInput, type UpdateInvoiceDraftInput, type UpdatePaymentLinkInput, type UpdateWebhookEndpointInput, type VerifyWebhookSignatureInput, type WebhookEndpointActionInput, assertPayclaveWebhookSignature, constructPayclaveWebhookEvent, createPayclaveServerClient, verifyPayclaveWebhookSignature };