> ## 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.

# Verificar TOTP de Masivo

> Comprueba un código de un solo uso de Masivo y devuelve la billetera de ese cliente.

Verifica un `code` TOTP de Masivo con la clave de API de servidor del comercio. Spark autoriza en Masivo, guarda el bearer en el servidor y te devuelve el `data` de Masivo tal cual (`customer`, `wallet`, `metadata`).

> [!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`.

El id del cliente en Masivo es `data.customer.id`.

Envía `order_id` cuando un kiosco va a entregar este pedido abierto a ese cliente. Spark comprueba que el pedido esté `OPEN` y sea tuyo, que `data.customer.id` exista en este comercio, y agrega `customer_switch_proof`. La prueba dura 60 segundos y la firma Fire spark. Envíala al [intercambio de token](https://firespark.cloud/docs/es/storefront-api/oauth/exchange/post.md) como `subject_token`. Sin `order_id`, la respuesta sigue siendo el payload de Masivo y no incluye prueba.

Con el SDK:

```ts theme={null}
const verified = await services.masivo.verifyTotp({ code, order_id })
await auth.switchCustomer(verified)
```

`auth.switchCustomer` también acepta solo `verified.customer_switch_proof`.

## Parámetros de consulta

| Parámetro | Requerido | Descripción |
| - | - | - |
| `code` | Sí | Código TOTP de Masivo. Sin espacios sobrantes, de 1 a 32 caracteres. |
| `order_id` | No | Pedido abierto que pasará al cliente verificado. Si lo envías, una respuesta exitosa incluye `customer_switch_proof`. |

## Solicitud

```bash theme={null}
curl "https://firespark.cloud/api/storefront/v1/masivo/totp/verify?code=1234" \
  -H "Authorization: Bearer ACCESS_TOKEN"
```

## Respuesta

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

```json theme={null}
{
  "data": {
    "customer": { "id": "masivo-customer-id", "name": "Ana Pérez" },
    "wallet": { "id": "wallet-id", "totals": [] },
    "metadata": {}
  }
}
```

Un código inválido es `422`. Spark conserva el `error` y los `details` de Masivo. Otros fallos de Masivo usan el mapeo de errores aguas arriba de Spark (`502` para límites y errores de servidor) y también conservan `error` y `details` cuando Masivo los envió.

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`.


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