FedCheckout
AccueilDocumentationTableau de bord

Démarrer

Vue d'ensembleMode test

Intégrer

Référence de l'APIWebhooksMoyens de paiement

Référence

Codes d'erreurJournal des versions

Intégrer FedCheckout

Quatre étapes, une seule à ta charge. Tout part de ton serveur : une clé secrète ne doit jamais quitter ton backend.

Le trajet complet

  1. ÉTAPE 1

    Créer un Payment Intent

    Depuis ton serveur, avec un montant, une devise et une clé d'idempotence. Tu reçois un checkout_url.

  2. ÉTAPE 2

    Envoyer le client sur checkout_url

    La page de paiement est hébergée par FedCheckout : moyens de paiement, règles antifraude et reprise sur échec sont de notre côté.

  3. ÉTAPE 3

    Recevoir le webhook signé

    payment_intent.succeeded, signé en HMAC-SHA256, réessayé jusqu'à réception.

  4. ÉTAPE 4

    Livrer

    Vérifie la signature, puis débloque la commande. Jamais l'inverse, et jamais sur la foi d'une redirection.

La clé secrète reste côté serveur. Elle ne doit jamais apparaître dans du JavaScript de navigateur, dans une application mobile, dans un dépôt public, ni dans une adresse : FedCheckout refuse d'ailleurs toute requête qui porte une clé en paramètre d'URL (API_KEY_IN_QUERY).

Les montants sont des chaînes

Un montant s'écrit "500.00", jamais 500.00 en nombre flottant. Le GDS a deux décimales, l'USD six. Un montant plus précis que sa devise est refusé avec INVALID_AMOUNT — il n'est pas arrondi en silence.

Ce que FedCheckout ne fait pas

  • Livrer ta commande — FedCheckout dit qu'un paiement a réussi, c'est ton application qui livre.
  • Détenir les fonds des marchands : il n'y a donc aucun « solde marchand » à afficher.
  • Proposer un moyen de paiement sans intégration réelle et confirmation serveur.

Pour continuer

Référence de l'API

Tous les points d'entrée, l'idempotence et les statuts d'un paiement.

Webhooks

La signature, les événements, et comment vérifier sans se tromper.

Mode test

Encaisser un premier paiement sans argent réel, et simuler chaque résultat.

Moyens de paiement

Ce qui est ouvert aujourd'hui, et ce qui ne l'est pas encore.

Créer un paiement

curl https://checkout.fedtopup.com/api/v1/payment_intents \
  -H "Authorization: Bearer $FEDCHECKOUT_SECRET_KEY" \
  -H "Idempotency-Key: commande-7781" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": "500.00",
    "currency": "GDS",
    "description": "Commande 7781",
    "external_reference": "ORD-7781",
    "return_url": "https://ton-site.com/merci"
  }'

Réponse

{
  "id": "fpay_pi_8K2M…",
  "object": "payment_intent",
  "status": "requires_payment_method",
  "amount": "500.000000",
  "currency": "GDS",
  "mode": "test",
  "capture_method": "automatic",
  "description": "Commande 7781",
  "created_at": "2026-09-21T13:04:11Z",
  "expires_at": "2026-09-21T14:04:11Z",
  "checkout_url": "https://checkout.fedtopup.com/pay/fpay_cs_…"
}
FedCheckout — une infrastructure de paiement de Fed Digital, Gonaïves, Haïti.
DocumentationConditionsConfidentialitéRemboursementsFedTopUp