Sign in
Introducción/Información general

Información general

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

Ver como Markdown·llms.txt

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
  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 para aprender a firmar las solicitudes
  5. Realiza tu primera llamada Create Payment

URL base

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

Text
https://api.2328.io/api

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.