用途:该技能用于把 Dodo Payments 集成进 Web 框架,借助官方 @dodopayments/* 适配器包处理路由接线、环境变量配置与处理器设置,无需从零编写结账、客户门户和 Webhook 路由。
主要能力:每个适配器提供三类处理器——Checkout(static 仅 GET、dynamic 带购物车 POST、session 预建会话 POST)、CustomerPortal(生成限时门户会话链接)、Webhooks(校验签名并分发类型化事件)。适配器负责保留原始请求体以校验 Webhook、映射环境变量并适配各框架的请求/响应形态。
使用方式:按框架安装对应包,例如 npm install @dodopayments/nextjs、@dodopayments/express、@dodopayments/fastify、@dodopayments/hono、@dodopayments/astro、@dodopayments/remix、@dodopayments/sveltekit、@dodopayments/nuxt、@dodopayments/tanstack、@dodopayments/convex,Bun 用 bun add @dodopayments/bun。多数适配器使用 DODO_PAYMENTS_API_KEY、DODO_PAYMENTS_WEBHOOK_KEY、DODO_PAYMENTS_ENVIRONMENT、DODO_PAYMENTS_RETURN_URL;Nuxt 用 NUXT_PRIVATE_ 前缀,Convex 用仪表盘环境变量。environment 类型为 "test_mode" | "live_mode",直接传 process.env 会类型报错,需定义收窄助手并默认 test_mode。
注意:各适配器导出名与返回形态不统一,如 express 为 checkoutHandler(小写)、fastify 返回 { getHandler, postHandler }、sveltekit 返回 { GET, POST }、nuxt 自动导入、convex 用 DodoPayments 组件与 createDodoWebhookHandler。Webhook 密钥变量名在不同适配器间可能为 DODO_PAYMENTS_WEBHOOK_KEY 或 DODO_PAYMENTS_WEBHOOK_SECRET,需查阅对应文档。结账载荷设计、Webhook 业务逻辑与门户行为分别属于其他技能。
限制:资料未提供收费、价格、平台支持范围或效果数据。