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

# Créditos y facturación

> Aprende cómo se consumen los créditos de la API de Enrow por endpoint, consulta tu saldo, gestiona la renovación automática y la recarga, y maneja la falta de créditos

Enrow utiliza un sistema basado en créditos, y los créditos solo se consumen cuando se encuentra un resultado o se realiza una comprobación. Esta página explica cómo se cobran los créditos por cada endpoint, cómo consultar tu saldo, cómo gestionar la configuración de facturación y qué ocurre cuando se agotan los créditos.

## ¿Cómo funcionan los créditos?

Los créditos solo se consumen cuando la API devuelve un resultado o completa una comprobación: las búsquedas fallidas que no encuentran nada no cuestan créditos. Cada función consume créditos a una tasa diferente:

| Endpoint           | Créditos                                                             |
| ------------------ | -------------------------------------------------------------------- |
| **Email Finder**   | 1 por email encontrado                                               |
| **Phone Finder**   | 40 por teléfono encontrado (predeterminado; 50 con planes heredados) |
| **Email Verifier** | 0.25 por comprobación                                                |

<Note>
  Los créditos se cobran de la misma forma en las operaciones individuales y masivas: por cada resultado individual. Ejecutar una [búsqueda masiva de emails](/es/api-reference/email-finder/find-bulk) de 1000 nombres cuesta lo mismo por email encontrado que 1000 búsquedas individuales.
</Note>

Cada solicitud que consume créditos devuelve un campo `credits_used` en su respuesta, para que puedas hacer un seguimiento del consumo por búsqueda. Consulta [Find Single Email](/es/api-reference/email-finder/find-single) para ver un ejemplo de respuesta.

## ¿Cómo consulto mi saldo de créditos?

Consulta el endpoint de la cuenta con tu clave de API en el encabezado `x-api-key` para recuperar tu saldo de créditos actual. No se necesita ningún cuerpo en la solicitud: la cuenta se identifica a partir de la clave de API.

```bash theme={null}
curl https://api.enrow.io/account/info \
  -H "x-api-key: YOUR_API_KEY"
```

```json Respuesta theme={null}
{
  "credits": 8500,
  "webhooks": ["https://your-app.com/webhooks/enrow"]
}
```

La respuesta contiene tu saldo y los webhooks registrados:

| Campo      | Descripción                                  |
| ---------- | -------------------------------------------- |
| `credits`  | Tu saldo de créditos actual                  |
| `webhooks` | Array de las URL de tus webhooks registrados |

Para consultar la referencia completa del endpoint, consulta [Account info](/es/api-reference/account/info). También puedes visitar tu [Panel](https://app.enrow.io) para ver los detalles de uso y facturación, o consultar la guía de [Autenticación](/es/authentication) para saber cómo funciona el encabezado `x-api-key` en cada endpoint.

## ¿Cómo gestiono la configuración de facturación?

Desde la [página de Facturación](https://app.enrow.io/billing) de la aplicación, puedes configurar tres opciones que mantienen tu cuenta con saldo y te avisan antes de que se agoten los créditos:

<AccordionGroup>
  <Accordion title="Renovación automática">
    Renueva automáticamente tu plan cuando caduque. Define la cantidad de créditos a renovar en el campo situado junto al interruptor.
  </Accordion>

  <Accordion title="Recarga automática">
    Compra automáticamente créditos adicionales de pago por uso cuando tu saldo sea bajo. Define la cantidad de créditos a recargar en el campo situado junto al interruptor.
  </Accordion>

  <Accordion title="Alerta de saldo bajo">
    Recibe una alerta por correo electrónico cuando tu saldo de créditos baje de un umbral. Define el umbral de créditos en el campo situado junto al interruptor.
  </Accordion>
</AccordionGroup>

## ¿Qué ocurre cuando se agotan los créditos?

Cuando tu saldo de créditos llega a cero, las solicitudes a la API devuelven un estado HTTP `402`. Los endpoints individuales (búsqueda individual de email/teléfono, verificación individual) devuelven:

```json theme={null}
{
  "reason": "Insufficient credits",
  "success": false
}
```

Los endpoints masivos devuelven `{ "message": "..." }` en su lugar. Para ver la lista completa de códigos de estado y formatos de respuesta, consulta [Códigos de estado](/es/status-codes) y [Manejo de errores](/es/error-handling).

<Warning>
  Para evitar interrupciones, activa la **Recarga automática** o la **Alerta de saldo bajo** desde la [página de Facturación](https://app.enrow.io/billing).
</Warning>

## ¿Qué plan debería elegir?

Visita [enrow.io/pricing](https://enrow.io/pricing) para comparar planes y encontrar el más adecuado para tus necesidades. Los créditos de pago por uso se pueden añadir a cualquier plan mediante la [Recarga automática](#how-do-i-manage-billing-settings).

## FAQ

<AccordionGroup>
  <Accordion title="¿Las búsquedas fallidas cuestan créditos?">
    No. Los créditos solo se consumen cuando se encuentra un email o un número de teléfono, o cuando se realiza una comprobación de verificación. Una búsqueda que no devuelve ningún resultado no cuesta créditos.
  </Accordion>

  <Accordion title="¿Las operaciones masivas son más baratas que las individuales?">
    No. Los créditos se cobran por cada resultado individual, por lo que una operación masiva cuesta lo mismo por email, teléfono o verificación encontrados que las solicitudes individuales equivalentes. Los endpoints masivos ahorran solicitudes, no créditos.
  </Accordion>

  <Accordion title="¿Cuántos créditos cuesta una verificación de email?">
    El Email Verifier consume 0.25 créditos por comprobación. El Email Finder consume 1 crédito por email encontrado, y el Phone Finder consume 40 créditos por teléfono encontrado (50 con planes heredados).
  </Accordion>

  <Accordion title="¿Qué error obtengo cuando no me quedan créditos?">
    Las solicitudes devuelven un estado HTTP `402`. Los endpoints individuales devuelven `{ "reason": "Insufficient credits", "success": false }`, mientras que los endpoints masivos devuelven `{ "message": "..." }`. Consulta [Manejo de errores](/es/error-handling) para más detalles.
  </Accordion>
</AccordionGroup>

## Próximos pasos

<CardGroup cols={2}>
  <Card title="Autenticación" icon="key" href="/es/authentication">
    Cómo pasar tu clave de API en el encabezado x-api-key.
  </Card>

  <Card title="Account info" icon="circle-user" href="/es/api-reference/account/info">
    Recupera tu saldo de créditos y los webhooks registrados.
  </Card>

  <Card title="Límites de tasa" icon="gauge-high" href="/es/rate-limits">
    Comprende los límites de solicitudes de la API antes de escalar.
  </Card>

  <Card title="Manejo de errores" icon="triangle-exclamation" href="/es/error-handling">
    Maneja con elegancia las respuestas de error 402 y otras.
  </Card>
</CardGroup>