Ir al contenido principal

Primeros pasos como socio de plataforma de software

Guía para plataformas de software que integran QrX una sola vez y conectan a sus comercios mediante QrX Connect para ofrecer Payment on Delivery.

H
Escrito por Hayko

Primeros pasos como socio de plataforma de software

Esta guía es para empresas que desarrollan software utilizado por muchos comercios, como un WMS, una plataforma de tiendas, un sistema de gestión de pedidos o un software de envíos, y que quieren ofrecer QrX Payment on Delivery dentro de su producto. Usted integra una sola vez. Después, cada comercio conecta su propia cuenta de QrX a su software con unos pocos clics mediante QrX Connect, sin copiar claves API.

En PortalX, esta es la ruta de configuración Desarrollo software y quiero conectar a mis comerciantes de la guía de inicio (Configuración > Negocios > Primeros pasos).

Cómo funciona

  • Cada comercio mantiene su propia cuenta de QrX, su proveedor de pago y su configuración de transportistas.

  • El comercio hace clic en "Connect QrX" en su software, inicia sesión en QrX, elige un canal de venta y hace clic en Allow (permitir).

  • Su servidor recibe la clave API de ese único canal y llama a la API pública de QrX en nombre del comercio.

  • El pago del consumidor en la puerta siempre se queda en go.qr-x.app. Su software nunca toca el pago en sí.

1. Configure su propia cuenta

  1. 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.

  2. Invite a sus desarrolladores en Configuración > Equipo y acceso > Usuarios.

2. Solicita tu ID de cliente de QrX Connect

Haga clic en Pregunta a QrX en el paso (abre el chat), o use qrx.eu/api. Indique a QrX el nombre de su producto y su URL de callback HTTPS. Cada integración recibe su propio client id.

3. Construya la conexión

  1. Envíe al comercio a https://portal.qr-x.app/oauth/authorize con su client id, la URL de callback, un state aleatorio y un challenge PKCE (S256).

  2. En su callback, compruebe el state e intercambie el code: POST https://api.qr-x.net/api/v1/oauth/token (authorization_code con code_verifier). El code solo funciona una vez.

  3. Guarde cifrada en su servidor la clave API del canal que se devuelve.

  4. Intercámbiela por un token de acceso con POST /api/v1/auth/token y llame a la API como en cualquier integración de comercio.

Detalles: "QrX Connect: conectar su plataforma con OAuth" y la referencia en qrx.eu/api.

4. Cree una transacción de prueba para su primer comercio

  1. Conecte un comercio de prueba (su propia cuenta de QrX sirve) con QrX Connect.

  2. Cree una transacción en modo de prueba con una etiqueta: POST /api/v1/transactions.

  3. Suscríbase a los webhooks de ese canal y verifique la cabecera X-QrX-Signature.

  4. Escanee el código QR de la etiqueta de prueba y complete un pago de prueba en la puerta.

5. Certifíquese con QrX

Antes de que los comercios usen su integración en producción, QrX comprueba con usted el flujo completo: la salida de etiquetas en las impresoras que usan sus comercios (PDF o ZPL, etiqueta UPS Standard o Extended), reintentos que nunca crean una segunda etiqueta, la gestión de webhooks y la cancelación. Resérvelo mediante Pregunta a QrX en el paso.

Colaboración

QrX ofrece comisiones de socio por la actividad que cumpla los requisitos. Las condiciones se acuerdan por colaboración; consulte "Socios y cómo asociarse con QrX".

Cuándo contactar con nuestro equipo de soporte

Contacte con QrX para solicitar o cambiar un client id o una URL de callback, cuando el intercambio de token siga fallando con un code válido, o para planificar la certificación.

Artículos relacionados
¿Ha quedado contestada tu pregunta?