Skip to main content
C’est le mode direct. Vous nommez le vendeur sur l’intention de paiement, et Yabetoo répartit le brut entre lui, vous et Yabetoo au moment où le client paie, atomiquement.
Préférez ce mode dès que vous connaissez le vendeur au moment de la vente. Il donne la meilleure traçabilité : chaque encaissement porte l’identité de son vendeur et sa commission.

​
Créer l’intention

Ajoutez deux champs à votre appel habituel de création d’intention de paiement.
Les deux vont ensemble, ou aucun. N’en fournir qu’un rend 422 connect.incomplete_request. Sans aucun des deux, l’encaissement est un encaissement ordinaire sur votre propre compte.
La confirmation de l’intention est ensuite identique à un paiement ordinaire : voir Confirmer une intention. Rien ne change côté client final : il paie comme d’habitude.
Collision de vocabulaire avec Stripe, à connaître. Chez Stripe, on_behalf_of désigne le marchand de règlement et les fonds restent chez la plateforme. Chez Yabetoo, ce champ dit où l’argent VA. Si vous venez de Stripe, ne le lisez pas à l’envers.
Pourquoi un taux et pas un montant. Le brut est converti dans la devise du pays choisi au moment de la confirmation : une intention de 100 EUR confirmée au Congo capture environ 65 000 XAF, tandis qu’un montant fixe de 20 resterait 20. Le taux, lui, reste juste quelle que soit l’échelle.
destination est l’ancien nom de on_behalf_of. Il est refusé en 422, jamais ignoré.

​
Ce qui se passe à la capture

Sur 10 000 XAF, avec application_fee_rate: 10, en mode controller et au barème standard (collection 3,5 % + 25, Connect 1 %) : Contrôle : 8 975 + 550 + 475 = 10 000. Le détail des deux modes et des refus : Commissions et tarification.
Le net du vendeur arrive en solde EN ATTENTE, pas en solde disponible. Il devient retirable après le délai de disponibilité. Voir Soldes et versements.

​
Relire les parts après capture

GET /v1/payment-intents/{id} porte un bloc connect sur toute intention créée avec on_behalf_of. Il est null sur une intention ordinaire.
200
Ces montants décrivent la capture : un remboursement ou une reprise ultérieurs ne les modifient pas. Le bloc est présent sur la lecture unitaire seulement, pas sur la liste des intentions.

​
Vérifications faites à la création

Yabetoo refuse à la création de l’intention, pas au moment où le client paie. C’est délibéré : un refus de contrat doit atteindre votre développeur, pas votre acheteur.
1

Le vendeur est bien le vôtre

Sinon 403. Un vendeur inconnu et un vendeur d’une autre marketplace rendent la même réponse.
2

Le mode de commission est connu

Sinon 422 connect.fee_payer_unset. Activez Connect sur votre compte.
3

Votre commission couvre les frais Yabetoo

En mode controller uniquement. Sinon 400 connect.application_fee_too_low, avec le plancher de taux et le minimum requis dans le corps.
4

Le vendeur recevrait un montant positif

Sinon 422 connect.vendor_net_not_positive.

​
Erreurs

​
L’alternative

Si vous ne connaissez pas encore le vendeur au moment de la vente (panier multi-vendeurs, répartition calculée après coup), encaissez normalement sur votre compte et répartissez ensuite : Mode différé.