API de storefront · v1

Vendé desde tu propia landing, con Tiendy como backend

Catálogo, precios, envío, ofertas, cupones, pedidos y pago. Tu landing muestra lo que el servidor calcula, y los pedidos aparecen en el panel como cualquier otro.

Incluida en el plan Tiendy AI.

POST/cart/quote
curl https://www.tiendy.com.py/api/storefront/v1/cart/quote \
  -H "Authorization: Bearer pk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "items": [
      {
        "productId": "clx0prod",
        "skuId": "clx0sku",
        "quantity": 2
      }
    ],
    "shippingMethodId": "1f2e3d4c",
    "cityId": "1101",
    "couponCode": "VERANO"
  }'

Tiendy calcula los totales

Precios, envío, ofertas y cupones salen del servidor. Cualquier total que mande la landing se ignora.

La clave determina la tienda

Una clave publicable para el navegador y una secreta para tu servidor. Ningún pedido lleva el identificador de la tienda.

Los datos del comprador no vuelven

Las respuestas nunca incluyen nombre, teléfono, dirección ni costos. La landing ya tiene lo que el comprador escribió.

Una venta en seis pasos

Leer la guía completa
  1. Paso 1: Cargar la tienda y el catálogoMoneda, métodos de envío, opciones de pago, categorías y productos.
  2. Paso 2: CotizarNo hay carrito en el servidor: la landing guarda las líneas y las cotiza.
  3. Paso 3: Crear el pedidoUn checkout con clave de idempotencia, así un reintento no duplica el pedido.
  4. Paso 4: Pagar con tarjetaEl pedido devuelve la dirección de Stripe a la que se envía al comprador.
  5. Paso 5: Página de retornoStripe devuelve al comprador a la landing, y con el pedido se consulta si pagó.
  6. Paso 6: Comprobante de pago manualEn una transferencia, el comprador sube su comprobante después del pedido.
  7. Paso 7: Pagopar (no disponible)Pagopar se retiró. Queda documentado para quienes lo tenían integrado.