Mode d’autorisation des décaissements

Payfonte prend en charge deux modes d’autorisation pour les demandes de décaissement :

Autorisation par PIN
URL d’autorisation

Comparaison des modes

Mode	Fonctionnement	Recommandé pour
Autorisation par PIN	Vous envoyez `pin` dans chaque demande de décaissement	Les équipes qui contrôlent strictement les décaissements depuis le backend
URL d’autorisation	Payfonte appelle votre endpoint d’approbation à chaque demande ; le décaissement continue uniquement sur HTTP `200`	Les plateformes qui exigent des contrôles de politique ou de risque avant chaque décaissement

1) Autorisation par PIN

Le mode PIN exige un code de décaissement sur les requêtes de décaissement.

Mise en place

Définir le PIN dans le dashboard

Ouvrez une page Décaissements dans le dashboard et terminez la configuration du PIN lorsque vous y êtes invité.

Stocker le PIN de façon sécurisée

Conservez le PIN uniquement dans un stockage secret backend. Ne l’exposez jamais côté frontend ou mobile.

Envoyer le PIN dans chaque requête

Incluez le champ pin dans POST /billing/v1/disbursements.

Exemple de requête avec PIN :

{
  "transferRecipientId": "6659692f019f6a143f7f90db",
  "amount": 100000,
  "reference": "disbursement-1001",
  "narration": "Vendor settlement",
  "pin": "1234"
}

2) URL d’autorisation

Le mode URL d’autorisation permet à votre système d’approuver ou de rejeter dynamiquement chaque tentative de décaissement.

Mise en place

Configurer l'URL d'autorisation

Définissez votre endpoint sous Disbursements -> Settings dans le dashboard.

Implémenter la validation de requête

Vérifiez l’authenticité de la requête entrante, hash ou signature, avant de répondre.

Renvoyer une décision stricte

Retournez HTTP 200 pour approuver ; toute réponse non 200 bloque le décaissement.

Le mode URL d’autorisation est strict : si votre endpoint est indisponible ou renvoie autre chose que 200, le décaissement n’est pas traité.

Payload de requête d’autorisation

Lorsque le mode URL d’autorisation est activé, Payfonte envoie un payload JSON comme celui-ci à votre URL d’autorisation configurée :

{
  "clientId": "client_123456789",
  "type": "disbursement",
  "externalReference": "EXT-DISB-000001",
  "reference": "DISB-000001",
  "provider": "paystack",
  "channel": "bank-transfer",
  "finalAmount": 500000,
  "amount": 500000,
  "transferRecipientLabel": "Paystack | Zenith Bank | Ada Lovelace | 0123456789",
  "transferRecipient": {
    "accountNumber": "0123456789",
    "bankCode": "057",
    "bankName": "Zenith Bank",
    "accountName": "Ada Lovelace"
  },
  "recipient": {
    "accountNumber": "0123456789",
    "bankCode": "057",
    "bankName": "Zenith Bank",
    "accountName": "Ada Lovelace"
  },
  "transferRecipientId": "trf_recipient_123456789",
  "charge": 15000,
  "chargesApplied": [],
  "fees": {},
  "status": "queued",
  "country": "NG",
  "currency": "NGN",
  "narration": "Vendor payout for invoice INV-2026-0001",
  "webhookURL": "https://example.com/webhooks/disbursements"
}

Contrôles de validation recommandés

Lorsque Payfonte appelle votre URL d’autorisation, validez :

L’authenticité de la requête, signature ou hash
La conformité du montant et de la devise avec vos règles métier
L’éligibilité du bénéficiaire au décaissement
La disponibilité des soldes, si vous appliquez des règles internes de portefeuille
Les plafonds journaliers, politiques AML ou risque et seuils de vélocité

Checklist de sécurité

Conserver les secrets côté serveur

N’exposez jamais le PIN de décaissement ni les secrets d’autorisation dans du code navigateur ou mobile.

Utiliser des endpoints HTTPS

L’URL d’autorisation doit être accessible publiquement via HTTPS.

Échouer de manière fermée sur erreur de vérification

Si les contrôles de signature ou de hash échouent, rejetez la demande d’autorisation.

Tracer chaque décision de décaissement

Journalisez les décisions approuvées comme rejetées, avec leur raison, pour la conformité et le dépannage.

Documentation associée

Vue d'ensemble des décaissements

Flux de décaissement complet et utilisation des endpoints.

Webhooks de décaissement

Traitez les mises à jour de statut asynchrones.

Exemples de décaissement

Requêtes et réponses prêtes à copier.

Premiers pas

Concepts clés

Prestataires et couverture

Développement

Encaisser des paiements

Décaissements

Mode d'autorisation des décaissements

Mode d’autorisation des décaissements

Comparaison des modes

1) Autorisation par PIN

Mise en place

2) URL d’autorisation

Mise en place

Payload de requête d’autorisation

Contrôles de validation recommandés

Checklist de sécurité

Documentation associée

Vue d'ensemble des décaissements

Webhooks de décaissement

Exemples de décaissement

​Mode d’autorisation des décaissements

​Comparaison des modes

​1) Autorisation par PIN

​Mise en place

​2) URL d’autorisation

​Mise en place

​Payload de requête d’autorisation

​Contrôles de validation recommandés

​Checklist de sécurité

​Documentation associée

Vue d'ensemble des décaissements

Webhooks de décaissement

Exemples de décaissement

Mode d’autorisation des décaissements

Comparaison des modes

1) Autorisation par PIN

Mise en place

2) URL d’autorisation

Mise en place

Payload de requête d’autorisation

Contrôles de validation recommandés

Checklist de sécurité

Documentation associée