Sync
Encaissez pour vos vendeurs, sans jamais toucher à leur compte.
Votre marketplace relie les comptes Wajub de ses vendeurs au sien. Un en-tête sur vos appels habituels, et le paiement appartient au vendeur pendant que votre commission vous est créditée. Le vendeur autorise la connexion depuis son propre compte Wajub.
Le vendeur autorise lui-même · Commission par connexion
Pourquoi Sync
Une plateforme qui encaisse pour d'autres, sans devenir leur banque.
Chaque paiement reste celui du vendeur. Votre plateforme garde la main sur l'expérience et prélève ce qui lui revient.
- Un seul en-tête
- Ajoutez X-Sync à un appel ordinaire : le paiement, le client et le remboursement appartiennent au vendeur connecté.
- Le vendeur reste maître de son compte
- Il ouvre un lien d'autorisation, se connecte chez lui, voit les accès demandés et accepte. Vous ne manipulez jamais ses identifiants.
- Votre commission, automatiquement
- Chaque connexion porte sa règle de tarification. Sur un paiement réussi, la commission est calculée et créditée à votre plateforme.
- Des accès que vous choisissez
- Paiements, remboursements, transferts, clients : vous demandez les capacités dont votre plateforme a besoin, et le vendeur les voit avant d'accepter.
- Leurs événements chez vous aussi
- Un paiement, un remboursement ou un transfert sur un compte connecté déclenche le webhook du vendeur et une copie vers vos endpoints.
- Un cycle de vie lisible
- En attente, active, annulée, expirée : quatre états, et le statut se lit à tout moment sur la connexion.
Commission
Votre commission, connexion par connexion.
Chaque connexion porte sa règle : un pourcentage, un montant fixe, un plancher et un plafond. Elle s'applique à chaque paiement réussi du vendeur.
- Pourcentage et montant fixe s'additionnent, puis le plancher et le plafond s'appliquent.
- Une fois la connexion acceptée, une nouvelle règle attend l'accord du vendeur.
- Une commission nulle n'est pas enregistrée.
Comment ça marche
Quatre étapes, et le vendeur garde son compte.
Vous invitez, le vendeur accepte, vos appels portent son identité. Son compte n'est jamais créé à sa place.
POST /accountsVous invitez- Vous créez la connexion et recevez un lien d'autorisation à usage unique.
authorization_urlLe vendeur autorise- Le vendeur l'ouvre, se connecte à son compte Wajub et accepte les accès demandés.
X-SyncVous encaissez- Vos appels portent l'en-tête X-Sync : le paiement est attribué à sa connexion.
fee.receivedVous êtes payé- À chaque paiement réussi, votre commission est calculée et créditée.
import { Wajub } from '@wajub/node'
const wajub = new Wajub({ secretKey: process.env.WAJUB_SECRET_KEY! })
const account = await wajub.accounts.create({
reference: 'atelier-sika',
capabilities: ['payments', 'refunds', 'customers'],
pricing: {
percentage_fee: 2.5,
fixed_fee: 100,
max_fee: 5000,
currency: 'XAF',
},
})
console.log(account.authorization_url)
// After the seller authorizes
const payment = await wajub.payments.create({
amount: 50000,
currency: 'XAF',
customer: { email: 'buyer@example.com' },
}, { sync: account.id })Réponse201 Created
{"account": {"id": "acc_7Yh2MpL4tRb3nP8sZcXv","status": "pending","authorization_url": "https://sync.wajub.com/oauth/v2/authorize?access_token=qT9vLm2Xw8RbN4pZkD7sHc5JwYe3"}}
Webhook signéX-Wajub-Signature
{"event": "fee.received","data": {"amount": 1350,"currency": "XAF","account": { "id": "acc_7Yh2MpL4tRb3nP8sZcXv" }}}
Réponse201 Created
{"account": {"id": "acc_7Yh2MpL4tRb3nP8sZcXv","status": "pending","authorization_url": "https://sync.wajub.com/oauth/v2/authorize?access_token=qT9vLm2Xw8RbN4pZkD7sHc5JwYe3"}}
Webhook signéX-Wajub-Signature
{"event": "fee.received","data": {"amount": 1350,"currency": "XAF","account": { "id": "acc_7Yh2MpL4tRb3nP8sZcXv" }}}
Questions fréquentes
Une autre question ? Parler à l'équipe
- Qui détient les fonds d'un paiement passé par Sync ?
- Le paiement appartient au compte du vendeur connecté, qui en garde le produit. Votre plateforme reçoit la commission configurée sur cette connexion.
- Puis-je partager un seul paiement entre plusieurs vendeurs ?
- Non. Un paiement porte une seule connexion. Un panier avec deux vendeurs, ce sont deux paiements. Le paiement en plusieurs fois, lui, concerne un même payeur et n'a rien à voir avec les marketplaces.
- Dois-je créer les comptes de mes vendeurs ?
- Non, et vous ne pouvez pas. Vous envoyez une invitation : le vendeur se connecte à son compte Wajub, ou en crée un à ce moment-là, puis accepte les accès demandés.
- Quels accès puis-je demander ?
- Onze capacités peuvent être demandées : lecture, écriture, paiements, transferts, remboursements, litiges, clients, factures, abonnements, analyses et paramètres. Une fois la connexion acceptée, en changer demande l'accord du vendeur.
- Comment payer un vendeur ?
- Cela dépend du type de compte. Un compte direct appartient au vendeur : ses paiements y arrivent et il retire lui-même son argent. Un compte Lite n'a pas de Dashboard : Wajub lui reverse son solde au rythme que vous fixez (chaque jour, chaque semaine ou chaque mois), ou à la demande avec POST /accounts/{id}/payouts.
- Quels plans incluent Sync ?
- Scale et Enterprise l'incluent. Sur les autres plans, Sync s'ajoute en option : son prix est sur la page Tarifs.
Connectez votre premier vendeur.
Sync est inclus dans les plans Scale et Enterprise. Créez un compte et testez l'invitation de bout en bout.