/** * Shared constants and types for payment provider management. */ // --- Types --- export interface ConfigFieldDef { key: string label: string sensitive: boolean optional?: boolean defaultValue?: string } export interface TypeOption { value: string label: string } /** Callback URL paths for a provider. */ export interface CallbackPaths { notifyUrl?: string returnUrl?: string } // --- Constants --- /** Maps provider key → available payment types. */ export const PROVIDER_SUPPORTED_TYPES: Record = { easypay: ['alipay', 'wxpay'], alipay: ['alipay'], wxpay: ['wxpay'], stripe: ['card', 'alipay', 'wxpay', 'link'], } /** Available payment modes for EasyPay providers. */ export const EASYPAY_PAYMENT_MODES = ['qrcode', 'popup'] as const /** Fixed display order for user-facing payment methods */ export const METHOD_ORDER = ['alipay', 'alipay_direct', 'wxpay', 'wxpay_direct', 'stripe'] as const /** Payment mode constants */ export const PAYMENT_MODE_QRCODE = 'qrcode' export const PAYMENT_MODE_POPUP = 'popup' /** Preferred popup size for payment gateways. Alipay's standard checkout * (QR + account login panel) needs ~1200×900 to render without any scrolling. */ const PAYMENT_POPUP_PREFERRED_WIDTH = 1250 const PAYMENT_POPUP_PREFERRED_HEIGHT = 900 /** Build a window.open features string sized to fit within the current screen * while preferring the above dimensions. Centers the popup on the available * work area so nothing is clipped on smaller laptop displays. */ export function getPaymentPopupFeatures(): string { const screen = typeof window !== 'undefined' ? window.screen : null const availW = screen?.availWidth ?? PAYMENT_POPUP_PREFERRED_WIDTH const availH = screen?.availHeight ?? PAYMENT_POPUP_PREFERRED_HEIGHT const width = Math.min(PAYMENT_POPUP_PREFERRED_WIDTH, availW - 40) const height = Math.min(PAYMENT_POPUP_PREFERRED_HEIGHT, availH - 40) const left = Math.max(0, Math.floor((availW - width) / 2)) const top = Math.max(0, Math.floor((availH - height) / 2)) return `width=${width},height=${height},left=${left},top=${top},scrollbars=yes,resizable=yes` } /** Webhook paths for each provider (relative to origin). */ export const WEBHOOK_PATHS: Record = { easypay: '/api/v1/payment/webhook/easypay', alipay: '/api/v1/payment/webhook/alipay', wxpay: '/api/v1/payment/webhook/wxpay', stripe: '/api/v1/payment/webhook/stripe', } export const RETURN_PATH = '/payment/result' /** Fixed callback paths per provider — displayed as read-only after base URL. */ export const PROVIDER_CALLBACK_PATHS: Record = { easypay: { notifyUrl: WEBHOOK_PATHS.easypay, returnUrl: RETURN_PATH }, alipay: { notifyUrl: WEBHOOK_PATHS.alipay, returnUrl: RETURN_PATH }, wxpay: { notifyUrl: WEBHOOK_PATHS.wxpay }, // stripe: no callback URL config needed (webhook is separate) } /** Per-provider config fields (excludes notifyUrl/returnUrl which are handled separately). */ export const PROVIDER_CONFIG_FIELDS: Record = { easypay: [ { key: 'pid', label: 'PID', sensitive: false }, { key: 'pkey', label: 'PKey', sensitive: true }, { key: 'apiBase', label: '', sensitive: false }, { key: 'cidAlipay', label: '', sensitive: false, optional: true }, { key: 'cidWxpay', label: '', sensitive: false, optional: true }, ], alipay: [ { key: 'appId', label: 'App ID', sensitive: false }, { key: 'privateKey', label: '', sensitive: true }, { key: 'publicKey', label: '', sensitive: true }, ], wxpay: [ { key: 'appId', label: 'App ID', sensitive: false }, { key: 'mpAppId', label: '', sensitive: false, optional: true }, { key: 'mchId', label: '', sensitive: false }, { key: 'privateKey', label: '', sensitive: true }, { key: 'apiV3Key', label: '', sensitive: true }, { key: 'certSerial', label: '', sensitive: false }, { key: 'publicKey', label: '', sensitive: true }, { key: 'publicKeyId', label: '', sensitive: false }, { key: 'h5AppName', label: '', sensitive: false, optional: true }, { key: 'h5AppUrl', label: '', sensitive: false, optional: true }, ], stripe: [ { key: 'secretKey', label: '', sensitive: true }, { key: 'publishableKey', label: '', sensitive: false }, { key: 'webhookSecret', label: '', sensitive: true }, ], } // --- Helpers --- /** Resolve type label for display. */ export function resolveTypeLabel( typeVal: string, _providerKey: string, allTypes: TypeOption[], _redirectLabel: string, ): TypeOption { return allTypes.find(pt => pt.value === typeVal) || { value: typeVal, label: typeVal } } /** Get available type options for a provider key. */ export function getAvailableTypes( providerKey: string, allTypes: TypeOption[], redirectLabel: string, ): TypeOption[] { const types = PROVIDER_SUPPORTED_TYPES[providerKey] || [] return types.map(t => resolveTypeLabel(t, providerKey, allTypes, redirectLabel)) } /** Extract base URL from a full callback URL by removing the known path suffix. */ export function extractBaseUrl(fullUrl: string, path: string): string { if (!fullUrl) return '' if (fullUrl.endsWith(path)) return fullUrl.slice(0, -path.length) // Fallback: try to extract origin try { return new URL(fullUrl).origin } catch { return fullUrl } }