Paiements fractionnés
Paiement en plusieurs fois, commission par connexion et ce qu'aucune de ces fonctionnalités ne fait.
Deux fonctionnalités sans rapport utilisent le terme split. Les personnes qui viennent d'une autre plateforme de paiement recherchent généralement une troisième fonctionnalité qui n'existe pas ici. Cette page définit clairement leurs limites.
| Sens possible | Nom utilisé ici | Emplacement |
|---|---|---|
| Un payeur règle en plusieurs fois | Paiement en plusieurs fois | POST /payments/{id}/splits |
| Votre plateforme conserve une part du paiement d'un marchand | Tarification par connexion | L'en-tête X-Sync |
| Un paiement est partagé entre plusieurs marchands | Aucun | Cette fonctionnalité n'existe pas |
Paiement en plusieurs fois
Cette fonctionnalité n'a aucun rapport avec les marketplaces. Le même payeur règle un seul paiement en deux, trois ou quatre tranches, débitées successivement.
https://api.wajub.com/payments/{id}/splitsEnvoyez split_count pour obtenir des tranches égales, ou split_amounts pour des tranches
différentes. Ces deux champs sont mutuellement exclusifs. La somme de split_amounts doit être égale
au total du paiement.
curl https://api.wajub.com/payments/trx_CSUGajfv9xh0XQ5wu2lx/splits \
-H "Authorization: sk_test.kZ3qP8mWvL2xR7tB5nY4hC6dF9jS1aG0eU3i…" \
-H "Content-Type: application/json" \
-d '{ "split_count": 3 }'split_count accepte uniquement les valeurs 2, 3 ou 4. Pour obtenir des tranches inégales, envoyez
vous-même les montants.
curl https://api.wajub.com/payments/trx_CSUGajfv9xh0XQ5wu2lx/splits \
-H "Authorization: sk_test.kZ3qP8mWvL2xR7tB5nY4hC6dF9jS1aG0eU3i…" \
-H "Content-Type: application/json" \
-d '{
"split_amounts": [4000, 3000, 3000],
"split_currency": "XAF"
}'Envoyez entre deux et quatre valeurs, chacune au moins égale à 0,01. Un payeur, un paiement, plusieurs débits.
Tarification par connexion
Cette fonctionnalité concerne les marketplaces. Un paiement attribué à une connexion appartient au marchand correspondant. Votre plateforme reçoit la commission configurée sur cette connexion.
curl https://api.wajub.com/payments \
-H "Authorization: sk.kZ3qP8mWvL2xR7tB5nY4hC6dF9jS1aG0eU3i…" \
-H "X-Sync: acc_7Yh2MpL4tRb3nP8sZcXv" \
-H "Content-Type: application/json" \
-d '{
"amount": 50000,
"currency": "XAF",
"customer": { "email": "buyer@example.com" }
}'Vous ne pouvez pas remplacer la commission pour une requête particulière. Elle provient des règles associées à la connexion, figées lors de l'acceptation du marchand. Le payload ne contient aucun champ de frais. Capacités du compte explique comment la règle est choisie et limitée.
La fonctionnalité qui n'existe pas
Un même paiement ne peut pas être réparti entre plusieurs marchands
Aucun tableau split ne permet de nommer plusieurs connexions sur un paiement, quel que soit le
plan ou l'endpoint. Un paiement contient exactement un en-tête X-Sync. Le moteur de commission
lit exactement une connexion sur la transaction qu'il règle.
Un panier avec plusieurs vendeurs nécessite donc plusieurs paiements, un par vendeur et chacun avec son propre en-tête.
| Conséquence | Solution |
|---|---|
| L'acheteur donne son autorisation plusieurs fois | Regroupez les articles par vendeur dans votre checkout et prévenez-le |
| Un échec partiel est possible | Traitez chaque paiement comme une ligne de commande distincte, pas comme un panier atomique |
| Aucune référence commune | Placez votre propre identifiant de panier dans les metadata de chaque paiement |
La dernière ligne vous sera utile plus tard. Le rapprochement d'un panier après son traitement est uniquement possible si tous ses paiements contiennent le même identifiant de votre système.
Le payout d'un marchand constitue encore une autre opération
Aucune de ces fonctionnalités ne transfère de l'argent vers le compte bancaire ou le portefeuille
d'un marchand. Les fonds d'un paiement connecté sont réglés sur le propre solde Wajub du marchand, et
la façon dont ils en sortent dépend du mode : un marchand direct retire lui-même, un marchand lite
est payé automatiquement par Wajub, et une marketplace relay paie ses vendeurs par lots — les trois
sont décrits dans Payer les vendeurs. Pendant ce temps, votre commission a déjà été
créditée sur le solde de votre plateforme sans aucun appel de votre part, retirable dès que la vente
dont elle vient a passé sa rétention.