Guías · Empezar

Introducción

Qué permite hacer la API de storefront de Tiendy y qué hace falta antes de empezar: plan, claves, URL base y montos.

Qué permite hacer

Vender desde una landing propia usando a Tiendy como backend: catálogo, precios, envío, ofertas, cupones, pedidos y pago. Los pedidos aparecen en Pedidos y cuentan en Finanzas como cualquier otro.

Tiendy es la única autoridad de precios, envío, ofertas, cupones y totales. La landing muestra lo que el servidor calcula, y cualquier total que envíe se ignora.

Antes de empezar

  • Plan. La API se incluye solo en el plan Tiendy AI (PRO, el más caro), sin compra aparte. Si la tienda no está en ese plan o lo pierde, los endpoints responden 403 STOREFRONT_API_PLAN_REQUIRED en hasta dos minutos. Las consultas de pedidos existentes (GET /orders/{token} y GET /orders/by-payment-hash/{hash}) siguen abiertas, porque un comprador que ya pagó tiene que poder ver su pedido. Los pedidos siguen en el panel y las confirmaciones de pago (el webhook de Stripe) se siguen procesando.
  • Claves. Cada tienda tiene las suyas, y la clave determina la tienda: ningún request lleva storeId.
  • URL base: https://www.tiendy.com.py/api/storefront/v1.
  • Montos. Enteros en la moneda de la tienda (currency en GET /store), sin decimales. No se dividen por 100: 150000 en PYG son 150.000 guaraníes.