@voyant-travel/finance 0.190.0 → 0.191.0

package/dist/card-payment.d.ts

@@ -41,6 +41,7 @@ export interface CardPaymentStartArgs {
     billing: CardPaymentBilling;
     description?: string;
     returnUrl?: string;
+    metadata?: Record<string, unknown>;
 }
 /** Result of a card-payment start: the hosted-payment URL to redirect to. */
 export interface CardPaymentStartResult {
@@ -68,4 +69,16 @@ export interface PaymentAdapterCardPaymentStarterOptions {
      */
     resolveNotifyUrl?(c: Context): string | undefined;
 }
+export interface PaymentAdapterCardPaymentExecution {
+    context: PaymentAdapterRuntimeContext;
+    runtime?: FinanceServiceRuntime;
+    notifyUrl?: string;
+    idempotencyKey?: string;
+}
+/**
+ * Start a payment through a selected adapter without requiring an HTTP
+ * framework context. Package runtimes use this function; the Hono-oriented
+ * starter below remains the checkout-surface convenience wrapper.
+ */
+export declare function startPaymentAdapterCardPayment(adapter: PaymentAdapter, args: CardPaymentStartArgs, execution: PaymentAdapterCardPaymentExecution): Promise<CardPaymentStartResult | null>;
 export declare function createPaymentAdapterCardPaymentStarter(adapter: PaymentAdapter, options?: PaymentAdapterCardPaymentStarterOptions): CardPaymentStarter;

package/dist/card-payment.js

@@ -2,58 +2,75 @@ import { eq } from "drizzle-orm";
 import { paymentSessions } from "./schema/payment-sessions.js";
 import { financePaymentSessionCompletionService } from "./service-payment-session-completion.js";
 import { financePaymentSessionService } from "./service-payment-sessions.js";
+/**
+ * Start a payment through a selected adapter without requiring an HTTP
+ * framework context. Package runtimes use this function; the Hono-oriented
+ * starter below remains the checkout-surface convenience wrapper.
+ */
+export async function startPaymentAdapterCardPayment(adapter, args, execution) {
+    const [session] = await args.db
+        .select()
+        .from(paymentSessions)
+        .where(eq(paymentSessions.id, args.sessionId))
+        .limit(1);
+    if (!session)
+        return null;
+    const idempotencyKey = session.idempotencyKey ?? execution.idempotencyKey ?? `payment:${session.id}`;
+    const metadata = {
+        ...(args.metadata ?? {}),
+        billing: args.billing,
+        ...(execution.notifyUrl ? { notifyUrl: execution.notifyUrl } : {}),
+    };
+    const result = await adapter.initiate(execution.context, {
+        paymentSessionId: session.id,
+        money: { amountMinor: session.amountCents, currency: session.currency },
+        description: args.description ?? session.notes ?? undefined,
+        returnUrl: args.returnUrl ?? session.returnUrl ?? undefined,
+        idempotencyKey,
+        customer: {
+            email: args.billing.email,
+            phone: args.billing.phone ?? null,
+            firstName: args.billing.firstName,
+            lastName: args.billing.lastName ?? null,
+        },
+        metadata,
+    });
+    const providerData = {
+        providerSessionId: result.processorSessionId ?? undefined,
+        providerPaymentId: result.processorPaymentId ?? undefined,
+        providerPayload: result.raw === undefined ? undefined : { initiation: result.raw },
+        metadata: { paymentAdapterInitiationIdempotencyKey: result.idempotencyKey },
+    };
+    if (result.nextState === "paid" || result.nextState === "authorized") {
+        await financePaymentSessionService.updatePaymentSession(args.db, session.id, {
+            provider: adapter.id,
+            redirectUrl: result.checkout?.url ?? undefined,
+            idempotencyKey,
+        });
+        await financePaymentSessionCompletionService.completePaymentSession(args.db, session.id, {
+            status: result.nextState,
+            captureMode: "automatic",
+            ...providerData,
+        }, execution.runtime);
+    }
+    else {
+        await financePaymentSessionService.updatePaymentSession(args.db, session.id, {
+            provider: adapter.id,
+            status: result.nextState,
+            redirectUrl: result.checkout?.url ?? undefined,
+            idempotencyKey,
+            ...providerData,
+        });
+    }
+    return { redirectUrl: result.checkout?.url ?? null };
+}
 export function createPaymentAdapterCardPaymentStarter(adapter, options = {}) {
     return async (c, args) => {
-        const [session] = await args.db
-            .select()
-            .from(paymentSessions)
-            .where(eq(paymentSessions.id, args.sessionId))
-            .limit(1);
-        if (!session)
-            return null;
-        const idempotencyKey = session.idempotencyKey ?? options.idempotencyKey?.(session.id) ?? `payment:${session.id}`;
-        const notifyUrl = options.resolveNotifyUrl?.(c);
-        const result = await adapter.initiate(options.resolveContext?.(c) ?? { env: c.env }, {
-            paymentSessionId: session.id,
-            money: { amountMinor: session.amountCents, currency: session.currency },
-            description: args.description ?? session.notes ?? undefined,
-            returnUrl: args.returnUrl ?? session.returnUrl ?? undefined,
-            idempotencyKey,
-            customer: {
-                email: args.billing.email,
-                phone: args.billing.phone ?? null,
-                firstName: args.billing.firstName,
-                lastName: args.billing.lastName ?? null,
-            },
-            ...(notifyUrl ? { metadata: { notifyUrl } } : {}),
+        return startPaymentAdapterCardPayment(adapter, args, {
+            context: options.resolveContext?.(c) ?? { env: c.env },
+            runtime: options.resolveRuntime?.(c),
+            notifyUrl: options.resolveNotifyUrl?.(c),
+            idempotencyKey: options.idempotencyKey?.(args.sessionId),
         });
-        const providerData = {
-            providerSessionId: result.processorSessionId ?? undefined,
-            providerPaymentId: result.processorPaymentId ?? undefined,
-            providerPayload: result.raw === undefined ? undefined : { initiation: result.raw },
-            metadata: { paymentAdapterInitiationIdempotencyKey: result.idempotencyKey },
-        };
-        if (result.nextState === "paid" || result.nextState === "authorized") {
-            await financePaymentSessionService.updatePaymentSession(args.db, session.id, {
-                provider: adapter.id,
-                redirectUrl: result.checkout?.url ?? undefined,
-                idempotencyKey,
-            });
-            await financePaymentSessionCompletionService.completePaymentSession(args.db, session.id, {
-                status: result.nextState,
-                captureMode: "automatic",
-                ...providerData,
-            }, options.resolveRuntime?.(c));
-        }
-        else {
-            await financePaymentSessionService.updatePaymentSession(args.db, session.id, {
-                provider: adapter.id,
-                status: result.nextState,
-                redirectUrl: result.checkout?.url ?? undefined,
-                idempotencyKey,
-                ...providerData,
-            });
-        }
-        return { redirectUrl: result.checkout?.url ?? null };
     };
 }

package/dist/checkout-routes.d.ts

@@ -15,6 +15,7 @@ export type CheckoutRoutesOptions = {
     notificationDispatcher?: CheckoutNotificationDispatcher | null;
     resolveNotificationDispatcher?: (bindings: Record<string, unknown>) => CheckoutNotificationDispatcher | null;
     paymentStarters?: Record<string, CheckoutPaymentStarter>;
+    resolveSelectedPaymentStarter?: (bindings: Record<string, unknown>) => CheckoutPaymentStarter | null;
     resolvePaymentStarters?: (bindings: Record<string, unknown>) => Record<string, CheckoutPaymentStarter>;
     bankTransferDetails?: CheckoutBankTransferDetails | null;
     resolveBankTransferDetails?: (bindings: Record<string, unknown>) => CheckoutBankTransferDetails | null;
@@ -31,6 +32,7 @@ export interface CheckoutReminderRunList {
 export type CheckoutRouteRuntime = {
     bindings: Record<string, unknown>;
     notificationDispatcher: CheckoutNotificationDispatcher | null;
+    selectedPaymentStarter: CheckoutPaymentStarter | null;
     paymentStarters: Record<string, CheckoutPaymentStarter>;
     bankTransferDetails: CheckoutBankTransferDetails | null;
     publicCheckoutBaseUrl?: string | null;

package/dist/checkout-routes.js

@@ -121,7 +121,9 @@ function resolveCheckoutRouteRuntime(bindings, options, container) {
     return buildCheckoutRouteRuntime(bindings, options);
 }
 function assertCheckoutRuntimeSupportsCollection(runtime, input) {
-    if (input.method === "card" && Object.keys(runtime.paymentStarters).length === 0) {
+    if (input.method === "card" &&
+        !runtime.selectedPaymentStarter &&
+        Object.keys(runtime.paymentStarters).length === 0) {
         throw new CheckoutRouteRuntimeNotConfiguredError();
     }
 }
@@ -129,6 +131,7 @@ export function buildCheckoutRouteRuntime(bindings, options = {}) {
     return {
         bindings,
         notificationDispatcher: options.resolveNotificationDispatcher?.(bindings) ?? options.notificationDispatcher ?? null,
+        selectedPaymentStarter: options.resolveSelectedPaymentStarter?.(bindings) ?? null,
         paymentStarters: options.resolvePaymentStarters?.(bindings) ?? options.paymentStarters ?? {},
         bankTransferDetails: options.resolveBankTransferDetails?.(bindings) ?? options.bankTransferDetails ?? null,
         publicCheckoutBaseUrl: options.resolvePublicCheckoutBaseUrl?.(bindings) ?? options.publicCheckoutBaseUrl ?? null,

package/dist/checkout-service-plan.d.ts

@@ -105,6 +105,8 @@ export interface CheckoutRuntimeOptions {
     bindings?: Record<string, unknown>;
     bankTransferDetails?: CheckoutBankTransferDetails | null;
     notificationDispatcher?: CheckoutNotificationDispatcher | null;
+    /** Deployment-selected PaymentAdapter bridge. Takes precedence over legacy keyed starters. */
+    selectedPaymentStarter?: CheckoutPaymentStarter | null;
     paymentStarters?: Record<string, CheckoutPaymentStarter>;
     publicCheckoutBaseUrl?: string | null;
 }

package/dist/checkout-service.js

@@ -256,9 +256,16 @@ export async function initiateCheckoutCollection(db, bookingId, input, options =
         if (!paymentSession) {
             throw new Error("No payment session available for provider start");
         }
-        const starter = runtime.paymentStarters?.[input.startProvider.provider];
+        // Processor selection belongs to the deployment. A selected PaymentAdapter
+        // therefore wins even when an older client still sends a provider hint.
+        // Keyed starters remain as a compatibility path for self-hosted plugins.
+        const requestedProvider = input.startProvider.provider;
+        const starter = runtime.selectedPaymentStarter ??
+            (requestedProvider ? runtime.paymentStarters?.[requestedProvider] : undefined);
         if (!starter) {
-            throw new Error(`Payment provider "${input.startProvider.provider}" is not configured`);
+            throw new Error(requestedProvider
+                ? `Payment provider "${requestedProvider}" is not configured`
+                : "No payment adapter is selected for card collection");
         }
         providerStart = await starter({
             db,

package/dist/checkout-validation.d.ts

@@ -46,7 +46,7 @@ export declare const checkoutReminderTargetTypeSchema: z.ZodEnum<{
     booking_cancelled_non_payment: "booking_cancelled_non_payment";
 }>;
 export declare const checkoutProviderStartInputSchema: z.ZodObject<{
-    provider: z.ZodString;
+    provider: z.ZodOptional<z.ZodString>;
     payload: z.ZodNullable<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
 }, z.core.$strip>;
 export declare const checkoutNotificationAttachmentSchema: z.ZodObject<{
@@ -407,7 +407,7 @@ export declare const initiateCheckoutCollectionSchema: z.ZodObject<{
         paymentLinkBaseUrl: z.ZodNullable<z.ZodOptional<z.ZodString>>;
     }, z.core.$strip>>;
     startProvider: z.ZodOptional<z.ZodObject<{
-        provider: z.ZodString;
+        provider: z.ZodOptional<z.ZodString>;
         payload: z.ZodNullable<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
     }, z.core.$strip>>;
     notes: z.ZodNullable<z.ZodOptional<z.ZodString>>;
@@ -659,7 +659,7 @@ export declare const bootstrapCheckoutCollectionSchema: z.ZodObject<{
         paymentLinkBaseUrl: z.ZodNullable<z.ZodOptional<z.ZodString>>;
     }, z.core.$strip>>;
     startProvider: z.ZodOptional<z.ZodObject<{
-        provider: z.ZodString;
+        provider: z.ZodOptional<z.ZodString>;
         payload: z.ZodNullable<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
     }, z.core.$strip>>;
     notes: z.ZodNullable<z.ZodOptional<z.ZodString>>;

package/dist/checkout-validation.js

@@ -28,7 +28,12 @@ export const checkoutReminderTargetTypeSchema = z.enum([
     "invoice",
 ]);
 export const checkoutProviderStartInputSchema = z.object({
-    provider: z.string().min(1).max(255),
+    /**
+     * Legacy provider hint. Deployments with a selected PaymentAdapter ignore
+     * this value and always use their selected adapter. New clients should omit
+     * it so processor selection remains deployment-owned.
+     */
+    provider: z.string().min(1).max(255).optional(),
     payload: z.record(z.string(), z.unknown()).optional().nullable(),
 });
 export const checkoutNotificationAttachmentSchema = z

package/dist/index.d.ts

@@ -28,8 +28,8 @@ export { PAYMENT_ADAPTER_CONTRACT_VERSION, PAYMENT_ADAPTER_RUNTIME_PORT_ID, paym
 export { type BookingCancellationSettlementInput, buildPaidBookingCancellationSettlementNote, closeTerminalBookingPaymentSchedules, financeBookingLifecycle, recordPaidBookingCancellationSettlement, } from "./booking-lifecycle.js";
 export { type BookingTaxRouteOptions, type BookingTaxSettings, computeBookingItemTaxLine, createBookingTaxPreviewApiExtension, createBookingTaxPreviewRoutes, createBookingTaxSettingsApiExtension, createBookingTaxSettingsRoutes, loadProductTaxFacts, matchesTaxPolicyCondition, mountBookingTaxPreviewRoutes, mountBookingTaxSettingsRoutes, type ProductTaxFacts, type ResolveBookingSellTaxRateOptions, type ResolveBookingTaxSettings, type ResolvedBookingSellTaxRate, resolveBookingSellTaxRate, type TaxPolicyCondition, type UpdateBookingTaxSettings, } from "./booking-tax.js";
 export { BOOKING_TAX_PREVIEW_RUNTIME_KEY, BOOKING_TAX_SETTINGS_RUNTIME_KEY, type BookingTaxRuntime, createBookingTaxPreviewVoyantRuntime, createBookingTaxSettingsVoyantRuntime, } from "./booking-tax-runtime.js";
-export type { CardPaymentBilling, CardPaymentStartArgs, CardPaymentStarter, CardPaymentStartResult, PaymentAdapterCardPaymentStarterOptions, } from "./card-payment.js";
-export { createPaymentAdapterCardPaymentStarter } from "./card-payment.js";
+export type { CardPaymentBilling, CardPaymentStartArgs, CardPaymentStarter, CardPaymentStartResult, PaymentAdapterCardPaymentExecution, PaymentAdapterCardPaymentStarterOptions, } from "./card-payment.js";
+export { createPaymentAdapterCardPaymentStarter, startPaymentAdapterCardPayment, } from "./card-payment.js";
 export { type DocumentDownloadEnvelope, type DocumentDownloadResolution, type DocumentDownloadResolver, resolveStoredDocumentDownload, type StoredDocumentReference, } from "./document-download.js";
 export { createInvoiceFxApiExtension, createInvoiceFxRoutes, createVoyantDataFxExchangeRateResolver, type InvoiceExchangeRateResolution, type InvoiceFxContext, type InvoiceFxOptions, type InvoiceFxRouteOptions, type InvoiceFxSettings, mountInvoiceFxRoutes, type ResolvedInvoiceFxSettings, type ResolveInvoiceExchangeRate, type ResolveInvoiceExchangeRateInput, type ResolveInvoiceFxSettings, resolveInvoiceFxContext, resolveInvoiceFxSettingsOrDefault, type UpdateInvoiceFxSettings, type VoyantDataFxResolverOptions, } from "./invoice-fx.js";
 export { type CreateOrderPaymentSessionsOptions, createOrderPaymentSessions, type EnsureOrderSessionParams, type OrderPaymentSessionSummary, type OrderPaymentSessions, type OrderPaymentSessionTargetType, type StartOrderPaymentProvider, } from "./order-payment-sessions.js";

package/dist/index.js

@@ -4,6 +4,7 @@ import { registerBookingFinancialLifecycle } from "@voyant-travel/bookings";
 import { customFieldsRuntimePort } from "@voyant-travel/core/custom-fields";
 import { defineGraphRuntimeFactory } from "@voyant-travel/core/project";
 import { stampOpenApiRegistryApiId } from "@voyant-travel/hono";
+import { paymentAdapterRuntimePort } from "@voyant-travel/payments";
 import { financeBookingLifecycle } from "./booking-lifecycle.js";
 import { createBookingTaxSettingsRoutes } from "./booking-tax.js";
 import { buildFinanceCheckoutRouteRuntime, createFinanceCheckoutAdminRoutes, createFinanceCheckoutRoutes, FINANCE_CHECKOUT_ROUTE_RUNTIME_CONTAINER_KEY, } from "./checkout-routes.js";
@@ -68,7 +69,9 @@ export const financeApiModule = createFinanceApiModule();
 export const createFinanceVoyantRuntime = defineGraphRuntimeFactory(async ({ api, getPort, getPorts, hasPort }) => {
     const configured = createFinanceApiModule(createFinanceRuntime(await getPort(financeHostRuntimePort), await getPort(customFieldsRuntimePort), await getPort(financeNotificationsRuntimePort), hasPort(financeCheckoutPaymentStartersRuntimePort)
         ? await getPort(financeCheckoutPaymentStartersRuntimePort)
-        : undefined, await getPorts(financeInvoiceSettlementPollerRuntimePort)));
+        : undefined, await getPorts(financeInvoiceSettlementPollerRuntimePort), hasPort(paymentAdapterRuntimePort)
+        ? await getPort(paymentAdapterRuntimePort)
+        : undefined));
     const bootstrap = configured.module.bootstrap;
     const selected = {
         module: {
@@ -91,7 +94,7 @@ export { PAYMENT_ADAPTER_CONTRACT_VERSION, PAYMENT_ADAPTER_RUNTIME_PORT_ID, paym
 export { buildPaidBookingCancellationSettlementNote, closeTerminalBookingPaymentSchedules, financeBookingLifecycle, recordPaidBookingCancellationSettlement, } from "./booking-lifecycle.js";
 export { computeBookingItemTaxLine, createBookingTaxPreviewApiExtension, createBookingTaxPreviewRoutes, createBookingTaxSettingsApiExtension, createBookingTaxSettingsRoutes, loadProductTaxFacts, matchesTaxPolicyCondition, mountBookingTaxPreviewRoutes, mountBookingTaxSettingsRoutes, resolveBookingSellTaxRate, } from "./booking-tax.js";
 export { BOOKING_TAX_PREVIEW_RUNTIME_KEY, BOOKING_TAX_SETTINGS_RUNTIME_KEY, createBookingTaxPreviewVoyantRuntime, createBookingTaxSettingsVoyantRuntime, } from "./booking-tax-runtime.js";
-export { createPaymentAdapterCardPaymentStarter } from "./card-payment.js";
+export { createPaymentAdapterCardPaymentStarter, startPaymentAdapterCardPayment, } from "./card-payment.js";
 export { resolveStoredDocumentDownload, } from "./document-download.js";
 export { createInvoiceFxApiExtension, createInvoiceFxRoutes, createVoyantDataFxExchangeRateResolver, mountInvoiceFxRoutes, resolveInvoiceFxContext, resolveInvoiceFxSettingsOrDefault, } from "./invoice-fx.js";
 export { createOrderPaymentSessions, } from "./order-payment-sessions.js";

package/dist/runtime.d.ts

@@ -1,9 +1,10 @@
 import type { CustomFieldsRuntime } from "@voyant-travel/core/custom-fields";
+import type { PaymentAdapter } from "@voyant-travel/payments";
 import type { FinanceApiModuleOptions } from "./index.js";
 import type { FinanceAccommodationsPaymentPolicyRuntime, FinanceBookingScheduleRuntime, FinanceCheckoutPaymentStartersRuntime, FinanceCruisesPaymentPolicyRuntime, FinanceDistributionPaymentPolicyRuntime, FinanceHostRuntime, FinanceInventoryPaymentPolicyRuntime, FinanceInvoiceSettlementPollerProvider, FinanceNotificationsRuntime, FinanceOperatorSettingsRuntime } from "./runtime-port.js";
 import type { InvoiceSettlementPoller } from "./service-settlement.js";
 /** Compose Finance's main HTTP runtime from generic host and selected providers. */
-export declare function createFinanceRuntime(host: FinanceHostRuntime, customFields: CustomFieldsRuntime, notifications: FinanceNotificationsRuntime, checkoutPaymentStarters?: FinanceCheckoutPaymentStartersRuntime, invoiceSettlementPollerProviders?: readonly FinanceInvoiceSettlementPollerProvider[]): FinanceApiModuleOptions;
+export declare function createFinanceRuntime(host: FinanceHostRuntime, customFields: CustomFieldsRuntime, notifications: FinanceNotificationsRuntime, checkoutPaymentStarters?: FinanceCheckoutPaymentStartersRuntime, invoiceSettlementPollerProviders?: readonly FinanceInvoiceSettlementPollerProvider[], selectedPaymentAdapter?: PaymentAdapter): FinanceApiModuleOptions;
 /** Compose Finance's payment schedule from statically selected domain providers. */
 export declare function createFinanceBookingScheduleRuntime(host: FinanceHostRuntime, settings: FinanceOperatorSettingsRuntime, distribution: FinanceDistributionPaymentPolicyRuntime, accommodations: FinanceAccommodationsPaymentPolicyRuntime, cruises: FinanceCruisesPaymentPolicyRuntime, inventory: FinanceInventoryPaymentPolicyRuntime): FinanceBookingScheduleRuntime;
 export declare function createFinanceBookingTaxRuntime(settings: FinanceOperatorSettingsRuntime): FinanceApiModuleOptions;

package/dist/runtime.js

@@ -1,6 +1,8 @@
+import { startPaymentAdapterCardPayment } from "./card-payment.js";
 import { createVoyantDataFxExchangeRateResolver, } from "./invoice-fx.js";
+import { financeService } from "./service.js";
 /** Compose Finance's main HTTP runtime from generic host and selected providers. */
-export function createFinanceRuntime(host, customFields, notifications, checkoutPaymentStarters, invoiceSettlementPollerProviders = []) {
+export function createFinanceRuntime(host, customFields, notifications, checkoutPaymentStarters, invoiceSettlementPollerProviders = [], selectedPaymentAdapter) {
     const { primitives } = host;
     return {
         resolveDocumentDownloadUrl: primitives.storage.downloadUrl,
@@ -18,11 +20,93 @@ export function createFinanceRuntime(host, customFields, notifications, checkout
         invoiceDueDateResolver: ({ issueDate, dueDate, bookingPaymentSchedule }) => bookingPaymentSchedule && dueDate < issueDate ? issueDate : dueDate,
         resolveNotificationDispatcher: notifications.resolveNotificationDispatcher,
         resolvePaymentStarters: (bindings) => checkoutPaymentStarters?.resolvePaymentStarters(bindings) ?? {},
+        resolveSelectedPaymentStarter: selectedPaymentAdapter
+            ? (bindings) => createSelectedPaymentAdapterStarter(host, selectedPaymentAdapter, bindings)
+            : undefined,
         resolveBankTransferDetails: (bindings) => resolveBankTransferDetails(primitives.env(bindings)),
         resolvePublicCheckoutBaseUrl: (bindings) => resolvePublicCheckoutBaseUrl(primitives.env(bindings)),
         listBookingReminderRuns: notifications.listBookingReminderRuns,
     };
 }
+function createSelectedPaymentAdapterStarter(host, adapter, bindings) {
+    return async (checkout) => {
+        const payload = checkout.startProvider.payload ?? {};
+        const billing = readCardPaymentBilling(payload.billing);
+        const env = host.primitives.env(bindings);
+        const started = await startPaymentAdapterCardPayment(adapter, {
+            db: checkout.db,
+            sessionId: checkout.paymentSession.id,
+            billing,
+            description: stringValue(payload.description),
+            returnUrl: stringValue(payload.returnUrl) ?? checkout.paymentSession.returnUrl ?? undefined,
+            metadata: recordValue(payload.metadata),
+        }, {
+            context: { env },
+            notifyUrl: resolvePaymentCallbackUrl(env),
+        });
+        const session = (await financeService.getPaymentSessionById(checkout.db, checkout.paymentSession.id)) ??
+            checkout.paymentSession;
+        return {
+            provider: adapter.id,
+            paymentSessionId: session.id,
+            redirectUrl: started?.redirectUrl ?? null,
+            externalReference: session.externalReference,
+            providerSessionId: session.providerSessionId,
+            providerPaymentId: session.providerPaymentId,
+            response: null,
+        };
+    };
+}
+function readCardPaymentBilling(value) {
+    const billing = recordValue(value);
+    const email = nonEmpty(billing.email);
+    const firstName = nonEmpty(billing.firstName);
+    if (!email || !firstName) {
+        throw new Error("Card payment billing requires email and firstName");
+    }
+    const phone = nonEmpty(billing.phone);
+    const lastName = nonEmpty(billing.lastName);
+    const city = nonEmpty(billing.city);
+    const country = typeof billing.country === "number" || typeof billing.country === "string"
+        ? billing.country
+        : undefined;
+    const state = nonEmpty(billing.state);
+    const postalCode = nonEmpty(billing.postalCode);
+    const details = nonEmpty(billing.details);
+    return {
+        email,
+        firstName,
+        ...(phone ? { phone } : {}),
+        ...(lastName ? { lastName } : {}),
+        ...(city ? { city } : {}),
+        ...(country !== undefined ? { country } : {}),
+        ...(state ? { state } : {}),
+        ...(postalCode ? { postalCode } : {}),
+        ...(details ? { details } : {}),
+    };
+}
+function recordValue(value) {
+    return value && typeof value === "object" && !Array.isArray(value)
+        ? value
+        : {};
+}
+function resolvePaymentCallbackUrl(env) {
+    const configured = nonEmpty(env.PAYMENT_CALLBACK_BASE_URL) ??
+        nonEmpty(env.DASH_BASE_URL) ??
+        nonEmpty(env.APP_URL)?.replace(/\/api\/?$/, "");
+    if (!configured)
+        return undefined;
+    const url = new URL(configured);
+    if ((url.protocol !== "http:" && url.protocol !== "https:") ||
+        url.username ||
+        url.password ||
+        url.pathname !== "/" ||
+        url.search ||
+        url.hash) {
+        throw new Error("Payment callback base must be an absolute HTTP(S) origin");
+    }
+    return `${url.origin}/api/v1/public/payment-link/callback`;
+}
 /** Compose Finance's payment schedule from statically selected domain providers. */
 export function createFinanceBookingScheduleRuntime(host, settings, distribution, accommodations, cruises, inventory) {
     const paymentPolicy = inventory.createPaymentPolicyRuntime({

package/dist/voyant.js

@@ -8,6 +8,7 @@ import { financeReceivablesDatasetDefinition, financeReportingTemplates, finance
 import { financeAccommodationsPaymentPolicyRuntimePort, financeCheckoutPaymentStartersRuntimePort, financeCruisesPaymentPolicyRuntimePort, financeDistributionPaymentPolicyRuntimePort, financeHostRuntimePort, financeInventoryPaymentPolicyRuntimePort, financeInvoiceSettlementPollerRuntimePort, financeNotificationsRuntimePort, financeOperatorSettingsRuntimePort, } from "./runtime-port.js";
 import { financeVoyantAdmin } from "./voyant-admin.js";
 import { bookingContractDocumentRequestedPayloadSchema, bookingCreatedPayloadSchema, bookingCreateRejectedPayloadSchema, bookingDualCreatedPayloadSchema, bookingPaymentSchedulePaidPayloadSchema, invoiceDocumentGeneratedPayloadSchema, invoiceIssuanceExternalPayloadSchema, invoicePaymentRecordedExternalPayloadSchema, invoiceProformaConvertedExternalPayloadSchema, invoiceRenderedPayloadSchema, invoiceSettledPayloadSchema, invoiceVoidedExternalPayloadSchema, paymentCompletedPayloadSchema, } from "./voyant-event-schemas.js";
+const paymentAdapterRuntimePortReference = { id: "payments.adapter.runtime" };
 /** Import-cheap deployment declaration owned by the finance package. */
 export const financeVoyantModule = defineModule({
     id: "@voyant-travel/finance",
@@ -19,6 +20,7 @@ export const financeVoyantModule = defineModule({
         requirePort(customFieldsRuntimePort),
         requirePort(financeNotificationsRuntimePort),
         requirePort(financeCheckoutPaymentStartersRuntimePort, { optional: true }),
+        { ...paymentAdapterRuntimePortReference, optional: true },
         requirePort(financeInvoiceSettlementPollerRuntimePort, {
             optional: true,
             cardinality: "many",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voyant-travel/finance",
-  "version": "0.190.0",
+  "version": "0.191.0",
   "license": "Apache-2.0",
   "type": "module",
   "exports": {
@@ -157,7 +157,7 @@
     "hono": "^4.12.27",
     "zod": "^4.4.3",
     "@voyant-travel/action-ledger": "^0.111.13",
-    "@voyant-travel/bookings": "^0.190.0",
+    "@voyant-travel/bookings": "^0.191.0",
     "@voyant-travel/core": "^0.131.0",
     "@voyant-travel/db": "^0.118.0",
     "@voyant-travel/types": "^0.109.9",