Saltar a contenido

Webhook y estado de pagos en Alfred

Summary

Los webhooks de Alfred son el mecanismo central para que Landbridge sepa si KYC/KYB, onramp u offramp avanzó, falló o terminó. Para un cierre inmobiliario, estos estados deben mapearse a checkpoints operativos: fondos recibidos, trade completado, transferencia fiat iniciada/completada y evidencia para underwriter/title company.

Definition

Canal de notificaciones HTTP firmado por Alfred, con payload que incluye referenceId, eventType, status y metadata, usado para reportar cambios de estado en workflows KYC, onramp, offramp y refund.

Key Points

  • Alfred firma eventos con header signature que incluye t=<timestamp> y s=<signature>; la firma usa HMAC SHA-256.
  • La verificación recomendada valida formato, timestamp de 5 minutos y HMAC del string timestamp + payload JSON.
  • Para 4xx/5xx, Alfred requiere al menos 10 reintentos con exponential backoff.
  • KYC/KYB: CREATED, IN_REVIEW, UPDATE_REQUIRED, COMPLETED, FAILED.
  • Onramp: CREATED, FIAT_DEPOSIT_RECEIVED, TRADE_COMPLETED, ON_CHAIN_INITIATED, ON_CHAIN_COMPLETED, FAILED.
  • Offramp: CREATED, ON_CHAIN_DEPOSIT_RECEIVED, TRADE_COMPLETED, FIAT_TRANSFER_INITIATED, FIAT_TRANSFER_COMPLETED, FAILED.
  • En Landbridge, FIAT_TRANSFER_COMPLETED sería el estado más relevante para liberar evidencia de pago fiat hacia title/escrow en un flujo crypto-to-fiat; FAILED exige playbook de soporte/devolución.

Evidence

  • Webhooks page: “automatic updates anytime the status on a KYC, Onramp, or Offramp workflow changes”.
  • Webhooks page: payload base con referenceId, eventType, status, metadata.
  • Webhooks page: estado FIAT_TRANSFER_COMPLETED descrito como “Partner fiat transfer to customer bank account settled”.
  • FAQ: webhook setup es obligatorio para recibir transaction and KYC updates; estados finales son ON_CHAIN_COMPLETED y FAILED salvo intervención de soporte.

Open Questions

  • Confirmar semántica final para Landbridge: si el cierre espera FIAT_TRANSFER_COMPLETED, qué prueba bancaria/documental entrega Alfred.
  • Confirmar cómo reintentar, reconciliar o consultar transacciones cuando se pierde un webhook.
  • Confirmar si webhooks incluyen datos suficientes para beneficiary/title company y externalId de Landbridge.
  • src-alfred-provider-docs-2026-05-11
  • [[entity-alfred]]
  • [[concept-alfred-api-integration]]
  • [[concept-crypto-to-fiat-settlement-inmobiliario]]