Integraciones y API

QrX conecta su tienda con proveedores de pago y redes de entrega a través de una capa compartida. Puede conectarse mediante una integración de plataforma ya preparada o desarrollar directamente sobre la API de QrX. Ambas opciones incorporan su negocio al mismo flujo de pago y entrega de QrX, y no necesita sustituir su tienda actual.

Integraciones disponibles

El directorio de integraciones en qrx.eu/integrations incluye actualmente:

Shopify (comercio): la app de QrX para Shopify incorpora sus pedidos de Shopify, el estado de los pagos y la información de entrega al mismo flujo de trabajo, y marca los pedidos como pagados cuando el cliente paga en la puerta. Consulte el artículo "QrX para Shopify".
Stripe (pagos): Stripe procesa el pago a través de su propia cuenta de Stripe. QrX coordina la solicitud y la confirmación del pago con el recorrido de la entrega.
MultiSafepay (pagos): utilice MultiSafepay para el procesamiento de pagos mientras QrX conecta el estado del pago con la entrega.
UPS (entrega): QrX es el socio oficial de UPS para Payment on Delivery en Europa y puede crear etiquetas de UPS. Consulte el artículo "UPS Payment on Delivery con QrX".

Mollie también es un proveedor de pago integrado para QrX Payment on Delivery. Los métodos de pago, países y servicios de transporte disponibles dependen siempre de su cuenta con el proveedor, sus mercados de destino y la configuración de QrX. Si su plataforma, PSP, transportista o red de taquillas no aparece en la lista, solicítela a través de la página de integraciones o reserve una demo.

Desarrollar con la API pública de QrX

Estilo: REST con JSON, URL base https://api.qr-x.net, especificación OpenAPI disponible.
Autenticación: cree una clave de API por canal de venta en PortalX, en Settings, Merchant channels. Intercámbiela por un token Bearer de corta duración con POST /api/v1/auth/token (válido durante una hora).
Transacciones: cree una transacción de Payment on Delivery, consulte sus detalles o el estado del pago, márquela como enviada con los datos de seguimiento o cancélela.
Datos de referencia: consulte transportistas, países, configuraciones regionales, métodos de envío y direcciones de remitente.
Productos y devoluciones: gestione su catálogo de productos y tramite solicitudes de devolución.
Stock de almacén: leer niveles de stock, artículos de stock y ubicaciones, registrar una corrección de stock y recibir los eventos stock/adjusted y stock/low. Consulte "API de stock y almacén" y "Webhooks de stock y almacén".
Webhooks: suscríbase a eventos, verifique envíos firmados, consulte el registro de envíos, reenvíe y rote los secretos de firma.
Modo de prueba: cree transacciones con testMode: true para probar el flujo completo sin pagos ni abonos reales.
QrX Connect (OAuth): plataformas como apps, sistemas WMS o tiendas a medida pueden permitir que un comercio vincule un canal de QrX sin pegar una clave de API.

La referencia completa y siempre actualizada, con ejemplos de código (cURL, Node.js, C#, PHP, Python) y una colección de Postman lista para usar, está en qrx.eu/api. Empiece por el artículo "Guía rápida para desarrolladores: API pública y webhooks de QrX".

Fiabilidad de los webhooks

Los webhooks son la fuente de verdad del estado final de la transacción, porque el procesamiento del pago puede completarse o fallar después de que su solicitud de creación haya respondido. Las suscripciones de webhooks en PortalX muestran un estado de salud. Si un endpoint sigue fallando, QrX avisa por correo electrónico a los destinatarios configurados y desactiva automáticamente la suscripción tras aproximadamente 24 horas de fallos continuos, para que se pueda corregir y volver a activar. Cada webhook tiene un registro de envíos que muestra cada intento, la solicitud y la respuesta, y los reintentos.

Canales del comercio

Un comercio puede gestionar varios canales de venta en QrX. Cada clave de API pertenece a un canal, y todo lo que se crea con ella (transacciones, etiquetas, webhooks) queda vinculado a ese canal. Utilice una clave distinta por canal.

Soporte para desarrolladores

Cuando contacte con el soporte por un problema de API o webhook, incluya la hora de la solicitud, el entorno (prueba o producción), el canal del comercio, la referencia del pedido, el id de la transacción, el id del envío del webhook, el estado de la respuesta y el cuerpo de la solicitud o respuesta sin datos sensibles. No envíe nunca claves de API, tokens de acceso ni secretos de webhook por chat o correo electrónico. Consulte también "Solución de problemas de API y webhooks".