Documentación para desarrolladores
WooCommerce
El plugin oficial conecta la tienda, presenta cuatro métodos de pago y concilia pedidos sin exponer la API key al navegador.
Antes de empezar
| Requisito | Versión o condición |
|---|---|
| WordPress | 6.4 o posterior |
| WooCommerce | 8.0 o posterior |
| PHP | 7.4 o posterior |
| Moneda | EUR |
| Tienda | HTTPS público, REST API accesible y WP-Cron o cron real |
| Inventario | Reserva desactivada o configurada durante al menos 30 minutos |
Tarjeta requiere Redsys inSite. Bizum requiere RTP. Apple Pay y Google Pay requieren X-PAY y la configuración correspondiente del banco y de cada wallet.
Configuración
AndorPay Payments for WooCommerce 0.6.7
SHA-256 aea21c11ba71c5f809202bd482a43a1cc39fc7fa4396ce8fdbb0c4cf079b465d
Descargar plugin 0.6.7- 1
Instala el ZIP
En WordPress abre Plugins, Añadir plugin, Subir plugin. Selecciona el archivo completo, instala y activa. - 2
Abre AndorPay Card
En WooCommerce, Ajustes, Pagos, abre AndorPay Card. Esta pantalla comparte la conexión con los otros métodos. - 3
Configura las URLs
Usa https://api.andorpay.com para la API y https://shop.andorpay.com para el checkout público. - 4
Guarda una clave ap_test_
El plugin autentica el entorno, crea su identidad privada y registra la conciliación automáticamente. - 5
Activa los métodos disponibles
Habilita sólo Tarjeta, Bizum, Apple Pay o Google Pay que AndorPay y el banco declaren disponibles para el TPV.
Crear un pago
El comprador elige un método en el checkout normal de WooCommerce y pulsa su único botón para realizar el pedido. Tarjeta carga los campos seguros de Redsys dentro del iframe de AndorPay. WordPress no recibe PAN, caducidad, CVV ni el idOper de Redsys.
| Método | Experiencia |
|---|---|
| Tarjeta | Campos inSite embebidos, con 3DS dentro de AndorPay cuando Redsys lo requiere. |
| Bizum | El móvil se introduce en WooCommerce y la autorización RTP termina en la app bancaria. |
| Apple Pay | Safari presenta la hoja nativa cuando comercio, dispositivo y tarjeta son compatibles. |
| Google Pay | La hoja oficial se presenta dentro del checkout alojado con gateway Redsys. |
Checkout clásico, Checkout Blocks, HPOS y order-pay están cubiertos. La URL del navegador sólo orienta al comprador; el reconciliador común decide cuándo invocar el pago completado de WooCommerce.
Probar la integración
- 1
Confirma el rótulo de pruebas
La pantalla de ajustes debe mostrar Pruebas, no se realizan cargos reales. - 2
Compra desde una ventana privada
Prueba Checkout clásico o Blocks con una tarjeta sandbox y completa 3DS si aparece. - 3
Revisa el pedido
Comprueba estado, notas e ID de transacción. Un rechazo debe mantenerlo sin pagar y permitir recuperación segura. - 4
Revisa Action Scheduler
En WooCommerce, Estado, Acciones programadas, busca el grupo andorpay-card y resuelve acciones vencidas.
Para Bizum usa 700 000 000 y un importe inferior a 5 € en el sandbox documentado. Google Pay usa Google TEST; Apple Pay necesita Apple Sandbox y un entorno X-PAY de certificación para autorización completa.
Configurar webhooks
No copies una URL ni un secreto manualmente. Al guardar la conexión, el plugin crea su identidad, genera el secreto y registra el endpoint firmado. La ruta pública debe aceptar POST enhttps://tu-tienda.example/wp-json/andorpay/v1/webhook.
El webhook es la vía rápida. Action Scheduler consulta el estado canónico a los 5 minutos, 30 minutos, 2 horas y 24 horas como recuperación. Un webhook degradado no confirma ni cancela por sí solo un pedido.
Errores frecuentes
| Problema | Comprobación |
|---|---|
| El método no aparece | Revisa activación, clave, URLs HTTPS, EUR y reserva de inventario. |
| Los campos de tarjeta no cargan | Comprueba dominio inSite, checkout URL, TLS, CSP, WAF y extensiones del navegador. |
| El webhook está degradado | Comprueba POST público, firewall, WP-Cron y acciones programadas vencidas. |
| El pedido sigue pendiente | Consulta AndorPay y usa Sincronizar pago con AndorPay. No completes ni cobres otra vez a ciegas. |
| Bizum o una wallet no aparecen | Confirma la activación en banco, Redsys, AndorPay y WooCommerce, además de la compatibilidad del dispositivo. |
Los registros están en WooCommerce, Estado, Registros, andorpay-card-gateway. Conservarequest_id y flow_id, pero no copies secretos ni datos de tarjeta.
Pasar a producción
Configura la cuenta Redsys productiva en AndorPay, autoriza el dominio exacto en inSite y sustituye la API key por una clave ap_live_. La pantalla debe mostrar Producción, pagos reales antes de abrir el método.
Recarga el checkout, realiza una compra real de importe reducido y verifica Redsys, AndorPay y WooCommerce. La continuidad Redsys es opcional, permanece apagada por defecto y no es necesaria para la integración estándar.