Saltar a contenido

Alfred provider docs 2026-05-11

Summary

Extracto amplio de la documentación pública de Alfred Pay para evaluar su encaje como proveedor de rampas, liquidez y pagos fiat/cripto en Landbridge. Alfred se presenta como una API REST de “last mile payments” que conecta monedas digitales con efectivo/cuentas bancarias, con KYC/KYB, métodos de pago locales, quotes, onramp/offramp, cuentas virtuales, liquidation addresses y webhooks. El foco declarado está en Latinoamérica, con rails como SPEI, PIX, COELSA, NEQUI/bank transfer, ACH/wire de EE. UU. y soporte adicional documentado para países como Bolivia, Chile, Perú, República Dominicana, Hong Kong/China.

Key Points

  • La API usa autenticación por headers api-key y api-secret; la documentación publica URL base de sandbox y producción, y recomienda Postman para empezar. Las credenciales visibles en ejemplos públicos fueron redactadas en el raw local.
  • Alfred permite crear clientes, completar KYC/KYB por API o iFrame, registrar cuentas fiat, pedir quotes y ejecutar transacciones onramp/offramp.
  • Onramp: fiat local del cliente a USDC/USDT en wallet blockchain; puede usar cuenta virtual/liquidation address para convertir depósitos fiat y enviar stablecoin.
  • Offramp: USDC/USDT desde wallet blockchain a fiat en una cuenta bancaria registrada; con AlfredPayment Manager (APM) pueden gestionar direcciones custodiales rotativas y liquidar a fiat en 3-5 minutos según docs.
  • Rails fiat documentados: USD por ACH/wire, MXN por SPEI, BRL por PIX, COP por NEQUI/bank transfer, ARS por COELSA, HK/China por bank transfer; otras páginas muestran ejemplos para BOB, CLP, DOP y PEN.
  • Redes/activos documentados: USDC en Arbitrum, Base, Ethereum, Optimism, Polygon, Solana y Stellar; ETH en Ethereum; USDT en Ethereum y Tron.
  • Virtual accounts: permiten recibir depósitos locales; México, Argentina y EE. UU. aparecen live in prod; Colombia y Brasil figuran como Q4. Argentina tiene cuenta virtual named by alias; México/USA/Colombia/Brasil no-named según tabla.
  • KYC/KYB: Alfred incluye compliance-as-a-service; los requisitos varían por país. KYC completo es requisito antes de depósitos/retiros; existe KYC Lite en algunos países. KYB iFrame usa Aiprise y recoge business info, address, beneficial owners y documentos corporativos.
  • Webhooks: eventos firmados con HMAC SHA-256 en header signature con timestamp; notifican KYC/KYB, onramp, offramp y refund. Alfred requiere mínimo 10 reintentos con exponential backoff para 4xx/5xx.
  • Estados clave: KYC 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.
  • FAQ: quotes incluyen fees, quote expira en 30 minutos, fiat soporta 2 decimales y crypto 6 decimales, no hay rate limit estricto pero 1 call/segundo es aceptable, los estados finales son ON_CHAIN_COMPLETED y FAILED salvo soporte.

Evidence

  • Overview: “Last Mile Payment solution bridging the gap between Digital Currencies and Cash/Bank accounts”, API REST, KYC, payment methods, quotes, on/off chain money movement and webhooks.
  • Getting Started: sandbox https://penny-api-restricted-dev.alfredpay.io/api/v1/third-party-service/penny, production https://api-service-co.alfredpay.app/api/v1/third-party-service/penny, headers api-key and api-secret.
  • Sending Money with Alfred: products include Payments, Virtual Accounts, Liquidation Address and OTC Trading; transactions are onramps and offramps; first-party and third-party payments are supported.
  • Payment Methods Supported: USD ACH/wire, MXN SPEI, BRL PIX, COP NEQUI/bank transfer, ARG COELSA, HK/China bank transfer; blockchain matrix includes USDC/USDT/ETH over multiple networks.
  • Hosted KYC/KYB and onboarding pages: KYC requirements by country, file uploads, KYC iFrame URL, KYB flow with beneficial ownership and corporate documents.
  • Create a Payment: onramp examples for MXN/BRL/ARS/COP/USD/BOB to stablecoins and offramp examples from USDC to MXN/BRL/ARS/COP/DOP/HKD/CLP/BOB; APM settlement claim of 3-5 minutes.
  • Webhooks page: signature header format, HMAC SHA-256, payload fields referenceId, eventType, status, metadata, retry policy and state tables.
  • FAQs: KYC is required before deposits/withdrawals; reverse quote is available; customer IDs differ by country; webhook setup is mandatory for updates; fees are included in quote.

Open Questions

  • Confirmar contractualmente si Alfred acepta que Landbridge sea verificador primario o si exige KYC/KYB por cliente final en el flujo real de producción.
  • Confirmar jurisdicciones live, límites de trade, fees, SLAs de settlement y cobertura exacta para EE. UU. inmobiliario; la documentación mezcla tablas live/Q4 y ejemplos de países adicionales.
  • Validar licencias/regulación de Alfred y de sus entidades locales para el uso específico: compra inmobiliaria, terceros beneficiarios, importes altos y pagos a title/escrow.
  • Confirmar si Alfred soporta wires directos a title companies/escrow y qué datos de beneficiary/third-party requieren.
  • Confirmar relación técnica real con Fireblocks: las docs públicas no mencionan Fireblocks; esa conexión viene de fuentes internas previas.
  • Definir si Landbridge debe usar APM custodial, non-custodial con originAddress, o Fireblocks como custody/orchestration layer.
  • Raw local: raw/alfred-provider-docs-2026-05-11.md
  • https://alfredpay.readme.io/docs/overview
  • https://alfredpay.readme.io/docs/getting-started
  • https://alfredpay.readme.io/docs/sending-money-with-alfred
  • https://alfredpay.readme.io/docs/payment-methods-supported
  • https://alfredpay.readme.io/docs/user-kyc-onboarding
  • https://alfredpay.readme.io/docs/iframe-kyc-session
  • https://alfredpay.readme.io/docs/hosted-kyc-onboarding-iframe-copy
  • https://alfredpay.readme.io/docs/how-to-create-a-payment
  • https://alfredpay.readme.io/docs/webhooks
  • [[entity-alfred]]
  • [[concept-alfred-api-integration]]
  • [[concept-crypto-to-fiat-settlement-inmobiliario]]