Conectar un comercio Shopify

Antes de conectar

La persona administradora debe decidir qué productos se ofrecerán y revisar que estén activos, tengan precio y cuenten con inventario o política de pedido por encargo. Para el piloto usa una tienda de desarrollo y Stellar testnet.

Setareh no necesita la contraseña de la tienda ni una clave privada de wallet. Las credenciales de la app pertenecen al entorno seguro del backend.

Instalar la app

La tienda recibe un enlace de instalación del equipo de Setareh, lo abre con su sesión de Shopify y aprueba los permisos. Shopify devuelve el control a Setareh, que verifica la firma de Shopify y un identificador de un solo uso antes de guardar el acceso. La tienda no envía credenciales por chat ni correo.

El acceso queda guardado cifrado y se renueva solo. Si la tienda desinstala la app, Shopify avisa a Setareh y este borra sus tokens.

Permisos solicitados

Scope	Motivo
read_products	Consultar productos, variantes y precios activos.
read_inventory	Comprobar stock al cotizar y antes de completar.
write_draft_orders	Crear el draft que fija la cotización.
read_orders	Conciliar el ID y estado de la orden resultante.
write_orders	Adjuntar evidencia resumida de pago a la orden.

Qué ocurre en Shopify

Al crear un quote, Setareh crea un draft order con las líneas, dirección y despacho fijo configurado. Añade una etiqueta setareh, un identificador de quote y una nota para conciliación. Después de payment settlement válido, completa ese mismo draft.

Al finalizar, adjunta el metafield JSON setareh.stellar_payment con el ID del quote, red, activo y hash de transacción cuando existe. No guarda el receipt crudo del facilitador en ese metafield.

Verificación de instalación

Ejecuta:

cd backend
npm.cmd run doctor -- --verify

El preflight debe confirmar conexión, scopes, una consulta de catálogo y capacidad x402 para stellar:testnet. Realiza después una compra de prueba de bajo importe y verifica una orden real en Shopify Admin.

Operación y revocación

En Shopify Admin el comercio puede revisar drafts, nuevas órdenes, stock y el metafield de evidencia. Para pausar el piloto, deshabilita el comercio en el entorno Setareh. Para revocar el acceso a la tienda, desinstala la app desde Settings → Apps and sales channels; esto no borra productos ni órdenes ya existentes.