/** * 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' /** Window features for payment popup windows */ export const POPUP_WINDOW_FEATURES = 'width=1000,height=750,left=100,top=80,scrollbars=yes,resizable=yes' /** Wider popup for Stripe redirect methods (Alipay checkout page needs ~1200px) */ export const STRIPE_POPUP_WINDOW_FEATURES = 'width=1250,height=780,left=80,top=60,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: 'mchId', label: '', sensitive: false }, { key: 'privateKey', label: '', sensitive: true }, { key: 'apiV3Key', label: '', sensitive: true }, { key: 'publicKey', label: '', sensitive: true }, { key: 'publicKeyId', label: '', sensitive: false, optional: true }, { key: 'certSerial', 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 } }