# Información general

> Especificación técnica para integrar el procesamiento de pagos en criptomonedas y los retiros con 2328.io.

Te damos la bienvenida a la documentación de la API de 2328.io. Esta referencia describe cómo integrar el procesamiento de pagos en criptomonedas y los retiros en tu aplicación.

## Primeros pasos

Para comenzar la integración:

1. Crea una cuenta de comerciante y un proyecto en [2328.io](https://2328.io)
2. Obtén el **UUID del proyecto** y la **API key** desde la configuración del proyecto
3. Genera una **Payout API key** independiente si planeas usar retiros
4. Lee la sección [Authentication](/docs/authentication) para aprender a firmar las solicitudes
5. Realiza tu primera llamada [Create Payment](/docs/payments)

## URL base

Todas las solicitudes de la API en producción utilizan la siguiente URL base:

```
https://api.2328.io/api
```

> **WARNING:** Todas las solicitudes deben realizarse a través de **HTTPS**. Las solicitudes sin HTTPS son bloqueadas.

## Qué puedes hacer

Con la API de 2328.io puedes:

- **Aceptar pagos en cripto** — crear sesiones de pago y redirigir a los clientes a un checkout alojado o a un Telegram MiniApp
- **Retirar fondos** — enviar retiros mediante programación desde tu saldo de comerciante a cualquier dirección blockchain
- **Consultar saldos** — los saldos de cuentas del comerciante por divisa, sus equivalentes en USD y los montos bloqueados por AML
- **Usar monederos estáticos** — generar direcciones de depósito permanentes vinculadas a un usuario o pedido
- **Obtener tipos de cambio** — consultar tipos de cambio en tiempo real para pares fiat y cripto
- **Recibir webhooks** — recibir notificaciones al instante cuando cambia el estado de un pago
## Límites de tasa

La API permite hasta **10 solicitudes por segundo por proyecto**. Las solicitudes que superen el límite reciben una respuesta HTTP `429 Too Many Requests` — aplica backoff y reintenta.