用途:为以色列市场编写支付代码时,统一编排多个本地支付网关(Cardcom、Tranzila、PayMe、Meshulam/Grow、iCredit、Pelecard),提供统一路由、回退与分期(tashlumim)能力。
主要能力与用法:
- 需求评估与网关比较:用 scripts/compare_gateways.py 生成比较矩阵;按分期类型、Bit/Apple Pay、定期扣款、托管页等匹配网关。PayMe 与 iCredit 多数字段公开资料未验证,需先向厂商确认。
- 编排抽象:定义统一 PaymentRequest/PaymentResult,内部用单一金额单位(agorot 整数),在各网关适配器中转换(Pelecard 用最小单位,Grow 用小数谢克尔)。
- 路由:先按功能过滤,再剔除不健康网关,再按商户自定优先级排序;不基于费率表排序(无网关公开费率,需向各网关索取书面报价)。
- 分期 CreditType:仅 1(单次)、6(信用卡分期,客户付息)、8(普通/免息分期,商户承担成本);不要发送 2-5 或 9,否则可能返回 017。
- 回退与重试:超时和 unknown 属于第三状态,不得直接切换网关以免重复扣款;仅当请求确实未到达网关时才重试;未验证网关不得进入故障切换链。需预先设计对账(关联键、幂等键、查询、轮询窗口与终态决策)。
- 授权/撤销/退款:区分授权(capture/release)与已结算后的 void 和 refund;void 未结算不产生清算费,refund 会产生两段清算费。
限制:本技能不公布费率;安装命令、具体端点与字段以各网关专用技能为准;PayMe、iCredit 缺少可访问的公开 API 文档,相关设计需先向厂商确认;分期上限、最低金额等属终端与发卡行配置,不可硬编码。安装与代码示例资料未完整提供。