变更日志

约定：路径版本为 /v1。同一主版本内以兼容扩展为主；删除/改义字段会提前在此公告，并尽量保留过渡期。

v1.8（当前 · 2026-08-04）

钱包流水类型扩展（兼容）：GET /wallet/flows 的 type 增加 auth_fee（授权相关费用）；与 chargeback_fee（拒付费）并列，均为钱包出账，允许余额记负
拒付费与账户限制：transaction.declined 后平台可能扣 chargeback_fee。已开通开放 API 的商户仅扣费、不因连续余额不足自动限制账户；未开通 API 的个人账户在连续不足达阈值时可能被自动限制（阈值由平台配置，0=关闭）
授权费定价：授权相关费用按「商户专属 → 全局默认」计价，公式为
扣款 = 上游金额 × 百分比% + 固定加价（百分比 100=原价透传，可配置更高以加价）
Webhook 3DS：card.3ds.otp 的 transactionAmount / transactionCurrency 在有交易金额时会填充；otp 仍约 5 分钟有效
共享池创建响应（兼容）：POST /card-groups 成功体以平台 groupId 为准，不再下发通道侧品牌化外部组 ID
文档：新增卡产品与身份认证——明确 KYC 按产品、非全站强制；对接须按 requireThirdPartyKyc 分支
控制台：共享池余额汇总、仪表盘资产卡对齐；商户端暗色主题与帮助中心/工单对比度修复（不影响 API 契约）

卡产品目录扩展（兼容）：GET /card-products 增加 productLabel、feeNotes[]、requireThirdPartyKyc、needCardHolder、cardHolderModel 等；定价「商户专属 → 卡 BIN → 通道默认」
KYC 按产品：requireThirdPartyKyc=true 才需要认证；false 不强制
身份认证透传：请求体 kycProvider + kycReferenceId（DIDIT / SUMSUB / MyInfo / Jumio / Shufti）或控制台一键认证；请求优先。只接 Didit 固定 DIDIT 即可
开卡与持卡人：holderId 须与当前 bin 产品线匹配
Webhook card.issued：不以供应商品牌字段为准；使用 externalCardId 等平台标识

Base URL 明确为：沙箱 https://uat-openapi.cafinx.com/v1、生产 https://openapi.cafinx.com/v1
文档站：https://doc.cafinx.com · 服务状态与工具下载在商户「开发者 → 工具与状态」（非外部 status 域名）
OpenAPI 侧栏标题：发卡接口；异步回调规范：WEBHOOK 通知
鉴权：RSA-2048 请求签名 + IP 白名单；写接口强制 X-Idempotency-Key
资金：业务消费只扣 USD，不足时自动兑数字货币补足
安全声明独立页：安全要求 · 免责 · 平台处置权
Guides：快速开始、认证（含 C# / Node / Python / Java / PHP）、错误码、Webhook、FAQ、术语表、最佳实践、变更日志、集成清单、SLA、服务状态
开发者 SDK 新增 docs/developer-sdk/csharp/CafinxClient.cs