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

# Kredyty i rozliczenia

> Jak działają kredyty, co kosztuje kredyt i jak plany obniżają cenę kartki.

Paperjoy działa w modelu przedpłaconym. Jeden kredyt to jedna pocztówka live: kartka, odręczne pismo, koperta i znaczek.

## Co zużywa kredyt

| Działanie | Koszt |
| - | - |
| Utworzenie pocztówki live (edytor, Zapier, MCP lub API) | 1 kredyt |
| Zapisanie, edycja, podgląd lub usunięcie [szkicu](https://docs.paperjoy.co/postcards/drafts.md) | Za darmo |
| Wysłanie szkicu live | 1 kredyt |
| Utworzenie pocztówki testowej | Za darmo |
| Podgląd kartki | Za darmo |
| Lista, pobranie pocztówki, sprawdzenie salda | Za darmo |
| Pocztówka odrzucona przez weryfikację treści | Zwrot automatyczny |
| Ponowienie z tym samym `Idempotency-Key` | Za darmo, zwraca pierwotną pocztówkę |

Kredyt jest pobierany w chwili złożenia zamówienia: gdy tworzysz pocztówkę bez `draft` albo gdy wysyłasz szkic. Szkice nigdy nie zużywają kredytów.

## Sprawdź saldo

Saldo widać w górnej części edytora i na stronie [Rozliczenia](https://paperjoy.co/billing). W kodzie użyj `GET /api/user` albo narzędzia MCP `get-account-status`:

```json theme={null}
{
  "data": {
    "id": "user_abc123",
    "name": "Marta Nowak",
    "email": "marta@example.com",
    "available_credit_balance": 48
  }
}
```

Pocztówki testowe nigdy nie zmieniają `available_credit_balance`.

## Kup kredyty

Otwórz [**Rozliczenia**](https://paperjoy.co/billing) i kliknij **Kup kredyty**. Jednorazowo możesz kupić od 5 do 1000 kredytów. Płacisz bezpiecznie przez Stripe. Faktury są wystawiane na dane Twojej organizacji.

![Strona Rozliczenia z aktualnym saldem kredytów, planami Start, Pro i Business oraz historią doładowań.](https://mintcdn.com/paperjoy/F1MJj4Vyrx0MCZIR/images/app/billing.webp?fit=max\&auto=format\&n=F1MJj4Vyrx0MCZIR\&q=85\&s=75c684fa5a81a2b484d13423e969e9de)

## Plany

Plan obniża cenę każdego kredytu i odblokowuje dodatkowe funkcje. Aktualne ceny zawsze znajdziesz na stronie [Rozliczenia](https://paperjoy.co/billing).

| | Start | Pro | Business |
| - | - | - | - |
| Abonament miesięczny | Brak | Tak | Tak |
| Cena kredytu | Standardowa | Niższa | Najniższa |
| Edytor, Zapier, MCP i API | Tak | Tak | Tak |
| [Własne podpisy](https://docs.paperjoy.co/postcards/custom-signatures.md) | — | 1 | Do 3 |
| Pomoc w pierwszej kolejności | — | Tak | Tak |
| Twoje kartki piszemy w pierwszej kolejności | — | — | Tak |
| Pomoc w podłączeniu Twojego systemu | — | — | Tak |

Plan zmienisz lub anulujesz na stronie Rozliczenia. Po wykupieniu abonamentu nowy plan może pojawić się z niewielkim opóźnieniem, gdy płatność jest potwierdzana.

## Brak kredytów

Pocztówki live nie zostaną utworzone, gdy saldo spadnie poniżej jednego kredytu:

| Sposób | Co zobaczysz |
| - | - |
| API | `402 Payment Required` z komunikatem `"You need at least 1 credit to create a postcard."` |
| MCP | Narzędzie zwraca ten sam komunikat jako błąd. |
| Zapier | Uruchomienie kończy się błędem. Doładuj konto i uruchom Zapa ponownie. |
| Edytor | Przycisk wysyłki jest nieaktywny, dopóki nie dodasz kredytów. |

Wysłanie szkicu bez kredytów też zwraca `402`, a pocztówka zostaje szkicem, więc nic nie przepada.

Po doładowaniu wyślij pocztówkę ponownie. Możesz użyć tego samego `Idempotency-Key`: Paperjoy nie zapisuje odpowiedzi `402`, więc ponowienie utworzy pocztówkę.


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