Resumen del flujo de trabajo del comercio

Esta guía resume el recorrido de una oferta de Revclic, desde su publicación hasta la facturación de una conversión.

1. Configurar el comercio

Crea el perfil del comercio, asocia sus categorías y añade al menos un dominio. El dominio debe verificarse antes de la integración en producción. La consulta myMerchants permite recuperar los identificadores accesibles para la cuenta conectada.

2. Publicar los productos

Una oferta se crea mediante la mutación createProduct. Debe contener como mínimo un nombre traducido y un precio; también puede incluir la URL, imágenes, mercados objetivo, categorías y el modo de tarificación.

3. Recibir una redirección

Cuando un comprador sale de Revclic hacia el sitio del comercio, la URL contiene un identificador revclic_rid. Consérvalo en la sesión o el carrito hasta completar el pedido. Este identificador permite atribuir correctamente la transacción.

4. Registrar la transacción

Ejecuta la mutación createTransaction con el identificador del comercio y un CreateTransactionInput. Cada artículo debe incluir su GTIN, precio, cantidad y tasa de comisión. redirectId es opcional si no existe una redirección de Revclic.

La API devuelve una transacción con su propio identificador: guárdalo para futuras actualizaciones.

5. Validar o rechazar artículos

Utiliza updateTransaction con el identificador de la transacción y la lista de artículos que deben cambiar. Cada UpdateBasketItemInput contiene el identificador del artículo y su nuevo estado.

Los artículos pendientes al finalizar el plazo de validación pueden procesarse automáticamente según las reglas de la plataforma. Informa cuanto antes de cancelaciones y devoluciones.

6. Consultar los resultados

  • merchantTransactions lista las transacciones y permite filtrar por fecha.
  • merchantTransaction muestra una transacción concreta.
  • transactionStats proporciona indicadores agregados.
  • merchantInvoices lista las facturas del comercio.

7. Facturación

Los artículos validados se incorporan a la siguiente factura. Normalmente se genera el primer día del mes siguiente y dispone de una fecha de vencimiento. Consulta Cómo funciona la facturación para más detalles.

Encontrarás payloads completos para createTransaction, updateTransaction y merchantTransactions en la referencia GraphQL.