Saltar a contenido

Formance Connectivity payments

Summary

Documento de Payments dentro de Connectivity. Define payment como movimiento de fondos entre cuentas del proveedor, con ID interno de Formance, referencia del proveedor, source/destination accounts, tipo PAYIN/TRANSFER/PAYOUT, provider, status, amount/asset, scheme, timestamps y payload raw.

Key Points

  • Payments normaliza movimientos externos de PSP o sistemas de pago.
  • Tipos documentados: PAYIN, TRANSFER y PAYOUT.
  • Estados documentados: PENDING, SUCCEEDED, FAILED, CANCELED.
  • Mantiene tanto ID interno como reference ID del proveedor.
  • Permite consultar por reference o metadata mediante filtros en list payments.

Evidence

  • Payment representa "moving funds between accounts on the payments provider".
  • Fields: source account ID, destination account ID, type, provider, status, InitialAmount, asset, scheme, creation date, raw payload.
  • Query by reference uses /payments with $match.

Open Questions

  • Mapear IDs externos de liquidez, escrow/title, Fireblocks y bancos a metadata estándar de Landbridge.
  • Validar si payments puede actuar como registro canónico o solo espejo de rails externos.
  • Raw local: raw/formance/formance-connectivity-payments.md
  • Source URL: https://docs.formance.com/modules/connectivity/concepts/payments