Primeros pasos

Introducción

Qué es Pasarela, cómo funciona un cobro de punta a punta y cómo recibir el primer depósito en minutos.

Pasarela es una pasarela de cobros solo en cripto y sin custodia. Cada usuario de tu empresa recibe una dirección de depósito permanente en Arbitrum que acepta USDT y USDC. Cuando deposita, el servidor lo detecta, te avisa con un webhook firmado y mueve el dinero a tu billetera en una sola transacción, que reparte comisiones y gas. La plataforma nunca guarda tus fondos.

Hoy opera en la red de pruebas

La pasarela funciona en Arbitrum Sepolia (chain id 421614) con tokens de prueba. Todo lo que integres ahí funciona igual en producción. Ver Entornos.

Cómo funciona#

1
Creas un cliente
Con Crear cliente envías tu identificador del usuario (external_id) y recibes su dirección de depósito, una página de pago (pay_url) y un QR (qr_url). La dirección es suya para siempre.
2
El usuario deposita
Envía USDT o USDC a su dirección desde cualquier billetera o exchange que opere en Arbitrum. Puede depositar las veces que quiera, por el monto que quiera.
3
Recibes el aviso
El servidor ve la transferencia (deposit.detected) y, tras unos bloques, la confirma (deposit.confirmed). Ahí acreditas el saldo en tu sistema.
4
El dinero llega a tu billetera
El depósito se barre en una transacción que paga la comisión de la plataforma, tu comisión, el gas si corresponde, y envía el resto a tu tesorería. Recibes deposit.settled con el reparto definitivo.

Por dónde seguir#

Flujo de integración

El paso a paso completo, desde la clave de API hasta la conciliación.

Webhooks

Eventos, reintentos y cómo verificar la firma en Node, Python y PHP.

Comisiones

Cómo se reparte cada depósito, con ejemplos numéricos.

Gas

Quién lo paga, cómo se estima y qué queda garantizado.

Sin custodia

Qué garantiza el contrato y quién puede hacer qué.

Retiros

Paga a tus usuarios en USDT/USDC desde tu caja: fichas a cripto.

Referencia de la API

Todas las rutas, con parámetros y respuestas de ejemplo.

Inicio rápido#

1. Crea un cliente. Usa la clave de API de tu empresa en la cabecera x-api-key.

1curl -X POST https://api.pasarela.hi-g.io/v1/customers \2  -H "x-api-key: sk_test_4f9c…" \3  -H "content-type: application/json" \4  -d '{"external_id": "TARJETA-000123"}'

Respuesta

1{2  "customer": {3    "id": "3d8ed2f2-72d4-4c27-b606-a53b5a4db086",4    "external_id": "TARJETA-000123",5    "address": "0xeB1322F1C80462602A728Ca005f1026709A738ba",6    "chain_id": 421614,7    "network": "Arbitrum Sepolia",8    "tokens": [9      {10        "symbol": "USDT",11        "address": "0xdc190461C20DE36fFB305b0190985B4023D7D183",12        "decimals": 613      },14      {15        "symbol": "USDC",16        "address": "0x928C3C521F85790c4B9b8c37251f4e22186610aE",17        "decimals": 818      }19    ],20    "pay_url": "https://api.pasarela.hi-g.io/pay/3d8ed2f2-72d4-4c27-b606-a53b5a4db086",21    "qr_url": "https://api.pasarela.hi-g.io/pay/3d8ed2f2-72d4-4c27-b606-a53b5a4db086/qr.svg",22    "metadata": {},23    "created_at": "2026-10-13T14:58:41.463Z"24  }25}

2. Muestra el QR. Abre pay_url en el navegador del usuario o inserta qr_url como imagen en tu propia pantalla. El QR sin parámetros contiene la dirección; con ?token=USDT&amount=10 abre la transferencia con el monto ya puesto. Ver Página de pago.

3. Recibe el webhook. Configura tu URL con Actualizar cuenta y acredita cuando llegue deposit.confirmed. Verifica siempre la firma: ver Webhooks.

1curl -X PATCH https://api.pasarela.hi-g.io/v1/me \2  -H "x-api-key: sk_test_4f9c…" \3  -H "content-type: application/json" \4  -d '{"webhook_url": "https://tu-servidor.com/webhooks/pagos"}'