API per l'emissione di carte
2328 è un'API per l'emissione di carte virtuali per i team che desiderano offrire una carta di pagamento ai propri utenti senza diventare un emittente autorizzato. Registri i titolari di carta, emetti carte sotto un BIN sponsorizzato, le finanzi dal tuo wallet USDT e controlli l'intero ciclo di vita — blocca, scarica, chiudi — tramite un'unica interfaccia REST.
Costruire un programma di carte nel modo tradizionale significa una licenza di circuito, un BIN, un processore, una banca sponsor e diciotto mesi di lavoro di certificazione prima che la prima autorizzazione venga approvata. Questo lavoro è già stato fatto qui. Ciò che rimane dalla tua parte è la parte che è effettivamente il tuo prodotto: chi riceve una carta, quanto può spendere e come appare l'esperienza.
L'API è solo JSON, tutti i campi sono in camelCase e ogni richiesta, eccetto il public health check, è autorizzata con una chiave Bearer. Il denaro è sempre un numero intero in unità minori con una valuta e una scala esplicite — il wallet è USDT con scala 6, le carte sono USD con scala 2 — quindi non c'è mai un float ambiguo in un registro.
Titolari di carta
Registra i titolari di carta con i dati di identità richiesti dal programma, quindi emetti una o più carte per ciascuno di essi. L'onboarding, i limiti e il ciclo di vita sono gestiti interamente dalla tua parte.
Emissione istantanea di carte virtuali
Le carte vengono create con una singola chiamata API e sono immediatamente utilizzabili — niente plastica, niente spedizione, nessun passaggio di attivazione. Emettine una per utente, per abbonamento, per campagna o per fornitore.
Finanziamento da un wallet USDT
Le carte sono finanziate dal tuo saldo di stablecoin. USDT arriva con scala 6, il saldo della carta è USD con scala 2, e l'API è esplicita su entrambi in modo che i registri non si discostino mai.
Controllo completo del ciclo di vita
Blocca, sblocca, scarica e chiudi le carte programmaticamente. Una carta compromessa è disattivata con una singola richiesta; una sottoscrizione terminata non costa nulla da chiudere.
Saldi e transazioni
Leggi i saldi delle carte in tempo reale e la cronologia delle transazioni dell'intero programma, incluse autorizzazioni, regolamenti, rifiuti e commissioni.
Ordini e webhook
Le operazioni di denaro sono asincrone: si invia un'operazione, si riceve un ordine e si considera il webhook come la fonte di verità, anziché presumere il successo con un 200.
Sponsorizzazione BIN, senza la deviazione di due anni
Ogni carta è ancorata a un BIN — il numero che indica ai circuiti di carte quale istituzione autorizzata la supporta. Ottenerne uno proprio significa diventare un membro principale di Visa o Mastercard: licenza normativa, garanzie del circuito, requisiti di capitale e anni di certificazione.
Le carte emesse tramite 2328 operano su un BIN sponsorizzato esistente. L'istituzione sponsorizzatrice detiene l'adesione al circuito e si occupa del regolamento con la rete; tu mantieni il prodotto, il branding, la relazione con il titolare della carta e l'economia. In pratica, questo trasforma un progetto di licenza in un progetto di integrazione.
L'onboarding richiede comunque una vera due diligence — ti verrà chiesto chi sono i tuoi titolari di carta, da dove provengono i fondi e come sono la tua KYC e il tuo monitoraggio. Più chiare sono queste risposte, più velocemente il programma inizia.
Come procede un'integrazione
- 1.Concorda il programma: profilo del titolare della carta, flusso di finanziamento, aree geografiche e limiti.
- 2.Ottieni le chiavi API e verifica la connettività rispetto all'endpoint pubblico GET /ping.
- 3.Registra il tuo primo titolare di carta ed emetti una carta nell'ambiente live.
- 4.Finanzia la carta dal tuo wallet USDT e conferma l'ordine risultante tramite webhook.
- 5.Integra saldi, transazioni e operazioni del ciclo di vita nel tuo prodotto.
- 6.Vai live e scala — l'emissione è una singola chiamata, quindi il volume non è un problema di ingegneria.
Domande frequenti
Ho bisogno di una mia licenza o BIN per emettere carte?
No. Le carte vengono emesse sotto un BIN sponsorizzato esistente, quindi non è necessario diventare un membro principale di Visa o Mastercard. Descrivi i tuoi titolari di carta e il flusso di finanziamento durante l'onboarding; la licenza e il regolamento del circuito sono a carico dell'istituzione sponsorizzatrice.
Quale autenticazione utilizza l'API di emissione delle carte?
Autenticazione Bearer. Ogni richiesta, eccetto il controllo di integrità pubblico, include Authorization: Bearer ck_{keyId}_{secret}. La chiave identifica il tuo account, quindi nessun ID commerciante o account viene passato nel payload. Mantieni la chiave solo sul tuo backend.
Come vengono finanziate le carte?
Dal tuo wallet USDT all'interno di 2328. Il finanziamento converte la stablecoin in un saldo USD della carta. Il wallet è USDT con scala 6 e le carte sono USD con scala 2 — gli importi sono sempre numeri interi in unità minori con una valuta e una scala esplicite.
Le operazioni con le carte sono sincrone?
Le operazioni di denaro sono asincrone. Una richiesta di finanziamento o scarico restituisce un ordine che segui fino al completamento, e un webhook conferma lo stato finale. Le operazioni di lettura come saldi e transazioni sono sincrone.
Esiste un ambiente sandbox?
Esiste un unico ambiente live — nessuna chiave sandbox separata. Un endpoint pubblico GET /ping è disponibile senza autenticazione per i controlli di liveness.
Per cosa possono essere utilizzate le carte?
I programmi tipici coprono abbonamenti online, spese pubblicitarie, spese per dipendenti e collaboratori, pagamenti per marketplace e spese generali dei consumatori finanziate in criptovalute. I casi d'uso consentiti vengono concordati durante l'onboarding del programma.