Skip to main content

​
Descripción general

Los pagos cross-chain permiten que tus clientes paguen desde cualquier blockchain soportada, no solo Stellar. Ebioro maneja la conversión automáticamente — los fondos llegan a tu cuenta como USDC en Stellar sin importar desde qué cadena pague el cliente.
Los pagos cross-chain solo están disponibles en el entorno de producción. El sandbox no soporta depósitos cross-chain.

​
Cadenas soportadas

Las rutas y tokens disponibles son dinámicos según la liquidez. Usa el endpoint de rutas para obtener la lista actual.

​
Cómo funciona

​
Flujo de integración

​
Paso 1: Crear un pago

Crea un pago como de costumbre vía POST /payments. Esto te da un checkout_id.

​
Paso 2: Obtener rutas disponibles

Devuelve las cadenas y tokens con los que el cliente puede pagar, filtrados por liquidez actual.

​
Paso 3: Solicitar una cotización

Una vez que el cliente selecciona una cadena/token:
La respuesta incluye:
  • depositAddress — la dirección en la cadena origen donde el cliente envía los fondos
  • amountIn — el monto exacto que el cliente debe enviar
  • deadline — cuándo expira la cotización
  • timeEstimateSeconds — tiempo estimado de completación en segundos

​
Paso 4: El cliente deposita

El cliente envía el monto especificado a la depositAddress en la cadena origen.

​
Paso 5: El pago se completa

Una vez que se detecta el depósito en la cadena origen, el estado del pago cambia a paid y recibes un webhook. La conversión y liquidación ocurren automáticamente en segundo plano.

​
Paso 6: Consultar estado (opcional)

Puedes consultar el estado del swap para actualizaciones en tiempo real:
Devuelve: pending_deposit, processing, completed, failed, o refunded.

​
Autenticación

Los endpoints cross-chain soportan ambos:
  • Digest Auth (headers) — para integración API servidor a servidor
  • Bearer Token (header Authorization) — para uso desde frontend/widget

​
Manejo de errores

Si la conversión cross-chain falla o expira, Ebioro maneja el reembolso a la dirección de recolección internamente. El merchant no necesita tomar acción. Si la cotización expira antes de que el cliente deposite, puedes solicitar una nueva cotización — el pago permanece abierto.