# Informazioni Generali

> Specifica tecnica per l'integrazione dell'elaborazione dei pagamenti in criptovaluta e dei prelievi con 2328.io.

Benvenuto nella documentazione dell'API di 2328.io. Questo riferimento descrive come integrare l'elaborazione dei pagamenti in criptovaluta e i prelievi nella tua applicazione.

## Per iniziare

Per avviare l'integrazione:

1. Crea un account merchant e un progetto su [2328.io](https://2328.io)
2. Ottieni il tuo **project UUID** e l'**API key** dalle impostazioni del progetto
3. Genera una **Payout API key** separata se intendi utilizzare i prelievi
4. Leggi la sezione [Authentication](/docs/authentication) per scoprire come firmare le richieste
5. Effettua la tua prima chiamata [Create Payment](/docs/payments)

## URL di base

Tutte le richieste API in produzione utilizzano il seguente URL di base:

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

> **WARNING:** Tutte le richieste devono essere effettuate tramite **HTTPS**. Le richieste senza HTTPS vengono bloccate.

## Cosa puoi fare

Con l'API di 2328.io puoi:

- **Accettare pagamenti in criptovaluta** — creare sessioni di pagamento e reindirizzare i clienti a un checkout ospitato o a una Telegram MiniApp
- **Prelevare fondi** — inviare prelievi in modo programmatico dal saldo merchant a qualsiasi indirizzo blockchain
- **Controllare i saldi** — visualizza i saldi degli account merchant per valuta, gli equivalenti in USD e gli importi bloccati per AML
- **Utilizzare wallet statici** — generare indirizzi di deposito permanenti associati a un utente o a un ordine
- **Recuperare i tassi di cambio** — ottenere tassi in tempo reale per coppie fiat e crypto
- **Ricevere webhook** — essere notificato istantaneamente al cambio di stato di un pagamento
## Limiti di frequenza

L'API consente fino a **10 richieste al secondo per progetto**. Le richieste oltre il limite ricevono una risposta HTTP `429 Too Many Requests` — applica un backoff e riprova.