Verser
Pay-outs, circuit de validation, bénéficiaires.
Verser exige la 2FA activée. Sans elle, l'écran Pay-Outs ne fonctionne pas du tout : même l'affichage des frais est refusé.
Lancer un pay-out
Écran Pay-Outs. Le formulaire suit les mêmes étapes que l'encaissement — numéro, devise, opérateur, montant — et affiche avant validation trois lignes calculées par le serveur : Solde disponible, Montant débité et Dont fees.
« Montant débité » est le total, frais compris : c'est lui qui sort du portefeuille, pas le montant saisi. Un solde insuffisant s'affiche en rouge sur cette ligne.
Le panneau de droite permet de partir d'un bénéficiaire enregistré, ce qui verrouille le numéro et présélectionne le pays.
Le versement lancé, l'écran suit son statut en direct, puis bascule sur le reçu.
Le circuit de validation
C'est le point qui surprend le plus : tous les rôles ne versent pas de la même façon.
| Qui initie | Ce qui se passe |
|---|---|
owner, admin, validator | Le pay-out part immédiatement chez l'opérateur. |
accountant | Le pay-out est créé en brouillon (pending_approval) et attend une approbation. |
Une clé d'API avec PAYOUT_APPROVE | Le pay-out part immédiatement chez l'opérateur. |
Une clé d'API sans PAYOUT_APPROVE | Le pay-out est créé en brouillon (pending_approval), comme pour un accountant — la portée d'une clé se choisit à sa création (Authentification API). |
Les brouillons arrivent dans l'écran Validations, visible par owner,
admin et validator. Chaque ligne porte le demandeur, le numéro,
l'opérateur, le montant, les frais et la date.
- Approuver envoie le pay-out à l'opérateur, sans nouvelle saisie.
- Rejeter exige un motif, conservé avec la demande.
Les fonds sont débités dès la création du brouillon, montant et frais compris. Un brouillon en attente immobilise donc de la trésorerie ; un rejet la restitue intégralement par écriture inverse. Un brouillon n'est pas une intention, c'est une réservation.
Deux conséquences pratiques :
- On ne peut pas approuver un brouillon au-delà du solde : les fonds étaient déjà réservés à la demande, l'approbation ne fait que poursuivre.
- Un brouillon sans décision est rejeté automatiquement après 7 jours, avec restitution du solde. Le contrôle ne passe qu'une fois par jour, à 04h30 (heure de Paris) : l'expiration effective tombe entre 7 et 8 jours. Ne comptez pas sur une file d'attente qui vous attendrait indéfiniment.
L'écran Validations est borné : au-delà d'un certain nombre de brouillons, un avertissement signale que seuls les plus récents sont affichés. Traitez-les pour faire apparaître les suivants — rien n'est masqué en silence.
Bénéficiaires
L'écran Bénéficiaires enregistre les destinataires récurrents (nom, téléphone, pays, email facultatif). C'est un carnet d'adresses de confort : il préremplit le formulaire de pay-out et évite les fautes de frappe sur un numéro.
Enregistrer un bénéficiaire ne lui donne aucun droit et ne déclenche rien.
Vérifier l'issue
Un pay-out réussi crédite le bénéficiaire et laisse une transaction completed
dans l'écran Transactions. Un pay-out échoué (failed) restitue les fonds
réservés.
Pour brancher un système sur ces issues, c'est le webhook sortant, pas l'écran.
La feuille de détail d'un pay-out porte les mêmes Notifications webhook et le même bouton Renvoyer que celle d'un pay-in — le mécanisme ne distingue pas les deux sens. Voir Encaisser.