← Blog
10 min di lettura
|
Pubblicato
|
Aggiornato

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.

Capitoli
C
Chaingateway Team
Esperti di blockchain

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.

SegmentoObiettivo di costoObiettivo di velocità (entro fine 2027)
Pagamenti al dettaglioCosto medio non superiore all’1 per cento, nessun corridoio sopra il 3 per cento, entro fine 2027Il 75 per cento dei pagamenti disponibile per il beneficiario entro un’ora
RimesseCosto medio per l’invio di 200 $ non superiore al 3 per cento entro il 2030, nessun corridoio sopra il 5 per centoIl 75 per cento dei pagamenti disponibile entro un’ora
IngrossoNessun obiettivo fissatoIl 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/trc20 o 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.

  1. Creare un indirizzo per il cliente o per l’ordine con POST /api/v2/{chain}/addresses. Su Bitcoin la risorsa si chiama wallets.
  2. Registrare un webhook per quell’indirizzo con POST /api/v2/{chain}/webhooks, prima che il cliente paghi.
  3. Ricevere la notifica sul proprio endpoint e verificarne l’header X-Signature.
  4. Confermare la transazione con l’API e accreditare l’ordine dopo un numero sufficiente di conferme.
  5. 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.

ReteIndirizzi e trasferimentiWebhook
BitcoinSìSì
EthereumSìSì
BNB Smart ChainSìSì
TronSìSì
PolygonSìSì
ArbitrumSìSì
SolanaSì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.

C
Chaingateway Team
Esperti di blockchain

Il team di Chaingateway si impegna a semplificare l'integrazione blockchain per sviluppatori di tutto il mondo.