Saltar al contenido principal

SDKs y Bibliotecas

Acelera tu integración utilizando SDKs 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 concentrarte en crear grandes experiencias de pago.

​
URLs del Entorno

Aprende más sobre Modo de Prueba vs Modo en Vivo.

​
Gestión de Claves API y Autenticación

1

Acceder a las Claves API

Navega a Desarrollador → Claves API en tu panel para gestionar tus claves.
2

Generar una Nueva Clave

Selecciona Agregar Clave API, 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 “Habilitar acceso de escritura” para integraciones de panel, herramientas de análisis y cualquier sistema que solo necesite ver datos sin realizar cambios.
3

Almacena Tu Clave de Forma Segura

Copia la clave generada de inmediato y asegúrate de que se almacene de forma segura.
4

Autentica Tus Solicitudes API

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 en 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

  • Estándar: 1000 solicitudes por minuto por negocio
  • Ráfaga: Hasta 100 solicitudes por segundo
Monitorea el encabezado X-RateLimit-Remaining para rastrear el uso.

​
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.

Códigos de Error

Profundiza en los detalles de errores y sus resoluciones.

Fallos de Transacción

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

​
Webhooks

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

Guía de Webhooks

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