Testing y Sandbox

Usa nuestro entorno sandbox para probar tu integración antes de ir a producción. Prueba con transacciones blockchain reales en testnet—no se requieren criptomonedas reales.

Modo Testnet

El modo sandbox se habilita automáticamente cuando se usan claves API de prueba:

Prefijo de Clave	Entorno	Red
`pk_test_, sk_test_`	Sandbox	Bitcoin Testnet, Ethereum Sepolia
`pk_live_, sk_live_`	Producción	Bitcoin Mainnet, Ethereum Mainnet

Obtener Monedas de Prueba

Necesitarás monedas testnet para simular pagos:

Bitcoin Testnet

Busca 'Bitcoin testnet faucet' para tBTC gratis

Sepolia ETH

Usa Alchemy, Infura u otros faucets de Sepolia

Stablecoin Testnet

Contacta soporte para USDT/USDC testnet

Simular Pagos

Crear Checkout de Prueba
Usa tu clave pública de prueba para crear una sesión de checkout
Abrir Checkout
Completa el flujo de checkout como lo haría un cliente
Enviar Pago de Prueba
Usa una billetera testnet para enviar el monto exacto
Verificar Webhook
Confirma que tu manejador de webhook recibe los eventos de prueba

Testing de Webhook

Para desarrollo local, expón tu endpoint de webhook:

Usa ngrok o similar para crear una URL pública
Configura la URL pública en los ajustes de SanPay
Monitorea las solicitudes entrantes en tus logs locales

Lista de Verificación Pre-Producción

✅ Crea pago y recibe webhook PAYMENT_CONFIRMED
✅ Maneja PAYMENT_EXPIRED correctamente
✅ Verifica que la validación de firma webhook funcione
✅ Prueba escenarios de subpago y sobrepago
✅ Confirma que el estado del pedido se actualice correctamente
✅ Prueba manejo de errores y mensajes al usuario