Sumá tu tienda a Natural Order

Por qué integrar tu tienda

• Apareces en matches geo-filtrados. Cada usuario tiene una wishlist con condición y precio máximo. Si tu stock cumple esos criterios y estás cerca, te mostramos como opción de compra. Los leads más calificados ahora están a un click de tu checkout.
• Te llegan carritos completos, no consultas sueltas. Cuando el comprador clickea “Comprar todo” en el match, le mandamos el carrito armado a tu sitio. Vos cerrás una venta con N cartas en una sola operación.
• Sin fee, sin lock-in, sin comisión. No cobramos por venta ni por listado. No te pedimos exclusividad. Si dejás de querer estar, desactivamos tu tienda y listo.
• Sincronizamos lo que ya tenés. No te pedimos que cargues stock a mano en otro lugar. Trabajamos con la plataforma que ya usás.

Cómo arrancar

Andá a naturalorder.app/stores/apply y completá el formulario. Te pedimos nombre de la tienda, contacto, país, dirección física (la usamos para calcular distancia con compradores cercanos) y opcionalmente tu sitio web.

Para enviar el formulario necesitás una cuenta en Natural Order — así el email queda verificado y tu cuenta queda asociada a la tienda. Esto es lo que después te permite ver y rotar tu API key vos mismo, sin depender de que te mandemos nada.

Revisamos solicitudes manualmente. Buscamos tiendas con stock real y operación verificable. La respuesta promedio es 1-3 días hábiles.

Tu API key vive en tu panel

Cuando aprobamos tu tienda, generamos una API key. Vos la ves una sola vez en naturalorder.app/dashboard/store la próxima vez que entres con tu cuenta. La copiás y la guardás (gestor de contraseñas, lo que prefieras). Después no vamos a poder mostrártela de nuevo — solo el prefijo, que sirve para identificar cuál estás usando.

Desde el mismo panel podés rotar tu API key cuando quieras. Si sospechás que se filtró, hacés clic en “Rotar key”: generamos una nueva, la anterior deja de funcionar al instante.

La key se llama nos_live_... y se manda como Bearer token en las requests a nuestra API. Está scopeada a tu tienda — no puede leer ni modificar datos de otras.

Dos caminos para conectar tu stock

La integración técnica depende de qué plataforma usás. Hay dos grupos: tiendas sobre plataformas conocidas (donde nos das credenciales y nosotros nos hacemos cargo), y tiendas con web propia (donde tu dev empuja inventario vía nuestro API).

Plataformas — nos das credenciales, listo

Si tu tienda corre en una plataforma comercial (Shopify, Crystal Commerce, BinderPOS, y similares), la integración se reduce a compartirnos las credenciales que esa plataforma usa para exponer tu catálogo. Una vez configurado, sincronizamos tu inventario y precios automáticamente — vos no tenés que volver a tocar nada.

• Shopify: usamos el endpoint público /products.json que ya viene activo en cada storefront. Cero esfuerzo de tu lado. Ejemplo vivo: Magic Lair (Argentina).
• Crystal Commerce: te pedimos una Secret API Key que se genera en menos de 5 minutos desde tu panel. Ejemplo vivo: Magic Dealers (Argentina).
• Otras plataformas: si la tuya no está en la lista, escribinos — info@naturalorder.app. La mayoría exponen alguna forma de leer catálogo y la sumamos cuando hay tienda interesada.

Web propia — el push API

Si tu tienda corre en un sitio propio o un stack que no calza con ninguna plataforma comercial, exponemos un push API documentado. Tu backend empuja inventario en sesiones atómicas:

1. Abrís una sesión de sync (un POST).
2. Mandás tu inventario en chunks de hasta 1000 listings (varios POSTs).
3. Cerrás con un finalize (otro POST) — atómicamente reemplazamos tu stock anterior con el nuevo.

Cada listing tiene scryfall_id (o set + collector_number), condición, foil/nonfoil, idioma, cantidad y precio. La doc completa con shape exacto, validaciones y rate limits está en naturalorder.app/developers#stores. Tu dev lo levanta en un par de horas.

Cart Handoff: la integración clave

Hasta acá, la integración te da visibilidad. Pero el momento donde cerrás venta es cuando el comprador clickea “Comprar todo” en el match. Lo que hacemos:

1. El comprador abre un match con tu tienda y ve N cartas que querés venderle, con tus precios y stock. Puede excluir alguna que no le interese.
2. Clickea “Comprar todo en [Tu Tienda]”. Generamos un token de un solo uso, válido por 10 minutos.
3. Abrimos una pestaña nueva a tu sitio en la URL que vos nos diste (ej: https://tu-tienda.com/nos/cart), con dos query params: ?nos_match=...&nos_token=....
4. Tu handler hace un fetch a nuestra API con tu API key + el token. Le devolvemos la lista canónica de cartas — con los IDs de tu sistema (los que vos nos pasaste en el push del inventario), las cantidades que el comprador quiere y las exclusiones ya filtradas.
5. Tu sitio agrega esos items al carrito del usuario y lo redirige a tu página de checkout. Desde ahí, todo es tu proceso normal: pago, envío, factura. Nosotros salimos del medio.

No procesamos pagos. No retenemos stock. No registramos la compra. Somos un deep-link con payload verificado: vos seguís siendo el dueño de la transacción de punta a punta.

La seguridad va por doble verificación: el token sólo se genera cuando un comprador real clickea desde un match con tu tienda, y para fetcharlo necesitás tu API key (no sirve la de otra tienda aunque consigan el token). Detalles técnicos en naturalorder.app/developers#stores-cart.

Para tu dev

Si la persona que lee esta nota no implementa la integración personalmente, pasale estos links:

• Push API de inventario — schema de listing, sesiones chunked, finalize, errores
• Cart handoff — contrato del query string, fetch endpoint, ejemplo de handler en Node.js
• Rate limits — buckets por endpoint

En resumen

Sumar tu tienda a Natural Order es entrar al feed de descubrimiento de compradores que ya están buscando lo que vendés. Si corrés sobre una plataforma comercial (Shopify, Crystal Commerce, otras), compartís credenciales y nosotros nos hacemos cargo del sync. Si tenés sitio propio, tu dev levanta el push API en horas.

Cuando el comprador clickea, le llega el carrito armado directo a tu sitio. Vos cerrás venta, no consulta. Sin fee, sin lock-in.