Skip to Content
EmpezarIntroducción
View as Markdown

Introducción

La forma de un pago

Un comerciante integrando InfraIO Pay trata con cuatro piezas en movimiento:

Sesión de checkout

Creas una sesión en el lado del servidor con artículos de línea y totales. La respuesta lleva una session_key (cst_…) y una checkout_url. Las sesiones tienen límite de tiempo (por defecto 30 minutos) y son de un solo uso.

Página de checkout alojada

Cargas nuestro SDK de navegador y abres la sesión: popup, redirect o iframe incrustado. El comprador elige una combinación cadena × activo (USDT en Polygon, ETH en Base, …), ve una dirección de depósito generada + QR, y envía fondos desde su wallet.

Confirmación de pago

InfraIO Pay vigila la red relevante para transferencias entrantes que coincidan con la dirección de depósito por pedido (CREATE2) de la sesión. Una vez que se alcanza el número de confirmaciones configurado (p. ej. 12 en Ethereum mainnet, 5 en Polygon: ver Cadenas y activos), el PaymentIntent subyacente se mueve a SETTLED y la Orden padre se mueve a PAID.

En TRON, Solana y TON no hay dirección de depósito. La wallet del comprador paga directamente a tu wallet de Tesorería (TronLink, un QR de Solana Pay o TON Connect) e InfraIO Pay reconoce ese pago. Ver Cadenas y activos.

Los pagos van directo a tus wallets de Tesorería — InfraIO Pay nunca retiene tus fondos.

Webhook

Enviamos (mediante POST) un evento firmado payment.settled a tu URL de webhook registrada. Tu servidor verifica la firma, busca la orden y procede con el cumplimiento del pedido.

El modelo de datos en un diagrama

CheckoutSession  ←  1:1  →  Order  ←  1:N  →  PaymentIntent
   (con límite de tiempo)       (permanente)       (uno por intento)

Piensas en Órdenes para el cumplimiento del pedido, creas Sesiones para cobrar pago, y el sistema gestiona PaymentIntents detrás de escena para reintentos y selección de red.

Lo que manejamos vs. lo que manejas tú

InfraIO Pay manejaTú manejas
UI de checkout alojado (dirección de depósito, QR, selector de activos)Creación de catálogo + Orden en tu DB
Monitorización de cadena + lógica de confirmación a través de 8 cadenas EVM más TRON, Solana y TON (próximamente)Receptor de webhook + verificación de firma
Checkout multi-activo de stablecoins (USDT, USDC por red)Mapeo de nuestro order_id ↔ tu ID de orden vía external_ref
Contabilidad de reembolsos (máquina de estados, dashboard, API)Firma + difusión de la tx de reembolso on-chain
Claves de modo de prueba + webhooks de prueba aisladosFinanciación de wallets testnet desde faucets

No tenemos custodia de los fondos del comerciante. Las transferencias comprador-a-comerciante ocurren directamente on-chain; nosotros somos la capa de indexador + reconciliación que te dice cuándo se confirmó la transferencia.

Modo de prueba vs modo live

Cada cuenta empieza en modo de prueba. Las claves de prueba llevan prefijo pk_test_ / sk_test_. Las claves live (pk_live_ / sk_live_) están disponibles después de completar la verificación de la cuenta y añadir una wallet de Tesorería para cada red en la que quieres recibir (firmas un mensaje para demostrar que la controlas).

La misma URL base de la API sirve ambas: el entorno se determina por el prefijo de la clave, no por la URL. El modo de prueba corre contra testnets reales (Sepolia, Base Sepolia, BSC Testnet, etc.): no hay cadena simulada. Para disparar un pago de prueba necesitas fondos testnet reales desde un faucet.

Contacto / soporte

¿Preguntas o necesitas ayuda? Escribe a [email protected].

Lo que InfraIO Pay no es

  • No es un custodio. Los fondos se mueven del comprador a tu wallet de Tesorería on-chain directamente. Nunca tenemos tu saldo.
  • No requiere una wallet nuestra. Los clientes pagan desde su propia wallet (el checkout alojado tiene una opción WalletConnect integrada). InfraIO Wallet es una wallet con passkey independiente y sin custodia, y no es obligatoria.
  • No es una pasarela fiat-cripto. Los compradores pagan en el activo cripto que tienen; no convertimos.
  • No es un gateway de Bitcoin. Stablecoins en 8 redes EVM más TRON, Solana y TON (próximamente); sin Bitcoin ni Lightning. Ver Cadenas y activos para la matriz vigente.

Qué sigue

BienvenidoInicio rápido