用途：把 Klix（Citadele）支付网关接入任意 Web 应用或网站，支持卡支付、Apple Pay、Google Pay、波罗的海地区银行转账（PIS）以及 Pay Later 分期。官方文档：https://developers.klix.app/；OpenAPI：https://portal.klix.app/api/schema/v1/。
集成方式：1）eCommerce 插件（无代码），适用 WooCommerce 3.5+、Shopify、Magento 2.0+、OpenCart 3.0+、PrestaShop 1.7+、Mozello；2）前端组件，仅用于 Pay Later 分期计算器展示；3）@biggora/klix TypeScript SDK（Node.js 20+，推荐 Node/TS），封装 REST API，内置缓存、错误类型、签名校验与 NestJS 支持，双 ESM/CJS；4）直接调用 HTTP API，适合非 Node.js 技术栈。
SDK 安装：npm install @biggora/klix。用 createKlixClient({ apiKey, brandId }) 初始化。资源包括 klix.purchases（create、read、cancel、capture、charge、refund、release）、klix.balance、klix.paymentMethods、klix.clients、klix.billing、klix.billingTemplates、klix.companyStatements、klix.webhooks。品牌 ID 会自动注入支付方式列表与购买调用。
直接 API：Base URL 为 https://portal.klix.app/api/v1/，使用 Authorization: Bearer <Secret Key>，金额以分为单位。核心端点：GET /payment_methods/（限速每分钟 1 次，需缓存）、POST /purchases/、GET /purchases/<ID>/、capture、release、charge。流程为服务端创建购买获取 checkout_url，跳转客户完成支付，Klix 回调 success_callback，再重定向，最后服务端用 GET 查询核实。
场景：一次性支付、循环扣款（force_recurring，后续调用 /charge）、预授权（skip_capture，6 天未捕获自动释放）、支付方式白名单、原生 Apple Pay/Google Pay、批量付款（PIS，需预先白名单 IBAN）。
限制与提示：必须在服务端验证支付状态，不能只依赖重定向；签名校验需开启 raw body 解析；参考资料文件 references/payment-methods.md、pay-later-widget.md、ecommerce-plugins.md、branding.md 提供更多细节。测试环境凭据、测试卡与品牌规范见原始资料。