Claves API para comerciantes e integración de acciones (Pro+)
Utilice claves del lado del servidor creadas por el propietario para tres rutas API compatibles, con acceso limitado y presupuestos de uso de la tienda.
En esta página
Crear una clave de alcance
Como propietario, abre Gestionar tienda → Enterprise → Merchant API. Asigna un nombre a la clave y selecciona solo los permisos necesarios: products:read, orders:read o stock:write. Copia el secreto una sola vez en un almacén seguro del servidor; no volverá a mostrarse.
Leer el contrato API
El contrato OpenAPI público está en /openapi/merchant-v1.json. Las rutas admitidas enumeran productos, enumeran pedidos y actualizan existencias de productos sin claves. Usa autenticación Bearer, páginas limitadas con cursor e Idempotency-Key para modificar existencias. No es una API completa de pagos, reembolsos o aprovisionamiento de clientes.
Respetar presupuestos y caducidad
Las claves creadas por la consola caducan después de 90 días. Los límites son 60 solicitudes/minuto por tienda y 10 000/mes en Pro o 100 000 en Enterprise; los reintentos cuentan. Manejar respuestas 401/403/409/429 y revocar claves no utilizadas. La transferencia del propietario, la suspensión o la pérdida del plan pueden impedir el acceso.