> ## Documentation Index
> Fetch the complete documentation index at: https://firespark.cloud/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Crear TOTP de Masivo

> Pide a Masivo un código de un solo uso para un cliente de Masivo.

Crea un TOTP de Masivo para un `customer_id` de Masivo. Spark autoriza con la clave de API de servidor del comercio, guarda ese bearer en el servidor y te devuelve el `data` de Masivo tal cual (`code`, `expired_at`, `seconds_left`).

> [!NOTE]
>
> Necesitas un access token de Fire spark del [intercambio de
> token](https://firespark.cloud/docs/es/storefront-api/oauth/exchange/post.md). Esta ruta no tiene interruptor
> en el canal ni en la integración. Funciona cuando este entorno tiene una
> conexión activa de Masivo. Si no la tiene, responde `409`
> `MASIVO_NOT_CONNECTED`.

Solo se envía `customer_id` a Masivo. No mandes metadata. Spark no escribe el código en un pedido.

## Cuerpo de la solicitud

| Campo | Requerido | Descripción |
| - | - | - |
| `customer_id` | Sí | Id del cliente en Masivo. Sin espacios sobrantes, de 1 a 128 caracteres. |

## Solicitud

```bash theme={null}
curl -X POST "https://firespark.cloud/api/storefront/v1/masivo/totp" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"customer_id":"masivo-customer-id"}'
```

## Respuesta

`201` con el objeto `data` de Masivo.

```json theme={null}
{
  "data": {
    "code": "1234",
    "expired_at": "2026-11-11T18:30:00.000Z",
    "seconds_left": 300
  }
}
```

Un cliente desconocido es `404`. Spark conserva el `error` y los `details` de Masivo. Los demás errores de cliente conservan el estado de Masivo. Un límite o un error de servidor se vuelve `502`.

Si este comercio y entorno no tienen Masivo conectado:

```json theme={null}
{
  "error": "Este comercio no tiene Masivo conectado. Conéctalo aquí en Integraciones.",
  "code": "MASIVO_NOT_CONNECTED",
  "details": { "code": "MASIVO_NOT_CONNECTED" }
}
```

El texto de `error` sigue `Accept-Language` (`es`, `en` o `pt`). El código se queda en `MASIVO_NOT_CONNECTED`. Verifica el código con [Verificar TOTP de Masivo](https://firespark.cloud/docs/es/storefront-api/masivo/totp/verify/get.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.