Passport 文档

收单方支付（Merchant of Record）

Passport 是全 Xeegam 服务的收单方：支付方式、地址、订单、订阅都是 Passport 的资源。

职责划分

角色 职责
Passport 管理支付方式与地址、创建与收款订单、订阅与续订、对账与退款
业务服务 创建业务订单时调 payment.order.create，接收 payment.order.paid 事件，交付业务结果

流转

  1. 业务服务经 NATS 创建订单（商品信息、金额、币种）。
  2. 用户在 Passport 侧完成支付（支付方式经支付工单确认，原文凭据不出 payment_service）。
  3. payment_service 发布 payment.order.paid，业务服务消费后交付业务。
  4. payment_worker 定时扫描续订到期（payment.subscription.renewal.due）与对账差异（payment.order.reconcile.diff），直接读写支付库。

业务服务永远接触不到原始支付凭据，只消费支付结果事件。