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 403STOREFRONT_API_PLAN_REQUIREDen hasta dos minutos. Las consultas de pedidos existentes (GET /orders/{token}yGET /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 (
currencyenGET /store), sin decimales. No se dividen por 100:150000en PYG son 150.000 guaraníes.