Aller au contenu

Bénéficiaires

Enregistrez une destination de payout une fois, puis payez-la par son id plutôt que par son numéro.

Un bénéficiaire est une destination enregistrée : un nom, un numéro Mobile Money et l'opérateur qui le dessert. Vous le créez une fois, puis le payez par son id. Le numéro reste ainsi absent de chaque appel de payout et des logs produits par ces appels.

C'est aussi le seul moyen de payer deux fois la même personne sans ressaisir la destination des fonds. Une ressaisie est souvent la cause d'un envoi vers le mauvais téléphone.

Deux pages vont plus loin :

  • Créer un bénéficiaire, le canal qui détermine l'opérateur, un autre compte Wajub comme destination, et la vérification du nom sur un portefeuille.
  • Gérer les bénéficiaires, ce qui est modifiable, récupérer, lister et supprimer un bénéficiaire, et ses relevés.

Payer un bénéficiaire

Transmettez l'id à l'emplacement où un payout attend un destinataire. Le reste du transfert ne change pas.

POSThttps://api.wajub.com/transfers

Le corps correspond à celui décrit dans Transferts, avec une chaîne à la place de l'objet inline.

Payer un bénéficiaire enregistré
{
"beneficiary": "ben_7Kq2mX9vL4tRb3nP8sZc",
"amount": 15000,
"currency": "XAF",
"description": "September retainer"
}

Enregistrer un bénéficiaire ne sécurise pas son paiement

Un bénéficiaire est une destination, pas une protection contre les doublons. Chaque POST /transfers nécessite toujours sa propre valeur Idempotency-Key, que le bénéficiaire soit enregistré ou non. Sans elle, une nouvelle tentative paie deux fois. Consultez Idempotence.

Comptes de versement

Un compte de versement est la destination de votre propre argent : celle du règlement quotidien et des payouts que vous vous faites. Vous le créez sous Settings, Transfers, Payout Accounts, sur Mobile Money, Djamo, un compte Wajub, ou un compte bancaire via wire. Il est enregistré comme bénéficiaire privileged et commence non vérifié. Le vérifier depuis la même page compare le compte au nom enregistré par son opérateur. Si les noms ne peuvent pas être rapprochés, Wajub demande au propriétaire du compte de confirmer le compte. Wajub traite les payouts wire, contre des frais fixes, sous 48 heures ouvrées par défaut.

Événements envoyés à votre webhook

ÉvénementDéclencheur
beneficiary.createdUn enregistrement est réellement créé : par POST /beneficiaries, à la volée par POST /transfers, ou comme compte de retrait dans le Dashboard. Pas quand la même destination renvoie le premier bénéficiaire, ce qui ne crée rien
beneficiary.updatedL'un des cinq champs modifiables change
beneficiary.deletedUn bénéficiaire est supprimé
beneficiary.receivable_recordedUne dette est enregistrée sur un bénéficiaire
beneficiary.receivable_recoveredUn payout groupé a recouvré tout ou partie d'une dette

Que pensez-vous de ce contenu ?