Antes de empezar: esta guía es un resumen, no un manual oficial
Lo que sigue se basa en la documentación técnica pública de AZUL (el documento de e-commerce con Webservices, versión 3.2 de 2023) y en información pública sobre sus soluciones. Los requisitos, plazos y parámetros cambian. Confirma siempre la versión vigente con AZUL antes de comprometer fechas con tu cliente.
Las cuatro formas de cobrar con AZUL en una tienda online
- Plugin o plataforma compatible: AZUL indica compatibilidad con plataformas como Shopify, WooCommerce, Magento y Odoo. Es el camino más rápido si ya usas una de ellas.
- Página de Pago AZUL: tu cliente es redirigido a una página de AZUL para ingresar su tarjeta y luego regresa a tu sitio.
- Webservices: tu sitio captura los datos de la tarjeta y tu servidor invoca el servicio de AZUL. Están disponibles en SOAP, JSON y HTTP Forms Post, y funcionan con cualquier tecnología.
- Link de Pagos: generas un enlace para compartir por WhatsApp, SMS o redes y cobrar sin una tienda completa.
Cuál te conviene
- Vendes por WhatsApp o Instagram y apenas empiezas: el Link de Pagos puede bastar mientras validas.
- Tienda en una plataforma estándar: usa el plugin compatible y evita desarrollo innecesario.
- Tienda a medida con checkout propio, suscripciones o reglas especiales: los Webservices dan el control que necesitas, a cambio de más trabajo y más responsabilidad en seguridad.
Si dudas entre una plataforma lista y una tienda a medida, revisa el servicio de desarrollo de e-commerce.
El camino de una integración con Webservices
- Afiliación como comercio y elección del canal de conexión.
- Conexión segura: la documentación describe dos opciones, una VPN site-to-site (IPSec) o autenticación mutua con certificados digitales, con certificados distintos para pruebas y producción.
- Credenciales de pruebas: AZUL entrega factores de autenticación y parámetros del comercio, y existe un ambiente de pruebas con las mismas funciones que producción.
- Desarrollo: adaptas tu tienda al servicio de AZUL.
- Certificación: pasas pruebas con el personal técnico de AZUL. Tras su no objeción técnica, se gestionan los accesos de producción.
La comunicación debe usar TLS 1.2, y la documentación indica que la aplicación debe poder usar la URL de contingencia si la principal falla.
Tipos de transacción que debes conocer
Según el documento técnico, entre las operaciones disponibles están:
- Venta (Sale): cobro con captura automática.
- Pre-autorización (Hold) y captura (Post): reserva el monto y lo cobra después. Útil si el total final depende de la disponibilidad o del envío.
- Anulación (Void): para cancelar una venta dentro de una ventana corta de tiempo.
- Devolución (Refund): total o parcial, con un límite de tiempo posterior a la venta.
- Consulta de transacciones: para confirmar el estado real de un pago por su número de orden.
- Bóveda de datos (DataVault): tokeniza la tarjeta para compras futuras.
- Suscripciones, cuotas y conversión dinámica de moneda (DCC).
Los plazos exactos de cada operación están en la documentación vigente: no los des por sentados al diseñar tus reglas de devolución.
Seguridad: 3D Secure y PCI DSS
Para comercio electrónico, AZUL contempla la autenticación del tarjetahabiente con Visa Secure y Mastercard ID Check (3D Secure), y los logos correspondientes deben mostrarse en tu sitio.
Si integras por Webservices, la documentación indica que debes completar el cuestionario de autoevaluación PCI DSS que corresponda y la atestación de cumplimiento. Si prefieres reducir esa carga, la Página de Pago o un plugin compatible evitan que los datos de la tarjeta pasen por tu servidor.
Lo que tu sitio debe mostrar para ser aprobado
La documentación de AZUL lista requisitos para el sitio del comercio:
- Nombre comercial y descripción clara de los productos o servicios.
- Logos de Visa y Mastercard.
- Políticas de devolución, de privacidad y de seguridad.
- Datos de contacto de servicio al cliente.
- Una casilla para aceptar los términos y condiciones antes de pagar.
Si todavía no tienes estas páginas, conviene redactarlas desde el inicio del proyecto.
Errores comunes al integrar un cobro con tarjeta
- No manejar los tiempos de espera. Si la respuesta no llega, el pedido queda en el limbo. Consulta el estado real de la transacción antes de reintentar y así evitas cobros dobles.
- No guardar el identificador del pedido de forma única para poder conciliar pagos.
- Guardar datos de tarjeta en tu base de datos en lugar de un token.
- Probar solo el caso feliz. Prueba tarjetas declinadas, tiempos agotados, anulaciones y devoluciones.
- Olvidar la conciliación y la facturación: cada pago debe cuadrar con el pedido y con el comprobante fiscal.
Preguntas Frecuentes
¿Vas a cobrar con tarjeta en tu tienda?
Te ayudo a elegir la modalidad, a prepararte para la certificación y a integrar AZUL con tu tienda y tu facturación. Cuéntame tu caso, sin compromiso.
Iniciar conversación