Saltar a contenido

Alfred API integration

Summary

La integración Alfred API para Landbridge sería una orquestación de cliente/KYC, payment methods, quotes, onramp/offramp, liquidation addresses y webhooks. Para un MVP manual, Alfred puede actuar como proveedor operativo detrás de Fireblocks o de una consola interna; para producto, exige modelar estados, expiración de quotes, validación de webhooks y conciliación de fiat/cripto.

Definition

Conjunto de flujos técnicos necesarios para conectar Landbridge con Alfred/Penny API mediante API REST autenticada, con ambientes sandbox/producción, creación de customers, KYC/KYB, registro de cuentas fiat, cotización, ejecución de rampas y tracking por webhooks.

Key Points

  • Autenticación: headers api-key y api-secret; las docs incluyen sandbox y production URL.
  • Flujo base: crear customer, completar KYC/KYB, registrar fiat account/payment method, generar quote, crear onramp/offramp y escuchar webhooks.
  • Onramp requiere customerId aprobado y quoteId; transforma fiat local a USDC/USDT en chain y dirección destino.
  • Offramp requiere customerId aprobado, quoteId y fiatAccountId; transforma USDC/USDT desde chain/originAddress a cuenta fiat registrada.
  • Liquidation address vincula virtual account con dirección blockchain para convertir depósitos fiat automáticamente a USDC/USDT.
  • APM custodial puede hacer originAddress opcional y usar smart contracts/direcciones rotativas; una solución non-custodial requiere pasar originAddress.
  • Para Landbridge, Fireblocks podría seguir siendo el control operativo de wallets si Alfred confirma compatibilidad; las docs públicas no lo prueban.

Evidence

  • Getting Started documenta Postman, sandbox, production y variables URL_BASE, apiKey, apiSecret.
  • Create a Payment muestra request bodies de onramp y offramp con customerId, quoteId, currencies, amount, chain, deposit/origin address y fiatAccountId.
  • Liquidation Address define la ruta permanente entre virtual account y blockchain address.
  • Custodial vs Non-Custodial describe APM, direcciones rotativas y liquidación fiat en 3-5 minutos.

Open Questions

  • Obtener OpenAPI/API reference completa y actualizada; los slugs antiguos v1.1 del ReadMe dieron 404 en parte de la exploración.
  • Confirmar cómo se crean quotes y cómo se bloquea precio para un cierre inmobiliario.
  • Confirmar idempotencia, límites, reconciliation reports, webhooks replay y búsqueda de transacciones.
  • Confirmar si el endpoint de webhooks se auto-configura por API o lo configura onboarding de Alfred, porque docs/FAQ mezclan ambos modelos.
  • src-alfred-provider-docs-2026-05-11
  • [[entity-alfred]]
  • [[concept-webhook-y-estado-de-pagos-en-alfred]]
  • [[concept-crypto-to-fiat-settlement-inmobiliario]]