> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developers.sellercenter.pe/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developers.sellercenter.pe/_mcp/server.

# Ambientes y autenticación

> URL base de cada ambiente y cómo autenticarte.

## Ambientes

| Ambiente | Uso                                                                                                                 |
| -------- | ------------------------------------------------------------------------------------------------------------------- |
| **QA**   | Desarrollo y pruebas. Los datos no son reales.                                                                      |
| **PRD**  | Producción. Solo después de probar tu integración en QA (ver [Paso a producción](/empieza-aqui/paso-a-produccion)). |

Las credenciales y la **apiKey son distintas en cada ambiente** y no son intercambiables.

## URL base

La API usa **dos URL base** por ambiente. En la [Referencia de la API](/referencia-de-la-api) cada endpoint ya indica la suya.

| URL base          | QA                                                          | PRD                                                       | Se usa en                                                           |
| ----------------- | ----------------------------------------------------------- | --------------------------------------------------------- | ------------------------------------------------------------------- |
| **Gateway**       | `https://qa.api.sellercenter.pe/sellercenter`               | `https://prd.api.sellercenter.pe/sellercenter`            | Login, datos maestros, crear producto, precio, stock y comprobantes |
| **Seller Center** | `https://inretailqa.mysellercenter.com/sellercenter/api/v1` | `https://inretail.mysellercenter.com/sellercenter/api/v1` | Órdenes y consulta de productos y SKUs                              |

## Autenticación

| URL base          | Headers                                                           |
| ----------------- | ----------------------------------------------------------------- |
| **Gateway**       | `Authorization: Bearer <accessToken>` **y** `apiKey: <tu apiKey>` |
| **Seller Center** | `Authorization: Bearer <accessToken>`                             |

El **mismo token** obtenido en [Login](/guias/autenticacion) sirve para ambas URL base. El login solo requiere el header `apiKey`.

### Buenas prácticas

1. Haz login al iniciar y guarda `accessToken` y su vencimiento (`ahora + expiresIn`).
2. Reutiliza el mismo token en todas las llamadas.
3. Renueva el token unos minutos antes de que venza, o cuando recibas `401` sin body.
4. No hagas login en cada llamada.