Sign in
Introduzione/Informazioni generali

Informazioni Generali

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

Visualizza come Markdown·llms.txt

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
  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 per scoprire come firmare le richieste
  5. Effettua la tua prima chiamata Create Payment

URL di base

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

Text
https://api.2328.io/api

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.