公共 API 参考(@saas/contracts + @core/saas-kit + apps/api 对外接口)
    Preparing search index...

    支付通道统一端口(global-cn-adaptation D1/P1)。

    与 StorageProvider 同构:领域只依赖本接口,具体通道(stripe/alipay/wechat_pay) 由 PaymentModule.register() 依配置装配、PaymentService 依 payment.provider 选择。 返回体为跨通道归一化引用 + raw 透传原生载荷,便于既有调用方渐进迁移。

    分层对齐:原居 providers/payment.interface.ts,现下沉 domain/ports(零框架依赖)。 签名属方案 §6.1 草案,随 P2/P3 通道接入在代码评审处定稿。

    interface PaymentProvider {
        id: PaymentProviderId;
        createCheckout(input: CreateCheckoutInput): Promise<PaymentCheckoutRef>;
        createCustomer(input: PaymentCustomerInput): Promise<PaymentCustomerRef>;
        refund(input: RefundInput): Promise<PaymentRefundRef>;
        retrieveCheckout(id: string): Promise<PaymentCheckoutRef>;
        supportsRecurring(): boolean;
        verifyWebhook(
            rawBody: string,
            signature: string,
        ): Promise<NormalizedPaymentEvent>;
    }
    Index

    支付提供方标识。