Primeros pasos con su propia tienda online o sistema
Esta guía es para comercios que venden en una tienda online distinta de Shopify (por ejemplo WooCommerce, Magento, Lightspeed o una tienda a medida) o que tienen su propio sistema de pedidos, y que quieren QrX Payment on Delivery y etiquetas de envío. Su sistema envía los pedidos a QrX a través de la API pública de QrX, o usted los importa desde una hoja de cálculo. El cliente completa la compra sin pagar, escanea en la puerta el código QR de QrX del paquete y paga a través de su propio proveedor de pago.
En PortalX, esta es la ruta de configuración Vendo en otra tienda online o en mi propio sistema de la guía de inicio (Configuración > Negocios > Primeros pasos).
1. Configura tu negocio
Completa los datos de tu empresa. QrX conserva el nombre de la empresa, la dirección y el número de IVA o de la Cámara de Comercio de su registro. Si falta algo o ha cambiado, haga clic en Pregunta a QrX en el paso y QrX lo completa por usted. El paso se marca cuando se conocen todos los datos.
Añade tu almacén como dirección de remitente en Configuración > Operaciones > Direcciones. Asígnele un código corto: su sistema usa ese código en las llamadas a la API.
Conecta tu proveedor de pagos (Stripe, Mollie o MultiSafePay) en la pestaña Pagos del canal.
2. Configure los envíos
Conecta un transportista en Configuración > Operaciones > Proveedores de envíos y añada perfiles de método. Cada perfil de método tiene un código para las llamadas a la API.
Conecta tu impresora de etiquetas en Configuración > Preferencias > Impresión (PrintNode), o deje que su propio sistema imprima las etiquetas que devuelve QrX.
Cree una regla de envío en Configuración > Operaciones > Reglas de envío. Para los pedidos de la API puede elegir si se aplican las reglas.
3. Conecta tu sistema (con la API)
Copia la clave API de tu canal. Configuración > Negocios > Canales para comerciantes, abra el canal, pestaña Configuración, Regenerar clave API (Regenerate API Key). QrX guarda la clave cifrada con hash, por lo que solo se muestra completa una vez: guárdela en su servidor, nunca en un navegador o una app. Haga clic en Marcar como hecho (Mark as done) en el paso cuando la tenga.
Obtén tu primer token de acceso. POST /api/v1/auth/token con la cabecera QrX-MerchantChannel-API-Key. El token es válido durante 3600 segundos.
Crea tu primera transacción de prueba. POST /api/v1/transactions con el importe, los datos del pedido y, si quiere una etiqueta en la misma llamada, un bloque parcel con sus códigos de método y de remitente. Use primero el modo de prueba. HTTP 201 significa que QrX ha aceptado el pedido, no que esté pagado.
Suscríbete a los webhooks. Configuración > Avanzado > Ganchos web, o POST /api/v1/webhooks. Como mínimo, transacción pagada, cancelada y envío expedido. Verifique la cabecera X-QrX-Signature en cada entrega.
Recibe tu primer webhook. Use Enviar prueba (Send Test) en el editor de webhooks y consulte los registros de entrega (Delivery Logs).
La referencia completa con ejemplos de código está en qrx.eu/api. Consulte también "Guía rápida para desarrolladores: API pública y webhooks de QrX".
Crea tus pedidos sin un desarrollador
Esta ruta también muestra los pasos para crear pedidos en PortalX, útiles para hacer pruebas o si todavía no tiene un desarrollador:
Crear una transacción a mano: Transacciones > Crear transacción.
Importar pedidos desde una hoja de cálculo: en Transacciones, use el menú Importar con una exportación CSV o Excel de su tienda. Las reglas de envío se aplican a los pedidos importados.
Añada sus productos en Productos > Catálogo para que las líneas de pedido se rellenen más rápido (opcional).
4. Mantén informados a tus clientes
Personalice su página de Track & Trace con su marca: Configuración > Operaciones > Seguimiento.
Personalice sus mensajes para clientes: Configuración > Operaciones > Plantillas.
Active las actualizaciones de entrega por SMS (opcional, de pago, desactivadas por defecto): Canales para comerciantes, abra el canal, pestaña Configuración, SMS.
Abra su Message Centre: Configuración > Operaciones > Message Centre.
5. Cobra en la puerta
Haga un pago de prueba en la puerta escaneando el código QR de una etiqueta de prueba. No cuesta nada.
Si lo desea, exija un PIN en la página de pago.
Pida a QrX el paso a producción mediante Chatea con QrX.
Su primer pago real en la puerta marca el último paso.
Consejos para una integración limpia
Envíe el ID de pedido de su propia tienda para poder encontrar los pedidos en ambos sistemas.
Trate los webhooks como la fuente de verdad para pagado y cancelado; el pago puede completarse mucho después de que su llamada de creación haya respondido.
Use los endpoints de referencia (/api/v1/reference/carriers, shipping-methods, senders) en lugar de IDs fijos en el código.
Mantenga un canal de comercio por tienda online: cada canal tiene su propia clave API, su proveedor de pago y su marca.
Cuándo contactar con nuestro equipo de soporte
Contacte con el soporte de QrX cuando las solicitudes de token sigan fallando con una clave válida, cuando los webhooks se desactiven tras fallos repetidos y no encuentre la causa, o cuando esté listo para pasar a producción.