Come funziona l'integrazione con l'API di Upay: una guida completa per le aziende

La tua azienda sta perdendo denaro se non accetti pagamenti in criptovalute. Il mondo gateway di pagamento crittografico Il mercato, valutato a 2.39 miliardi di dollari nel 2026, dovrebbe raggiungere i 4.74 miliardi di dollari entro il 2030.

Tuttavia, il problema non è la domanda, ma la configurazione. La maggior parte delle aziende non sa da dove iniziare. È qui che entra in gioco l'integrazione con l'API di Upay.

Upay offre alle aziende un modo semplice e intuitivo per gli sviluppatori di accettare pagamenti in criptovalute, emettere carte personalizzate e inviare pagamenti in tutto il mondo senza dover costruire un'infrastruttura di pagamento da zero.

Punti chiave

• L'integrazione con l'API di Upay consente alle aziende di accettare pagamenti in criptovalute, emettere carte personalizzate e inviare pagamenti senza dover creare un'infrastruttura di pagamento da zero.
• Il processo di integrazione si articola in diverse fasi: registrazione, lettura della documentazione, configurazione dell'ambiente di test (sandbox), generazione delle chiavi API, effettuazione della prima richiesta, configurazione dei webhook e messa in produzione.
• Ogni richiesta API di Upay richiede l'inserimento dell'indirizzo IP in una whitelist, quattro intestazioni personalizzate e una firma crittografica valida per 60 secondi.
• L'ambiente sandbox è disponibile per tutti i partner e consente di effettuare test in sicurezza prima di andare in produzione.
  

Leggi anche: Le migliori carte di criptovalute con supporto per Apple Pay e Google Pay

Cos'è Upay?

Fondata nel 2023, Upay è una piattaforma globale di pagamenti in criptovalute creata per trasferire denaro, non solo per conservarlo. Mentre molti fornitori si concentrano esclusivamente su portafogli o exchange, Upay combina infrastrutture di pagamento, emissione di carte, accettazione di criptovalute e funzionalità di prelievo in un unico ecosistema pensato sia per i consumatori che per le aziende.

L'azienda gestisce due piattaforme distinte. La sua offerta per i consumatori, disponibile tramite Upay.bestFornisce agli utenti un portafoglio di criptovalute e carte di pagamento collegate a criptovalute per spendere asset digitali in tutto il mondo. 

Dal lato commerciale, business.upay.com Offre un'infrastruttura di livello enterprise che consente alle aziende di accettare pagamenti in criptovaluta, lanciare carte Visa personalizzate tramite la sua soluzione White Label, gestire i wallet e automatizzare i pagamenti di massa attraverso un'API unificata.

Ciò che distingue Upay è il suo approccio incentrato sui pagamenti. Invece di offrire servizi di criptovalute a sé stanti, fornisce un'infrastruttura finanziaria completa che aiuta le aziende a integrare la blockchain con la finanza tradizionale.

Attraverso un'unica integrazione, le aziende possono accettare criptovalute, convertire fondi, emettere cartagestire la conformità e regolare i pagamenti a livello globale.

Sicurezza e conformità sono al centro della piattaforma. Upay è autorizzata a Dubai e collabora con il partner per la sicurezza SlowMist, il partner per i pagamenti StraitsX, il partner per la verifica dell'identità (KYC) Sumsub e Tencent Cloud per l'infrastruttura.

Si tratta di una suite di soluzioni incentrata sulla conformità, pensata per le aziende che necessitano di soluzioni di pagamento sicure, scalabili e regolamentate per le proprie attività a livello globale.

Che cos'è un'API e perché è importante per i pagamenti?

Fonte: business.upay.com

Un'API (Application Programming Interface) è un ponte tra due sistemi software. Permette al tuo sito web o alla tua app di comunicare con un'altra piattaforma e di scambiare informazioni in modo automatico.

Immaginate un sistema di ordinazione simile a quello di un ristorante: dite al cameriere cosa volete. Il cameriere va in cucina, dove il cibo viene preparato e poi riportato al tavolo. Voi non vedete mai la cucina. 

