
API voor kaartuitgifte
2328 is een API voor de uitgifte van virtuele kaarten voor teams die hun gebruikers een betaalkaart willen aanbieden zonder zelf een gelicentieerde uitgever te worden. U registreert kaarthouders, geeft kaarten uit onder een gesponsorde BIN, financiert deze vanuit uw USDT-wallet en beheert de gehele levenscyclus — bevriezen, ontladen, sluiten — via één REST-interface.
Het opzetten van een kaartprogramma op de traditionele manier betekent een schemalicentie, een BIN, een processor, een sponsorende bank en achttien maanden certificeringswerk voordat de eerste autorisatie wordt goedgekeurd. Dat werk is hier al gedaan. Wat aan uw kant overblijft, is het deel dat daadwerkelijk uw product is: wie krijgt een kaart, wat ze kunnen uitgeven en hoe de ervaring eruitziet.
De API is alleen JSON, alle velden zijn camelCase, en elke aanvraag, behalve de openbare health check, is geautoriseerd met een Bearer key. Geld is altijd een geheel getal in kleinere eenheden met een expliciete valuta en schaal — de wallet is USDT op schaal 6, kaarten zijn USD op schaal 2 — zodat er nooit een dubbelzinnige float in een grootboek is.
Kaarthouders
Registreer kaarthouders met de identiteitsgegevens die het programma vereist, en geef vervolgens één of meerdere kaarten uit onder elk van hen. Onboarding, limieten en levenscyclus worden volledig vanuit uw kant beheerd.
Directe uitgifte van virtuele kaarten
Kaarten worden gemaakt met één enkele API-aanroep en zijn direct bruikbaar — geen plastic, geen verzending, geen activeringsstap. Geef er één uit per gebruiker, per abonnement, per campagne of per leverancier.
Financiering vanuit een USDT-wallet
Kaarten worden gefinancierd vanuit uw stablecoin-saldo. USDT komt binnen op schaal 6, het kaartsaldo is USD op schaal 2, en de API is expliciet over beide, zodat de grootboeken nooit afwijken.
Volledige levenscyclusbeheer
Kaarten programmatisch bevriezen, deblokkeren, ontladen en sluiten. Een gecompromitteerde kaart is met één verzoek onbruikbaar; een beëindigd abonnement kost niets om af te sluiten.
Saldi en transacties
Lees live kaartsaldio's en transactiegeschiedenis van het hele programma, inclusief autorisaties, afwikkelingen, weigeringen en kosten.
Orders en webhooks
Geldoperaties zijn asynchroon: u dient een operatie in, ontvangt een order en behandelt de webhook als de bron van waarheid in plaats van succes aan te nemen bij een 200-statuscode.
BIN-sponsoring, zonder de omweg van twee jaar
Elke kaart is gekoppeld aan een BIN — het nummer dat de kaartnetwerken vertelt welke gelicentieerde instelling erachter staat. Een eigen BIN krijgen betekent hoofdlid worden van Visa of Mastercard: een regulerende licentie, schemacollateral, kapitaalvereisten en jaren van certificering.
Kaarten uitgegeven via 2328 draaien op een bestaande gesponsorde BIN. De sponsorende instelling heeft het schemalidmaatschap en regelt de afwikkeling met het netwerk; u behoudt het product, de branding, de relatie met de kaarthouder en de economie. In de praktijk verandert dat een licentieproject in een integratieproject.
Onboarding vereist nog steeds grondige due diligence — u wordt gevraagd wie uw kaarthouders zijn, waar het geld vandaan komt en hoe uw KYC en monitoring eruitzien. Hoe duidelijker die antwoorden, hoe sneller het programma van start gaat.
Hoe een integratie verloopt
- 1.Stem het programma af: kaarthouderprofiel, financieringsstroom, geografische gebieden en limieten.
- 2.Verkrijg API-sleutels en controleer de connectiviteit via het openbare GET /ping-endpoint.
- 3.Registreer uw eerste kaarthouder en geef een kaart uit in de live omgeving.
- 4.Financier de kaart vanuit uw USDT-wallet en bevestig de resulterende order via webhook.
- 5.Integreer saldi, transacties en levenscyclusoperaties in uw product.
- 6.Ga live en schaal — uitgifte is één enkele aanroep, dus volume is geen technisch probleem.
Veelgestelde vragen
Heb ik een eigen licentie of BIN nodig om kaarten uit te geven?
Nee. Kaarten worden uitgegeven onder een bestaande gesponsorde BIN, dus u hoeft geen hoofdlid te worden van Visa of Mastercard. U beschrijft uw kaarthouders en financieringsstroom tijdens de onboarding; de licentieverlening en schema-afwikkeling liggen bij de sponsorende instelling.
Welke authenticatie gebruikt de API voor kaartuitgifte?
Bearer-authenticatie. Elk verzoek, behalve de openbare health check, bevat Authorization: Bearer ck_{keyId}_{secret}. De sleutel identificeert uw account, dus er worden geen merchant- of account-ID's in de payload doorgegeven. Bewaar de sleutel alleen op uw backend.
Hoe worden kaarten gefinancierd?
Vanuit uw USDT-wallet binnen 2328. Financiering converteert stablecoin naar een USD-kaartsaldo. De wallet is USDT op schaal 6 en kaarten zijn USD op schaal 2 — bedragen zijn altijd gehele getallen in kleinere eenheden met een expliciete valuta en schaal.
Zijn kaartoperaties synchroon?
Geldoperaties zijn asynchroon. Een financierings- of ontlaadverzoek retourneert een order die u tot voltooiing volgt, en een webhook bevestigt de uiteindelijke status. Leesoperaties zoals saldi en transacties zijn synchroon.
Is er een sandbox-omgeving?
Er is één live omgeving — geen aparte sandbox-sleutels. Een openbaar GET /ping-endpoint is beschikbaar zonder authenticatie voor liveness checks.
Waarvoor kunnen de kaarten worden gebruikt?
Typische programma's omvatten online abonnementen, advertentie-uitgaven, uitgaven van werknemers en aannemers, uitbetalingen via marktplaatsen en algemene door crypto gefinancierde consumentenuitgaven. Toegestane gebruiksscenario's worden overeengekomen tijdens de onboarding van het programma.