Intégration API

Intégrez les paiements Fasil Pay dans votre application

Notre API REST moderne vous permet d'accepter des paiements, gérer des portefeuilles et automatiser vos flux financiers en quelques lignes de code.

Obtenir une clé API Voir la documentation
Réponse < 200ms
SSL / TLS chiffré
99.9% uptime
REST + Webhooks
Multi-devises
Support dédié
Fonctionnalités

Tout ce que notre API peut faire pour vous

Une API REST complète, sécurisée par JWT, couvrant tous vos besoins de paiement.

Transferts P2P

Envoyez de l'argent instantanément entre comptes Fasil Pay, par email, téléphone ou FP-ID.

  • Transfert instantané
  • USD, HTG, USDT
  • Frais transparents

Portefeuilles

Consultez les soldes et l'historique complet des transactions de vos utilisateurs.

  • Multi-devises (USD, HTG)
  • Dépôts & retraits
  • Historique paginé

Cartes Virtuelles

Émettez des cartes Visa virtuelles rechargeables pour payer partout en ligne, acceptées sur tous les sites e-commerce.

  • Création instantanée
  • Recharge / Retrait
  • Blocage / Remplacement

Dépôts & Retraits

Alimentez ou retirez depuis un portefeuille via les méthodes de paiement disponibles.

  • Méthodes configurables
  • Validation admin
  • Notifications email

Échange de devises

Convertissez entre USD, HTG et USDT au taux défini par la plateforme, en temps réel.

  • Taux dynamique
  • Atomique (tout ou rien)
  • Historique complet

Transactions

Consultez et filtrez l'ensemble des opérations : transferts, dépôts, retraits, recharges.

  • Filtres par type/date
  • Pagination
  • Statut en temps réel
Intégration rapide

Quelques lignes de code suffisent

L'API Fasil Pay est une API REST sécurisée par JWT. Base URL : https://fasilpay.com/api

JavaScript 
// 1. Connexion — récupère le token JWT dans un cookie httpOnly
await fetch('https://fasilpay.com/api/auth/login', {
  method: 'POST',
  credentials: 'include',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ email: 'user@example.com', password: '••••••••' })
});

// 2. Transfert P2P vers un autre compte Fasil Pay
const res = await fetch('https://fasilpay.com/api/transfers', {
  method: 'POST',
  credentials: 'include',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    recipient: 'FP-ABC123',  // FP-ID, email ou téléphone
    amount: 50,
    currency: 'USD',
    note: 'Remboursement'
  })
});
const data = await res.json();
// { success: true, data: { reference: "TXN-...", amount: 50, fee: 0.25 } }
1

Créez votre compte

Inscrivez-vous sur Fasil Pay et contactez-nous pour activer l'accès API sur votre compte.

2

Authentifiez-vous

Appelez /api/auth/login — le token JWT est stocké dans un cookie sécurisé httpOnly.

3

Appelez les endpoints

Tous les appels suivants incluent automatiquement le cookie. Pas besoin de gérer le token manuellement.

4

Gérez les erreurs

Chaque réponse retourne { success, data, message }. Les erreurs HTTP standard (400, 401, 422, 429) s'appliquent.

Endpoints

Les principaux endpoints disponibles

Base URL : https://fasilpay.com/api — Authentification par cookie JWT (httpOnly)

Authentification

POST /auth/login Connexion — retourne un cookie JWT
POST /auth/register Inscription nouvel utilisateur
POST /auth/logout Déconnexion — invalide le cookie

Transferts & Portefeuille

POST /transfers Transfert P2P (FP-ID, email ou téléphone)
GET /wallet Soldes de tous les portefeuilles
POST /deposits Demande de dépôt
POST /withdrawals Demande de retrait
POST /exchange Échange de devises (USD ↔ HTG ↔ USDT)
GET /transactions Historique des transactions (filtrable)

Cartes Virtuelles Fasil Pay

GET /cards/fees Frais de création et recharge
GET /cards/holder Informations du titulaire de carte
POST /cards/holder Créer un dossier titulaire (KYC léger)
GET /cards Lister mes cartes virtuelles
POST /cards Émettre une nouvelle carte Visa virtuelle
GET /cards/{id}/details Numéro complet + CVV (sécurisé)
GET /cards/{id}/transactions Transactions réelles de la carte
POST /cards/{id}/recharge Recharger la carte depuis le portefeuille
POST /cards/{id}/withdraw Retirer le solde vers le portefeuille
PATCH /cards/{id}/block Bloquer / Débloquer la carte
POST /cards/{id}/replace Remplacer une carte perdue ou compromise
DEL /cards/{id} Annuler définitivement la carte
Sécurité

Une API conçue pour la fintech

Chaque couche de l'API est protégée contre les attaques courantes.

JWT httpOnly

Le token d'authentification est stocké dans un cookie httpOnly — impossible à lire via JavaScript. Protège contre le vol de session XSS.

Rate Limiting

10 tentatives de connexion / 10 min par IP. 50 opérations financières / 15 min par utilisateur. Protège contre le brute-force.

HTTPS + Helmet

Toutes les communications sont chiffrées TLS. Les headers HTTP de sécurité sont configurés via Helmet.js (HSTS, CSP, X-Frame-Options…).

Transactions atomiques

Chaque opération financière s'exécute dans une transaction PostgreSQL. En cas d'erreur, tout est annulé — aucun solde ne peut être débité sans être crédité.

KYC obligatoire

Les cartes virtuelles et les opérations sensibles nécessitent une vérification d'identité (KYC) avant d'être activées.

Webhook HMAC-SHA256

Les webhooks entrants sont vérifiés par signature HMAC-SHA256 avec comparaison temporellement sûre pour prévenir les timing attacks.

Prêt à intégrer Fasil Pay ?

Rejoignez les développeurs qui font confiance à notre API pour leurs applications de paiement.

Obtenir une clé API Parler à un expert