Vai al contenuto principale

SDK e Librerie

Accelera la tua integrazione utilizzando gli 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 ottime esperienze di pagamento.

​
URL dell’Ambiente

Scopri di più su Modalità Test vs Modalità Live.

​
Gestione delle Chiavi API e Autenticazione

1

Accedi alle Chiavi API

Naviga su Sviluppatore → Chiavi API nel tuo dashboard per gestire le tue chiavi.
2

Genera una Nuova Chiave

Seleziona Aggiungi Chiave API, 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 “Abilita accesso in scrittura” per integrazioni del dashboard, strumenti di analisi e qualsiasi sistema che ha solo bisogno di visualizzare i dati senza apportare modifiche.
3

Conserva la Tua Chiave in Sicurezza

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

Autenticare le Tue Richieste API

Utilizza 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

  • Standard: 1000 richieste al minuto per azienda
  • Burst: Fino a 100 richieste al secondo
Monitora X-RateLimit-Remaining header per tracciare l’uso.

​
Gestione degli Errori

Per gestire efficacemente gli errori, consulta le sezioni Codici di Errore e Fallimenti delle Transazioni per indicazioni dettagliate.

Codici di Errore

Approfondisci i dettagli degli errori e le loro risoluzioni.

Fallimenti delle Transazioni

Ottieni informazioni sui problemi comuni delle transazioni e le loro soluzioni.

​
Webhook

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

Guida ai Webhook

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