@payclave/sdk-server 0.1.1 → 0.3.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.refund_verified", "invoice.refund_failed", "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,191 @@ 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;
+    /** Omit in test mode; Payclave simulates one. */
+    externalTransactionHash?: string;
+    chainId: number;
+    tokenContract: string;
+    /** Where the refund was sent. Optional when the payment has a verified paying wallet. */
+    destinationAddress?: string;
+    /** Required when destinationAddress is not the verified paying wallet. */
+    destinationReason?: string;
+    idempotencyKey?: string;
+};
+type CheckInvoiceRefundInput = PayclaveRequestOptions & {
+    paymentId: string;
+    amount: string;
+    destinationAddress: string;
+};
+type PayclaveRefundRiskCode = "different_destination" | "repeat_destination" | "overpayment" | "sent_from_other_wallet" | (string & {});
+type PayclaveRefundDecision = {
+    allowed: boolean;
+    blockedReason?: string;
+    requiresApproval: boolean;
+    destinationSource?: "verified_payer" | "provided" | (string & {});
+    refundableAmount: string;
+    overpaidAmount: string;
+    warnings: Array<{
+        code: PayclaveRefundRiskCode;
+        message: 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,17 +246,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;
@@ -72,11 +443,16 @@ 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;
@@ -95,19 +471,48 @@ type PayclaveCheckoutSession = {
      */
     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;
@@ -118,10 +523,176 @@ type PayclaveInvoice = {
     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;
+    /** Refund references only: whether Payclave verified the transfer onchain. */
+    verificationStatus?: "unverified" | "pending" | "verified" | "failed" | (string & {});
+    destinationAddress?: string;
+    destinationSource?: "verified_payer" | "provided" | (string & {});
+    destinationReason?: string;
+    riskFlags?: PayclaveRefundRiskCode[];
+    /** Where a verified refund actually came from. */
+    senderAddress?: string;
+    verifiedAt?: string;
+    verificationFailureReason?: string;
+    /** A failed refund's hash, released so the transfer can be recorded again. */
+    failedTransactionHash?: 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;
@@ -133,6 +704,16 @@ 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;
@@ -140,7 +721,7 @@ type PayclavePayment = {
     failureReason: string | null;
     confirmedAt: string | null;
     createdAt: string;
-};
+} & PayclavePaymentSource;
 type PayclaveWebhookEndpoint = {
     id: string;
     object: "webhook_endpoint";
@@ -148,19 +729,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;
@@ -169,6 +805,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>;
@@ -180,7 +822,7 @@ type PayclaveWebhookEvent<TData = PayclaveWebhookData> = {
     createdAt: string;
     data: TData;
 };
-declare const PAYCLAVE_API_ERROR_CODES: readonly ["ACCOUNT_SUSPENDED", "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_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", "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];
@@ -217,7 +859,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.3.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>;
@@ -225,12 +867,59 @@ 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>;
+    checkInvoiceRefund: (id: string, input: CheckInvoiceRefundInput) => Promise<PayclaveRefundDecision>;
+    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 { 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, PayclaveError, assertPayclaveWebhookSignature, constructPayclaveWebhookEvent, createPayclaveServerClient, verifyPayclaveWebhookSignature };
+export type { CheckInvoiceRefundInput, CreateCheckoutSessionInput, CreateInvoiceCheckoutSessionInput, CreateInvoiceDraftInput, CreateInvoiceInput, CreatePaymentLinkInput, CreateReconciliationExportInput, CreateTestWebhookInput, CreateWebhookEndpointInput, GetReconciliationSummaryInput, InvoiceActionInput, IssueInvoiceInput, ListInvoicesInput, ListPaymentLinkPaymentsInput, ListPaymentLinksInput, ListReconciliationExportsInput, ListWebhookDeliveriesInput, ListWebhookIncidentsInput, PayclaveApiErrorCode, PayclaveCheckoutSession, PayclaveCreatedCheckoutSession, PayclaveErrorCode, PayclaveFetcher, PayclaveInvoice, PayclaveInvoiceActivityEvent, PayclaveInvoiceCheckoutSession, PayclaveInvoiceCheckoutSessionCreated, PayclaveInvoiceCollectionState, PayclaveInvoiceCustomer, PayclaveInvoiceDelivery, PayclaveInvoiceDiscountInput, PayclaveInvoiceDraftFields, PayclaveInvoiceLineInput, PayclaveInvoiceList, PayclaveInvoicePDF, PayclaveInvoicePayment, PayclaveInvoiceReminderSchedule, PayclaveInvoiceStatus, PayclaveInvoiceTaxInput, PayclaveMetadata, PayclaveMigrationState, PayclaveMode, PayclavePayment, PayclavePaymentAdjustment, PayclavePaymentLink, PayclavePaymentLinkAmountType, PayclavePaymentLinkCollect, PayclavePaymentLinkFields, PayclavePaymentLinkList, PayclavePaymentLinkPayments, PayclavePaymentLinkStatus, PayclavePaymentLinkUsageType, PayclavePaymentSource, PayclavePaymentStatus, PayclaveReconciliationDateBasis, PayclaveReconciliationDownload, PayclaveReconciliationExport, PayclaveReconciliationExportList, PayclaveReconciliationExportStatus, PayclaveReconciliationFile, PayclaveReconciliationFilters, PayclaveReconciliationSchema, PayclaveReconciliationSummary, PayclaveReconciliationTokenSummary, PayclaveRefundDecision, PayclaveRefundReferenceResult, PayclaveRefundRiskCode, PayclaveRequestOptions, PayclaveServerClient, PayclaveServerClientOptions, PayclaveServerSdkErrorCode, PayclaveSourceType, PayclaveWebhookData, PayclaveWebhookDelivery, PayclaveWebhookDeliveryAttempt, PayclaveWebhookDeliveryAttemptSummary, PayclaveWebhookDeliveryStatus, PayclaveWebhookEndpoint, PayclaveWebhookEvent, PayclaveWebhookEventType, PayclaveWebhookIncident, PayclaveWebhookSecretVersion, PayclaveWebhookVerificationErrorCode, PaymentLinkActionInput, ReconciliationExportActionInput, RecordInvoiceRefundReferenceInput, ReleasePaymentLinkReservationInput, ReplayWebhookDeliveryInput, UpdateInvoiceDraftInput, UpdatePaymentLinkInput, UpdateWebhookEndpointInput, VerifyWebhookSignatureInput, WebhookEndpointActionInput };