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- Paso 1: Cargar la tienda y el catálogoMoneda, métodos de envío, opciones de pago, categorías y productos.
- Paso 2: CotizarNo hay carrito en el servidor: la landing guarda las líneas y las cotiza.
- Paso 3: Crear el pedidoUn checkout con clave de idempotencia, así un reintento no duplica el pedido.
- Paso 4: Pagar con tarjetaEl pedido devuelve la dirección de Stripe a la que se envía al comprador.
- Paso 5: Página de retornoStripe devuelve al comprador a la landing, y con el pedido se consulta si pagó.
- Paso 6: Comprobante de pago manualEn una transferencia, el comprador sube su comprobante después del pedido.
- Paso 7: Pagopar (no disponible)Pagopar se retiró. Queda documentado para quienes lo tenían integrado.
Guías
- Autenticación y orígenesClaves publicables y secretas, y desde dónde se puede usar cada una.
- Stock: se puede sobrevenderEl checkout verifica el stock, pero no lo reserva.
- Verificación ante ráfagasCuándo una tienda pide el desafío ALTCHA y cómo resolverlo.
- Webhooks de pedidosFirma, reintentos y el contrato del receptor.
- Errores y límites de frecuenciaLos códigos estables por los que conviene ramificar.
Novedades
- NuevoWebhooks de pedidosTiendy avisa a tu servidor cuando se crea, se paga o cambia de estado un pedido, con una pantalla para administrarlos en el panel.
- PanelClaves y orígenes desde el panelCada comercio crea y revoca sus claves, y registra los orígenes autorizados, sin pedirle nada a soporte.
- CatálogoProductos por dirección amigableEl detalle de un producto también se consulta por su slug.