Skip to main content

​
Registro

Para acceder a la plataforma completa el formulario de registro que se encuentra en la siguiente página de registro.
Si ya completaste el registro. Asegúrate de verificar tu cuenta. Si aún no lo has hecho, dirígete al apartado de verificación.

​
Configura tus llaves

  1. Ingresa a Perfil → Desarrolladores → API Keys.
  2. Genera una llave Secret y una Public para el ambiente test.
  3. Guarda las llaves en tu gestor de secretos. Nunca las publiques en repositorios.

​
Realiza tu primer cobro

  1. Desde el panel crea un cliente de prueba o usa el endpoint POST /customers.
  2. Registra un método de pago sandbox siguiendo la guía de tarjetas de prueba.
  3. Crea un cobro rápido con POST /payments o genera un link desde la consola.
  4. Abre el link, aprueba el pago con los datos de prueba y verifica el resultado en el dashboard.

​
Activa webhooks

  • Dirígete a Desarrolladores → Webhooks y registra la URL de tu servidor.
  • Copia el secreto generado; lo necesitarás para validar la firma (x-onepay-signature).
  • Responde 200 OK para confirmar la recepción de cada evento.

​
Checklist para ir a producción

  • Subiste la documentación legal en Configuración → Información de la compañía.
  • Probaste los casos de éxito, error e idempotencia en ambiente test.
  • Configuraste alertas en tus webhooks y monitoreas event.id para evitar duplicados.
  • Activaste los métodos de pago que usarás en vivo.