Émission de cartes virtuelles Visa et Mastercard (issuing card) par API
Créez des cartes virtuelles en dollars pour votre entreprise, vos employés ou vos clients avec une API. Financez-les depuis votre Master Wallet, suivez les dépenses, gelez une carte en une requête.
Émettre des cartes virtuelles par API (card issuing)
L'API d'émission de cartes de Freda Pay vous permet de créer, alimenter et gérer des cartes virtuelles Visa et Mastercard en dollars américains, pour vos dépenses en ligne, vos employés ou vos clients. Chaque carte s'obtient par une requête, sans dossier papier.
Cartes individuelles et entreprise
Une carte entreprise pour vos dépenses, ou une carte individuelle pour une personne précise. Vous pouvez enregistrer plusieurs titulaires et choisir celui de chaque carte.
Contrôle complet
Alimenter, retirer des fonds, geler, dégeler ou fermer une carte, par API ou depuis le tableau de bord.
Suivi des dépenses
Historique des transactions par carte et total dépensé dans le mois. Le titulaire du compte peut afficher le numéro complet et le CVV pour ses propres achats.
Créer une carte virtuelle avec l'API
const { FredaPay } = require("@fredapay/issuing");
const freda = new FredaPay("sk_test_VOTRE_CLE");
const card = await freda.cards.create({
reference: "CARD-001",
kind: "business",
brand: "VISA", // ou "MASTERCARD"
amount: 20, // dollars préfinancés
business_name: "Boutique Lakay"
});
// 202 : status "pending", puis card.created arrive par webhookLa création est asynchrone : la carte passe de pending à active en quelques instants, et vous êtes prévenu par le webhook card.created (ou card.failed). Le champ id de la réponse est le seul identifiant dont vous avez besoin pour gérer la carte ensuite.
Comment financer vos cartes
Les cartes sont préfinancées depuis votre Master Wallet en dollars. Vous alimentez ce Master Wallet par MonCash ou Natcash, ou par Zelle et virement bancaire (les moyens que nous conseillons) après vérification. Les frais de financement de votre plan sont retenus sur le montant reçu. Une réserve minimale de 50 $ reste toujours sur le Master Wallet.
Où la carte fonctionne
Ce sont des cartes en USD, acceptées chez les commerçants qui acceptent les cartes en dollars, surtout aux États-Unis. Certaines catégories de commerçants (jeux d'argent, transferts d'argent, cryptomonnaies, par exemple) et certains pays sous sanctions sont refusés. La liste complète est dans la documentation.
Tarifs de l'émission de cartes
| Plan | Abonnement | Création de carte | Recharge (jusqu'à 100 $) | Retrait | Cartes maximum |
|---|---|---|---|---|---|
| Startup | 0 $ | 5,00 $ | 1,60 $ | 1,30 $ | 200 |
| Pro | 150 $ / mois | 3,50 $ | 1,25 $ | 1,15 $ | 10 000 |
| Premium | 500 $ / mois | 2,50 $ | 1,10 $ | 1,10 $ | Illimité |
Recharge au-dessus de 100 $ : 3 % (Startup), 2 % (Pro et Premium). Ajout de fonds au Master Wallet : 4,5 % (Startup), 3,0 % (Pro), 2,5 % (Premium). Achat par carte : 0,10 $ (Startup), gratuit (Pro et Premium). Transactions internationales : 2,5 % + 0,60 $. Entretien mensuel : 0 $.
Questions fréquentes sur l'émission de cartes
Faut-il enregistrer un titulaire pour chaque carte ?
Pour une carte individuelle, oui : vous créez le titulaire une fois, puis vous l'utilisez pour ses cartes. Une carte entreprise n'en demande pas.
Quelle est la différence entre une carte Visa et Mastercard ?
Vous choisissez la marque à la création avec le paramètre brand. Les deux sont des cartes virtuelles en USD gérées de la même façon.
Puis-je tester sans argent réel ?
Oui. Le mode test fournit un Master Wallet de démonstration, et vous pouvez simuler des achats et des crédits sur une carte pour vérifier votre historique.
Que se passe-t-il si un achat est refusé ?
La carte refuse la transaction. Un refus pour solde insuffisant coûte 1,00 $, donc rechargez la carte avant un achat important.
Puis-je gérer les cartes depuis mon propre système ?
Oui, toutes les actions existent en API REST avec votre clé secrète, avec des SDK Node.js et PHP et une spécification OpenAPI. Voir la documentation des cartes.
Puis-je aussi accepter des paiements MonCash et Natcash ?
Oui, avec le même compte. Voir l'API MonCash et Natcash.