← Blog
10 min de lectura
|
Publicado
|
Actualizado

API blockchain para finanzas: qué hace y qué no

Qué aporta una API blockchain a equipos de pagos y finanzas: wallets, transferencias y webhooks de depósito, y qué no cubre, como KYC e informes regulatorios.

Capítulos
C
Chaingateway Team
Expertos en blockchain

Revisado por Maurice Sobiera

Una API blockchain para finanzas es una interfaz REST que permite al backend de una empresa crear wallets, enviar transacciones y recibir avisos de depósito en blockchains públicas sin ejecutar nodos propios. Chaingateway la ofrece para Bitcoin, Ethereum, BNB Smart Chain, Tron, Solana, Polygon y Arbitrum. Mueve valor en la cadena. No sustituye los procesos de cumplimiento.

¿Qué problema financiero puede abordar una API blockchain?

Una API blockchain aborda la parte técnica de mover valor en la cadena: wallets, transferencias y confirmación de los pagos entrantes. Los pagos transfronterizos son una motivación habitual. El Financial Stability Board (FSB) describe los objetivos que el G20 fijó para ellos en su informe de hoja de ruta.

SegmentoObjetivo de costeObjetivo de velocidad (a finales de 2027)
Pagos minoristasCoste medio de como máximo el 1 por ciento, ningún corredor por encima del 3 por ciento, a finales de 2027El 75 por ciento de los pagos disponible para el destinatario en una hora
RemesasCoste medio de enviar 200 $ de como máximo el 3 por ciento en 2030, ningún corredor por encima del 5 por cientoEl 75 por ciento de los pagos disponible en una hora
MayoristaSin objetivo fijadoEl 75 por ciento abonado en una hora

Una transferencia en la cadena es una vía técnica para acercarse a los objetivos de velocidad, porque una transacción confirmada se liquida entre las dos wallets sin bancos intermediarios. Los objetivos de coste dependen de más cosas que la transferencia. Cuentan las comisiones de red, la conversión desde y hacia la moneda local y las licencias de las partes implicadas. Una API no elimina ninguna de ellas. Trate cualquier afirmación sobre ahorro de costes como algo que debe medir en su propio flujo.

¿Qué hace la API?

La API de Chaingateway cubre los pasos de un flujo de pago en la cadena mediante endpoints HTTP. Usted se autentica con un bearer token, y una cabecera de la solicitud selecciona mainnet o testnet.

  • Crear y gestionar direcciones, por ejemplo con POST /api/v2/ethereum/addresses, y consultar saldos.
  • Enviar monedas nativas y tokens, por ejemplo con POST /api/v2/tron/transactions/trc20 o los endpoints ERC-20.
  • Consultar transacciones y recibos.
  • Registrar webhooks que avisan a su endpoint cuando una dirección supervisada recibe una transacción.

Los webhooks están disponibles en Bitcoin, Ethereum, BNB Smart Chain, Tron, Polygon y Arbitrum. Solana no tiene webhooks, así que allí los depósitos se detectan consultando transacciones. Las notificaciones de webhook no se reintentan automáticamente. Las notificaciones fallidas se listan y puede pedir que se envíen de nuevo, por lo que su sistema también debe conciliar con la API. El artículo sobre las garantías de entrega de webhooks explica cómo diseñar para ello.

Chaingateway no es custodial, de modo que el servicio no retiene sus fondos.

¿Cómo es un flujo de pago de principio a fin?

Un flujo de depósito tiene cinco pasos, y cada uno corresponde a una llamada a la API.

  1. Cree una dirección para el cliente o el pedido con POST /api/v2/{chain}/addresses. En Bitcoin el recurso se llama wallets.
  2. Registre un webhook para esa dirección con POST /api/v2/{chain}/webhooks, antes de que el cliente pague.
  3. Reciba la notificación en su endpoint y verifique su cabecera X-Signature.
  4. Confirme la transacción con la API y acredite el pedido tras suficientes confirmaciones.
  5. Mueva los fondos a su propia wallet de tesorería con un endpoint de transferencia, por ejemplo POST /api/v2/ethereum/transactions/erc20.

La tabla muestra dónde está disponible este flujo. El segmento de ruta {chain} es uno de bitcoin, ethereum, bsc, tron, polygon, arbitrum o solana.

RedDirecciones y transferenciasWebhooks
BitcoinSíSí
EthereumSíSí
BNB Smart ChainSíSí
TronSíSí
PolygonSíSí
ArbitrumSíSí
SolanaSíNo

¿Una API blockchain se encarga del cumplimiento normativo?

No. Una API no realiza KYC, cribado de sanciones ni informes regulatorios. Esas obligaciones siguen correspondiendo a la empresa que ofrece el servicio, y cuáles se aplican depende de su modelo de negocio y de su jurisdicción. Nuestro artículo sobre el KYC en pagos con criptomonedas describe las comprobaciones que conviene resolver antes de integrar.

Lo que sí aporta la cadena es un registro. El National Institute of Standards and Technology (NIST) de EE. UU. explica en NISTIR 8202 que los usuarios de Bitcoin son seudónimos: no se nombra a la persona detrás de una cuenta, pero los identificadores de cuenta son visibles y todas las transacciones son públicas. Sus registros pueden referenciar hashes de transacción que cualquiera puede verificar. Vincular una dirección a un cliente es algo que debe hacer su propio proceso de alta.

NIST también afirma que las blockchains son evidentes ante manipulaciones y resistentes a ellas, pero no completamente inmutables. Los bloques más recientes pueden ser reemplazados por una cadena competidora más larga. Por eso la mayoría de los usuarios espera varias confirmaciones de bloque antes de considerar un pago definitivo. Decida el número de confirmaciones que exige su política de riesgo y acredite a los clientes solo a partir de ese punto.

¿Cómo empiezo?

Empiece en una testnet. Añada la cabecera X-Network: testnet a sus solicitudes para usar las redes de prueba, cree una dirección, envíe una transferencia pequeña y registre un webhook para ver llegar una notificación. Chaingateway tiene una prueba gratuita de 7 días que no requiere tarjeta ni verificación de identidad para empezar. Los planes de pago empiezan en 49 € al mes o 490 € al año.

Para un plan de construcción práctico, lea cómo crear una wallet de criptomonedas con una API y cómo funcionan los webhooks de pagos con criptomonedas.

Cómo escribimos estos artículos

¿Listo para construirlo tú mismo? Obtenga su clave de API — prueba de 7 días, sin tarjeta — o consulte API Blockchain para la referencia completa de los endpoints.

C
Chaingateway Team
Expertos en blockchain

El equipo de Chaingateway se dedica a simplificar la integración blockchain para desarrolladores de todo el mundo.