Integraciones y API
QrX da soporte a comercios y plataformas que desean automatizar Payment On Delivery mediante integraciones de API y webhooks. Las integraciones pueden crear pedidos con pago habilitado, recibir cambios de estado y conectar la confirmación de pago de QrX con los flujos de trabajo de entrega y soporte.
Qué puede integrar
Creación de pedidos con los datos de contacto del cliente, importe, moneda, referencia del comercio y referencia de entrega.
Estado del pago, incluidos los estados creado, pendiente, pagado, fallido, caducado, cancelado y reembolsado.
Datos de seguimiento cuando su sistema de entrega o transportista proporciona referencias de seguimiento.
Verificación de los datos de contacto del cliente para flujos de correo electrónico, teléfono, WhatsApp y SMS como respaldo.
Flujos de reembolso cuando su proveedor de pago y la configuración del comercio lo permitan.
Etiquetas de envío para comercios conectados a transportistas, incluida la creación de etiquetas UPS a través de la API.
Webhooks para eventos relacionados con pagos, pedidos y entregas.
Fiabilidad de los webhooks
Las suscripciones a 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 fallo continuo para que pueda corregirse y reactivarse. Cada webhook tiene un registro de entregas en PortalX que muestra cada intento, la solicitud y la respuesta, y los reintentos, de modo que los problemas de integración pueden diagnosticarse sin contactar con soporte.
Canales del comercio
Un comercio puede operar varios canales o cuentas de cliente en QrX. Asegúrese de que cada solicitud a la API incluya los identificadores correctos de comercio, cliente, canal o cuenta que requiera su integración. Esto mantiene los pagos, las conversaciones de soporte y los datos de seguimiento conectados al contexto de negocio correcto.
Soporte para desarrolladores
Al contactar con soporte sobre un problema de API o webhook, incluya la hora de la solicitud, el entorno, el comercio o canal, la referencia del pedido, el id de la transacción, el id del evento del webhook, el estado de la respuesta y un cuerpo de solicitud o respuesta sin datos sensibles. No envíe claves secretas por chat ni por correo electrónico.
UPS y flujos de trabajo con transportistas
QrX es el único socio de UPS para Payment On Delivery en Europa. Los flujos de trabajo de UPS elegibles pueden usar QrX para cobrar el pago digital antes de entregar un paquete, según la configuración del comercio y la disponibilidad del transportista.
