API d'émission de cartes
2328 est une API d'émission de cartes virtuelles pour les équipes qui souhaitent proposer une carte de paiement à leurs utilisateurs sans devenir un émetteur agréé. Vous enregistrez les titulaires de carte, émettez des cartes sous un BIN sponsorisé, les financez depuis votre portefeuille USDT et contrôlez l'intégralité du cycle de vie — gel, déchargement, clôture — via une seule interface REST.
Construire un programme de cartes de manière traditionnelle implique une licence de réseau, un BIN, un processeur, une banque sponsor et dix-huit mois de travail de certification avant que la première autorisation ne soit accordée. Ce travail est déjà fait ici. Ce qui reste de votre côté est la partie qui constitue réellement votre produit : qui reçoit une carte, ce qu'ils peuvent dépenser et à quoi ressemble l'expérience.
L'API est uniquement JSON, tous les champs sont en camelCase, et chaque requête, à l'exception de la vérification de santé publique, est autorisée avec une clé Bearer. L'argent est toujours un entier en unités mineures avec une devise et une échelle explicites — le portefeuille est en USDT à l'échelle 6, les cartes sont en USD à l'échelle 2 — il n'y a donc jamais de flottant ambigu dans un registre.
Titulaires de carte
Enregistrez les titulaires de carte avec les données d'identité requises par le programme, puis émettez une ou plusieurs cartes pour chacun d'eux. L'intégration, les limites et le cycle de vie sont entièrement gérés de votre côté.
Émission instantanée de cartes virtuelles
Les cartes sont créées par un simple appel API et sont utilisables immédiatement — pas de plastique, pas d'expédition, pas d'étape d'activation. Émettez-en une par utilisateur, par abonnement, par campagne ou par fournisseur.
Financement depuis un portefeuille USDT
Les cartes sont financées à partir de votre solde de stablecoin. L'USDT arrive à l'échelle 6, le solde de la carte est en USD à l'échelle 2, et l'API est explicite sur les deux afin que les registres ne dérivent jamais.
Contrôle complet du cycle de vie
Geler, dégeler, décharger et clôturer des cartes par programmation. Une carte compromise est désactivée en une seule requête ; un abonnement terminé ne coûte rien à résilier.
Soldes et transactions
Lisez les soldes de cartes en temps réel et l'historique des transactions pour l'ensemble du programme, y compris les autorisations, les règlements, les refus et les frais.
Commandes et webhooks
Les opérations monétaires sont asynchrones : vous soumettez une opération, recevez une commande et traitez le webhook comme la source de vérité plutôt que de supposer un succès sur un 200.
Parrainage de BIN, sans le détour de deux ans
Chaque carte est ancrée à un BIN — le numéro qui indique aux réseaux de cartes quelle institution agréée la soutient. Obtenir le vôtre signifie devenir un membre principal de Visa ou Mastercard : licence réglementaire, garantie de programme, exigences de capital et années de certification.
Les cartes émises via 2328 fonctionnent sur un BIN parrainé existant. L'institution de parrainage détient l'adhésion au programme et règle avec le réseau ; vous conservez le produit, l'image de marque, la relation avec le titulaire de carte et les aspects économiques. En pratique, cela transforme un projet de licence en un projet d'intégration.
L'intégration reste une diligence réelle — il vous sera demandé qui sont vos titulaires de carte, d'où vient l'argent et à quoi ressemblent votre KYC et votre surveillance. Plus ces réponses sont claires, plus le programme démarre rapidement.
Comment se déroule une intégration
- 1.Convenir du programme : profil du titulaire de carte, flux de financement, zones géographiques et limites.
- 2.Obtenez les clés API et vérifiez la connectivité par rapport au point de terminaison public GET /ping.
- 3.Enregistrez votre premier titulaire de carte et émettez une carte dans l'environnement de production.
- 4.Financez la carte depuis votre portefeuille USDT et confirmez la commande résultante via webhook.
- 5.Intégrez les soldes, les transactions et les opérations de cycle de vie dans votre produit.
- 6.Passez en production et mettez à l'échelle — l'émission est un simple appel, donc le volume n'est pas un problème d'ingénierie.
Questions fréquemment posées
Ai-je besoin de ma propre licence ou de mon propre BIN pour émettre des cartes ?
Non. Les cartes sont émises sous un BIN parrainé existant, vous n'avez donc pas besoin de devenir un membre principal de Visa ou Mastercard. Vous décrivez vos titulaires de carte et votre flux de financement lors de l'intégration ; la licence et le règlement du programme relèvent de l'institution de parrainage.
Quelle authentification l'API d'émission de cartes utilise-t-elle ?
Authentification Bearer. Chaque requête, à l'exception de la vérification de santé publique, contient Authorization: Bearer ck_{keyId}_{secret}. La clé identifie votre compte, donc aucun ID de commerçant ou de compte n'est transmis dans la charge utile. Gardez la clé uniquement sur votre backend.
Comment les cartes sont-elles financées ?
Depuis votre portefeuille USDT au sein de 2328. Le financement convertit le stablecoin en un solde de carte USD. Le portefeuille est USDT à l'échelle 6 et les cartes sont USD à l'échelle 2 — les montants sont toujours des entiers en unités mineures avec une devise et une échelle explicites.
Les opérations sur carte sont-elles synchrones ?
Les opérations monétaires sont asynchrones. Une requête de financement ou de déchargement renvoie une commande que vous suivez jusqu'à son achèvement, et un webhook confirme l'état final. Les opérations de lecture telles que les soldes et les transactions sont synchrones.
Existe-t-il un environnement de bac à sable ?
Il existe un seul environnement de production — pas de clés de bac à sable séparées. Un point de terminaison public GET /ping est disponible sans authentification pour les vérifications de liveness.
À quoi les cartes peuvent-elles être utilisées ?
Les programmes typiques couvrent les abonnements en ligne, les dépenses publicitaires, les dépenses des employés et des sous-traitants, les paiements de place de marché et les dépenses de consommation générales financées par la crypto. Les cas d'utilisation autorisés sont convenus lors de l'intégration du programme.