🧪 Pruebas en Sandbox
Guía completa para probar todos los escenarios de pago
Pruebas en Sandbox
El entorno sandbox de Koywe te permite probar todos los flujos de pago con transacciones simuladas antes de ir en vivo.
Entorno Sandbox
URL Base
Todas las solicitudes API de sandbox usan:
Obtener Credenciales de Prueba
Contacta a soporte@koywe.com para recibir:
- API Key de Sandbox
- Secret de Sandbox
- ID de Organización
- ID de Comercio
Sandbox vs Producción: Las credenciales de sandbox están completamente separadas de producción. No se involucra dinero real en las pruebas de sandbox.
Métodos de Pago de Prueba por País
Colombia (COP) 🇨🇴
PSE (Pagos Seguros en Línea)
Bancos de Prueba:
BANCOLOMBIADAVIVIENDABOGOTAOCCIDENTE
Uso:
Comportamiento:
- El enlace de pago es completamente funcional en sandbox
- Sigue el proceso de pago simulado
- Puedes elegir éxito o fallo del pago durante el flujo
- Permite probar la experiencia completa del usuario
Nequi
Uso:
Comportamiento:
- Genera un código QR de prueba
- Después de escanear el código QR, recibirás opciones para éxito o fallo del pago
- Simula la experiencia completa de pago Nequi
Brasil (BRL) 🇧🇷
PIX Estático
Uso:
Comportamiento:
- Genera un código QR de prueba
- Después de escanear el código QR, recibirás opciones para éxito o fallo del pago
- Simula la experiencia completa de pago PIX
PIX Dinámico
Uso:
Comportamiento:
- Genera un código QR de prueba
- Después de escanear el código QR, recibirás opciones para éxito o fallo del pago
- Similar a PIX_STATIC con opciones de prueba interactivas
México (MXN) 🇲🇽
SPEI
Uso:
Comportamiento:
- Proporciona detalles de cuenta bancaria de prueba
- Se completa automáticamente después de la creación de la orden
- Simula confirmación de transferencia bancaria
Tarjetas
Números de Tarjeta de Prueba:
- Éxito:
4242424242424242 - Rechazada:
4000000000000002 - Fondos Insuficientes:
4000000000009995
Uso:
Chile (CLP) 🇨🇱
Khipu
Uso:
Comportamiento:
- El enlace de pago es completamente funcional en sandbox
- Sigue el proceso de pago simulado
- Puedes elegir éxito o fallo del pago durante el flujo
- Permite probar la experiencia completa del usuario
Argentina (ARS) 🇦🇷
Múltiples Métodos Locales
Uso:
Comportamiento:
- El enlace de pago es completamente funcional en sandbox
- Puedes elegir éxito o fallo del pago durante el flujo
Escenarios de Prueba
Pruebas Interactivas: La mayoría de métodos de pago (PSE, Khipu) proporcionan enlaces de pago funcionales donde puedes seguir el proceso de pago simulado y elegir éxito o fallo. Los métodos basados en QR (PIX, Nequi) te dan opciones después de escanear el código.
Flujo de Pago Exitoso
Prueba un pago exitoso de extremo a extremo:
Flujo esperado:
Escenario de Pago Fallido
Prueba el manejo de fallo de pago:
Usa el monto especial de prueba 666 para simular un pago fallido:
Flujo esperado:
Pago Expirado
Prueba la expiración de orden:
Flujo de Enlace de Pago (PAYMENT_LINK)
Prueba la experiencia completa de checkout de marca Koywe:
PAYMENT_LINK es perfecto para e-commerce! Sin contacto o método de pago necesario - solo crea un enlace y compártelo. El cliente ingresa sus propios datos y selecciona su método de pago en el checkout de Koywe.
Probando el flujo de checkout:
- Crea el enlace de pago usando el código anterior
- Copia la
paymentUrl - Ábrela en tu navegador
- Verás la página de checkout de marca Koywe
- Completa información de cliente de prueba
- Selecciona un método de pago
- Completa el pago simulado (elige éxito o fallo)
- Verifica que se reciba la notificación webhook
Caso de Uso: PAYMENT_LINK es ideal para:
- Páginas de checkout e-commerce
- Solicitudes de pago de facturas
- Enlaces de pago vía email/WhatsApp
- Pagos con código QR
- Colecciones de pago rápidas sin almacenar datos del cliente
Probar Webhooks
Configurar Endpoint de Webhook
Usa herramientas de prueba de webhooks:
- webhook.site - URL de webhook instantánea
- ngrok - Túnel a localhost
- RequestBin - Inspector de webhooks
Usar webhook.site
Eventos de Webhook Esperados
Para un PAYIN exitoso:
order.created- Orden es creadaorder.pending- Esperando pagoorder.processing- Pago siendo procesadoorder.paid- Pago confirmadoorder.completed- Fondos acreditados
Ejemplo de Payload de Webhook
Datos de Prueba
Contactos de Prueba
Usa estos números de documento de prueba (todos válidos en sandbox):
Colombia
Brasil
México
Chile
Cuentas Bancarias de Prueba
Para pruebas de PAYOUT:
Colombia
Brasil
México
Chile
Probar Operaciones Cripto
Selección Automática de Red de Prueba
Nombres de Red de Producción en Sandbox: Al usar nombres de red de producción como ETHEREUM, POLYGON o BSC en sandbox, el sistema automáticamente redirige a redes de prueba (Sepolia, Amoy, BSC Testnet respectivamente). No necesitas especificar nombres de testnet explícitamente.
Redes de Prueba
Sandbox usa automáticamente estas testnets:
Ejemplo: Especifica "network": "POLYGON" en tu solicitud, y sandbox usará Amoy automáticamente.
Dirección de Billetera de Prueba
Usa esta dirección para recibir cripto de prueba:
Nunca uses direcciones de producción en sandbox - Siempre usa direcciones de prueba/quema como la dirección cero arriba.
Prueba ONRAMP
Prueba OFFRAMP
Límites de Tasa
El entorno sandbox tiene los siguientes límites:
Encabezados de límite de tasa están incluidos en todas las respuestas:
X-RateLimit-Limit: Total de solicitudes permitidasX-RateLimit-Remaining: Solicitudes restantesX-RateLimit-Reset: Timestamp Unix cuando se reinicia el límite
Mejores Prácticas de Prueba
Prueba Todos los Tipos de Orden
Prueba cada tipo de orden:
- ✅ PAYIN con diferentes métodos de pago
- ✅ PAYOUT a diferentes países
- ✅ BALANCE_TRANSFER entre monedas
- ✅ ONRAMP para compras de cripto
- ✅ OFFRAMP para ventas de cripto
- ✅ PAYMENT_LINK con vencimiento
Prueba Escenarios de Error
Prueba manejo de errores:
- ✅ Credenciales API inválidas
- ✅ Saldo insuficiente para PAYOUT
- ✅ Detalles de cuenta bancaria inválidos
- ✅ Cotizaciones expiradas
- ✅ Pagos fallidos (monto: 666)
- ✅ Verificación de firma de webhook
Prueba Idempotencia
Flujos de Trabajo de Prueba Comunes
Flujo de Checkout E-Commerce
Pasar a Producción
Cuando estés listo para ir en vivo:
Solicitar Credenciales de Producción
Contacta a soporte@koywe.com para credenciales de producción API key y secret
Actualizar Credenciales
Reemplaza credenciales de sandbox con credenciales de producción en tus variables de entorno
Lista de Verificación de Producción
- Credenciales de producción API obtenidas
- URL base actualizada a producción
- URLs de webhook apuntando a servidores de producción
- Verificación de firma de webhook implementada
- Manejo de errores probado
- Logging y monitoreo configurado
- Transacción de prueba pequeña exitosa
- Equipo capacitado en procesos de producción
¿Necesitas Ayuda?
soporte@koywe.com
Para problemas de acceso a sandbox o preguntas de pruebas
Problemas comunes y soluciones
Documentación completa de API
Guía de integración de 5 minutos