Vai al contenuto principale

SDKs & Libraries

Accelera la tua integrazione utilizzando SDK ufficiali per TypeScript, Python, Go, PHP, Java, Kotlin, C#, Ruby e React Native. Queste librerie semplificano le richieste API, l’autenticazione e la gestione degli errori, permettendoti di concentrarti sulla creazione di esperienze di pagamento eccellenti.

​
URL dell’Ambiente

Scopri di più su Modalità di test vs modalità live.

​
Gestione delle Chiavi API e Autenticazione

1

Access API Keys

Vai su Developer → API Keys nella tua dashboard per gestire le chiavi.
2

Generate a New Key

Seleziona Add API Key, fornisci un nome descrittivo e configura l’accesso in scrittura:
  • Abilita accesso in scrittura (selezionato): Permessi completi di lettura e scrittura per tutte le operazioni API
  • Abilita accesso in scrittura (non selezionato): Accesso in sola lettura - può solo recuperare dati (pagamenti, abbonamenti, clienti, prodotti). Non può creare o modificare risorse.
Deseleziona “Enable write access” per le integrazioni della dashboard, gli strumenti di analisi e qualsiasi sistema che deve solo visualizzare i dati senza apportare modifiche.
3

Store Your Key Securely

Copia immediatamente la chiave generata e assicurati che sia archiviata in modo sicuro.
4

Authenticate Your API Requests

Usa le tue chiavi API per autenticare tutte le richieste. Applica il seguente formato di autorizzazione:
Authorization: Bearer YOUR_API_KEY
Non esporre mai le tue chiavi API segrete nel codice lato client o in repository pubblici.

​
Formato della Risposta

{
  "id": "pay_1234567890",
  "status": "completed",
  "amount": 2999,
  "currency": "USD",
  "created_at": "2024-01-15T10:30:00Z"
}

​
Limiti di Richiesta

La nostra API utilizza un sistema di limitazione delle richieste a doppia finestra con protezione burst. I limiti vengono applicati in base al metodo di autenticazione e al livello aziendale.

​
Limiti predefiniti (Livello 0)

FinestraLimite
Al secondo (Burst)40 richieste
Al minuto (Sostenuto)240 richieste

​
Livelli aziendali

Sono disponibili limiti più elevati per le aziende con esigenze API maggiori:
LivelloBurst (al secondo)Sostenuto (al minuto)
Livello 0 (Predefinito)40240
Livello 11001.000
Livello 25005.000
Contatta l’assistenza per aggiornare la tua azienda a un livello con limiti più elevati.

​
Richieste non autenticate

Le richieste senza intestazioni di autenticazione valide sono limitate per indirizzo IP:
FinestraLimite
Al secondo (Burst)20 richieste
Al minuto (Sostenuto)100 richieste

​
Intestazioni del limite di richiesta

Monitora il tuo utilizzo con queste intestazioni di risposta:
  • X-RateLimit-Limit - Richieste massime consentite
  • X-RateLimit-Remaining - Richieste rimanenti nella finestra corrente
  • X-RateLimit-Reset - Tempo di reset del limite di richiesta
Quando superi i limiti, l’API restituisce una risposta 429 Too Many Requests. Implementa un backoff esponenziale nella logica di tentativo.

​
Gestione degli errori

Per gestire efficacemente gli errori, consulta le sezioni Error Codes e Transaction Failures per indicazioni dettagliate.

Error Codes

Approfondisci i dettagli completi sugli errori e sulle relative risoluzioni.

Transaction Failures

Ottieni informazioni sui problemi di transazione più comuni e sulle loro soluzioni.

​
Webhooks

Ricevi notifiche in tempo reale sugli eventi di pagamento. Consulta la nostra Guida ai webhook per le istruzioni di configurazione.

Webhook Guide

Configura i webhook per le notifiche in tempo reale e la gestione degli eventi.

Webhook Guide

Set up webhooks for real-time notifications and event handling.