Envía pedidos desde tu servidor
Si tu tienda no está en una plataforma de venta conectada, tu sistema envía cada venta a Clakta con la API de pedidos. Esto es lo que hay que enviar y los errores que evitar.
Si tu tienda funciona en Shopify, WooCommerce, Stripe u otra plataforma de venta conectada, no necesitas esto: la conexión envía tus ventas por ti. Este artículo es para tiendas cuyo sistema envía los pedidos por su cuenta, y necesita un desarrollador.
El script no puede crear pedidos: las ventas solo llegan a Clakta desde tu servidor, con la API de pedidos.
La petición
Crea la clave en Configuración del equipo → Claves de API y mantenla en tu servidor: puede escribir en tus datos. Todas las opciones están en la referencia de la API.
Qué enviar
Campos principales
| Campo | Qué es |
|---|---|
projectId | El id o slug del proyecto al que pertenece el pedido. |
orderId | El id del pedido en tu sistema. |
platform | Texto libre, como shopify o el nombre de tu propio checkout. |
paymentMethod | credit_card, debit_card, pix, boleto, paypal, apple_pay, google_pay, samsung_pay, stripe_link u other. |
status | paid, pending, rejected, refunded o canceled. |
currency | Código de tres letras, como EUR. La moneda del proyecto si no lo envías. |
totalPrice | Número en la unidad principal: 10.4 significa 10,40 €. |
products | Cada uno con id, name, quantity y price. |
createdAt | Fecha y hora del pedido. Ahora, si no lo envías. |
approvedDate, refundedAt | Fechas opcionales. |
El objeto tracking
Es lo que une el pedido con el anuncio. Envía los valores que tu sitio captó cuando llegó el visitante:
| Campo | Qué es |
|---|---|
clkt | El parámetro del clic en el anuncio, de la primera página. Sin él, el pedido nunca recibe mérito de un anuncio. |
utm_* | Las UTM de la campaña, guardadas para los informes. |
sessionId | La visita a la que pertenece el pedido. Se ignora en los proyectos respetuosos con la privacidad. |
domain | El sitio donde se hizo la compra. Obligatorio en los proyectos respetuosos con la privacidad con más de un dominio. |
Guarda estos valores en el carrito o el checkout cuando el comprador empiece el checkout, para que tu servidor todavía los tenga cuando se apruebe el pago.
Proyectos respetuosos con la privacidad
El pedido es el mismo, con una regla estricta: customer solo puede tener ip y
userAgent. Enviar id, name, email, phone, gender, dateOfBirth o
address hace que Clakta rechace el pedido.
Clakta usa la IP, el navegador y el dominio para encontrar las visitas del mismo
día. sessionId se ignora.
Es el error más habitual. Tu servidor ve su propia dirección; tienes que enviar los valores que tu sitio vio para el comprador. Si están mal, ningún pedido se une a una visita y todo aparece como tráfico directo.
Envía el userAgent exactamente como lo mandó el navegador, sin recortar ni
cambiar nada.
Actualizar un pedido
Los reembolsos y cambios de estado usan un PATCH:
Puedes cambiar status, paymentMethod, platform, currency, totalPrice,
createdAt, approvedDate y refundedAt, y tienes que enviar al menos uno.
Consejos
Artículos relacionados
Cómo funciona el seguimiento de Clakta
El camino del clic en el anuncio hasta la venta en Clakta, paso a paso, y dónde mirar cuando falta algo.
Modos de seguimiento
Respetuoso con la privacidad o atribución completa: qué recoge cada modo, a qué renuncias en cada uno y qué cambia cuando lo cambias.
Registra eventos de ecommerce
Registra vistas de producto, añadidos al carrito, inicios de checkout y pagos enviados en tu sitio, para ver dónde abandonan los visitantes antes de comprar.