Acceso a Sandbox

El ambiente Sandbox de Aloha Pay te permite desarrollar y probar tu integración sin procesar transacciones reales. Es el primer paso recomendado antes de pasar a producción.

¿Por qué usar Sandbox?

Utilizar el ambiente de pruebas es fundamental por varias razones:

Sin riesgo financiero

Realiza todas las pruebas necesarias sin procesar pagos reales ni afectar dinero de clientes.

Desarrollo seguro

Experimenta con la API, prueba diferentes escenarios y corrige errores sin consecuencias.

Validación completa

Verifica que tu integración funcione correctamente antes de ir a producción.

Pruebas de flujo

Simula el flujo completo de pago incluyendo webhooks y confirmaciones.

Beneficios adicionales

• Prueba webhooks: Configura y valida que tus endpoints reciban correctamente las notificaciones
• Simula errores: Prueba cómo tu aplicación maneja diferentes escenarios de error
• Itera rápidamente: Desarrolla y ajusta tu integración sin preocuparte por transacciones reales
• Capacita a tu equipo: Permite que tu equipo se familiarice con la plataforma de forma segura

Solicitar acceso

Para obtener una cuenta en el ambiente Sandbox de Aloha Pay, completa el siguiente formulario:

Solicitar acceso al Sandbox

Tiempo de respuesta

Recibirás tus credenciales de acceso en un lapso de 24 horas hábiles.

URLs del ambiente Sandbox

Una vez que tengas tus credenciales, utiliza las siguientes URLs para acceder al ambiente de pruebas:

Servicio	URL
Dashboard (App Web)	https://app-dev.alohapay.co
API	https://api-dev.alohapay.co

Configuración en tu código

Cuando uses el Embedded Checkout, activa el modo sandbox:

AlohaPay.create({
  apiKey: 'tu_api_key_sandbox',
  container: '#checkout',
  amount: 10000,
  useSandbox: true  // Activa el ambiente de pruebas
});

Para llamadas directas a la API, usa la URL de sandbox:

curl -X GET "https://api-dev.alohapay.co/api/external/v1/payment-methods" \
  -H "X-API-KEY: tu_api_key_sandbox"

Diferencias entre Sandbox y Producción

Aspecto	Sandbox	Producción
Transacciones	Simuladas	Reales
Dinero	No se procesa	Se procesa dinero real
API URL	api-dev.alohapay.co	api.alohapay.co
Dashboard	app-dev.alohapay.co	app.alohapay.co
Propósito	Desarrollo y pruebas	Operación real

Pasar a Producción

Una vez que hayas validado tu integración en Sandbox:

1. Solicita tus credenciales de producción
2. Actualiza las URLs en tu configuración
3. Cambia useSandbox: false o elimina el parámetro
4. Realiza una transacción de prueba con un monto pequeño
5. Verifica que los webhooks lleguen correctamente

Ejemplo de cambios en el código

Embedded Checkout:

// Sandbox
AlohaPay.create({
  apiKey: 'tu_api_key_sandbox',
  container: '#checkout',
  amount: 10000,
  useSandbox: true
});

// Producción
AlohaPay.create({
  apiKey: 'tu_api_key_produccion',
  container: '#checkout',
  amount: 10000
  // useSandbox se omite o se establece en false
});

Llamadas directas a la API:

# Sandbox
curl -X GET "https://api-dev.alohapay.co/api/external/v1/payment-methods" \
  -H "X-API-KEY: tu_api_key_sandbox"

# Producción - cambia api-dev por api
curl -X GET "https://api.alohapay.co/api/external/v1/payment-methods" \
  -H "X-API-KEY: tu_api_key_produccion"

Importante

Nunca uses credenciales de producción para pruebas de desarrollo. Siempre utiliza el ambiente Sandbox para evitar procesar transacciones reales accidentalmente.