Documentación para desarrolladores
Tarjetas de prueba Redsys y guía de sandbox
Valida tu integración con las tarjetas de prueba de Redsys y credenciales propias de sandbox. Comprueba el resultado bancario, el pedido y la entrega, además de lo que ve el comprador.
Tarjetas de prueba Redsys: número, caducidad y CVV
| Escenario | Tarjeta | Caducidad | CVV |
|---|---|---|---|
| VISA genérica · EMV3DS 2.2 | 4548810000000003 | 12/49 | 123 |
| Autorización sin challenge · EMV3DS 2.1 | 4548814479727229 | 12/49 | 123 |
| Autorización con challenge · EMV3DS 2.1 | 4548817212493017 | 12/49 | 123 |
| Rechazo · autenticar con éxito en el simulador | 4548810000000003 | 12/49 | 999 |
12/49 es una caducidad de ejemplo; Redsys admite una fecha futura. El CVV 999 simula una denegación con la tarjeta genérica. Completa la autenticación correctamente en el simulador para comprobar ese rechazo.
Tarjetas y entornos de prueba oficiales de Redsys
Prueba también abandono del challenge, recarga y retorno tardío. Ante un resultado incierto, consulta la operación existente antes de solicitar otro cobro.
Preparar el entorno de pruebas
- 1
Configura tu cuenta Redsys de pruebas
Guarda el FUC, terminal y secreto de sandbox facilitados para tu TPV. Las credenciales productivas son distintas. La cuenta de demostración genérica de Redsys no sustituye la activación de inSite para tu comercio. - 2
Genera una clave ap_test_
La API key fija el entorno de cada checkout al crearlo. No reutilices una clave ap_live_ durante las pruebas. - 3
Autoriza el dominio
Redsys inSite debe permitir el origen HTTPS exacto donde se carga el formulario de tarjeta. - 4
Configura el webhook
Utiliza una URL pública HTTPS y conserva el secreto de firma de sandbox en el servidor.
Probar Bizum
En el sandbox utilizado por nuestra integración, usa el móvil 700 000 000 (+34700000000). Un importe inferior a 5 € autoriza, entre 5 € y 10 € rechaza y por encima de 10 € no admite la prueba. Confirma las condiciones del entorno asignado a tu terminal.
Verifica autorización en la app bancaria, rechazo, abandono y callback tardío. Bizum requiere RTP habilitado por el banco; AndorPay no cambia automáticamente a una redirección clásica si RTP no está disponible.
Probar Apple Pay y Google Pay
Apple Pay
Apple Sandbox permite validar la hoja de pago, la elegibilidad y la sesión del comercio en Safari y un dispositivo compatible. El sandbox Redsys ordinario puede rechazar X-PAY. La autorización completa requiere el entorno de certificación acordado con Redsys o tu banco.
Google Pay
En Configuración → Raíles → Redsys, selecciona Pruebas, activa Google Pay y guarda. La selección se conserva por entorno: activarlo en pruebas no lo activa en producción.
La integración utiliza Google TEST y gateway=redsys. La hoja puede abrirse sin un merchant ID productivo, pero la autorización requiere X-PAY habilitado en el terminal y una tarjeta compatible con CRYPTOGRAM_3DS.
Probar webhooks y evitar efectos duplicados
| Caso | Resultado esperado |
|---|---|
| Firma válida | El endpoint acepta el cuerpo exacto y devuelve 2xx. |
| Firma modificada | Devuelve 400 antes de interpretar o aplicar el evento. |
| Marca temporal antigua | Rechaza una diferencia superior a 5 minutos. |
| Respuesta 500 | AndorPay conserva event.id y programa una reentrega. |
| Evento repetido | Reconoce event.id y no repite el efecto de negocio. |
| Eventos fuera de orden | Decide según contenido y estado, no solo por orden de llegada. |
Probar pagos recurrentes con Redsys
Un primer pago correcto no valida una suscripción completa. Con tokenización y recurrencia habilitadas en el terminal de pruebas, comprueba también lo siguiente:
| Caso | Resultado esperado |
|---|---|
| Alta y primera operación | Relaciona cliente, consentimiento, referencia de pago y suscripción. |
| Renovación posterior | Verifica una operación MIT y el periodo al que corresponde, sin repetir la compra inicial. |
| Renovación rechazada o pendiente | No amplíes el acceso como si estuviera pagado; resuelve el estado antes de otro cargo. |
| Notificación repetida | Un mismo pago no amplía dos veces el periodo ni duplica la entrega. |
| Baja | Comprueba la fecha de efecto y que no quede programado un cargo posterior a la baja efectiva. |
Requisitos y funcionamiento de los pagos recurrentes en Andorra
Criterios para cerrar las pruebas
Una autorización y un rechazo deben producir estados coherentes en Redsys, AndorPay y tu aplicación. El webhook válido activa una sola vez el efecto esperado; la firma inválida no lo activa; un pago pendiente no provoca un segundo cobro a ciegas.
Repite el recorrido en escritorio y móvil. Conserva request_id, event.id y la referencia interna del pedido, sin registrar API keys, secretos, PAN, caducidad ni CVV.
Siguientes pasos
Documentación técnica adicional en español: Firma y reintentos de webhooks · Paso a producción