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

CampoQué es
projectIdEl id o slug del proyecto al que pertenece el pedido.
orderIdEl id del pedido en tu sistema.
platformTexto libre, como shopify o el nombre de tu propio checkout.
paymentMethodcredit_card, debit_card, pix, boleto, paypal, apple_pay, google_pay, samsung_pay, stripe_link u other.
statuspaid, pending, rejected, refunded o canceled.
currencyCódigo de tres letras, como EUR. La moneda del proyecto si no lo envías.
totalPriceNúmero en la unidad principal: 10.4 significa 10,40 €.
productsCada uno con id, name, quantity y price.
createdAtFecha y hora del pedido. Ahora, si no lo envías.
approvedDate, refundedAtFechas 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:

CampoQué es
clktEl 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.
sessionIdLa visita a la que pertenece el pedido. Se ignora en los proyectos respetuosos con la privacidad.
domainEl 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.

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