Collecte - Checkout standard

Le checkout standard est un flux par redirection :

Votre backend crée une session de checkout.
Payfonte renvoie une URL de checkout.
Vous redirigez le client vers cette URL.
Le client finalise le paiement et Payfonte notifie votre système via webhook.

Pourquoi utiliser le checkout standard ?

Lancement le plus rapide

Complexité frontend minimale. Votre backend crée un checkout puis redirige l’utilisateur.

Expérience hébergée

Payfonte gère l’interface des moyens de paiement et les interactions spécifiques à chaque provider.

Mises à jour fiables

Utilisez les événements webhook et la vérification de transaction pour connaître le résultat final.

Étapes d’intégration

Collecter les informations de paiement côté backend

Préparez les champs requis comme amount, currency, country et les données client.

Créer une session de checkout

Envoyez une requête à POST /payments/v1/checkouts avec votre client-id et votre client-secret.

Rediriger le client

Redirigez l’utilisateur vers data.shortURL ou data.url renvoyé dans la réponse.

Confirmer le statut final

Traitez les notifications webhook et vérifiez éventuellement le statut de transaction avant d’exécuter la commande.

Requête de création de checkout

curl --location 'https://sandbox-api.payfonte.com/payments/v1/checkouts' \
  --header 'client-id: <client-id>' \
  --header 'client-secret: <client-secret>' \
  --header 'Content-Type: application/json' \
  --data '{
    "reference": "ORDER-1001",
    "amount": 50000,
    "currency": "NGN",
    "country": "NG",
    "redirectURL": "https://yourapp.com/payment/complete",
    "webhook": "https://yourapp.com/webhooks/payfonte",
    "user": {
      "email": "customer@example.com",
      "phoneNumber": "2348012345678",
      "name": "John Doe"
    }
  }'

Exemple de réponse :

{
  "data": {
    "url": "https://checkout-staging.payfonte.com/payfusion/66579afe04916ddcfcf73e7b",
    "shortURL": "https://l.6bd.co/XXXXX",
    "reference": "ORDER-1001",
    "amount": 50000
  }
}

Référence des paramètres

Champ	Type	Requis	Description
`reference`	string	Recommandé	Identifiant de transaction unique dans votre système
`amount`	integer	Oui	Montant en sous-unités, sans décimales
`currency`	string	Oui	Code devise ISO, par exemple `NGN`
`country`	string	Oui	Code pays ISO, par exemple `NG`
`user`	object	Oui	Objet client avec e-mail, téléphone et nom
`redirectURL`	string	Non	URL de retour du client après le checkout
`webhook`	string	Non	URL de webhook spécifique à cette transaction
`metadata`	object	Non	Champs personnalisés pour votre suivi interne

Règle de montant importante

Payfonte ne prend pas en charge les montants API décimaux. Envoyez uniquement des valeurs entières en sous-unités.

500.00 NGN -> 50000
1250.75 NGN -> 125075

Voir Spécification des montants pour la règle complète.

Après la redirection et le paiement

Résultat de redirection client

Après le checkout, le client est redirigé vers votre redirectURL avec des informations de contexte telles que status et reference.

Notification webhook

Si les webhooks sont configurés, Payfonte envoie des mises à jour de statut à votre endpoint webhook.

Vérification de l'état final

Pour les flux critiques, vérifiez le statut de transaction depuis votre backend avant l’expédition d’un bien ou le crédit d’un portefeuille.

Gestion des paiements échoués

Si le paiement échoue, autorisez la relance et conservez votre commande dans un état en attente jusqu’à confirmation d’un succès final.

Bonnes pratiques de production

Pratique	Pourquoi c’est important
Générer les références côté serveur	Évite les doublons et améliore le rapprochement
Traiter les webhooks de façon idempotente	Empêche les doubles exécutions sur retry
Valider les paramètres de redirection	Protège contre les valeurs client altérées ou mal formées
Utiliser la vérification backend	Garantit le statut final avant une action métier critique

Documentation associée

Checkout inline

Alternative embarquée pour un paiement sur la page.

Webhooks

Configurez et validez les callbacks d’événements de paiement.

Référence API

Détails des endpoints et schémas pour les opérations de checkout.

Premiers pas

Concepts clés

Prestataires et couverture

Développement

Encaisser des paiements

Décaissements

Collecte - Checkout standard

Pourquoi utiliser le checkout standard ?

Lancement le plus rapide

Expérience hébergée

Mises à jour fiables

Étapes d’intégration

Requête de création de checkout

Référence des paramètres

Règle de montant importante

Après la redirection et le paiement

Bonnes pratiques de production

Documentation associée

Checkout inline

Webhooks

Référence API

​Pourquoi utiliser le checkout standard ?

Lancement le plus rapide

Expérience hébergée

Mises à jour fiables

​Étapes d’intégration

​Requête de création de checkout

​Référence des paramètres

​Règle de montant importante

​Après la redirection et le paiement

​Bonnes pratiques de production

​Documentation associée

Checkout inline

Webhooks

Référence API

Pourquoi utiliser le checkout standard ?

Étapes d’intégration

Requête de création de checkout

Référence des paramètres

Règle de montant importante

Après la redirection et le paiement

Bonnes pratiques de production

Documentation associée