# Informacje ogólne

> Specyfikacja techniczna integracji przetwarzania płatności kryptowalutowych i wypłat z 2328.io.

Witamy w dokumentacji API 2328.io. Niniejsza dokumentacja referencyjna opisuje, jak zintegrować przetwarzanie płatności kryptowalutowych oraz wypłat z Państwa aplikacją.

## Pierwsze kroki

Aby rozpocząć integrację:

1. Załóż konto sprzedawcy oraz projekt na [2328.io](https://2328.io)
2. Pobierz **project UUID** oraz **API key** z ustawień projektu
3. Wygeneruj osobny **Payout API key**, jeśli planujesz korzystać z wypłat
4. Zapoznaj się z sekcją [Authentication](/docs/authentication), aby dowiedzieć się, jak podpisywać żądania
5. Wykonaj swoje pierwsze wywołanie [Create Payment](/docs/payments)

## Bazowy URL

Wszystkie produkcyjne żądania API korzystają z następującego bazowego URL:

```
https://api.2328.io/api
```

> **WARNING:** Wszystkie żądania muszą być wykonywane przez **HTTPS**. Żądania bez HTTPS są blokowane.

## Co możesz robić

Za pomocą API 2328.io możesz:

- **Akceptować płatności kryptowalutowe** — twórz sesje płatności i przekierowuj klientów do hostowanego checkoutu lub Telegram MiniApp
- **Wypłacać środki** — programowo wysyłaj wypłaty z salda sprzedawcy na dowolny adres blockchain
- **Sprawdzanie sald** — zobacz salda kont merchanta dla każdej waluty, ekwiwalenty w USD i kwoty zablokowane przez AML
- **Korzystać ze statycznych portfeli** — generuj trwałe adresy depozytowe powiązane z użytkownikiem lub zamówieniem
- **Pobierać kursy walutowe** — uzyskuj kursy w czasie rzeczywistym dla par fiat i kryptowalut
- **Otrzymywać webhooki** — natychmiast otrzymuj powiadomienia o zmianie statusu płatności
## Limity zapytań

API pozwala na maksymalnie **10 żądań na sekundę na projekt**. Żądania przekraczające limit otrzymują odpowiedź HTTP `429 Too Many Requests` — zastosuj wycofanie i spróbuj ponownie.