Andorpay
Navegación de la documentación

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

EscenarioTarjetaCaducidadCVV
VISA genérica · EMV3DS 2.2454881000000000312/49123
Autorización sin challenge · EMV3DS 2.1454881447972722912/49123
Autorización con challenge · EMV3DS 2.1454881721249301712/49123
Rechazo · autenticar con éxito en el simulador454881000000000312/49999

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. 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. 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. 3

    Autoriza el dominio

    Redsys inSite debe permitir el origen HTTPS exacto donde se carga el formulario de tarjeta.
  4. 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

CasoResultado esperado
Firma válidaEl endpoint acepta el cuerpo exacto y devuelve 2xx.
Firma modificadaDevuelve 400 antes de interpretar o aplicar el evento.
Marca temporal antiguaRechaza una diferencia superior a 5 minutos.
Respuesta 500AndorPay conserva event.id y programa una reentrega.
Evento repetidoReconoce event.id y no repite el efecto de negocio.
Eventos fuera de ordenDecide 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:

CasoResultado esperado
Alta y primera operaciónRelaciona cliente, consentimiento, referencia de pago y suscripción.
Renovación posteriorVerifica una operación MIT y el periodo al que corresponde, sin repetir la compra inicial.
Renovación rechazada o pendienteNo amplíes el acceso como si estuviera pagado; resuelve el estado antes de otro cargo.
Notificación repetidaUn mismo pago no amplía dos veces el periodo ni duplica la entrega.
BajaComprueba 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

WhatsApp