Aller au contenu

Relay

Encaissez pour des vendeurs sans compte Wajub, et laissez Wajub calculer et verser ce qui revient à chacun.

En relay, vous êtes le marchand de référence. Vos vendeurs n'ont pas de compte Wajub : chacun est une connexion liée à son portefeuille mobile money. Vous encaissez chaque vente sur votre propre solde, et Wajub tient, vente par vente, ce qui revient à chaque vendeur, puis le lui verse au rythme que vous fixez.

Ouvert en live une fois votre plateforme examinée par Wajub

Tous les appels de cette page fonctionnent avec une clé de sandbox. En live, Relay est ouvert à toute plateforme que Wajub a approuvée pour lui : demandez la revue sous Paramètres, Sync, Plateforme. Tant qu'elle n'est pas approuvée, ou si l'approbation est retirée, POST /accounts avec account_type: relay, un appel portant X-Sync sur une connexion Relay live, et une part Relay d'un paiement partagé répondent 403 avec error_code: sync_mode_not_approved.

Une connexion par vendeur

Créez la connexion avec le portefeuille du vendeur : un bénéficiaire que vous avez déjà, ou les informations pour en créer un, avec les mêmes champs que POST /beneficiaries.

Un vendeur Relay
curl https://api.wajub.com/accounts \
  -H "Authorization: sk.xxxxxxxxxxxxxxxx…" \
  -H "Content-Type: application/json" \
  -d '{
    "account_type": "relay",
    "capabilities": ["payments", "refunds"],
    "pricing": { "percentage_fee": 10, "currency": "XAF" },
    "payout_schedule": "weekly",
    "beneficiary": "ben_LRQqYvlhrgUOE225KMKU"
  }'
Le portefeuilleLa connexion
Son nom est confirmé par l'opérateuractive, avec payment_status: active, tout de suite
Pas encore vérifié, ou l'opérateur n'a pas pu être interrogépending ; relay.pending_reason dit pourquoi. Elle passe active dès qu'une vérification réussit, avec POST /beneficiaries/{id}/verify ou d'elle-même
Connu de l'opérateur sous un autre nompending avec wallet_name_mismatch : corrigez le nom, puis vérifiez de nouveau

Il n'y a ni onboarding ni authorization_url. Un portefeuille porte une seule connexion Relay par plateforme : une seconde répond 409 avec error_code: relay_wallet_taken.

Ce qui revient à chaque vendeur

Encaissez avec X-Sync comme pour toute connexion. Le paiement est le vôtre : il arrive sur votre solde. Pour chaque vente réussie, Wajub enregistre le dû du vendeur :

Le dûCe que la vente vous a crédité, moins les frais de Wajub, moins votre commission (le pricing de la connexion)
RetenuJusqu'à la fin de la rétention de la vente, comme l'argent lui-même
À verserEnsuite, jusqu'à ce qu'un versement le prenne
Réserve carteUne vente par carte garde 10 % de son dû pendant 120 jours par défaut, sur votre solde, contre les rétrofacturations : payée au vendeur par le premier versement après ce délai (La réserve carte)

Une vente encaissée sur votre propre compte chez un prestataire n'est jamais arrivée chez Wajub : elle ne crée aucun dû.

Les versements

payout_schedule (manual, daily, weekly, monthly) et payout_min_amount fonctionnent comme en lite, et POST /accounts/{id}/payouts paie le vendeur tout de suite. Chaque versement envoie les dus à verser du vendeur, du plus ancien au plus récent et entiers, moins ce qu'il doit après un remboursement, de votre solde vers son portefeuille. Quand ce qu'il doit absorbe tout le versement, rien n'est envoyé : l'appel répond 200 avec transfer: null et le montant netted.

Un vendeur Relay reçoit un versement par jour au plus. Quand deux passages se rencontrent le même jour (le planifié et votre POST /accounts/{id}/payouts, ou un appel que vous avez rejoué), le second répond avec le versement du jour et n'envoie rien de plus ; les dus enregistrés entre-temps partent avec le versement du lendemain, par un versement à eux. Un dû n'est jamais marqué payé que par le versement qui le portait.

Ce qui retient un versementpayout_hold.reason
Votre solde ne contient pas le montantinsufficient_balance : rien ne part, le passage suivant réessaie
Votre plafond d'expositionexposure_cap (Votre plafond d'exposition)
Wajub a retiré votre approbationapproval_withdrawn
Le vendeur a dépassé le palier du nom seulidentity_required (ci-dessous)
Le vendeur est nouveau, et seuls ses dus plus anciens sont payésnew_seller (Risque vendeur)
Vous, ou Wajub, avez gelé le vendeurfrozen (Risque vendeur)

Une vente que vous bloquez jusqu'à la livraison garde son dû impayé jusqu'à votre libération, sans payout_hold.

Chaque retenue envoie account.payout_limited une fois, sauf identity_required, qui envoie account.identity_required. Un versement passe tous les contrôles d'un virement ordinaire, y compris votre réserve et les remboursements en route.

Quand une vente est remboursée

Le remboursement sort de votre solde, comme pour tout paiement à vous : il attend avec insufficient_balance si vous ne le détenez pas. Côté vendeur :

Le dûCe qui se passe
Pas encore verséIl est réduit de la part remboursée, et annulé s'il ne reste rien
Déjà verséCe que le vendeur doit est enregistré sur son bénéficiaire, et retenu sur son prochain versement

Un litige perdu fonctionne de la même façon. Chaque remboursement ou litige ne compte qu'une fois, même rejoué.

L'identité du vendeur, au-delà d'un palier

Un vendeur est payé sur le seul nom de son portefeuille tant que ce que Wajub a versé à ce portefeuille sur les 12 derniers mois reste sous un plafond (500 000 XAF ou XOF). Au-delà, la part d'un versement qui dépasse le plafond attend une pièce d'identité : vous recevez account.identity_required, et l'envoyez avec POST /accounts/{id}/identity, en multipart/form-data.

Champ
full_nameTel que la pièce l'imprime
document_typenational_id, passport, driving_license ou residence_permit
document_numberJamais conservé en clair
birth_dateAAAA-MM-JJ
document_expires_atFacultatif ; une pièce expirée est refusée
documentJPG, PNG ou PDF, 10 Mo au plus

Wajub l'examine, en général dans la journée ouvrée : account.identity_verified, et les versements retenus partent au passage suivant, ou account.identity_rejected avec le motif. En sandbox, elle est approuvée tout de suite. Le plafond peut changer : Wajub prévient les plateformes Relay avant.

Que pensez-vous de ce contenu ?