API blockchain per la finanza: che cosa fa
Che cosa fa un'API blockchain per i team di pagamento e finanza: wallet, trasferimenti e webhook di deposito, e che cosa non copre, come KYC e reportistica.
Verificato da Maurice Sobiera
Un’API blockchain per la finanza è un’interfaccia REST che permette al backend di un’azienda di creare wallet, inviare transazioni e ricevere notifiche di deposito su blockchain pubbliche, senza gestire nodi propri. Chaingateway la offre per Bitcoin, Ethereum, BNB Smart Chain, Tron, Solana, Polygon e Arbitrum. Sposta valore on-chain. Non sostituisce i processi di compliance.
Quale problema finanziario può affrontare un’API blockchain?
Un’API blockchain affronta il lato tecnico dello spostamento di valore on-chain: wallet, trasferimenti e conferma dei pagamenti in entrata. I pagamenti transfrontalieri sono una motivazione tipica. Il Financial Stability Board (FSB) descrive gli obiettivi che il G20 ha fissato per questi pagamenti nel suo rapporto di roadmap.
| Segmento | Obiettivo di costo | Obiettivo di velocità (entro fine 2027) |
|---|---|---|
| Pagamenti al dettaglio | Costo medio non superiore all’1 per cento, nessun corridoio sopra il 3 per cento, entro fine 2027 | Il 75 per cento dei pagamenti disponibile per il beneficiario entro un’ora |
| Rimesse | Costo medio per l’invio di 200 $ non superiore al 3 per cento entro il 2030, nessun corridoio sopra il 5 per cento | Il 75 per cento dei pagamenti disponibile entro un’ora |
| Ingrosso | Nessun obiettivo fissato | Il 75 per cento accreditato entro un’ora |
Un trasferimento on-chain è un modo tecnico per avvicinarsi agli obiettivi di velocità, perché una transazione confermata si regola tra i due wallet senza banche intermediarie. Gli obiettivi di costo dipendono da più del trasferimento. Contano le commissioni di rete, la conversione da e verso la valuta locale e le licenze delle parti coinvolte. Un’API non elimina nessuna di queste voci. Ogni affermazione sul risparmio di costi va misurata nel proprio flusso.
Che cosa fa l’API?
L’API di Chaingateway copre i passaggi di un flusso di pagamento on-chain tramite endpoint HTTP. L’autenticazione avviene con un bearer token, e un header della richiesta seleziona mainnet o testnet.
- Creare e gestire indirizzi, ad esempio con
POST /api/v2/ethereum/addresses, e leggere i saldi. - Inviare monete native e token, ad esempio con
POST /api/v2/tron/transactions/trc20o con gli endpoint ERC-20. - Leggere transazioni e ricevute.
- Registrare webhook che notificano il proprio endpoint quando un indirizzo monitorato riceve una transazione.
I webhook sono disponibili su Bitcoin, Ethereum, BNB Smart Chain, Tron, Polygon e Arbitrum. Solana non ha webhook, quindi lì i depositi si rilevano interrogando le transazioni. Le notifiche webhook non vengono ritentate in automatico. Le notifiche fallite vengono elencate, e si può chiederne il reinvio, quindi il sistema dovrebbe riconciliarsi anche con l’API. L’articolo sulle garanzie di consegna dei webhook spiega come progettare in funzione di questo aspetto.
Chaingateway è non-custodial, quindi il servizio non detiene i fondi.
Come si presenta un flusso di pagamento dall’inizio alla fine?
Un flusso di deposito ha cinque passaggi, e ciascuno corrisponde a una chiamata API.
- Creare un indirizzo per il cliente o per l’ordine con
POST /api/v2/{chain}/addresses. Su Bitcoin la risorsa si chiamawallets. - Registrare un webhook per quell’indirizzo con
POST /api/v2/{chain}/webhooks, prima che il cliente paghi. - Ricevere la notifica sul proprio endpoint e verificarne l’header
X-Signature. - Confermare la transazione con l’API e accreditare l’ordine dopo un numero sufficiente di conferme.
- Spostare i fondi sul proprio wallet di tesoreria con un endpoint di trasferimento, ad esempio
POST /api/v2/ethereum/transactions/erc20.
La tabella mostra dove questo flusso è disponibile. Il segmento di percorso {chain} è uno tra bitcoin, ethereum, bsc, tron, polygon, arbitrum o solana.
| Rete | Indirizzi e trasferimenti | Webhook |
|---|---|---|
| Bitcoin | Sì | Sì |
| Ethereum | Sì | Sì |
| BNB Smart Chain | Sì | Sì |
| Tron | Sì | Sì |
| Polygon | Sì | Sì |
| Arbitrum | Sì | Sì |
| Solana | Sì | No |
Un’API blockchain gestisce la compliance?
No. Un’API non esegue KYC, screening delle sanzioni o segnalazioni regolamentari. Questi obblighi restano all’azienda che offre il servizio, e quali si applicano dipende dal suo modello di business e dalla giurisdizione. Il nostro articolo sul KYC nei pagamenti crypto descrive i controlli da chiarire prima dell’integrazione.
Ciò che la catena fornisce è un registro. Il National Institute of Standards and Technology (NIST) degli Stati Uniti spiega nel NISTIR 8202 che gli utenti Bitcoin sono pseudonimi: la persona dietro un account non viene nominata, ma gli identificativi degli account sono visibili e tutte le transazioni sono pubbliche. I registri possono fare riferimento ad hash di transazione che chiunque può verificare. Collegare un indirizzo a un cliente è un compito del proprio processo di onboarding.
Il NIST afferma anche che le blockchain sono a prova di manomissione e resistenti alle manomissioni, ma non sono completamente immutabili. I blocchi più recenti possono essere sostituiti da una catena concorrente più lunga. Per questo la maggior parte degli utenti attende diverse conferme di blocco prima di considerare definitivo un pagamento. Si stabilisca il numero di conferme richiesto dalla propria policy di rischio, e si accreditino i clienti solo dopo quel punto.
Come si inizia?
Si inizi su una testnet. Si aggiunga l’header X-Network: testnet alle richieste per usare le reti di test, si crei un indirizzo, si invii un piccolo trasferimento e si registri un webhook per vedere arrivare una notifica. Chaingateway offre una prova gratuita di 7 giorni che non richiede carta né verifica dell’identità per iniziare. I piani a pagamento partono da 49 € al mese, oppure da 490 € all’anno.
Per un piano di sviluppo pratico, si leggano come creare un wallet crypto con un’API e come funzionano i webhook per i pagamenti crypto.
Come scriviamo questi articoli
Pronto a costruirlo da solo? Ottieni la tua API key — prova di 7 giorni, senza carta — oppure consulta Blockchain API per il riferimento completo degli endpoint.