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

# Kredyty i rozliczenia

> Dowiedz się, jak kredyty API Enrow są zużywane na poszczególne endpointy, sprawdzaj saldo, zarządzaj automatycznym odnawianiem i doładowaniem oraz radź sobie z brakiem kredytów

Enrow korzysta z systemu opartego na kredytach, a kredyty są zużywane wyłącznie wtedy, gdy zostanie znaleziony wynik lub wykonane sprawdzenie. Ta strona wyjaśnia, jak naliczane są kredyty dla każdego endpointu, jak sprawdzić saldo, jak zarządzać ustawieniami rozliczeń oraz co się dzieje, gdy kredyty się skończą.

## Jak działają kredyty?

Kredyty są zużywane wyłącznie wtedy, gdy API zwróci wynik lub ukończy sprawdzenie — nieudane wyszukiwania, które niczego nie znajdą, nie kosztują kredytów. Każda funkcja zużywa kredyty według innej stawki:

| Endpoint           | Kredyty                                                             |
| ------------------ | ------------------------------------------------------------------- |
| **Email Finder**   | 1 za znaleziony adres e-mail                                        |
| **Phone Finder**   | 40 za znaleziony numer telefonu (domyślnie; 50 w starszych planach) |
| **Email Verifier** | 0,25 za sprawdzenie                                                 |

<Note>
  Kredyty są naliczane tak samo dla operacji pojedynczych i masowych — za każdy pojedynczy wynik. [Masowe wyszukiwanie adresów e-mail](/pl/api-reference/email-finder/find-bulk) dla 1000 nazwisk kosztuje za każdy znaleziony adres e-mail tyle samo, co 1000 pojedynczych wyszukiwań.
</Note>

Każde żądanie, które zużywa kredyty, zwraca w odpowiedzi pole `credits_used`, dzięki czemu możesz śledzić zużycie dla poszczególnych wyszukiwań. Przykładową odpowiedź znajdziesz w [Find Single Email](/pl/api-reference/email-finder/find-single).

## Jak sprawdzić saldo kredytów?

Aby pobrać bieżące saldo kredytów, wyślij zapytanie do endpointu konta z kluczem API w nagłówku `x-api-key`. Nie jest wymagane żadne ciało żądania — konto jest identyfikowane na podstawie klucza API.

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

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

Odpowiedź zawiera Twoje saldo oraz zarejestrowane webhooki:

| Pole       | Opis                                           |
| ---------- | ---------------------------------------------- |
| `credits`  | Twoje bieżące saldo kredytów                   |
| `webhooks` | Tablica zarejestrowanych adresów URL webhooków |

Pełną dokumentację endpointu znajdziesz w [Account info](/pl/api-reference/account/info). Możesz też odwiedzić swój [Dashboard](https://app.enrow.io), aby zobaczyć szczegóły zużycia i rozliczeń, lub zajrzeć do przewodnika [Authentication](/pl/authentication), aby dowiedzieć się, jak nagłówek `x-api-key` działa we wszystkich endpointach.

## Jak zarządzać ustawieniami rozliczeń?

Na [stronie rozliczeń](https://app.enrow.io/billing) w aplikacji możesz skonfigurować trzy opcje, które utrzymują Twoje konto doładowane i ostrzegają Cię, zanim kredyty się skończą:

<AccordionGroup>
  <Accordion title="Automatyczne odnawianie">
    Automatycznie odnawia Twój plan po jego wygaśnięciu. Ustaw liczbę kredytów do odnowienia w polu obok przełącznika.
  </Accordion>

  <Accordion title="Automatyczne doładowanie">
    Automatycznie kupuje dodatkowe kredyty pay-as-you-go, gdy Twoje saldo jest niskie. Ustaw liczbę kredytów do doładowania w polu obok przełącznika.
  </Accordion>

  <Accordion title="Alert o niskim saldzie">
    Otrzymuj alert e-mail, gdy saldo kredytów spadnie poniżej progu. Ustaw próg liczby kredytów w polu obok przełącznika.
  </Accordion>
</AccordionGroup>

## Co się dzieje, gdy kredyty się skończą?

Gdy saldo kredytów osiągnie zero, żądania API zwracają status HTTP `402`. Pojedyncze endpointy (find single dla e-maila/telefonu, verify single) zwracają:

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

Endpointy masowe zwracają zamiast tego `{ "message": "..." }`. Pełną listę kodów statusu i struktur odpowiedzi znajdziesz w [Status codes](/pl/status-codes) oraz [Error handling](/pl/error-handling).

<Warning>
  Aby uniknąć przerw w działaniu, włącz **Automatyczne doładowanie** lub **Alert o niskim saldzie** na [stronie rozliczeń](https://app.enrow.io/billing).
</Warning>

## Który plan wybrać?

Odwiedź [enrow.io/pricing](https://enrow.io/pricing), aby porównać plany i znaleźć rozwiązanie odpowiednie do Twoich potrzeb. Kredyty pay-as-you-go można dodać do dowolnego planu za pomocą [Automatycznego doładowania](#how-do-i-manage-billing-settings).

## FAQ

<AccordionGroup>
  <Accordion title="Czy nieudane wyszukiwania kosztują kredyty?">
    Nie. Kredyty są zużywane wyłącznie wtedy, gdy zostanie znaleziony adres e-mail lub numer telefonu albo gdy zostanie wykonane sprawdzenie weryfikacyjne. Wyszukiwanie, które nie zwraca żadnego wyniku, nie kosztuje kredytów.
  </Accordion>

  <Accordion title="Czy operacje masowe są tańsze niż pojedyncze?">
    Nie. Kredyty są naliczane za każdy pojedynczy wynik, więc operacja masowa kosztuje za każdy znaleziony adres e-mail, numer telefonu lub weryfikację tyle samo, co odpowiadające jej pojedyncze żądania. Endpointy masowe pozwalają zaoszczędzić na liczbie żądań, a nie na kredytach.
  </Accordion>

  <Accordion title="Ile kredytów kosztuje weryfikacja adresu e-mail?">
    Email Verifier zużywa 0,25 kredytu za sprawdzenie. Email Finder zużywa 1 kredyt za znaleziony adres e-mail, a Phone Finder zużywa 40 kredytów za znaleziony numer telefonu (50 w starszych planach).
  </Accordion>

  <Accordion title="Jaki błąd otrzymam, gdy nie mam już kredytów?">
    Żądania zwracają status HTTP `402`. Pojedyncze endpointy zwracają `{ "reason": "Insufficient credits", "success": false }`, natomiast endpointy masowe zwracają `{ "message": "..." }`. Szczegóły znajdziesz w [Error handling](/pl/error-handling).
  </Accordion>
</AccordionGroup>

## Następne kroki

<CardGroup cols={2}>
  <Card title="Authentication" icon="key" href="/pl/authentication">
    Jak przekazać klucz API w nagłówku x-api-key.
  </Card>

  <Card title="Account info" icon="circle-user" href="/pl/api-reference/account/info">
    Pobierz saldo kredytów i zarejestrowane webhooki.
  </Card>

  <Card title="Rate limits" icon="gauge-high" href="/pl/rate-limits">
    Poznaj limity żądań API, zanim zwiększysz skalę.
  </Card>

  <Card title="Error handling" icon="triangle-exclamation" href="/pl/error-handling">
    Obsługuj 402 i inne odpowiedzi błędów w prawidłowy sposób.
  </Card>
</CardGroup>