Aller au contenu

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

PlateformeContrôlesVendeursAcheteurVue d'ensembleCréer une connexionVolume3 120 000 FCFACommissions81 450 FCFANDNkolo DécoRéussi32 000 FCFAOrange MoneyECEbène ChaussuresRéussi27 500 FCFAMTN MoMo9:41Mboa MarketRobe en pagneVendu par Komerxe50 000 FCFAPayer avec MTN MoMo

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.

Suivre le guide de démarrageRéférence de l'API

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.