> ## Documentation Index
> Fetch the complete documentation index at: https://docs.yabetoopay.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Encaisser pour un vendeur
> Nommez le vendeur au moment de la vente : le partage est fait à la capture, en une transaction.
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.
```bash theme={null}
POST https://pay.sandbox.yabetoopay.com/v1/payment-intents # Sandbox
POST https://pay.api.yabetoopay.com/v1/payment-intents # Production
```
| Paramètre | Type | Description |
| ---------------------- | -------- | --------------------------------------------------------- |
| `on_behalf_of` | `string` | L'identifiant du vendeur, `acct_…` |
| `application_fee_rate` | `number` | Votre commission, **en pourcentage** (entre `0` et `100`) |
**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.
```bash cURL theme={null}
curl -X POST https://pay.sandbox.yabetoopay.com/v1/payment-intents \
-H "Authorization: Bearer YOUR_SECRET_KEY" \
-H "Content-Type: application/json" \
-d '{
"amount": 10000,
"currency": "xaf",
"on_behalf_of": "acct_01HZVENDOR0000000000000000",
"application_fee_rate": 10
}'
```
```javascript fetch theme={null}
const res = await fetch(
"https://pay.sandbox.yabetoopay.com/v1/payment-intents",
{
method: "POST",
headers: {
Authorization: `Bearer ${process.env.YABETOO_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
amount: 10000,
currency: "xaf",
on_behalf_of: sellerAccountId,
application_fee_rate: 10,
}),
}
);
```
La confirmation de l'intention est ensuite **identique à un paiement ordinaire** : voir
[Confirmer une intention](/fr/payments/api/confirm). 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 %) :
| Poste | Montant | Destination |
| ---------------------------------------------------- | --------: | ------------------------------------------------ |
| Brut encaissé | 10 000 | n/a |
| Votre commission (10 % + 25 de frais fixe répercuté) | −1 025 | prélevée sur le brut |
| **Net vendeur** | **8 975** | portefeuille du vendeur, en **solde en attente** |
| Collection Yabetoo | −375 | Yabetoo |
| Surcharge Connect Yabetoo | −100 | Yabetoo |
| **Votre net** | **550** | votre portefeuille, **disponible immédiatement** |
Contrôle : `8 975 + 550 + 475 = 10 000`.
Le détail des deux modes et des refus : [Commissions et tarification](/fr/connect/pricing).
**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](/fr/connect/payouts).
## 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.
```bash theme={null}
GET https://pay.api.yabetoopay.com/v1/payment-intents/pi_...
```
```json 200 theme={null}
{
"id": "pi_...",
"status": "succeeded",
"amount": 10000,
"onBehalfOfAccountId": "acct_01HZVENDOR0000000000000000",
"connect": {
"onBehalfOfAccountId": "acct_01HZVENDOR0000000000000000",
"feePayer": "controller",
"applicationFeeRate": 10,
"captureState": "captured",
"shares": {
"grossAmount": 10000,
"applicationFeeAmount": 1025,
"vendorNetAmount": 8975,
"controllerNetAmount": 550,
"yabetooFeeAmount": 475
}
}
}
```
| Champ | Signification |
| ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `captureState` | `pending` tant que rien n'a été capturé, `captured` ensuite. `inconsistent` signale une anomalie de grand livre — contactez le support, ne réessayez pas. |
| `shares` | `null` tant que `captureState` n'est pas `captured`. Les montants viennent de ce qui a **réellement** été écrit à la capture, jamais recalculés depuis la grille. |
| `applicationFeeAmount` | Votre commission, telle que prélevée. |
| `controllerNetAmount` | Ce que vous **gardez** : en mode `controller`, votre commission moins les frais Yabetoo ; en mode `account`, égal à `applicationFeeAmount`. |
| `feePayer` | Le mode **figé à la capture** : un changement ultérieur de votre configuration ne le déplace pas. |
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.
Sinon `403`. Un vendeur inconnu et un vendeur d'une autre marketplace rendent la même
réponse.
Sinon `422 connect.fee_payer_unset`. Activez Connect sur votre compte.
En mode `controller` uniquement. Sinon `400 connect.application_fee_too_low`, avec le
plancher de taux et le minimum requis dans le corps.
Sinon `422 connect.vendor_net_not_positive`.
## Erreurs
| Statut | Code | Cause |
| ------ | ---------------------------------- | ------------------------------------------------------------------------------------------------ |
| `400` | `connect.application_fee_too_low` | Votre commission ne dépasse pas les frais Yabetoo |
| `400` | `connect.application_fee_too_high` | Votre commission dépasse le montant encaissé |
| `401` | n/a | Clé de test visant un vendeur `live` |
| `403` | n/a | Vendeur inconnu, malformé, ou d'une autre marketplace |
| `422` | `connect.incomplete_request` | `on_behalf_of` et `application_fee_rate` non fournis ensemble |
| `422` | `connect.fee_payer_unset` | Connect n'est pas activé sur votre compte |
| `422` | `connect.vendor_net_not_positive` | Le vendeur ne recevrait rien |
| `422` | `rule: "unsupported"` | `destination` envoyé au lieu de `on_behalf_of` |
| `503` | `E_CONNECT_PRICING_UNAVAILABLE` | La grille de commission n'a pas pu être résolue. Connect **refuse** plutôt que de facturer zéro. |
## 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é](/fr/connect/payments/allocations).