An API Funziona allo stesso modo. Il tuo sito web invia una richiesta, il sistema di Upay la elabora e restituisce una risposta. Il tuo cliente non vede mai nulla di ciò che avviene dietro le quinte.

Senza un'API, accettare criptovalute richiederebbe l'esecuzione della propria blockchain nodo, monitoraggio manuale delle transazioni in entrata, gestione delle conversioni di valuta e creazione di un proprio livello di sicurezza.

Si tratta di mesi di lavoro di progettazione. Tuttavia, con l'integrazione dell'API di Upay, è sufficiente connettersi una sola volta e la piattaforma si occupa del resto.

Leggi anche: Coin Ticker: le tre lettere che rappresentano un intero progetto crypto.

Cosa puoi fare con l'integrazione API di Upay

L'API Upay Business copre diverse funzionalità principali ed è consultabile all'indirizzo https://upay-api.readme.io/reference/api-list.

Accettazione di pagamenti in criptovalute (API Acquirer)

Consenti alla tua azienda di accettare pagamenti in criptovalute da clienti di tutto il mondo grazie a un'infrastruttura di pagamento efficiente.

L'API Acquirer genera indirizzi di portafoglio univoci per ogni transazione, consentendo di tracciare i pagamenti in modo accurato e di automatizzare la riconciliazione. 

Consente inoltre di creare e gestire ordini, elaborare rimborsi e annullare transazioni quando necessario, offrendo ai commercianti il ​​controllo completo sul ciclo di vita dei pagamenti e semplificando l'accettazione di criptovalute su larga scala.

Emissione di carte (API per carte)

Lancia carte di pagamento virtuali e fisiche personalizzate senza dover costruire l'infrastruttura da zero. L'API Card ti consente di emettere carte ai clienti e di gestire ogni fase del loro ciclo di vita, dall'attivazione e finanziamento al blocco, sblocco e cancellazione. 

UPay, attraverso la sua soluzione White Label, gestisce la produzione, l'evasione degli ordini e la consegna delle carte, consentendo alle aziende di offrire un programma di carte completamente personalizzato con costi operativi minimi.

Gestione del portafoglio di criptovalute (API del portafoglio)

Integra funzionalità di portafoglio di criptovalute sicure direttamente nella tua piattaforma. L'API Wallet consente alle aziende di generare e gestire indirizzi di portafoglio, monitorare i depositi, elaborare i prelievi e trasferire asset digitali in modo efficiente. 

I controlli AML integrati aiutano a vagliare le transazioni in entrata e a soddisfare i requisiti di conformità, rendendoli una soluzione ideale per borse valori, piattaforme fintech e applicazioni che custodiscono fondi per conto degli utenti.

Pagamenti (API di prelievo)

Automatizza i pagamenti in criptovalute a privati ​​o aziende in qualsiasi parte del mondo. L'API Outlay consente alle piattaforme di inviare fondi a indirizzi di wallet esterni in modo rapido ed efficiente, sia per stipendi, pagamenti a freelance, commissioni di affiliazione, programmi fedeltà o erogazioni di massa. 

Progettato per transazioni ad alto volume, semplifica le operazioni di pagamento riducendo al contempo la complessità della gestione di trasferimenti di criptovalute su larga scala.

Come funziona l'integrazione API di Upay, passo dopo passo

Ecco come funziona il processo di integrazione dell'API di Upay, dalla registrazione alla prima transazione reale.

Passaggio 1: Registrati e completa la procedura KYC

Fonte: business.upay.com

Innanzitutto, dovrai contattare direttamente il loro team commerciale tramite il Sito web di Upay per richiedere l'accesso alla loro infrastruttura B2B scalabile e agli strumenti API.

Una volta sulla pagina web, scorri verso il basso fino a "Collabora con noi" e fai clic sulla scheda. Si aprirà la pagina come nell'immagine qui sopra; compila le informazioni richieste nella sezione "Richiesta", seleziona la scheda "Integrazione API" e fai clic sulla scheda "Richiedi una demo gratuita".

