Passer au contenu principal
Payfonte attribue des portefeuilles par marchand et par marché afin de séparer les flux entrants de collecte des flux sortants de décaissement.

​
Types de portefeuilles

Portefeuille de collecte, dépôt

Les fonds entrants y sont d’abord réglés. Utilisez ce portefeuille comme solde principal de collecte.

Portefeuille de décaissement

Les décaissements et virements sont déduits de ce portefeuille lorsque vous lancez des décaissements.

​
Statut des portefeuilles

Les portefeuilles peuvent avoir les états suivants :
StatutSignification
activeLe portefeuille peut recevoir et envoyer des fonds selon les opérations configurées.
post-no-debitLe portefeuille peut recevoir des fonds, mais les débits sortants sont bloqués.
post-no-debit est souvent utilisé comme contrôle de sécurité lorsque des identifiants ou des mécanismes de décaissement pourraient être compromis.

​
Opérations sur portefeuille

Transférer des fonds entre portefeuilles

Déplacez des fonds du portefeuille de collecte vers le portefeuille de décaissement lorsque vous avez besoin de liquidité pour les décaissements.
Appliquez un contrôle de suspension ou post-no-debit pour arrêter les sorties pendant une investigation ou un contrôle de sécurité.
Supprimez les restrictions une fois les contrôles restaurés et le compte jugé sûr.

​
Récupérer les soldes des portefeuilles via l’API

Utilisez l’endpoint wallet pour interroger les soldes actuels par country et currency. 
curl --location 'https://api.payfonte.com/billing/v1/wallets?country=NG&currency=NGN' \
  --header 'client-id: <your-client-id>' \
  --header 'client-secret: <your-client-secret>'
Exemple de format de réponse : 
{
  "data": [
    {
      "type": "deposit",
      "amount": 1250000,
      "currency": "NGN",
      "country": "NG",
      "status": "active"
    },
    {
      "type": "disbursement",
      "amount": 500000,
      "currency": "NGN",
      "country": "NG",
      "status": "active"
    }
  ]
}

​
Flux recommandé

1

Surveiller les entrées de collecte

Suivez les fonds qui arrivent sur le portefeuille dépôt ou collecte après des transactions réussies.
2

Alimenter le portefeuille de décaissement de manière proactive

Transférez suffisamment de solde avant les campagnes de décaissement à fort volume.
3

Alerter sur un faible solde de décaissement

Mettez en place des alertes internes pour éviter des échecs dus à un solde insuffisant.
4

Appliquer rapidement les contrôles de sécurité

Si vous suspectez une compromission, suspendez les opérations sortantes et faites tourner les identifiants immédiatement.

​
Documentation associée

Autorisation

Sécurisez les appels à l’API wallet avec les en-têtes requis.

Décaissements

Comprendre les flux de décaissement utilisant votre portefeuille de décaissement.

Référence API

Détails complets des endpoints de portefeuille.