跳到正文
H3-08本地清算网络1 分钟更新于 2026-11

适配器能力

一句话

能力声明决定上层怎么编排。

本文目录8 节

适配器能力

它解决什么

适配器要声明自己的能力:是否实时、可否撤销、有无原生退款、限额多少、支持哪些币种。上层按「能力」编排,而不是按「通道名」写 if-else。按通道名写逻辑,每接一家新通道就要改一次代码,改多了必然出错。能力声明是编排的基础,没有它就只能写死分支。能力声明是编排的基础,没有它只能写死分支。

怎么用

  • 能力字段化
  • 上层按能力决策
  • 定期校准
  • 接入前必填

一个判断

某系统按通道名写 if-else,接第 8 家通道时改错分支,线上故障两小时。

边界

能力声明的边界是「准确性」:声明错了比不声明更糟,因为上层会按错的假设编排。

一个反例

某系统按通道名写 if-else,接第 8 家通道时改错分支,线上故障两小时。现在能力字段化,新通道只填配置不改代码。

常见误判

  • 按通道名判断能力。

自查清单

  • 知道这个渠道的能力边界
  • 知道它的费率与结算条款
  • 知道它挂了怎么切换
  • 知道它的合规资质

依据

  • 适配器的能力声明。

相关:适配器契约的五个字段

相关阅读