Una volta che il team di Upay ti contatterà, scarica Upay dal sito web oppure dall'Apple Store o dal Google Play Store e crea un account aziendale. 

Prima di accedere all'API, dovrai completare la verifica dell'identità (KYC). Questa procedura è standard per qualsiasi piattaforma di pagamento regolamentata e protegge sia te che i tuoi clienti.

Passaggio 2: Leggere la documentazione per gli sviluppatori

Ogni API è accompagnata da una documentazione che funge da manuale di istruzioni. Spiega gli endpoint disponibili, quali dati inviare e cosa aspettarsi in risposta.

Leggi la documentazione prima di scrivere una sola riga di codice. Upay fornisce la documentazione API completa tramite il suo portale per sviluppatori all'indirizzo https://upay-api-en.readme.io.

Passaggio 3: Ottenere la chiave pubblica/chiave API/chiave segreta della piattaforma

Fonte: upay-api-en.readme.io

Puoi ottenere la chiave API pubblica/chiave API/chiave segreta della piattaforma dalla tua dashboard commerciante. Una chiave API è una lunga stringa di caratteri che funge da password per il tuo account quando comunichi con il sistema Upay.

• Chiave API: fornita da UPay, un identificativo univoco per il commerciante.
• Chiave segreta: utilizzata per la firma dei dati durante le richieste API.
• Chiave pubblica della piattaforma: fornita da UPay, utilizzata per crittografare i parametri durante le richieste API.
• Chiave privata della piattaforma: utilizzata da UPay per decrittografare i parametri dopo aver ricevuto la richiesta API, ottenendo così i dati originali.

Esempio: 

—–INIZIO CHIAVE PUBBLICA—–

MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA2r69mrDofiNPIAKNRV5v

BeVBjEnrYPgKf8LKDK+gLhLrepuTc+gxlJurH/gYwgRwD8DL5rmdcXRZMpX+L8gx

yszzD0qFWnBoumN1RHx2kkok1vgLr/dBlJRwVPZbZT69m/B8kGWR8JboBVOWJwxn

DX6WaRDyWVa2qu1KogQq4m028gJWZlVzs0bSExQqSW5ZiUFGyJygjTa2XAKqceSe

xHov8jR66mpnv0vJy6+4YJK34t2VzyNdEqseTE3spZkSJCzzxNV7xIs63u/WTenK

J1BWar+/rA63A+/0Lt2BB/Uf/iq0OwGm4t2d0Pf1O7hylXXP65BGunWvu0QWCsNo

xQIDAQAB

—–FINE CHIAVE PUBBLICA—–

Importante: non inserire mai la chiave API direttamente nel codice front-end del tuo sito web. Archiviala in modo sicuro sul tuo server, poiché chiunque la trovi può effettuare richieste per tuo conto.

Passaggio 4: Configurare la chiave pubblica del commerciante

Fonte: upay-api-en.readme.io

Chiave pubblica del commercianteIl commerciante configura la chiave pubblica generata sulla propria piattaforma. Se una richiesta API è crittografata, anche i dati di risposta saranno crittografati.

UPay crittograferà i dati della risposta utilizzando la chiave pubblica del commerciante.

Chiave privata del commercianteDopo aver ottenuto i dati di risposta dell'API, il commerciante li decifra utilizzando la propria chiave privata per recuperare i dati di risposta originali.

Passaggio 5: Creare l'API di richiesta di pagamento

Quando un cliente sceglie di pagare con criptovalute, il tuo backend invia una richiesta all'API di Upay. La richiesta comunica a Upay: Un cliente desidera pagare. Genera un indirizzo di pagamento.

POST /v2/pagamenti/indirizzi

