Saltar al contenido principal

SDKs & Libraries

Acelera tu integración utilizando los SDK oficiales para TypeScript, Python, Go, PHP, Java, Kotlin, C#, Ruby y React Native. Estas bibliotecas simplifican las solicitudes a la API, la autenticación y el manejo de errores, permitiéndote centrarte en crear excelentes experiencias de pago.

​
URLs del Entorno

Obtén más información sobre Modo de prueba vs Modo en vivo.

​
Gestión de Claves API y Autenticación

1

Access API Keys

Navega a Developer → API Keys en tu panel para administrar tus claves.
2

Generate a New Key

Selecciona Add API Key, proporciona un nombre descriptivo y configura el acceso de escritura:
  • Habilitar acceso de escritura (marcado): Permisos de lectura y escritura completos para todas las operaciones de la API
  • Habilitar acceso de escritura (desmarcado): Acceso solo de lectura - solo se puede obtener datos (pagos, suscripciones, clientes, productos). No se pueden crear ni modificar recursos.
Desmarca “Enable write access” para integraciones de panel, herramientas analíticas y cualquier sistema que solo necesite ver datos sin realizar cambios.
3

Store Your Key Securely

Copia la clave generada de inmediato y asegúrate de almacenarla de forma segura.
4

Authenticate Your API Requests

Utiliza tus claves API para autenticar todas las solicitudes. Aplica el siguiente formato de autorización:
Authorization: Bearer YOUR_API_KEY
Nunca expongas tus claves API secretas en código del lado del cliente o repositorios públicos.

​
Formato de Respuesta

{
  "id": "pay_1234567890",
  "status": "completed",
  "amount": 2999,
  "currency": "USD",
  "created_at": "2024-01-15T10:30:00Z"
}

​
Límites de Tasa

Nuestra API utiliza un sistema de limitación de tasa de doble ventana con protección contra ráfagas. Los límites se aplican según tu método de autenticación y nivel comercial.

​
Límites predeterminados (Nivel 0)

VentanaLímite
Por segundo (ráfaga)40 solicitudes
Por minuto (sostenido)240 solicitudes

​
Niveles de negocio

Están disponibles límites de tasa más altos para empresas con mayores necesidades de API:
NivelRáfaga (por segundo)Sostenido (por minuto)
Nivel 0 (predeterminado)40240
Nivel 11001,000
Nivel 25005,000
Contacta al soporte para actualizar tu negocio a un nivel de límite de tasa superior.

​
Solicitudes no autenticadas

Las solicitudes sin encabezados de autenticación válidos se limitan por dirección IP:
VentanaLímite
Por segundo (ráfaga)20 solicitudes
Por minuto (sostenido)100 solicitudes

​
Encabezados de límite de tasa

Supervisa tu uso con estos encabezados de respuesta:
  • X-RateLimit-Limit - Máximo de solicitudes permitidas
  • X-RateLimit-Remaining - Solicitudes restantes en la ventana actual
  • X-RateLimit-Reset - Momento en que se restablece el límite de tasa
Cuando superas los límites de tasa, la API devuelve una respuesta 429 Too Many Requests. Implementa retroceso exponencial en tu lógica de reintento.

​
Manejo de errores

Para gestionar errores de manera efectiva, consulta las secciones Códigos de error y Fallos de transacción para obtener orientación detallada.

Error Codes

Profundiza en los detalles completos de los errores y sus resoluciones.

Transaction Failures

Obtén información sobre problemas comunes de transacciones y sus soluciones.

​
Webhooks

Recibe notificaciones en tiempo real sobre eventos de pago. Consulta nuestra Guía de Webhooks para obtener instrucciones de configuración.

Webhook Guide

Configura webhooks para notificaciones en tiempo real y manejo de eventos.