{ “chain”: “ETH”, “asset”: “USDT”, “label”: “order_00245”, “callback_url”: “https://yourshop.com/webhooks/crypto” }

Risposta: { “address”: “0x742d35Cc6634C0532925a3b844Bc…”, “asset”: “USDT”, “created_at”: “2026-05-18T10:30:00Z” }

Ecco come si presenta tale richiesta in termini semplici:

• Cosa inviare: L'importo, la valuta (ad esempio, USDT) e un URL di callback (il tuo endpoint webhook)
• Cosa riceverai in cambio: Un indirizzo univoco del portafoglio e un codice QR che il cliente può scansionare.
  

Ogni ordine riceve un indirizzo di portafoglio univoco. Ciò impedisce qualsiasi sovrapposizione tra le transazioni e semplifica la riconciliazione.

Passaggio 6: Impostare i webhook

Un webhook è una notifica automatica che Upay invia al tuo server quando un pagamento viene confermato sulla blockchain.

Invece di ricevere ripetutamente la richiesta di pagamento, Upay ti avvisa nell'istante stesso in cui il pagamento viene ricevuto. Pensala come una notifica di consegna da parte di un corriere.

Non devi aggiornare continuamente la pagina di tracciamento; devi attendere il messaggio di testo. Quando il webhook arriva, il tuo sistema aggiorna lo stato dell'ordine, invia una conferma al cliente e avvia la fase successiva del flusso di evasione.

Leggi anche: Cosa significa 5x nel mondo delle criptovalute?

Passaggio 7: Impostare una lista bianca di indirizzi IP

Fonte: upay-api-en.readme.io

È possibile limitare l'accesso all'API specificando gli indirizzi IP autorizzati a connettersi. Se non viene configurato alcun indirizzo IP, l'API accetta per impostazione predefinita le richieste da tutti gli IP.

È possibile inserire nella whitelist più indirizzi IP separandoli con delle virgole.

Esempio : 127.0.0.1, 127.0.0.2

Passaggio 8: Configura il tuo ambiente sandbox

Una sandbox è un ambiente di test in cui non vengono movimentati soldi reali. Riproduce fedelmente il sistema live. L'ambiente di test di Upay è disponibile all'indirizzo https://openapi.upay-test.best ed è accessibile a tutti i partner fin dal primo giorno. 

Utilizza l'ambiente di test (sandbox) per simulare i pagamenti, attivare le notifiche webhook e verificare come il tuo sistema gestisce i pagamenti non andati a buon fine o parziali. Questo passaggio è molto importante, quindi non saltarlo.

Passaggio 9: vai in diretta

Una volta che tutto è stato testato e verificato, passa dalla modalità sandbox alla modalità live utilizzando la tua chiave API di produzione. Upay condivide le credenziali dell'ambiente di produzione direttamente con i partner approvati dopo la revisione dell'onboarding. A questo punto, i pagamenti reali possono essere elaborati tramite il tuo sistema.

Ambiente API Upay 

UPay offre ambienti di test e di produzione separati, consentendo agli sviluppatori di testare le integrazioni in tutta sicurezza prima di pubblicarle. Crea e convalida i tuoi flussi di pagamento nell'ambiente di test, quindi passa all'ambiente di produzione quando sei pronto a elaborare transazioni reali.

Ambiente	URL	Descrizione
Test	https://openapi.upay-test.best	Disponibile per tutti i partner per la creazione e il test delle loro integrazioni.
STG (Staging)	attualmente non disponibile	N/A
Produzione	Non divulgato pubblicamente	L'ambiente in modalità live fornito da Upay

Sicurezza dell'API Upay: condizioni e restrizioni di accesso

Ogni richiesta API a Upay deve soddisfare quattro requisiti di sicurezza.

Fattore di sicurezza	Cosa fa	Obbligatorio
Whitelist IP	L'indirizzo IP del tuo server deve essere registrato su Upay prima che le richieste vengano accettate.	I veri
Risposta Verifica IP	Il tuo sistema accetta risposte solo dall'indirizzo IP verificato di Upay.	I veri
Risposte Webhook	Alcune transazioni attivano una seconda conferma tramite webhook	Falso
Finestra di firma di 60 secondi	Ogni richiesta firmata scade dopo 60 secondi per bloccare gli attacchi di replay.	Si

La finestra temporale di 60 secondi è la più importante. Un attacco di replay si verifica quando qualcuno intercetta una richiesta valida e tenta di reinviarla in un secondo momento.

La finestra della firma lo impedisce. Assicurati che l'orologio del tuo server sia sincronizzato tramite NTP (Network Time Protocol) prima di iniziare l'integrazione.

Intestazioni di richiesta/risposta dell'API Upay

Ogni richiesta/risposta richiede quattro intestazioni HTTP personalizzate. Queste intestazioni lavorano insieme per verificare che ogni richiesta sia autentica, tempestiva e provenga dall'account corretto.

• X-UPA-APIKEY: Questa è la tua chiave API univoca assegnata da UPay. Solo chi possiede questa chiave può accedere ed effettuare chiamate.
• X-UPA-REQUESTID: Un ID univoco per ogni richiesta per evitare l'elaborazione duplicata.
• X-UPA-TIMESTAMP: Il timestamp corrente in millisecondi
• X-UPA-SIGN: Una firma crittografica che dimostra che la richiesta non è stata alterata.
  

Richiedi intestazioni

Settore	Tipo di dati	Spiegazione	Effect
X-UPA-APIKEY	Corda	Richiesta di chiave API	Identificare e differenziare gli utenti white-label
X-UPA-REQUESTID	Corda	Richiesta di un codice univoco	Richiesta di idempotenza
X-UPA-TIMESTAMP	Corda	Timestamp in millisecondi	Richiesta di tempo; se non si riceve risposta entro 60 secondi, la richiesta scade e non viene più elaborata. Previene attacchi di replay.
X-UPA-SIGN	Corda	Sartoriale	Firma a conferma dell'autenticità e della correttezza del richiedente.

Header di risposta

Settore	Tipo di dati	Spiegazione
X-UPA-REQUESTID	Corda	Richiedi un codice univoco identico all'ID della richiesta per garantire la coerenza nella risposta.
X-UPA-TIMESTAMP	Corda	Timestamp della risposta, timestamp, millisecondi

Un esempio concreto di integrazione dell'API di Upay in azione.

Tunde, un'azienda di Lagos specializzata nel commercio di beni digitali, vende a clienti in Nigeria, Regno Unito, Canada ed Emirati Arabi Uniti. In precedenza, i bonifici bancari internazionali richiedevano spesso diversi giorni lavorativi per essere elaborati e comportavano costose commissioni di conversione valuta.

Dopo aver integrato l'API di Upay nel suo processo di pagamento, le transazioni sono diventate quasi istantanee. Quando un cliente di Toronto seleziona "Paga con criptovalute", il sistema di Tunde invia una richiesta a Upay, che genera un indirizzo di pagamento USDT univoco e un codice QR. 

Il cliente completa il pagamento dal proprio portafoglio e Upay monitora e verifica automaticamente la transazione sulla blockchain. Una volta confermata, un webhook notifica la piattaforma di Tunde, attivando l'evasione dell'ordine e la consegna.

L'intero processo richiede meno di due minuti, eliminando i ritardi bancari e riducendo i costi di pagamento non necessari. Secondo Dati sulla proprietà delle squadre di Triple-ANel 2024, il numero di persone che possiedono criptovalute a livello globale ha raggiunto circa 562 milioni, con un aumento del 34% rispetto ai 420 milioni dell'anno precedente. 

Questa crescita è esattamente il motivo per cui sempre più aziende come Tunde stanno aggiungendo l'opzione di pagamento in criptovalute anziché considerarla una funzionalità di nicchia, e UPay sta offrendo questo servizio su scala globale.

Perché le aziende scelgono Upay

Se desideri integrare i pagamenti in criptovalute senza complessità tecniche, UPay offre una soluzione pratica e scalabile. È il suo business.

L'API offre ai commercianti diverse opzioni di pagamento, la possibilità di personalizzare le carte con il proprio marchio e molto altro, con pagamenti istantanei e conversione automatica da criptovaluta a valuta fiat. 

Grazie alle registrazioni normative negli Stati Uniti, in Canada, a Hong Kong e negli Emirati Arabi Uniti, UPay offre la sicurezza, la conformità e la portata globale necessarie per semplificare i moderni pagamenti in criptovalute e supportare la crescita a lungo termine.