# Wajub, Developer Documentation > Payment orchestration for Africa: API, SDKs, webhooks, Mobile Money, marketplaces and routing. Toutes les pages de la documentation en Markdown, puis la référence de l'API. Chaque page commence par son titre et son adresse. Ajoutez `.md` à l'adresse d'une page pour n'obtenir qu'elle. # Activation du compte et KYC URL: https://docs.wajub.com/fr/getting-started/account-activation > Le dossier qui débloque les paiements live, le déroulement de la vérification et ce qu'elle change. Le sandbox ne vous demande rien d'autre qu'une adresse email. La production exige une identité vérifiée, parce que déplacer l'argent des autres est réglementé partout où Wajub opère. Tant que votre dossier de conformité n'est pas `verified`, votre équipe reste en sandbox. Le Dashboard refuse de passer en live, aucune clé live ne peut donc être créée, pas même par `wajub login`. C'est la vérification qui fait passer votre équipe en live. ## Commencez par choisir ce que vous êtes Ce premier choix détermine tout le dossier, alors faites-le en connaissance de cause. Wajub reconnaît huit types d'entité juridique : **particulier**, **entreprise**, **ONG**, **établissement d'enseignement**, **organisation religieuse**, **organisation politique**, **entité gouvernementale** et **autre**. Chacun a ses propres sous-types : une SARL et une SA sont deux formes du même type entreprise. La distinction qui compte pour votre charge de travail oppose le particulier à tous les autres. Un particulier, freelance ou entrepreneur individuel, ne fournit aucun document d'entreprise. Tous les autres types en fournissent quatre. Le type ne se change que dans un sens. Une fois vérifié comme particulier, vous pouvez passer à un autre type depuis **Paramètres → Conformité**. Votre dossier repasse alors à `unverified` et vous demande ce que le nouveau type exige en plus de ce que vous avez déjà fourni. Aucun autre changement de type n'est proposé. Le guide du tableau de bord montre [comment changer de type](https://docs.wajub.com/dashboard/activation/switch-to-business). ## Les six étapes La vérification se trouve dans le Dashboard, sous **Paramètres → Conformité** : un assistant en six étapes, où chaque étape débloque la suivante. Le guide du tableau de bord le parcourt écran par écran : [vérifier son entreprise](https://docs.wajub.com/dashboard/activation/verify-business) pour le dossier, [vérifier l'identité d'une personne](https://docs.wajub.com/dashboard/activation/verify-identity) pour chaque personne du dossier, puis [suivre sa vérification](https://docs.wajub.com/dashboard/activation/track-verification) une fois le dossier envoyé. ## Ce que contrôle vraiment le bouton Soumettre pour vérification Le bouton reste inactif tant que le dossier n'est pas complet, et les règles sont précises, pas indicatives. Les lire maintenant va plus vite que les découvrir un refus après l'autre. Tout le monde doit avoir une catégorie d'activité, une description des produits, une raison sociale avec une adresse complète, un email d'entreprise vérifié, un téléphone d'entreprise vérifié et au moins une présence en ligne. **Si vous êtes une entreprise, une ONG ou toute autre organisation**, vous envoyez quatre documents au niveau de l'entreprise, et le quatrième n'est dispensé que pour les entités gouvernementales. | Document | Ce que c'est | | ---------------------------- | ------------------------------------------------------------------------------------------- | | Certificat d'immatriculation | La preuve que l'entité est légalement enregistrée. | | Statuts | Le document fondateur qui décrit la structure et les règles. | | Plan de localisation | Une carte ou un plan qui montre où l'activité s'exerce physiquement. | | Attestation fiscale | La confirmation de l'immatriculation fiscale. Non exigée pour les entités gouvernementales. | Vous enregistrez aussi au moins une personne désignée comme représentant légal, et cette personne doit avoir une pièce d'identité au dossier. Passeport, carte nationale d'identité ou titre de séjour sont acceptés. Le représentant légal fait aussi la vérification de présence (liveness), la même session en temps réel qu'un particulier (décrite plus bas), et peut la faire via un lien que vous lui envoyez. **Si vous êtes un particulier**, il n'y a aucun document d'entreprise. Vous vous enregistrez vous-même et fournissez trois éléments : une pièce d'identité, un justificatif de domicile et une vérification de présence (liveness). Cette vérification est une session en temps réel, faite dans le Dashboard ou via un lien que vous envoyez, ce qui est plus simple quand la personne à vérifier n'est pas celle qui est devant le clavier. Un fichier vidéo que vous téléversez vous-même ne compte pas comme une vérification de présence. **Si votre activité est réglementée**, et c'est le cas du traitement de paiements, du transfert d'argent, du prêt, de l'échange de cryptomonnaies, de l'investissement, des jeux d'argent, de la loterie, de la télémédecine et de la pharmacie en ligne, vous devez joindre une licence valide en plus de tout ce qui précède. Une licence expirée ou déjà refusée ne compte pas, et le dossier ne peut pas être soumis sans licence. ## Règles pour les fichiers Les documents sont acceptés en PDF, JPG, JPEG ou PNG, jusqu'à 10 Mo chacun. Numérisez de façon lisible. Un document illisible est le refus le plus bête qui soit, et il vous coûte un cycle de vérification complet. ## Après la soumission Votre dossier passe en `pending` et le Dashboard vous indique d'attendre une réponse sous 48 heures. Vous recevez immédiatement un email de confirmation, et l'équipe conformité prend le relais. Pendant l'attente, le dossier passe en lecture seule : vous ne pouvez ni modifier de champ ni ajouter de personne tant qu'une décision n'est pas rendue. Votre intégration sandbox n'est pas touchée. C'est le bon moment pour la terminer, tester les cas d'échec et dérouler la [checklist pour passer en live](https://docs.wajub.com/fr/getting-started/going-live), afin que l'approbation soit la seule chose qui vous sépare de votre premier vrai paiement. ## Suivez la décision depuis votre code La conformité émet des webhooks : votre application peut donc réagir à une décision sans que personne n'actualise un onglet du Dashboard. Abonnez un endpoint aux événements qui vous intéressent, et ils arrivent dans l'enveloppe signée habituelle. | Événement | Déclenché quand | | ------------------------------ | ---------------------------------------------------------------- | | `compliance.submitted` | Votre dossier entre en vérification. | | `compliance.verified` | Vous êtes approuvé et le live s'ouvre. | | `compliance.rejected` | Le dossier est refusé, avec un motif. | | `compliance.changes_requested` | Un point précis doit être corrigé avant une décision. | | `compliance.inquiry.created` | La conformité ouvre une question de suivi après la vérification. | | `compliance.inquiry.resolved` | Cette question est close. | Le payload contient le nouveau statut, le statut précédent et le motif de refus quand il y en a un, ce qui suffit pour envoyer une alerte à la bonne personne de votre côté. ```json title="compliance.verified" { "id": "evt_7Yh2Mp4kQ9vB5nL6hR1cY8dF", "event": "compliance.verified", "livemode": true, "api_version": "2026-10-11", "created": "2026-05-24T10:21:08+00:00", "data": { "legal_name": "Boutique Amina SARL", "type": "company", "status": "verified", "previous_status": "pending", "rejection_reason": null, "submitted_at": "2026-05-22T09:04:11+00:00", "verified_at": "2026-05-24T10:21:08+00:00" } } ``` Ces événements n'atteignent que les endpoints **live** qui les citent par leur nom. Un endpoint sandbox ne les reçoit jamais, un endpoint abonné à `*` non plus : ajoutez-les donc explicitement à la configuration de votre endpoint live. ## Quand vous êtes approuvé Votre dossier de conformité passe en `verified`, votre équipe passe en live et vos plafonds live sont fixés. Les clés live se créent ensuite de la même façon que les clés sandbox : en changeant d'environnement dans le Dashboard et en générant une nouvelle clé. Consultez [Configurer votre compte](https://docs.wajub.com/fr/getting-started/dashboard-setup) pour savoir où cela se trouve. Une clé sandbox n'est jamais promue en clé live. Vos plafonds, par transaction, par jour et par mois, pour l'encaissement comme pour les payouts, dépendent de votre entreprise et de son activité, et sont affichés dans le Dashboard. La vérification n'est pas définitive. Wajub fixe une date de nouvelle vérification à douze mois et vous prévient trente jours avant l'échéance : prévoyez de mettre vos documents à jour une fois par an. ## Quand le dossier revient pour corrections Un refus n'est pas définitif. `rejected` s'accompagne d'un motif écrit, et `changes_requested` signifie qu'un élément précis manque ou est illisible. Dans les deux cas, le dossier redevient modifiable et vous soumettez à nouveau le même dossier. Voici les causes qui reviennent réellement. | Cause | Que faire | | --------------------------------------------------------------------- | ------------------------------------------------------------------------------------------ | | Scan illisible ou partiel | Numérisez à nouveau la page entière, les quatre coins visibles. | | Le nom sur le document ne correspond pas à la raison sociale déclarée | Utilisez des documents au nom exact enregistré, ou corrigez la raison sociale. | | La présence en ligne est une page provisoire ou une URL hors ligne | Publiez quelque chose de réel avant de soumettre à nouveau, l'URL est ouverte. | | Description des produits trop vague | Dites ce que vous vendez, à qui, et pour quel montant habituel. | | Activité réglementée déclarée sans licence | Joignez la licence, ou corrigez l'activité si elle a été mal sélectionnée. | | Bénéficiaires effectifs manquants | Enregistrez chaque propriétaire, avec sa pièce d'identité et son pourcentage de détention. | Une fois vérifié, les questions supplémentaires arrivent par des **demandes de conformité** (compliance inquiries) plutôt que par une nouvelle vérification. Elles se trouvent dans le Dashboard à côté de votre dossier, s'enchaînent comme une conversation, et vous pouvez joindre des fichiers à une réponse. C'est le canal normal des suivis de lutte contre le blanchiment (AML), et elles ne suspendent pas votre compte à elles seules. Le guide du tableau de bord montre [comment y répondre](https://docs.wajub.com/dashboard/activation/track-verification#answer-an-inquiry). > [!WARNING] > **Certaines activités ne sont jamais éligibles** > > Les armes, les substances illicites et les jeux d'argent sans licence sont refusés quel que soit le > dossier, tout comme ce qui est illégal dans les pays où vous opérez. Si votre activité est > réglementée et que vous détenez la licence, déclarez-la dès la première étape au lieu d'espérer > que la question ne se pose pas. - [Passer en live](https://docs.wajub.com/fr/getting-started/going-live): La checklist à dérouler avant de changer de clés. - [Configurer votre compte](https://docs.wajub.com/fr/getting-started/dashboard-setup): Où les clés live sont générées une fois que vous êtes approuvé. - [Conformité et sécurité](https://docs.wajub.com/fr/resources/compliance): PCI-DSS, protection des données, réglementation régionale. - [Plafonds et quotas](https://docs.wajub.com/fr/resources/limits): Plafonds de montant, limites de requêtes, livraison des webhooks. --- # Structure des réponses URL: https://docs.wajub.com/fr/getting-started/api-structure > L'enveloppe JSON, le format des listes, la forme des erreurs et les identifiants communs à tous les endpoints. Chaque endpoint répond avec la même enveloppe JSON, en cas de succès comme d'échec. Trois clés sont toujours présentes : un seul handler de réponses couvre donc toute l'API, et vous ne distinguez que les parties qui changent. ## Les trois clés toujours présentes `code` répète le statut HTTP dans le corps, pour les clients qui lisent difficilement les en-têtes. `status` est le libellé HTTP de ce code (`OK`, `Created`, `Not Found`, `Unprocessable Content`), et jamais la chaîne littérale `error`. `message` est une courte phrase qui décrit ce qui s'est passé, destinée à vos logs plutôt qu'à vos clients. Tout le reste du corps dépend de ce que vous avez demandé. ## Une ressource Quand vous récupérez ou créez un seul objet, il arrive sous une clé qui porte le nom de son type. Un paiement revient sous `transaction`, un client sous `customer`, un transfert sous `transfer`. Il n'y a pas d'enveloppe générique `data` à déballer. Un champ sans valeur peut être omis ou envoyé à `null`. Traitez chaque champ facultatif comme pouvant être absent ou `null`, et lisez-le avec une valeur par défaut. ```json title="GET /payments/{id} · 200 OK" { "code": 200, "status": "OK", "message": "Payment retrieved", "transaction": { "id": "trx_test_CSUGajfv9xh0XQ5wu2lx", "reference": "order-4172", "status": "succeeded", "amount": 5000, "currency": "XAF", "created_at": "2026-05-24T10:21:08+00:00" } } ``` Un endpoint peut ajouter ses propres clés de premier niveau à côté de la ressource quand elles n'en sont pas des propriétés. La création d'un paiement est le premier cas que vous rencontrerez : l'URL de la page hébergée décrit la session que vous venez d'ouvrir, pas le paiement lui-même. Elle se place donc à côté de la ressource plutôt qu'à l'intérieur. Le jeton n'a pas de préfixe de type : c'est une chaîne aléatoire, précédée de `test_` dans la sandbox. ```json title="POST /payments · 201 Created" { "code": 201, "status": "Created", "message": "Payment initiated", "authorization_url": "https://pay.wajub.com/test_7Yh2Mp4kQ9xL4vR8tB3nW6yC1dF5sJ0aG…", "authorization_token": "test_7Yh2Mp4kQ9xL4vR8tB3nW6yC1dF5sJ0aG…", "transaction": { "id": "trx_test_CSUGajfv9xh0XQ5wu2lx", "status": "pending", "amount": 25000, "currency": "XAF" } } ``` ## Plusieurs ressources Les endpoints de liste dérogent volontairement à la règle de nommage. Le tableau s'appelle `items`, quel que soit son contenu, et un objet `meta` porte l'état de la pagination. Écrire une seule fonction de liste qui marche pour les paiements, les clients, les transferts et les autres ressources vaut donc la peine. Seule exception : `GET /events`, dont le tableau s'appelle `events` et qui ne pagine que par numéro. ```json title="GET /payments · 200 OK" { "code": 200, "status": "OK", "message": "Payments retrieved", "items": [ { "id": "trx_test_CSUGajfv9xh0XQ5wu2lx", "status": "succeeded", "amount": 5000 }, { "id": "trx_test_9Wm4Kd2pR7vB5nL6hY1c", "status": "pending", "amount": 12000 } ], "meta": { "current_page": 1, "last_page": 4, "per_page": 25, "total": 87, "next_cursor": "Q2t9mVxL4pRw8nZs...", "has_more": true } } ``` `meta` existe sous deux formes, et celle que vous recevez dépend de votre requête. Par défaut, vous paginez par numéro de page et `meta` vous indique où vous en êtes par rapport au total. Sur les listes qui prennent en charge les curseurs, il porte aussi `next_cursor` et `has_more`. Renvoyez ce `next_cursor` dans le paramètre `cursor` et l'API passe en pagination par curseur : c'est ce qu'il vous faut pour un gros export ou une reprise de données, car elle reste correcte pendant que de nouveaux objets arrivent. ```json title="meta, mode curseur" { "per_page": 25, "next_cursor": "Hj4kP9wQx2LmV7tRb3NcY6sD", "prev_cursor": null, "has_more": true } ``` La taille de page vaut 25 par défaut et plafonne à 100. [Pagination](https://docs.wajub.com/fr/api/pagination) explique comment parcourir une collection du début à la fin. ## Erreurs Une erreur garde les trois mêmes clés. Le code HTTP est dans la plage `4xx` ou `5xx`, `status` est le libellé de ce code, et `message` dit ce qui n'a pas marché. Comme l'enveloppe ne change pas, un appel en échec se lit avec le même code qu'un appel réussi. ```json title="422 Unprocessable Content" { "code": 422, "status": "Unprocessable Content", "message": "The amount field is required. (and 1 more error)", "errors": { "amount": ["The amount field is required."], "currency": ["The selected currency is invalid."] } } ``` Deux classes d'erreurs ajoutent un champ à traiter explicitement. Un `422` contient `errors`, un objet indexé par nom de champ dont les valeurs sont des tableaux de messages : un champ peut donc échouer sur plusieurs règles à la fois ; un refus qui ne vise aucun champ précis range son message sous `errors.request`. Le `message` de premier niveau est le premier d'entre eux, suivi de `(and 1 more error)` s'il y en a d'autres. Une réponse bloquée par la limite de requêtes contient `retry_after`, le nombre de secondes à attendre, ce qui vous évite de deviner un délai. Un `409 Conflict` qui contient `errors.idempotency_key` signifie que vous avez réutilisé une `Idempotency-Key` dont la première requête est encore en cours : renvoyez-la un instant plus tard pour obtenir la réponse enregistrée. Une `reference` n'est jamais contrôlée pour son unicité : la réutiliser ne provoque aucun conflit. Les autres `409` disent que la ressource n'est pas dans un état qui permet l'appel. `payment_in_progress`, sur un débit ou une annulation, signifie qu'un débit est en cours : attendez son issue, par webhook ou en relisant le paiement, puis rappelez si besoin. Un paiement préparé déjà activé, annulé ou expiré, l'annulation d'un paiement dont des échéances ont été payées (`payment_partly_paid`), et quelques cas Sync et CLI décrits sur leurs pages ne changent pas en attendant : relisez la ressource, puis décidez. Un `404` vous indique quelle ressource manquait, `Payment Not Found` plutôt qu'un message générique : le champ `message` suffit donc pour aiguiller l'erreur sans examiner l'URL appelée. Le catalogue complet des codes se trouve dans la [référence API](https://docs.wajub.com/fr/api/errors). > [!WARNING] > **N'analysez pas le message** > > `message` est du texte libre, et il change. Basez vos décisions sur `code`, et sur les clés de > `errors` quand vous avez besoin du détail par champ. ## Statuts de paiement Le `status` d'une transaction prend l'une de neuf valeurs. Les transitions entre elles, et celles qui sont finales, sont décrites dans [Concepts clés](https://docs.wajub.com/fr/getting-started/concepts#payment-lifecycle). | Statut | Signification | | -------------------- | ----------------------------------------------------------------- | | `pending` | Créé, en attente d'une action du client. | | `processing` | Confirmé auprès du prestataire, règlement en cours. | | `succeeded` | Fonds reçus. Vous pouvez livrer la commande. | | `failed` | Refusé par le prestataire ou par le portefeuille. | | `cancelled` | Annulé par le client ou par vous. | | `expired` | La fenêtre de paiement s'est fermée avant la fin. | | `partial` | Une partie du montant a été capturée, sur un paiement fractionné. | | `refunded` | Entièrement remboursé après un succès. | | `partially_refunded` | Partiellement remboursé après un succès. | ## Identifiants Chaque objet porte un `id` construit de la même façon : un préfixe qui nomme le type, puis `test_` quand l'objet vit dans la sandbox, puis une chaîne aléatoire. Le préfixe vous dit ce que vous avez entre les mains sans rien consulter, et le segment `test_` empêche de confondre un identifiant sandbox avec un identifiant live dans un log ou un ticket de support. | Préfixe | Objet | Partie aléatoire | | ------- | ----------------- | ---------------- | | `trx_` | Paiement | 20 caractères | | `po_` | Transfert sortant | 20 caractères | | `rfd_` | Remboursement | 20 caractères | | `dsp_` | Litige | 20 caractères | | `ben_` | Bénéficiaire | 20 caractères | | `acc_` | Sous-compte Sync | 20 caractères | | `cus_` | Client | 24 caractères | | `evt_` | Événement webhook | 24 caractères | Ainsi, un paiement sandbox s'écrit `trx_test_CSUGajfv9xh0XQ5wu2lx` et son jumeau en production `trx_CSUGajfv9xh0XQ5wu2lx`. Stockez les identifiants en texte de longueur illimitée, jamais dans une colonne fixe de 24 ou 32 caractères. Les factures et les liens de paiement suivent leurs propres règles, listées dans [Concepts clés](https://docs.wajub.com/fr/getting-started/concepts#resource-identifiers). ## Dates Chaque horodatage est au format ISO 8601 en UTC, avec un décalage explicite plutôt qu'un suffixe `Z`. ```json title="Format des horodatages" "created_at": "2026-05-24T10:21:08+00:00" ``` Les deux écritures désignent le même instant et tout parseur ISO 8601 les gère. Mais si vous comparez des horodatages sous forme de chaînes, ce que vous ne devriez pas faire, c'est ce décalage que vous recevrez réellement. ## Montants Les montants sont exprimés dans l'unité principale de la devise. `5000` dans une réponse signifie 5 000 XAF, et non 50 XAF, soit l'inverse de ce que font la plupart des API de paiement. Le franc CFA n'a pas de subdivision utilisée au quotidien : une convention en unité mineure inventerait une coupure qui n'existe pas. Les valeurs reviennent sous forme de nombres arrondis à deux décimales. Ce que vous pouvez débiter est borné par devise : de 25 à 2 000 000 en XAF et XOF, à partir de 100 en NGN, à partir de 0,50 en USD et EUR. Un montant hors de ces bornes est refusé avec un `422` dont le message les indique. Lisez le champ `currency` avant tout calcul, car un même chiffre signifie des choses très différentes en XAF et en USD. --- # Concepts clés URL: https://docs.wajub.com/fr/getting-started/concepts > Cycle de vie d'un paiement, environnements, jetons de session, API keys et modèle d'orchestration. Avant d'écrire du code, prenez quelques minutes pour comprendre les concepts de base. Ensuite, chaque appel d'API et chaque événement webhook vous paraîtra clair tout de suite. ## Cycle de vie d'un paiement Un paiement est une conversation entre trois parties : votre serveur, Wajub et la personne qui paie. Chaque changement d'état vient de l'action de l'une d'elles. Le plus rapide pour comprendre le cycle de vie est donc de regarder qui fait quoi, et dans quel ordre. ### Le parcours d'un paiement réussi Six mouvements, dont deux seulement vous reviennent. Vous ouvrez le paiement, vous redirigez, puis vous attendez. Wajub choisit un prestataire, encaisse l'argent et vous dit comment tout s'est terminé. 1. Votre serveur → Wajub: Vous déclarez l'intention d'encaisser (`POST /payments`, `pending`) 2. Wajub → Client: Vous redirigez le payeur vers la page hébergée (`authorization_url`) 3. Client → Wajub: Le payeur choisit un opérateur et confirme sur son téléphone (`processing`) 4. Wajub → Wajub: Wajub route vers un prestataire et les fonds arrivent (`succeeded`) 5. Wajub → Votre serveur: Wajub livre l'événement à votre endpoint (`payment.succeeded`) 6. Votre serveur → Wajub: Vous vérifiez le résultat avant de livrer la commande (`GET /payments/{id}`) ### Quand le paiement n'aboutit pas Les trois mêmes parties, le même ordre, mais le paiement quitte le parcours idéal. Chaque sortie produit son propre événement : votre endpoint l'apprend exactement comme il apprend un succès. 1. Client → Wajub: Le payeur abandonne et la fenêtre se ferme (`expired`) 2. Client → Wajub: Le payeur annule, ou vous annulez vous-même le paiement (`cancelled`) 3. Wajub → Wajub: Le prestataire refuse le débit ou ne répond pas à temps (`failed`) 4. Wajub → Wajub: Seule une partie du montant est réglée, le reste est encore en cours (`partial`) 5. Wajub → Wajub: Le reste est réglé, le paiement aboutit donc quand même (`succeeded`) 6. Wajub → Votre serveur: Wajub livre l'événement correspondant (`payment.failed`) Quatre états mettent fin à la tentative : `succeeded`, `failed`, `cancelled` et `expired`. Rien de ce que fait le client ne fait sortir un paiement de ces états. `pending`, `processing` et `partial` sont encore en cours : traitez-les comme ouverts, jamais comme un échec. Deux choses peuvent encore bouger après la fin. Un prestataire qui confirme une charge en retard fait passer un paiement `failed`, `cancelled` ou `expired` à `succeeded`, puisque l'argent a été prélevé. Et un paiement `succeeded` peut encore afficher `refunded` ou `partially_refunded` des jours plus tard. | État | Signification | Action suivante | | -------------------- | ------------------------------------------------------------------ | -------------------------------------------------------------------- | | `pending` | Initialisé, en attente d'une action du client. | Redirigez le client vers la page de paiement. | | `processing` | Le prestataire traite le débit. | Attendez. Le webhook `payment.*` vous indique comment il se termine. | | `succeeded` | Fonds reçus. Vous pouvez livrer la commande. | Livrez le produit ou le service. | | `failed` | Refusé, sans réponse à temps, ou jamais transmis à un prestataire. | Affichez une erreur, proposez de réessayer. | | `cancelled` | Annulé par le client ou le marchand. | Aucune action nécessaire. | | `expired` | La fenêtre de paiement s'est fermée avant la fin. | Relancez le paiement si nécessaire. | | `partial` | Une partie du montant est réglée, le reste est encore en cours. | Gardez la commande ouverte. Elle peut encore atteindre `succeeded`. | | `refunded` | Un paiement réussi a été entièrement remboursé. | Gérez le retour. | | `partially_refunded` | Un remboursement partiel a été appliqué. | Suivez le montant restant. | ### Comment un paiement passe d'un état à l'autre 1. **Vous** appelez `POST /payments`, ce qui crée une transaction en `pending`. 2. **Le client** effectue le paiement sur la page hébergée (`pay.wajub.com`). 3. **Wajub** traite le débit avec le meilleur prestataire disponible (voir [Orchestration](https://docs.wajub.com/fr/orchestration)). 4. **Wajub** envoie un webhook `payment.succeeded` à votre serveur. 5. **Vous** vérifiez le statut via `GET /payments/{id}` et livrez la commande. C'est à l'étape 4 que la machine à états vous atteint. Chaque transition enregistrée par Wajub émet un événement, et un événement livré à votre endpoint ressemble à ceci. Le type se trouve dans `event`, et `data` contient le paiement exactement tel que `GET /payments/{id}` le renverrait : ```json title="payment.succeeded" { "id": "evt_test_aio5DpN577tNU2vOxdmu", "event": "payment.succeeded", "data": { "id": "trx_test_CSUGajfv9xh0XQ5wu2lx", "amount": 5000, "amount_paid": 5000, "currency": "XAF", "status": "succeeded", "channel": "cm.mtn", "customer": { "id": "cus_test_sAaim5apjocIgtlhzJY3", "email": "amina@example.com" }, "sandbox": true, "created_at": "2026-09-11T10:24:00+00:00" }, "livemode": false, "pending_webhooks": 1, "api_version": "2026-10-11", "request": { "id": null, "idempotency_key": "idem_4kQ9xL2mR7vB5nW8tY3cZ6hJ1dF0sGaP" }, "created": "2026-09-11T10:26:13+00:00" } ``` ## Sandbox ou live Wajub fournit deux environnements entièrement isolés. Une seule URL de base sert les deux. L'environnement est déterminé par l'API key que vous utilisez. | | Sandbox | Live | | ------------------- | ------------------------------------------------------------------------------------------ | ------------------------------------------------------------ | | **Clés** | `pk_test.…` / `sk_test.…` | `pk.…` / `sk.…` | | **Argent** | Aucun mouvement de fonds réel | Paiements réels | | **Données de test** | [Numéros de téléphone de test](https://docs.wajub.com/fr/getting-started/quickstart#4-pay-it-with-a-sandbox-number) | Données clients réelles | | **Périmètre** | Paiements, remboursements, transferts, clients, webhooks | Tout, y compris les liens, les factures, les taxes et Shield | > [!WARNING] > **Ne mélangez jamais les environnements** > > Une clé sandbox ne peut pas accéder aux données live, et inversement. Stockez les clés dans des > variables d'environnement distinctes pour chaque environnement. ## API keys Trois types de clés, chacun avec un rôle précis : - `Clé publique (pk.… / pk_test.…)` (sûre côté client): Initialisez des paiements depuis le navigateur ou l'application mobile. N'a pas accès aux opérations sensibles. - `Clé privée (sk.… / sk_test.…)` (serveur uniquement): Accès complet à l'API : paiements, transferts, remboursements, solde. Ne doit jamais quitter votre backend. - `Clé restreinte (rk.… / rk_test.…)` (serveur uniquement): Limitée à des ressources précises (par ex. payment.read). Idéale pour les intégrations tierces ou les services à privilèges minimaux. > [!CAUTION] > **Les clés privées sont bloquées dans les navigateurs** > > N'utilisez jamais une clé privée `sk` depuis un navigateur ou une application mobile. Lorsque > Wajub détecte une clé privée utilisée depuis un navigateur, il refuse la requête et vous prévient > par e-mail. C'est un filet de sécurité, pas une garantie. Stockez `sk.…` dans des variables > d'environnement. Jamais dans du code côté client. ## Jetons de session `POST /payments` renvoie un **jeton de session**, `authorization_token`, déjà inclus dans l'`authorization_url` vers laquelle vous redirigez. Le jeton est limité à un seul paiement, il ne peut rien faire d'autre que payer ce paiement, et vous pouvez le confier sans risque à un navigateur. Sa durée de vie suit celle du paiement. La fenêtre de paiement est de 24 heures par défaut, ajustable de 5 minutes à 30 jours avec `expires.in`. Vous ne manipulez le jeton vous-même que si vous intégrez le checkout dans votre propre page au lieu de rediriger. Votre serveur crée le paiement comme d'habitude : ```typescript title="Serveur, créer le paiement" import { Wajub } from '@wajub/node'; const wajub = new Wajub({ apiKey: process.env.WAJUB_API_KEY! }); const payment = await wajub.payments.create({ amount: 5000, currency: 'XAF', customer: { email: 'amina@example.com' }, }); // Send payment.authorization_token to your frontend. ``` Votre frontend transmet ce jeton au SDK navigateur, qui est un package différent et ne voit jamais votre API key : ```typescript title="Navigateur, afficher le checkout" import { mount } from '@wajub/js'; await mount('#checkout', { sessionId: authorizationToken }); ``` Consultez [Wajub Components](https://docs.wajub.com/fr/libraries/components) pour le checkout intégré complet. ## Modèle d'orchestration Wajub route chaque paiement vers un prestataire selon le canal, le pays, le montant et vos règles de routage, et se replie sur le suivant si le premier échoue. Il vous suffit de créer un paiement et d'écouter le webhook. > [!TIP] > **Consultez chaque décision de routage** > > Une fois en live, ouvrez [Konsole → Journal de routage](https://docs.wajub.com/fr/developer-tools/konsole/routing-log) pour voir la > décision de routage et les prestataires essayés pour chaque paiement. Il n'existe pas en sandbox. ## Identifiants de ressources Chaque identifiant de ressource se compose d'un préfixe, puis de `test_` quand l'objet vit dans la sandbox, puis de 20 à 24 caractères aléatoires selon la ressource. Un identifiant vous indique donc deux choses d'un coup d'œil : ce qu'il désigne, et quel environnement l'a produit. Stockez les identifiants en texte, avec de la place pour 40 caractères. | Préfixe | Ressource | Live | Sandbox | | ------- | ----------------------- | ------------------------------ | ----------------------------------- | | `trx_` | Transaction de paiement | `trx_CSUGajfv9xh0XQ5wu2lx` | `trx_test_CSUGajfv9xh0XQ5wu2lx` | | `po_` | Transfert (payout) | `po_225KMKULRQqYvlhrgUOE` | `po_test_225KMKULRQqYvlhrgUOE` | | `rfd_` | Remboursement | `rfd_9xh0XQ5wu2lxCSUGajfv` | `rfd_test_9xh0XQ5wu2lxCSUGajfv` | | `ben_` | Bénéficiaire | `ben_LRQqYvlhrgUOE225KMKU` | `ben_test_LRQqYvlhrgUOE225KMKU` | | `dsp_` | Litige | `dsp_hrgUOE225KMKULRQqYvlh` | `dsp_test_hrgUOE225KMKULRQqYvlh` | | `pm_` | Moyen de paiement | `pm_sAaim5apjocIgtlhzJY3x` | `pm_test_sAaim5apjocIgtlhzJY3x` | | `cus_` | Client | `cus_sAaim5apjocIgtlhzJY3wQ8s` | `cus_test_sAaim5apjocIgtlhzJY3wQ8s` | | `evt_` | Événement webhook | `evt_aio5DpN577tNU2vOxdmuZGhT` | `evt_test_aio5DpN577tNU2vOxdmuZGhT` | Trois ressources suivent leur propre règle. Une facture commence toujours par `inv_`, sans segment d'environnement. Un lien de paiement n'a aucun préfixe : son identifiant fait neuf caractères, comme `kQ7vB4nL6`, car c'est aussi l'URL publique que reçoivent les gens. Un message de litige est un UUID. > [!TIP] > **Servez-vous du préfixe comme garde-fou** > > Un identifiant `test_` qui arrive dans votre base de données de production est un bug de > configuration, pas un paiement. Vérifier le préfixe avant de livrer une commande repère une API key > mal choisie bien avant votre comptable. ## Montants Contrairement à beaucoup de prestataires de paiement, Wajub exprime les montants dans l'**unité principale** de la devise (par ex. `5000` = 5 000 XAF, et non 500 000 centimes). Les devises en franc CFA n'ont pas de subdivision courante, ce qui évite toute confusion. ## « Paiement » ou « transaction » Wajub utilise les deux termes, et ils désignent le même objet : - **Paiement**. Le concept métier. Vous créez un paiement, un client paie, vous livrez la commande. - **Transaction**. Le nom que l'API donne à l'objet paiement. La réponse de l'API utilise `"transaction": {...}` comme clé racine, et le champ `id` est préfixé par `trx_`. En pratique : vous appelez `POST /payments`, recevez `transaction.id = "trx_xxx"`, et écoutez les webhooks `payment.succeeded`. Dans cette documentation, les deux termes sont interchangeables. ## Étapes suivantes - [Démarrage rapide](https://docs.wajub.com/fr/getting-started/quickstart) : codez votre premier paiement. - [Orchestration](https://docs.wajub.com/fr/orchestration) : le fonctionnement du routage et du repli. - [Webhooks](https://docs.wajub.com/fr/developer-tools/webhooks/quickstart) : recevez `payment.succeeded` de manière fiable. --- # Configurer votre compte URL: https://docs.wajub.com/fr/getting-started/dashboard-setup > Créez votre compte, générez une API key dans le bon environnement et branchez-la dans votre SDK. Chaque appel à l'API Wajub est authentifié par une clé, et une clé appartient à un compte et à un environnement. Cette page vous emmène de l'absence de compte à un SDK qui s'authentifie, soit l'état dans lequel le [démarrage rapide](https://docs.wajub.com/fr/getting-started/quickstart) suppose que vous êtes déjà. ## 1. Créez votre compte Inscrivez-vous sur **[dashboard.wajub.com](https://dashboard.wajub.com)** avec votre nom, votre email et un mot de passe, puis confirmez l'email que nous vous envoyons. Rien n'est payant à ce stade : un nouveau compte démarre sur le plan gratuit **Pay as you go**. Votre compte utilisateur vient d'abord, votre activité ensuite. Juste après la confirmation de votre email, le Dashboard vous demande de créer votre premier compte marchand, sur un écran intitulé **Parlez-nous de votre activité** : | Champ | Obligatoire | À quoi il sert | | ------------------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------- | | Nom du marchand | Oui | Le nom de votre entreprise, de votre projet ou de votre application. | | E-mail professionnel | Non | Imprimé sur les factures et les emails que reçoivent vos clients. Votre propre email est utilisé si vous le laissez vide. | | Téléphone de l'entreprise | Non | Affiché à vos clients à côté de cet email, pour qu'ils puissent vous joindre. | Vous êtes le propriétaire de ce compte. Le Dashboard reste sur cet écran tant qu'il n'existe pas, et vous pourrez créer d'autres comptes marchands plus tard avec le même utilisateur. Votre équipe est créée en **sandbox**, et elle y reste tant que la vérification de votre activité n'est pas approuvée. Rien de ce que vous faites maintenant ne peut déplacer de l'argent réel, et c'est tout l'intérêt : construisez et cassez librement avant que l'[activation](https://docs.wajub.com/fr/getting-started/account-activation) n'ouvre la production. L'accueil du Dashboard affiche une checklist de configuration adaptée à ce que vous avez dit vouloir construire. Elle suit les mêmes étapes que cette page, vous pouvez donc suivre l'une ou l'autre. ## 2. Choisissez l'environnement avant de générer une clé C'est l'étape que tout le monde saute. Une clé est générée pour l'environnement que le Dashboard affiche à ce moment-là. Basculez **d'abord** l'environnement sur **Test** ou sur **Production**, puis créez la clé. Créée dans le mauvais environnement, elle s'authentifiera sans problème tout en renvoyant les données d'un environnement auquel vous ne vouliez pas toucher. Le live reste indisponible tant que votre compte n'est pas vérifié : d'ici là, chaque clé que vous créez est une clé `_test`, quoi que vous fassiez. Changer d'environnement est en soi une permission. Le propriétaire du compte peut toujours le faire, les autres membres ont besoin d'un rôle qui le permet, **Administrator** ou **Developer** par défaut, et un membre au rôle **Sandbox User** ne peut jamais passer en live. ## 3. Créez votre première API key Ouvrez **Paramètres → Développeurs → Clés API** et créez une clé. Vous choisissez le type, et le préfixe découle de ce choix et de l'environnement sélectionné à l'étape 2. | Type | Préfixe sandbox | Préfixe production | À utiliser pour | | ---------- | --------------- | ------------------ | -------------------------------------------------------------------------------------------- | | Publique | `pk_test.` | `pk.` | Le code navigateur et mobile, pour créer un paiement. La détenir n'est pas une autorisation. | | Privée | `sk_test.` | `sk.` | Votre serveur. Accès complet à l'API. | | Restreinte | `rk_test.` | `rk.` | Votre serveur, limité aux scopes que vous accordez. | Commencez par une clé privée. Une clé restreinte vaut l'étape supplémentaire une fois que vous savez quels endpoints vous appelez réellement, et [Environnements et API keys](https://docs.wajub.com/fr/getting-started/environments) détaille les scopes, la liste d'IP autorisées et la date d'expiration que vous pouvez associer à chacune d'elles. > [!CAUTION] > **Copiez la valeur tout de suite** > > La valeur complète apparaît dans le bandeau juste après la création. Copiez-la dans votre > gestionnaire de secrets avant de quitter la page. La liste des clés n'en montre ensuite que les > premiers caractères. Vous pouvez afficher de nouveau une clé privée ou restreinte avec **Afficher**, > qui vous demande un code de vérification de sécurité, est limité en fréquence et est inscrit au > journal d'audit. Une clé publique reste copiable depuis la liste. Si vous avez installé la [CLI](https://docs.wajub.com/fr/developer-tools/cli/installation), `wajub login` le fait pour vous : la commande associe le terminal à votre compte via le navigateur, et le propriétaire, un Administrator ou un Developer (un Sandbox User aussi, pour une clé sandbox) approuve la demande et choisit l'environnement, Sandbox sauf s'il choisit Live. La CLI enregistre la clé dans un profil local. Cette clé expire au bout de 90 jours, et `wajub login` vous en donne une nouvelle. **Connexion avec Wajub**, dans le plugin WordPress, demande une clé de la même façon, et cette clé dure 90 jours sauf si la personne qui approuve choisit **Durée indéterminée**. Chaque clé créée par un appairage envoie un e-mail au propriétaire et à chaque Administrator. ## 4. Placez la clé dans votre environnement Les clés vont dans l'environnement, jamais dans le code et jamais dans le dépôt. Créez un fichier `.env` à la racine de votre projet et gardez-le hors de git. ```bash title=".env" WAJUB_API_KEY=sk_test.xxxxxxxxxxxxxxxx… WAJUB_WEBHOOK_SECRET=whsec_test_xxxxxxxxxxxxxxxx ``` `WAJUB_API_KEY` est le nom que tous les SDK reconnaissent : utilisez-le plutôt que d'inventer le vôtre. `WAJUB_WEBHOOK_SECRET` est le secret de signature d'un endpoint de webhook, un identifiant complètement différent, et c'est à l'étape 6 que vous en obtenez un. ## 5. Branchez la clé dans le SDK Deux des SDK lisent `WAJUB_API_KEY` dans l'environnement d'eux-mêmes. Python et Go construisent un client fonctionnel à partir d'une configuration vide, c'est pourquoi les exemples ci-dessous ne passent rien. Node et PHP ne lisent pas l'environnement et lèvent une erreur si la configuration est vide : vous leur passez donc la valeur vous-même. **Authentifier le SDK** ```javascript import { Wajub } from '@wajub/node'; const wajub = new Wajub({ apiKey: process.env.WAJUB_API_KEY }); ``` ```python from wajub import Wajub wajub = Wajub() ``` ```php getenv('WAJUB_API_KEY'), ]); ``` ```go package main import ( "log" "github.com/wajubhq/wajub-go" ) func main() { client, err := wajub.New(wajub.Config{}) if err != nil { log.Fatal(err) } _ = client } ``` Quel que soit votre SDK, les quatre lisent `WAJUB_WEBHOOK_SECRET` d'eux-mêmes pour vérifier les signatures : une fois cette variable définie, vous ne passez jamais le secret explicitement. ## 6. Enregistrez un endpoint de webhook Un paiement se confirme de façon asynchrone : votre serveur apprend donc le résultat par un webhook, et non par la réponse à l'appel qui l'a créé. Enregistrez l'endpoint maintenant, pendant que vous êtes dans le Dashboard, pour que le [démarrage rapide](https://docs.wajub.com/fr/getting-started/quickstart) ait une adresse où livrer. Ouvrez **Konsole → Webhooks → Points de terminaison**, ajoutez votre URL et copiez le secret de signature affiché sur l'endpoint. Il ressemble à `whsec_test_` suivi de 32 caractères en sandbox, et à `whsec_` suivi de 32 caractères en production. Ce secret est propre à chaque endpoint et à chaque environnement. Enregistrer à nouveau la même URL en live vous donne un secret différent : c'est pourquoi passer en production implique de copier un nouveau secret plutôt que de réutiliser celui que vous avez. Utilisez-le pour [vérifier chaque signature entrante](https://docs.wajub.com/fr/developer-tools/webhooks/signature-verification) avant de faire confiance à un payload. ## 7. Renouvelez une clé qui a fuité Le renouvellement remplace la valeur sur place. Le nom, les scopes et la liste d'IP autorisées sont conservés, l'ancienne valeur cesse de s'authentifier dès que vous confirmez, et il n'existe aucune période de grâce pendant laquelle les deux fonctionnent. Ayez donc la nouvelle valeur prête à déployer avant de cliquer, sinon vous subissez une interruption entre le renouvellement et la mise en production. Comme cette action est destructive, le renouvellement demande un code de vérification de sécurité si vous n'en avez pas saisi un récemment. La suppression d'une clé demande la même chose. ## 8. Qui peut le faire dans votre équipe Les API keys ne sont visibles que par le propriétaire du compte et par les membres qui ont la permission de gérer les API keys, que portent les rôles **Administrator**, **Developer** et **Sandbox User**. Les autres membres trouvent quand même **Paramètres → Développeurs → Clés API** dans le menu, mais la page répond « Vous n'avez pas la permission requise pour effectuer cette action. » : demandez à un admin de changer votre rôle. Le [tableau des rôles](https://docs.wajub.com/fr/dashboard#roles) du guide du tableau de bord liste ce que chaque rôle peut faire. ## 9. Quand la production s'ouvre Les comptes vérifiés obtiennent leurs clés live de la même façon, en changeant d'environnement et en créant une clé. Les clés live sont des objets distincts : une clé sandbox n'est jamais promue. Prévoyez de remplacer ensemble la clé, l'URL du webhook et son nouveau secret de signature, et déroulez la [checklist pour passer en live](https://docs.wajub.com/fr/getting-started/going-live) avant de le faire. - [Démarrage rapide](https://docs.wajub.com/fr/getting-started/quickstart): Votre premier paiement, avec la clé que vous venez de créer. - [Environnements et API keys](https://docs.wajub.com/fr/getting-started/environments): Formats de clés, scopes, listes d'IP autorisées, expiration. - [Activation du compte et KYC](https://docs.wajub.com/fr/getting-started/account-activation): Les documents qui débloquent la production. - [Bonnes pratiques de sécurité](https://docs.wajub.com/fr/best-practices/security): Stocker, renouveler et restreindre les identifiants. --- # Environnements et API keys URL: https://docs.wajub.com/fr/getting-started/environments > Comprendre les modes test et production, le format des clés et comment basculer sans risque. Wajub fait tourner deux environnements isolés derrière une seule API, avec la même URL de base, les mêmes endpoints et les mêmes payloads. C'est la clé que vous envoyez qui décide auquel vous vous adressez : changer d'environnement revient à changer d'identifiant, jamais à réécrire du code. ```bash title="URL de base (test et production)" https://api.wajub.com ``` ## Sandbox La sandbox est l'endroit où vous développez. Les opérateurs Mobile Money y sont simulés par des [numéros de test](https://docs.wajub.com/fr/getting-started/quickstart#4-pay-it-with-a-sandbox-number) dont les six derniers chiffres décident du résultat, les webhooks se déclenchent exactement comme en production, et aucun argent ne circule jamais. Elle ne partage aucune donnée avec le mode live, si bien qu'un client, un paiement ou un événement sandbox n'apparaît jamais dans votre compte live. Les clés sont `pk_test.…` et `sk_test.…`, et chaque objet créé dans la sandbox porte `test_` dans son id. ## Production La production déplace de l'argent réel. Elle s'ouvre une fois la vérification de votre entreprise approuvée : consultez [Activation du compte et KYC](https://docs.wajub.com/fr/getting-started/account-activation) pour les documents et les délais. Les clés sont `pk.…` et `sk.…`. Dans le Dashboard, chaque membre travaille dans un environnement à la fois : le guide du tableau de bord montre [comment passer en Production](https://docs.wajub.com/dashboard/getting-started/test-and-live) et ce qui y change. ## Ce que la sandbox ne couvre pas La sandbox reproduit fidèlement le parcours de paiement, mais cinq fonctionnalités n'existent qu'en live. Les appeler avec une clé de test renvoie `403` avec `This feature is only available in live mode.` | Fonctionnalité | Endpoints | Sandbox | | -------------------------------------------------------- | ----------------------------------- | --------------- | | Liens de paiement | `/links` | Live uniquement | | Factures | `/invoices` | Live uniquement | | Taxes | `/tax` et `/customers/{id}/tax_ids` | Live uniquement | | Shield | `/shield` | Live uniquement | | Paiements, remboursements, transferts, clients, webhooks | | Disponible | Une autre différence joue en sens inverse : la page de paiement sandbox propose toujours une carte de test pour que vous puissiez tester ce parcours de code, alors que la page live ne propose que les canaux couverts par vos prestataires actifs. Une carte n'y apparaît qu'une fois un prestataire qui accepte les cartes activé sur votre compte. Développez d'abord avec Mobile Money. ## Types de clés | Type | Préfixe | Où elle s'exécute | Ce qu'elle peut faire | | ---------- | ------------------ | ------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------- | | Publique | `pk.` / `pk_test.` | Navigateur, application mobile | Créer un paiement depuis la page. La détenir n'est pas une autorisation : voir [les endpoints qui l'acceptent](https://docs.wajub.com/fr/api/authentication#the-three-key-types). | | Privée | `sk.` / `sk_test.` | Votre serveur uniquement | Tout : paiements, remboursements, transferts, solde. | | Restreinte | `rk.` / `rk_test.` | Votre serveur uniquement | Uniquement les scopes que vous lui accordez, une ressource à la fois. | Une clé se compose d'un préfixe, d'un point, puis d'une longue partie secrète aléatoire. Stockez les clés en texte, jamais dans une colonne de longueur fixe de 32 ou 64 caractères. ```bash title="Format d'une clé" sk_test.xxxxxxxxxxxxxxxx… # prefix "sk_test", a dot, then the random secret ``` > [!CAUTION] > **Ne commitez jamais une clé privée** > > Gardez `sk.…` dans des variables d'environnement ou un gestionnaire de secrets. Si une clé fuite, > révoquez-la depuis **Paramètres → Développeurs → Clés API** dans le Dashboard. La rotation d'une clé génère > immédiatement une nouvelle valeur, et l'ancienne cesse de fonctionner dès la requête suivante. ## Limiter ce qu'une clé peut faire Trois contrôles existent sur chaque clé, et les activer ne coûte rien. **Des scopes, sur les clés restreintes.** Une clé restreinte porte une liste explicite de permissions `{resource}.{read|write}` : `payment.read`, `payment.write`, `customer.read`, `transfer.write`, `refund.write`, `recipient.*`, `invoice.*`, `dispute.*`, `webhook.*`, `event.*`, `link.*`, `identity.*`, `tax.*`, plus `balance.read` et `account.read` en lecture seule. Tout ce qui sort de la liste renvoie `403`. Il n'existe pas de `balance.write`, mais `transfer.write` suffit pour envoyer des payouts avec `POST /transfers` : ne l'accordez qu'à une clé dont le rôle est de payer quelqu'un. **Une liste d'IP autorisées.** Chaque clé accepte une liste d'adresses IPv4 ou IPv6 exactes, ou de plages CIDR de l'une ou l'autre famille, comme `203.0.113.0/24` ou `2001:db8::/32`. Vous la saisissez à la création de la clé, et vous pouvez la modifier ensuite, quel que soit le type de clé. Une requête venant de n'importe où ailleurs est refusée avec `403 IP address not allowed for this API key`, quel que soit le type de clé. Une clé qui ne fonctionne que depuis vos serveurs de production ne vaut rien dans un dépôt divulgué. **Une date d'expiration.** Une clé peut porter `expires_at`. Passé ce moment, elle n'authentifie plus rien. Utilisez-la pour un sous-traitant, un script de migration ou toute intégration que vous savez temporaire. Vous la fixez à la création de la clé, vous la changez ou la retirez ensuite, quel que soit le type de clé, et elle s'affiche à côté de la clé dans la liste : **Expire le …**, ou **Expirée le …** une fois la date passée. Une clé sans expiration n'affiche aucune date. Modifier autre chose sur une clé laisse son expiration telle qu'elle était. Une clé créée en approuvant un appairage, `wajub login` ou une application comme le plugin WordPress, expire au bout de 90 jours, sauf si la personne qui approuve choisit **Durée indéterminée**, ce que la page d'approbation ne propose jamais pour la CLI. ## Variables d'environnement Trois noms suffisent pour une intégration serveur. Gardez-les dans l'environnement plutôt que dans le code, et nommez-les exactement ainsi : les SDKs cherchent ces noms et aucun autre. ```bash title=".env" WAJUB_API_KEY=sk_test.xxxxxxxxxxxxxxxx… WAJUB_WEBHOOK_SECRET=whsec_test_xxxxxxxxxxxxxxxx WAJUB_PUBLIC_KEY=pk_test.xxxxxxxxxxxxxxxx… ``` `WAJUB_API_KEY` est l'identifiant d'authentification. Les SDKs Python et Go la lisent eux-mêmes dans l'environnement, si bien qu'une configuration vide vous donne un client qui fonctionne. Les SDKs Node et PHP ne le font pas : ils lèvent une erreur sur une configuration vide et attendent que vous passiez la valeur. Consultez [Configurer votre compte](https://docs.wajub.com/fr/getting-started/dashboard-setup#5-point-the-sdk-at-the-key) pour la forme exacte dans chaque langage. `WAJUB_WEBHOOK_SECRET` est la seule que les quatre lisent automatiquement. Définissez-la et la vérification de signature fonctionne sans que vous ayez à passer le secret nulle part. `WAJUB_PUBLIC_KEY` n'est lue par aucun SDK. Elle sert à votre propre code frontend, et seulement si votre navigateur ou votre client mobile initialise lui-même les paiements. Les valeurs de production ont leur place dans votre gestionnaire de secrets, jamais dans un fichier commité. La configuration la plus sûre sépare les variables de sandbox et de production, pour que la mise en production de votre code n'oblige jamais à modifier une clé à la main. ## Passer en production 1. Finalisez la vérification de votre entreprise dans le Dashboard. Consultez [Activation du compte et KYC](https://docs.wajub.com/fr/getting-started/account-activation) pour les documents requis et les délais d'examen. 2. Créez des clés de production. Les clés sandbox ne peuvent pas être promues, ce sont des objets distincts. 3. Faites pointer vos endpoints de webhook vers leurs URLs de production et copiez le nouveau secret de signature : il diffère selon l'environnement. 4. Testez à nouveau les fonctionnalités marquées « Live uniquement » dans le tableau ci-dessus. C'est la première fois que votre code s'exécute avec elles. 5. Suivez le guide [Passer en live](https://docs.wajub.com/fr/getting-started/going-live) pour la checklist complète. --- # Passer en live URL: https://docs.wajub.com/fr/getting-started/going-live > La checklist à dérouler avant de changer de clés, et ce qui change en production. Passer en production tient en une ligne de configuration. Tout ce qui rend ce passage sûr se fait avant de modifier cette ligne, et c'est l'objet de cette page : une checklist que vous pouvez vraiment cocher, puis la liste de ce qui se comporte différemment en production et qui n'a pas pu être testé dans la sandbox. ## Avant tout, faites vérifier votre compte La production s'ouvre quand votre dossier de conformité est approuvé, et pas une minute plus tôt. D'ici là, votre équipe reste en sandbox : le Dashboard refuse de passer en live et `wajub login` refuse un profil live, si bien qu'aucune clé live ne peut être créée. [Activation du compte et KYC](https://docs.wajub.com/fr/getting-started/account-activation) détaille le dossier et l'examen. Soumettez-le tôt. L'examen prend jusqu'à 48 heures, et votre intégration sandbox continue de fonctionner pendant ce temps. L'ordre logique est donc de déposer le dossier d'abord, puis de dérouler le reste de cette page pendant qu'il est examiné. ## Puis activez un moyen d'encaissement L'approbation du dossier ouvre la production, mais ne branche aucun moyen de paiement. Tant qu'aucun fournisseur n'est actif en production, la page de paiement n'en propose aucun et vos payeurs ne peuvent pas payer, même avec une intégration parfaite. Deux voies, depuis **Orchestration** dans le Dashboard, en Production : - [connecter votre propre fournisseur](https://docs.wajub.com/dashboard/orchestration/connect-provider), avec vos identifiants de production : il encaisse dès qu'il est connecté ; - [demander le rail Wajub](https://docs.wajub.com/dashboard/orchestration/rail), si vous n'avez pas de contrat à vous, pour encaisser sur ceux de Wajub. C'est une demande signée, que Wajub examine : faites-la dès que la production s'ouvre. Tant que rien n'est actif, l'accueil du Dashboard affiche **Activez vos moyens de paiement**. ## La checklist Cochez ces points dans votre propre environnement. Chaque élément se vérifie en exécutant du code, pas en faisant confiance. Votre progression est conservée dans ce navigateur : vous pouvez y revenir. ## Ce qui change une fois en live C'est la partie qu'une sandbox ne peut pas vous apprendre : lisez-la avant de basculer, pas après. **Cinq fonctionnalités ne vous ont jamais été accessibles.** Les liens de paiement, les factures, les taxes, Shield et les identifiants fiscaux des clients refusent tous les clés sandbox avec `403 This feature is only available in live mode.` Si votre intégration utilise l'une d'elles, ce code s'exécute pour la première fois en production. Prévoyez une répétition ciblée sur ces parcours précisément. **Votre limite de requêtes dépend de votre offre, pas de votre environnement.** Pay as you go autorise 120 requêtes par minute, Growth 360, Scale 720, et Enterprise n'a pas de plafond. Sur une offre sans plafond, les en-têtes `X-RateLimit-*` sont totalement absents : tout code qui les lit doit traiter leur absence comme normale, et non comme un zéro. **Le secret de signature des webhooks est différent.** Il appartient à un endpoint, et un endpoint appartient à un seul environnement. Enregistrer la même URL en production vous donne une nouvelle valeur `whsec_`. Recopier celle de la sandbox est la raison la plus fréquente pour laquelle un premier webhook live échoue à la vérification de signature. **Les identifiants perdent leur segment `test_`.** Un paiement sandbox est `trx_test_…` et son équivalent en production est `trx_…`. Rien dans votre code ne doit dépendre de ce segment, et tout ce qui reconnaît des identifiants par motif doit être vérifié une fois avant de basculer. **L'argent peut vraiment manquer.** Un payout échoue sur un solde insuffisant, un portefeuille a son propre plafond journalier inférieur au vôtre, et un client peut tout simplement ne pas confirmer. Rien de tout cela n'arrive dans une sandbox, où le résultat dépend du numéro de test que vous avez composé. ## Faire la bascule Faites ces quatre étapes dans un seul déploiement plutôt que sur tout un après-midi. Une intégration à moitié basculée envoie des paiements live vers un webhook sandbox, et vous ne le remarquerez qu'au rapprochement. 1. Enregistrez vos endpoints de webhook de production et copiez chaque nouveau secret de signature. 2. Placez la clé de production et ces secrets dans votre environnement de production. 3. Déployez. Le SDK ne demande aucun autre changement, la clé seule détermine l'environnement. 4. Vérifiez dans Konsole que votre première requête de production a bien été authentifiée en live. > [!CAUTION] > **Ne mélangez jamais un environnement avec l'autre** > > Un identifiant sandbox n'existe pas en production, et l'inverse est tout aussi vrai. Gardez les deux > jeux de variables entièrement séparés, et ne laissez jamais un repli de votre configuration se > rabattre discrètement sur la clé de test quand la clé live manque. Dans ce cas, échouer bruyamment > est le bon comportement. ## Votre premier vrai paiement Payez-vous vous-même. Prenez le plus petit montant accepté par votre opérateur, en général 100 XAF, et déroulez tout le parcours avec votre propre téléphone. Quatre conditions doivent être réunies avant d'ouvrir les portes. La transaction atteint `succeeded`. Votre endpoint de production a reçu `payment.succeeded` et la signature a été vérifiée. Le montant apparaît dans votre solde. Et votre propre base de données a enregistré la commande comme payée, par le même chemin de code que celui qu'un client déclencherait. Ensuite, remboursez-le. Le remboursement est le seul parcours que personne ne teste avant d'en avoir besoin, et le jour où l'on en a besoin n'est jamais un jour calme. ## En cas de problème Revenir en arrière consiste à redéployer votre clé sandbox. Aucune donnée n'est perdue et rien n'est à annuler côté Wajub, car les deux environnements n'ont jamais rien partagé. Les paiements déjà encaissés restent où ils sont, et vous pouvez tous les inspecter dans Konsole pendant que vous réparez ce qui a cassé. - [Activation du compte et KYC](https://docs.wajub.com/fr/getting-started/account-activation): Le dossier qui ouvre la production. - [Vérifier les signatures de webhook](https://docs.wajub.com/fr/developer-tools/webhooks/signature-verification): Le contrôle qui doit réussir dès la première livraison live. - [Bonnes pratiques de sécurité](https://docs.wajub.com/fr/best-practices/security): Stocker, restreindre et renouveler vos clés et secrets. - [Supervision et observabilité](https://docs.wajub.com/fr/resources/monitoring): Ce qu'il faut surveiller une fois que de l'argent réel circule. --- # Introduction URL: https://docs.wajub.com/fr/getting-started > L'orchestrateur de paiement qui réunit Mobile Money, cartes et virements derrière une seule API. Wajub est une **plateforme d'orchestration de paiement** pensée pour l'Afrique. Au lieu d'intégrer séparément chaque opérateur Mobile Money, chaque banque ou chaque agrégateur, vous intégrez **une seule API** et un seul jeu de webhooks. > [!NOTE] > **Vous découvrez les paiements en Afrique ?** > > Des termes comme Mobile Money, USSD, MTN MoMo, Orange Money, canal ou règlement vous sont peut-être > inconnus. Lisez d'abord le [Glossaire](https://docs.wajub.com/fr/resources/glossary). Il définit chaque terme en langage simple, > avant que vous n'écriviez la moindre ligne de code. ## Avant de commencer Pour suivre les exemples de ce site, il vous faut trois choses. 1. **Un compte Wajub.** Créez-en un gratuitement sur [dashboard.wajub.com](https://dashboard.wajub.com). 2. **Une API key.** Une fois connecté, ouvrez **Paramètres → Développeurs → Clés API** et créez-en une. 3. **Un client HTTP**, curl, ou un SDK serveur (Node.js, Python, PHP, Go, Ruby, Java, C#). Un nouveau compte ne possède aucune clé. Vous créez celles dont vous avez besoin, une par une, dans l'environnement affiché par le Dashboard. Les clés de production ne peuvent être créées qu'une fois votre compte vérifié. | Clé | Environnement | Où l'utiliser | | ----------- | ------------- | ------------------------------------------------------------------------------- | | `pk_test.…` | Sandbox | Publique. Sans risque dans un navigateur, initialise les paiements côté client. | | `sk_test.…` | Sandbox | Privée. Côté serveur uniquement, aucun argent réel ne circule. | | `rk_test.…` | Sandbox | Restreinte. Côté serveur uniquement, limitée aux scopes que vous lui accordez. | | `pk.…` | Production | Publique. Même rôle côté client, sur des fonds réels. | | `sk.…` | Production | Privée. Côté serveur uniquement, déplace de l'argent réel. | | `rk.…` | Production | Restreinte. Côté serveur uniquement, sur des fonds réels. | Consultez [Configurer votre compte](https://docs.wajub.com/fr/getting-started/dashboard-setup) pour une visite guidée du Dashboard, étape par étape. ## Ce que vous pouvez construire - **Encaissez** des paiements par Mobile Money (MTN MoMo, Orange Money, Wave, Airtel), carte et virement bancaire. - **Versez** des fonds sur des portefeuilles Mobile Money via l'[API des transferts](https://docs.wajub.com/fr/payouts/transfers) ou gérez vos [bénéficiaires](https://docs.wajub.com/fr/api/beneficiaries). - **Intégrez le checkout** directement dans votre application avec [Wajub Components](https://docs.wajub.com/fr/libraries/components), en React, Vue, Svelte, Angular ou JS natif. - **Orchestrez** intelligemment vos prestataires grâce au routage et au repli ([Orchestration](https://docs.wajub.com/fr/orchestration)). ## Comment fonctionne l'API L'API Wajub suit les principes REST. Elle utilise des URLs prévisibles, accepte des corps de requête encodés en JSON, renvoie des réponses JSON et s'appuie sur les codes HTTP standard. Toutes les requêtes passent par une seule URL de base : ```bash title="URL de base" https://api.wajub.com ``` ## Votre premier appel Un paiement commence par une requête. Vous envoyez le montant, la devise, la personne qui paie et la page vers laquelle la renvoyer une fois qu'elle a terminé. Wajub crée le paiement, le garde en `pending` et répond avec une page hébergée où le client choisit son opérateur et confirme. Personne n'est débité à ce stade. Décrivez le payeur dans l'objet `customer` : il porte `email`, `name`, `phone`, `address` et `metadata`. Le `callback` est l'adresse où Wajub renvoie le client une fois qu'il a terminé sur la page de paiement. Lancez cet appel depuis votre serveur ou votre terminal avec votre **clé privée sandbox** (`sk_test.…`). Ne mettez jamais cette clé dans un navigateur ou une application mobile. Wajub fournit aussi une clé publique (`pk_test.…`), destinée à créer un paiement depuis le navigateur. Consultez [Concepts clés → API keys](https://docs.wajub.com/fr/getting-started/concepts#api-keys) pour le détail complet. `POST /payments` **Créer un paiement** ```bash curl https://api.wajub.com/payments \ -H "Authorization: sk_test.xxxxxxxxxxxxxxxx…" \ -H "Content-Type: application/json" \ -d '{ "amount": 25000, "currency": "XAF", "customer": { "email": "amina@example.com" }, "description": "Order #4172", "callback": "https://shop.example.com/order/complete" }' ``` ```javascript import { Wajub } from '@wajub/node'; const wajub = new Wajub({ apiKey: process.env.WAJUB_API_KEY }); const payment = await wajub.payments.create({ amount: 25000, currency: 'XAF', customer: { email: 'amina@example.com' }, description: 'Order #4172', callback: 'https://shop.example.com/order/complete', }); console.log('Payment page:', payment.authorization_url); ``` ```python import os from wajub import Wajub wajub = Wajub(api_key=os.environ["WAJUB_API_KEY"]) payment = wajub.payments.create({ "amount": 25000, "currency": "XAF", "customer": {"email": "amina@example.com"}, "description": "Order #4172", "callback": "https://shop.example.com/order/complete", }) print(payment.authorization_url) ``` ```php getenv('WAJUB_API_KEY')]); $payment = $wajub->payments->create([ 'amount' => 25000, 'currency' => 'XAF', 'customer' => [ 'email' => 'amina@example.com', ], 'description' => 'Order #4172', 'callback' => 'https://shop.example.com/order/complete', ]); echo $payment->authorization_url; ``` ```go client, err := wajub.New(wajub.Config{APIKey: os.Getenv("WAJUB_API_KEY")}) if err != nil { log.Fatal(err) } payment, err := client.Payments.Create(context.Background(), map[string]any{ "amount": 25000, "currency": "XAF", "customer": map[string]any{"email": "amina@example.com"}, "description": "Order #4172", "callback": "https://shop.example.com/order/complete", }, nil) if err != nil { log.Fatal(err) } log.Println(payment.AuthorizationURL) ``` Wajub répond `201 Created`. Le paiement existe désormais sur votre compte, il porte un id que vous utiliserez partout ailleurs, et il contient les deux valeurs qui pilotent le reste de votre intégration : ```json title="Réponse · 201 Created" { "code": 201, "status": "Created", "message": "Payment initiated", "authorization_url": "https://pay.wajub.com/xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx", "authorization_token": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx", "transaction": { "id": "trx_test_CSUGajfv9xh0XQ5wu2lx", "amount": 25000, "amount_paid": 0, "currency": "XAF", "status": "pending", "description": "Order #4172", "customer": { "id": "cus_test_sAaim5apjocIgtlhzJY3wQ8s", "email": "amina@example.com" }, "callback": "https://shop.example.com/order/complete", "sandbox": true, "created_at": "2026-09-11T10:24:00+00:00" } } ``` Trois champs de cette réponse comptent dès maintenant : - **`authorization_url`** est la page de paiement hébergée de ce paiement, et de rien d'autre. Redirigez votre client vers elle. C'est la façon la plus simple d'intégrer Wajub, et celle que nous recommandons. - **`authorization_token`** est le jeton de session contenu dans cette URL. Il ne vaut que pour ce paiement et peut être transmis sans risque à un navigateur : c'est ce qu'utilisent les [Components](https://docs.wajub.com/fr/libraries/components) quand vous préférez garder le client sur votre propre page. - **`transaction.status`** démarre à `pending`. Il ne passe à `succeeded` qu'une fois que le client a confirmé sur son téléphone, ce qui arrive bien après le retour de cet appel. > [!WARNING] > **Les montants sont en unité principale, jamais en centimes** > > `"amount": 25000` signifie 25 000 XAF, pas 250 XAF. Contrairement à la plupart des prestataires de > paiement, Wajub n'utilise jamais de sous-unités. Envoyez `500` pour 500 NGN et `10.50` pour 10,50 USD. > Consultez [Concepts clés → Montants](https://docs.wajub.com/fr/getting-started/concepts#amounts). ### « Paiement » ou « transaction » Vous venez de voir les deux mots dans la même réponse, et ils désignent **le même objet**. « Paiement » est le concept métier, d'où l'endpoint `POST /payments`. « Transaction » est ce que l'API sérialise, d'où une réponse qui l'imbrique sous `"transaction"` et préfixe l'`id` par `trx_`. Les deux termes sont interchangeables dans toute cette documentation. L'explication complète se trouve dans [Concepts clés](https://docs.wajub.com/fr/getting-started/concepts#payment-vs-transaction). ### Ce qui se passe ensuite En ouvrant `authorization_url` dans votre navigateur, vous arrivez sur la page de paiement, où des numéros de téléphone sandbox permettent de simuler un succès, un refus ou un délai dépassé. Votre serveur confirme ensuite le résultat avec `GET /payments/{id}` avant de livrer quoi que ce soit, car le seul retour du navigateur peut être falsifié, ou ne jamais se produire. Le [Démarrage rapide](https://docs.wajub.com/fr/getting-started/quickstart) détaille ces deux étapes avec les numéros de test. > [!TIP] > **Déboguez en temps réel avec Konsole** > > Inspectez chaque requête API, rejouez vos webhooks et observez les décisions d'orchestration en direct > avec [Konsole →](https://docs.wajub.com/fr/developer-tools/konsole). C'est le moyen le plus rapide de comprendre ce qui se passe > pendant une intégration. ## Et maintenant ? ### Pour débuter - [Démarrage rapide](https://docs.wajub.com/fr/getting-started/quickstart) : traitez un premier paiement en 5 minutes. - [Démarrage rapide des SDKs](https://docs.wajub.com/fr/libraries/sdks/quickstart) : installez le SDK de votre langage (Node.js, Python, PHP, Go). - [Concepts clés](https://docs.wajub.com/fr/getting-started/concepts) : cycle de vie d'un paiement, sandbox ou live, jetons de session. - [Environnements et API keys](https://docs.wajub.com/fr/getting-started/environments) : test ou production. ### Prêt à intégrer - [Guides et tutoriels](https://docs.wajub.com/fr/guides) : des intégrations pas à pas pour chaque cas d'usage. - [Moyens de paiement et canaux](https://docs.wajub.com/fr/payments/payment-methods) : couverture complète pays × opérateur. - [Référence API](https://docs.wajub.com/fr/api) : chaque endpoint, avec des exemples de requête et de réponse. ### Pour aller plus loin - [Bonnes pratiques](https://docs.wajub.com/fr/best-practices) : idempotence, gestion des erreurs, sécurité. - [Passer en live](https://docs.wajub.com/fr/getting-started/going-live) : checklist de production et KYC. - [Tous les SDKs et bibliothèques](https://docs.wajub.com/fr/libraries/sdks) : Node.js, Python, PHP, Go, SDKs mobiles et navigateur. --- # Démarrage rapide URL: https://docs.wajub.com/fr/getting-started/quickstart > Votre premier paiement de bout en bout, de l'API key au webhook vérifié, en cinq minutes environ. Ce guide vous emmène d'un compte vide à un paiement vérifié, avec un webhook qui fonctionne. Il vous faut un compte Wajub (gratuit) et quelques minutes. ## 1. Créez votre compte et récupérez vos clés Créez un compte sur le [Dashboard](https://dashboard.wajub.com). Un nouveau compte ne possède aucune clé : une fois connecté, ouvrez **Paramètres → Développeurs → Clés API** et créez une clé **privée** pendant que le Dashboard affiche la sandbox. Elle commence par `sk_test.…`. | Clé | Environnement | Où l'utiliser | | ----------- | ------------- | ------------------------------------------------------------------------------- | | `pk_test.…` | Sandbox | Publique. Sans risque dans un navigateur, initialise les paiements côté client. | | `sk_test.…` | Sandbox | Privée. Côté serveur uniquement, aucun argent réel ne circule. | | `pk.…` | Production | Publique. Même rôle côté client, sur des fonds réels. | | `sk.…` | Production | Privée. Côté serveur uniquement, déplace de l'argent réel. | Les clés de production ne deviennent disponibles qu'une fois votre compte vérifié, et les clés restreintes `rk` sont présentées dans [Environnements et API keys](https://docs.wajub.com/fr/getting-started/environments). Tout ce guide s'exécute sur votre serveur, il utilise donc partout la clé privée sandbox. La clé publique existe pour le seul cas où du code s'exécute dans un navigateur : initialiser un paiement depuis la page elle-même. N'utilisez jamais une clé privée depuis un navigateur : lorsque Wajub en détecte une, il refuse la requête et vous prévient par e-mail, pour qu'une clé divulguée ne passe pas inaperçue. ## 2. Installez le SDK de votre langage Les SDKs enveloppent l'API HTTP avec des ressources typées et la vérification de signature des webhooks. Si vous préférez appeler l'API directement, chaque exemple ci-dessous a un onglet cURL. **Installation** ```javascript npm install @wajub/node ``` ```python pip install "wajub>=1.2.1" ``` ```php composer require wajub/wajub-php ``` ```go go get github.com/wajubhq/wajub-go ``` Ruby, Java, C#, Kotlin, Flutter, React Native et Swift ont leurs propres SDKs et leurs propres guides. Consultez [SDKs](https://docs.wajub.com/fr/libraries/sdks) pour la liste complète et la référence de configuration. ## 3. Créez un paiement Un paiement commence par une requête. Vous envoyez le montant, la devise, la personne qui paie et la page vers laquelle la renvoyer. Wajub crée le paiement, le garde en `pending` et répond avec une page hébergée où le client choisit son opérateur et confirme. Personne n'est encore débité. Décrivez le payeur dans l'objet `customer` : il porte `email`, `name`, `phone`, `address` et `metadata`. `POST /payments` **Créer un paiement** ```bash curl https://api.wajub.com/payments \ -H "Authorization: sk_test.xxxxxxxxxxxxxxxx…" \ -H "Content-Type: application/json" \ -d '{ "amount": 5000, "currency": "XAF", "customer": { "email": "amina@example.com" }, "callback": "https://shop.example.com/order/complete" }' ``` ```javascript import { Wajub } from '@wajub/node'; const wajub = new Wajub({ apiKey: process.env.WAJUB_API_KEY }); const payment = await wajub.payments.create({ amount: 5000, currency: 'XAF', customer: { email: 'amina@example.com' }, callback: 'https://shop.example.com/order/complete', }); console.log('Payment page:', payment.authorization_url); ``` ```python import os from wajub import Wajub wajub = Wajub(api_key=os.environ["WAJUB_API_KEY"]) payment = wajub.payments.create({ "amount": 5000, "currency": "XAF", "customer": {"email": "amina@example.com"}, "callback": "https://shop.example.com/order/complete", }) print(payment.authorization_url) ``` ```php getenv('WAJUB_API_KEY')]); $payment = $wajub->payments->create([ 'amount' => 5000, 'currency' => 'XAF', 'customer' => [ 'email' => 'amina@example.com', ], 'callback' => 'https://shop.example.com/order/complete', ]); echo $payment->authorization_url; ``` ```go client, err := wajub.New(wajub.Config{APIKey: os.Getenv("WAJUB_API_KEY")}) if err != nil { log.Fatal(err) } payment, err := client.Payments.Create(context.Background(), map[string]any{ "amount": 5000, "currency": "XAF", "customer": map[string]any{"email": "amina@example.com"}, "callback": "https://shop.example.com/order/complete", }, nil) if err != nil { log.Fatal(err) } log.Println(payment.AuthorizationURL) ``` Wajub répond `201 Created` avec le paiement, son id et la page vers laquelle envoyer le client : ```json title="Réponse · 201 Created" { "code": 201, "status": "Created", "message": "Payment initiated", "authorization_url": "https://pay.wajub.com/xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx", "authorization_token": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx", "transaction": { "id": "trx_test_CSUGajfv9xh0XQ5wu2lx", "amount": 5000, "amount_paid": 0, "currency": "XAF", "status": "pending", "customer": { "id": "cus_test_sAaim5apjocIgtlhzJY3wQ8s", "email": "amina@example.com" }, "callback": "https://shop.example.com/order/complete", "sandbox": true, "created_at": "2026-09-11T10:24:00+00:00" } } ``` Enregistrez `transaction.id` avec votre commande, puis redirigez le client vers `authorization_url`. > [!NOTE] > **Les montants sont en unité principale, jamais en centimes** > > `"amount": 5000` signifie 5 000 XAF, pas 50 XAF. Wajub n'utilise jamais de sous-unités. Envoyez `500` > pour 500 NGN et `10.50` pour 10,50 USD. Consultez [Concepts clés → Montants](https://docs.wajub.com/fr/getting-started/concepts#amounts). ## 4. Payez avec un numéro sandbox Ouvrez `authorization_url` dans votre navigateur. En mode test, la page de paiement accepte de faux numéros Mobile Money dont les **6 derniers chiffres** décident du résultat. Les mêmes suffixes fonctionnent pour tous les opérateurs et tous les pays : | Suffixe | Résultat | | -------- | ------------------------------------------------------ | | `000000` | Paiement réussi | | `000001` | Fonds insuffisants | | `000002` | Échec, refusé par l'opérateur | | `000003` | Délai dépassé | | `000004` | En attente → annulé | | `000009` | Le paiement réussit, un remboursement ultérieur échoue | Choisissez un numéro pour l'opérateur que vous voulez tester : La page de paiement sandbox ne demande aucun code PIN : le numéro de test décide seul du résultat. > [!WARNING] > **La sandbox propose des moyens de paiement que la production n'a pas forcément** > > La page de paiement sandbox propose toujours une carte de test, pour que vous puissiez tester ce > parcours de code. **La page de paiement live ne propose que les canaux couverts par vos prestataires > actifs.** Une carte n'y apparaît qu'une fois un prestataire qui accepte les cartes activé sur votre > compte. Développez et testez d'abord avec Mobile Money. ## 5. Vérifiez le paiement côté serveur Le client revient sur votre URL de `callback`, et ce retour ne prouve rien. N'importe qui peut ouvrir cette URL à la main, et un client qui ferme l'onglet ne l'ouvre jamais. Avant de livrer une commande, demandez à l'API ce qui s'est réellement passé, depuis votre serveur, avec l'id enregistré à l'étape 3. `GET /payments/{id}` **Récupérer un paiement** ```bash curl https://api.wajub.com/payments/trx_test_CSUGajfv9xh0XQ5wu2lx \ -H "Authorization: sk_test.xxxxxxxxxxxxxxxx…" ``` ```javascript const payment = await wajub.payments.retrieve('trx_test_CSUGajfv9xh0XQ5wu2lx'); console.log(payment.status, payment.amount, payment.currency); ``` ```python payment = wajub.payments.retrieve("trx_test_CSUGajfv9xh0XQ5wu2lx") print(payment.status, payment.amount, payment.currency) ``` ```php $payment = $wajub->payments->retrieve('trx_test_CSUGajfv9xh0XQ5wu2lx'); echo $payment->status; ``` ```go payment, err := client.Payments.Retrieve(context.Background(), "trx_test_CSUGajfv9xh0XQ5wu2lx") if err != nil { log.Fatal(err) } log.Println(payment.Status, payment.Amount, payment.Currency) ``` La réponse contient le paiement tel que Wajub le connaît, quoi qu'ait affiché votre navigateur : ```json title="Réponse · 200 OK" { "code": 200, "status": "OK", "message": "Payment retrieved", "transaction": { "id": "trx_test_CSUGajfv9xh0XQ5wu2lx", "amount": 5000, "amount_paid": 5000, "currency": "XAF", "status": "succeeded", "channel": "cm.mtn", "customer": { "id": "cus_test_sAaim5apjocIgtlhzJY3wQ8s", "email": "amina@example.com" }, "sandbox": true, "created_at": "2026-09-11T10:24:00+00:00" } } ``` Ne livrez la commande que lorsque `status` vaut `succeeded`, et seulement après avoir vérifié que `amount` et `currency` correspondent à ce que vous avez facturé. Un paiement encore en `pending` n'est pas un échec : c'est un client qui n'a pas encore terminé. Laissez donc la commande ouverte, et laissez le webhook de l'étape 6 vous prévenir quand le paiement aboutit. > [!TIP] > **Suivez la transaction dans Konsole** > > Ouvrez [Konsole → Journaux API](https://docs.wajub.com/fr/developer-tools/konsole/log-explorer) pour voir la requête et la réponse > exactes enregistrées par Wajub. Une fois en live, le [Journal de routage](https://docs.wajub.com/fr/developer-tools/konsole/routing-log) > montre quel prestataire a été choisi, et pourquoi. Il n'existe pas en sandbox. ## 6. Configurez un endpoint de webhook Interroger l'API après chaque redirection ne couvre que les clients qui reviennent. Les webhooks couvrent le reste : un paiement confirmé dix minutes plus tard côté opérateur, un remboursement émis depuis le Dashboard, un litige ouvert par le client. Configurez-en un maintenant, avant de construire quoi que ce soit par-dessus. ### Enregistrez l'endpoint Dans **Konsole → Webhooks → Points de terminaison** : 1. Cliquez sur **Ajouter un endpoint**. 2. Saisissez votre URL publique, par exemple `https://yourapp.com/webhooks/wajub`. 3. Sélectionnez les événements à recevoir. Commencez par tous les événements de paiement, avec **Tout sélectionner** à côté d'eux. Un abonnement ne reconnaît que des noms exacts : saisir `payment.*` ne recevrait rien. 4. Enregistrez, puis copiez le **Secret de signature** (`whsec_…`) dans votre environnement sous le nom `WAJUB_WEBHOOK_SECRET`. ### Donnez le secret de signature au SDK Le client que vous avez créé à l'étape 3 vérifie aussi les webhooks, dès qu'il connaît le secret de signature. Ajoutez-le au même constructeur, à côté de votre API key : **Configurer le client** ```javascript import { Wajub } from '@wajub/node'; export const wajub = new Wajub({ apiKey: process.env.WAJUB_API_KEY, webhookSecret: process.env.WAJUB_WEBHOOK_SECRET, }); ``` ```python import os from wajub import Wajub wajub = Wajub( api_key=os.environ["WAJUB_API_KEY"], webhook_secret=os.environ["WAJUB_WEBHOOK_SECRET"], ) ``` ```php getenv('WAJUB_API_KEY'), 'webhook_secret' => getenv('WAJUB_WEBHOOK_SECRET'), ]); ``` ```go client, err := wajub.New(wajub.Config{ APIKey: os.Getenv("WAJUB_API_KEY"), WebhookSecret: os.Getenv("WAJUB_WEBHOOK_SECRET"), }) ``` ### Écrivez l'endpoint Quatre règles rendent un endpoint de webhook correct, et le SDK ne gère que la première à votre place. **Vérifiez la signature, dans tous les environnements.** Un endpoint qui saute la vérification accepte tout ce que n'importe qui lui envoie, y compris un faux `payment.succeeded`. `constructEvent` vérifie la signature avant d'analyser le JSON. Il lui faut le corps **brut** : désactivez donc l'analyse du corps JSON sur cette route. **Accusez réception avant de travailler.** Wajub attend votre `2xx` pendant 30 secondes. Au-delà, la livraison compte comme échouée et fait l'objet d'une nouvelle tentative : répondez d'abord, et faites le travail lent ensuite, dans une file d'attente ou une goroutine. **Dédupliquez sur l'id de l'événement.** Une livraison échouée est retentée pendant 72 heures au plus, et chaque tentative porte le même `id` d'événement. C'est cet id qui empêche une nouvelle tentative de livrer deux fois la même commande. **Traitez ensuite l'événement.** Le type se trouve dans `event.event`, et `event.data` contient l'objet concerné par l'événement, avec la même forme que celle renvoyée par l'API. Pour `payment.succeeded`, `event.data.id` est l'id du paiement enregistré à l'étape 3. **Endpoint de webhook** ```javascript app.post('/webhooks/wajub', express.raw({ type: '*/*' }), async (req, res) => { const event = wajub.webhooks.constructEvent( req.body, req.headers['x-wajub-signature'], req.headers['x-wajub-timestamp'], ); res.sendStatus(200); if (await alreadyHandled(event.id)) return; await markHandled(event.id); if (event.event === 'payment.succeeded') { await fulfillOrder(event.data.id); } }); ``` ```python @app.post("/webhooks/wajub") def wajub_webhook(): event = wajub.webhooks.construct_event( request.get_data(as_text=True), request.headers["X-Wajub-Signature"], request.headers["X-Wajub-Timestamp"], ) if already_handled(event["id"]): return "", 200 mark_handled(event["id"]) queue.enqueue(handle_event, event) return "", 200 ``` ```php Route::post('/webhooks/wajub', function (Request $request) use ($wajub) { $event = $wajub->webhooks->constructEvent( $request->getContent(), $request->header('X-Wajub-Signature'), $request->header('X-Wajub-Timestamp'), ); if (AlreadyHandled::check($event['id'])) { return response()->noContent(); } AlreadyHandled::mark($event['id']); HandleWajubEvent::dispatch($event); return response()->noContent(); }); ``` ```go http.HandleFunc("/webhooks/wajub", func(w http.ResponseWriter, r *http.Request) { body, err := io.ReadAll(r.Body) if err != nil { w.WriteHeader(http.StatusBadRequest) return } event, err := client.Webhooks.ConstructEvent( body, r.Header.Get("X-Wajub-Signature"), r.Header.Get("X-Wajub-Timestamp"), 0, ) if err != nil { w.WriteHeader(http.StatusBadRequest) return } w.WriteHeader(http.StatusOK) id, _ := event["id"].(string) go handleEvent(id, event) }) ``` ### Recevez les événements sur votre machine Pas besoin d'URL publique, de déploiement ni d'endpoint enregistré pour commencer. La CLI transmet chaque événement sandbox à une adresse locale : ```bash npm install -g @wajub/cli wajub listen --forward-to http://localhost:3000/webhooks/wajub ``` Rien sur votre machine n'est exposé à Internet. `wajub listen` affiche le secret de signature des événements transférés : c'est ce secret que doit contenir votre `WAJUB_WEBHOOK_SECRET` local pendant que vous développez. Il reste le même d'une exécution à l'autre : placez-le une seule fois (`wajub listen --print-secret` l'affiche seul). Ce n'est pas le secret d'un endpoint enregistré : chaque endpoint garde le sien. Consultez la [commande CLI listen](https://docs.wajub.com/fr/developer-tools/cli/listen) pour toutes les options. > [!NOTE] > **Guide complet des webhooks** > > Vérification de signature, politique de nouvelles tentatives, catalogue d'événements et idempotence : > tout est traité dans la [section Webhooks](https://docs.wajub.com/fr/developer-tools/webhooks). ## Et maintenant ? - [Concepts clés](https://docs.wajub.com/fr/getting-started/concepts): Cycle de vie d'un paiement, sandbox ou live, jetons de session, orchestration. - [Webhooks](https://docs.wajub.com/fr/developer-tools/webhooks): Vérification de signature, catalogue d'événements, politique de nouvelles tentatives. - [Encaisser un paiement, guide complet](https://docs.wajub.com/fr/guides/accept-a-payment): Initialiser, rediriger, vérifier et livrer, de bout en bout. - [Passer en live](https://docs.wajub.com/fr/getting-started/going-live): La checklist complète avant de passer en production. - [Bonnes pratiques](https://docs.wajub.com/fr/best-practices): Idempotence, gestion des erreurs et sécurité pour la production. - [Référence API](https://docs.wajub.com/fr/api): Chaque endpoint, avec des exemples de requête et de réponse. --- # Solutions par activité URL: https://docs.wajub.com/fr/getting-started/solutions > Choisissez le parcours d'intégration adapté à votre activité, avec le plan et l'environnement dont il a besoin. L'API est la même pour tout le monde ; ce qui change d'une activité à l'autre, ce sont les produits que vous assemblez et leur ordre. Chaque parcours ci-dessous liste ses produits dans l'ordre de construction, avec le plan à partir duquel il est disponible et si vous pouvez le construire en sandbox ou uniquement en production. ## Quel est votre parcours Répondez à une seule question : où finit l'argent ? | Si | Votre parcours | | ------------------------------------------------------------ | ------------------------------------------------------------- | | Vous vendez vos propres produits et c'est vous qui êtes payé | [E-commerce](#e-commerce-and-online-sales) | | D'autres vendeurs sont payés par votre intermédiaire | [Marketplace](#marketplace-and-platform) | | Vous envoyez de l'argent plus souvent que vous n'en recevez | [Payouts en masse](#mass-payouts-and-gig-economy) | | Le même client vous paie à nouveau à chaque cycle | [Facturation récurrente](#subscription-and-recurring-billing) | Les parcours se recoupent, et c'est normal. Une marketplace vend et rembourse aussi : elle suit donc d'abord le parcours e-commerce et ajoute les sous-comptes par-dessus. ## Le socle de tous les parcours Les paiements, la page de checkout hébergée, les remboursements, les clients, les webhooks et les événements forment le cœur. Aucun plan ne les restreint, et ils se comportent de la même façon en sandbox et en production. Quoi que vous construisiez, c'est la base sur laquelle vous vous appuyez, et c'est ce qu'il faut faire fonctionner avant tout le reste. **Le socle** - [Encaisser un paiement](https://docs.wajub.com/fr/payments/hosted-checkout): Créez-le, redirigez vers la page hébergée ou intégrez la vôtre. - [Recevoir les webhooks](https://docs.wajub.com/fr/developer-tools/webhooks/quickstart): Le seul signal fiable qu'un paiement a réussi. ## E-commerce et vente en ligne Vous vendez des produits ou des services, et chaque client paie une fois. Avant d'écrire la moindre ligne de code, vérifiez sur quoi tourne déjà votre boutique. Si c'est WordPress, le plugin officiel couvre WooCommerce, GiveWP, Easy Digital Downloads, Tutor LMS, MemberPress et Gravity Forms, avec un shortcode `[wajub_pay]` pour tout le reste. Vous collez vos clés et c'est terminé, il n'y a aucune intégration à maintenir. Si vous construisez la boutique vous-même, trois étapes suffisent. Vous créez le paiement quand le panier est validé, vous envoyez le client vers l'`authorization_url` renvoyée, et vous livrez la commande quand le webhook `payment.succeeded` arrive. Ne livrez jamais sur la seule redirection : un client qui ferme l'onglet paie quand même. Les remboursements arrivent en dernier, et c'est voulu. Il vous faut des commandes avant d'avoir quoi que ce soit à rembourser, et l'endpoint de remboursement a besoin d'un identifiant de paiement que vous n'aurez qu'une fois la première étape fonctionnelle. Tout ceci fonctionne avec **Pay as you go**, en sandbox comme en production. Seule exception : les liens de paiement, disponibles uniquement en production et limités à 25 liens sur le plan gratuit, avant de devenir illimités avec Growth. **Votre parcours** - [Commencez ici si vous utilisez WordPress](https://docs.wajub.com/fr/libraries/plugins): WooCommerce, GiveWP, EDD, LMS, formulaires, sans aucun code d'API. - [1. Encaisser un paiement](https://docs.wajub.com/fr/payments/hosted-checkout): Page hébergée ou votre propre checkout. - [2. Livrer sur le webhook](https://docs.wajub.com/fr/developer-tools/webhooks/quickstart): Expédiez à l'arrivée de payment.succeeded, pas sur la redirection. - [3. Gérer les remboursements](https://docs.wajub.com/fr/payments/refunds): Retours, annulations, remboursements partiels. ## Marketplace et plateforme Vous mettez en relation des vendeurs et des acheteurs, et l'argent doit arriver au vendeur au lieu de s'arrêter chez vous. C'est le rôle de Sync. Chaque vendeur devient un sous-compte avec ses propres capacités, sa propre tarification et son propre historique de transactions. Vous agissez ensuite pour le compte d'un vendeur en ajoutant un en-tête à un appel que vous savez déjà faire, `X-Sync: acc_…`, sans deuxième API à apprendre. Inscrivez les vendeurs avant de faire passer le moindre paiement par eux, car un sous-compte doit être accepté et actif avant de pouvoir effectuer des transactions. Les payouts bouclent la boucle. Les bénéficiaires vous permettent d'enregistrer une fois le portefeuille d'un vendeur, au lieu de renvoyer le numéro et l'opérateur à chaque transfert. Sync est une fonctionnalité du plan **Scale** : les pages Sync du Dashboard, où vous créez et gérez vos connexions, s'ouvrent à partir de ce plan. Il fonctionne en sandbox, mais un sous-compte appartient à un seul environnement : appeler un sous-compte sandbox avec une clé de production, ou l'inverse, renvoie `404` `Sync account not found.`, la même réponse que pour un identifiant qui n'existe pas ou le sous-compte d'une autre plateforme. Les transferts et les bénéficiaires sont disponibles sur tous les plans. **Votre parcours** - [1. Encaisser les paiements](https://docs.wajub.com/fr/payments/hosted-checkout): Le même checkout que n'importe quelle boutique. - [2. Inscrire vos vendeurs](https://docs.wajub.com/fr/sync/quickstart): Créez des sous-comptes, définissez capacités et tarification. - [3. Payer les vendeurs](https://docs.wajub.com/fr/payouts/transfers): Transferts Mobile Money via l'API. - [4. Enregistrer les destinataires](https://docs.wajub.com/fr/api/beneficiaries): Enregistrez un portefeuille une fois, réutilisez-le à chaque payout. ## Payouts en masse et économie à la tâche Vous distribuez des fonds : salaires, gains de chauffeurs, commissions, primes. `POST /transfers/batch` accepte jusqu'à 500 payouts en un seul appel. Son en-tête `Idempotency-Key` est obligatoire et chaque ligne porte sa propre `reference` : un lot à moitié échoué se renvoie tel quel, et seules les lignes qui ne sont pas passées partent la deuxième fois. Chaque ligne passe les mêmes contrôles qu'un payout seul, et un destinataire refusé ne bloque pas les autres. Enregistrer d'abord vos destinataires comme bénéficiaires est ce qui raccourcit ce lot. Chaque ligne paie un identifiant `ben_…` au lieu de répéter le numéro de téléphone, l'opérateur et le pays, et une paie devient une liste d'identifiants que vous avez déjà. Surveillez le solde, pas la réponse de l'API. Un transfert est refusé quand le solde disponible est insuffisant : une série de payouts doit donc lire le solde avant de démarrer, au lieu de découvrir le problème au quarantième destinataire. Les transferts, les lots, les bénéficiaires et le solde sont disponibles sur tous les plans et fonctionnent en sandbox via l'API. Dans le Dashboard, le bouton qui crée un transfert à la main est réservé à la production. **Votre parcours** - [1. Envoyer un transfert](https://docs.wajub.com/fr/payouts/transfers): Un payout Mobile Money, un appel. - [2. Enregistrer vos destinataires](https://docs.wajub.com/fr/api/beneficiaries): Payez un bénéficiaire enregistré au lieu de répéter les coordonnées du portefeuille. - [3. Surveiller le solde](https://docs.wajub.com/fr/payouts/balance): Fonds disponibles, cycles de règlement, frais. - [4. Cadencer la boucle](https://docs.wajub.com/fr/api/rate-limits): Requêtes par minute autorisées sur votre plan. ## Abonnements et facturation récurrente Vous facturez le même client à chaque cycle. Sur Wajub, la facturation récurrente repose sur des factures, pas sur un mandat enregistré. Le Mobile Money ne permet pas de débiter un portefeuille plus tard sans que le client s'en aperçoive : chaque cycle produit donc une nouvelle facture avec son propre lien de paiement, et le client l'approuve. Vous créez la première facture avec `is_recurring` activé et une `recurring_frequency` parmi `daily`, `weekly`, `monthly`, `quarterly` ou `yearly`, et Wajub émet les suivantes selon le calendrier. Changer le montant ou le cycle revient à mettre à jour cette facture, et l'annuler arrête la facturation. Ce sont les relances qui font vraiment encaisser ce modèle. Comme chaque cycle demande une approbation humaine, une facture impayée le reste tant que personne n'est relancé : considérez le calendrier de relances comme une partie de l'intégration, pas comme un bonus. Il n'existe pas de ressource produits, prix ou coupons pour modéliser votre catalogue. Si vous avez besoin de plans par paliers, de prorata ou de facturation à l'usage, vous construisez cette logique de votre côté au-dessus de l'API Payments, et le guide de facturation récurrente vous accompagne. La facturation est disponible sur tous les plans, limitée à 10 factures avec Pay as you go et illimitée à partir de Growth. La génération récurrente elle-même nécessite **Growth** ou plus, et elle échoue sans bruit si vous repassez en dessous : la facture parente est conservée, mais aucun nouveau cycle n'est émis tant que le plan n'est pas rétabli. Les factures sont réservées à la production : construisez et testez d'abord la gestion des paiements et des webhooks en sandbox, puis changez de clé avant de toucher à la facturation. **Votre parcours** - [1. Émettre votre première facture](https://docs.wajub.com/fr/billing/invoice/quickstart): Lignes, taxes, date d'échéance, lien de paiement hébergé. - [2. La mettre sur un cycle](https://docs.wajub.com/fr/billing/invoice/recurring): is_recurring, fréquence, conditions de fin. - [3. Relancer les impayés](https://docs.wajub.com/fr/billing/invoice/reminders): Relances automatiques avant et après la date d'échéance. - [4. Construire des plans par-dessus](https://docs.wajub.com/fr/guides/subscription-billing): Paliers, prorata et facturation à l'usage, dans votre propre code. > [!TIP] > **Valable pour tous les parcours** > > Gardez [Konsole](https://docs.wajub.com/fr/developer-tools/konsole) ouvert pendant l'intégration : il affiche chaque > requête et chaque livraison de webhook en direct. Lisez les [Bonnes pratiques](https://docs.wajub.com/fr/best-practices) > avant de manipuler de l'argent réel, et déroulez la [checklist pour passer en > live](https://docs.wajub.com/fr/getting-started/going-live) avant de changer de clés. --- # Guide du tableau de bord URL: https://docs.wajub.com/fr/dashboard > Gérez votre activité depuis le tableau de bord Wajub, une tâche à la fois. Qui peut faire quoi, Test et Production, et le code de sécurité. Ce guide s'adresse aux personnes qui travaillent dans le tableau de bord [dashboard.wajub.com](https://dashboard.wajub.com) sans écrire de code : propriétaires, équipes finance, support et comptabilité. Chaque page décrit une tâche, étape par étape, avec ce que l'écran montre ensuite. Si vous connectez Wajub à votre site ou à votre application, commencez par les [Premiers pas](https://docs.wajub.com/fr/getting-started). Pour démarrer, [Recevoir un premier transfert](https://docs.wajub.com/dashboard/getting-started/first-payout) suit le chemin complet, de l'inscription au premier transfert vers votre compte. ## Comment se lit une page Avant les étapes, chaque page dit qui peut faire la tâche, le forfait qu'elle demande quand tous ne l'ont pas, si elle ne marche qu'en Production et si le tableau de bord demande un code de sécurité. Les règles ci-dessous valent partout : une page ne les répète que lorsqu'elle s'en écarte. ## Test et Production Le sélecteur en haut à droite du tableau de bord passe de **Test**, où les paiements sont simulés, à **Production**, où l'argent circule pour de vrai. Les deux ont des données séparées : un client ou un paiement créé en Test n'apparaît jamais en Production. [Environnements](https://docs.wajub.com/fr/getting-started/environments) explique ce que simule le mode test.  *Le sélecteur en haut à droite indique l'environnement où vous êtes.* Une nouvelle organisation reste en Test tant que Wajub n'a pas validé son [activation](https://docs.wajub.com/fr/getting-started/account-activation). Ensuite, le propriétaire, un Administrateur, un Développeur, ou un rôle personnalisé qui a **Gérer les paramètres** ou **Gérer les paramètres développeur** peut basculer. Un Utilisateur de test reste toujours en Test. Six modules n'existent qu'en Production et quittent le menu en Test : **Factures**, **Liens de paiement**, **Revenus**, **Taxe**, **Shield** et **Orchestration**. Leur raccourci clavier indique alors qu'ils sont disponibles uniquement en production. Certaines actions demandent aussi la Production : envoyer un transfert, modifier, archiver ou supprimer un bénéficiaire, fusionner deux clients, et tous les exports sauf ceux de Konsole et l'export de vos données personnelles. Dans **Paramètres**, les sections **Liens de paiement**, **Factures**, **Transferts** et **Fusions de clients** restent dans la liste en Test, marquées **Production uniquement**. ## Rôles Une organisation a un propriétaire, la personne qui l'a créée, et les membres qu'il invite. Le propriétaire peut tout faire, et lui seul peut fermer l'organisation, la céder à quelqu'un d'autre ou lire les conversations des membres avec l'assistant. Chaque membre a l'un des sept rôles. | Rôle | Ce qu'il couvre | | ----------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Administrateur** | Tout ce que peut faire le propriétaire, sauf les trois actions ci-dessus. | | **Développeur** | Clés API, webhooks et Konsole, réglages techniques, et le passage entre Test et Production. Lit les paiements, les clients, les factures et les paramètres, et gère les liens de paiement. | | **Finance** | Les paiements, sans remboursements ni litiges. Transferts et bénéficiaires, factures, liens de paiement, abonnements, rapports, revenus et taxe. Lit les clients. | | **Analyste** | Lit les paiements, les clients, les transferts, les factures, les liens de paiement, les abonnements, les rapports, les revenus et la taxe. Ne modifie rien, sauf pour ouvrir un ticket de support. | | **Spécialiste support** | Paiements, remboursements, litiges et clients. Lit les factures. | | **Observateur** | Lit ce que lit un Analyste, plus les paramètres. Ne modifie rien, sauf pour ouvrir un ticket de support. | | **Utilisateur de test** | Test uniquement : paiements de test, clés API et webhooks. Lit les clients. |  *Paramètres › Membres liste chaque membre avec son rôle.* Shield est ouvert au propriétaire, aux Administrateurs et aux rôles personnalisés qui l'incluent. Quand aucun des sept rôles ne convient, le propriétaire, un Administrateur ou un rôle personnalisé qui a **Gérer les membres** en crée un dans **Paramètres › Membres › Rôles personnalisés**. Un rôle personnalisé ne peut contenir que des permissions que son créateur possède. ## Le code de sécurité Les modifications sensibles vous demandent d'abord de prouver que c'est bien vous : rembourser un paiement, envoyer un transfert, supprimer un lien de paiement, créer une clé API, accepter un litige ou modifier un rôle personnalisé, entre autres. Le tableau de bord ouvre **Vérification de sécurité** et demande un **Code de vérification**. Vous le recevez par e-mail, par SMS si le SMS est votre méthode de double authentification et que votre numéro est enregistré, ou dans votre application d'authentification si vous en avez activé une. Une fois le code saisi, le tableau de bord ne le redemande pas pendant 30 minutes. Votre mot de passe ne le remplace jamais. ## Modules hors de votre forfait Quand votre forfait n'inclut pas un module, son entrée reste dans le menu, marquée **Pas dans votre forfait**. En l'ouvrant, vous voyez la page du module : ce qu'il apporte, puis les façons de l'obtenir, côte à côte — le module seul quand il se vend à l'unité, et chaque forfait qui l'inclut, avec son prix et ce qu'il ajoute au vôtre. --- # Voir votre activité URL: https://docs.wajub.com/fr/dashboard/account/activity-and-data > Relire les connexions et les changements de sécurité de votre compte utilisateur, et exporter les données personnelles que Wajub garde sur vous. **Votre activité** liste les connexions et les changements de sécurité de votre compte utilisateur. **Vos données**, sur votre profil, exporte ce que Wajub garde sur vous. Chaque membre voit sa propre activité et exporte ses propres données, quel que soit son [rôle](https://docs.wajub.com/fr/dashboard#roles), [en Test comme en Production](https://docs.wajub.com/fr/dashboard#sandbox-and-live), sans [code de sécurité](https://docs.wajub.com/fr/dashboard#the-security-code). ## Lire votre activité Ouvrez **Paramètres**, puis **Votre activité** dans le groupe **Personnel**. Chaque ligne donne une action et sa date : connexion, déconnexion, mot de passe changé ou réinitialisé, méthode de double authentification changée, clé d'accès ajoutée ou supprimée. **Date** choisit une période, sur 365 jours au plus, et **Action** garde une seule action.  *Seules les actions de votre compte utilisateur apparaissent ici.* Une connexion que vous ne reconnaissez pas : fermez la session et changez votre mot de passe, comme décrit dans [Sécuriser votre connexion](https://docs.wajub.com/dashboard/account/security#sessions). Ce que font les membres dans l'organisation figure dans le [journal d'audit](https://docs.wajub.com/dashboard/settings/audit-log). ## Exporter vos données Ouvrez **Profil** dans le groupe **Personnel**, puis, sous **Vos données**, **Exporter toutes mes données**. Le tableau de bord télécharge un fichier JSON avec votre profil (nom, e-mail, téléphone, langue), vos organisations et votre rôle dans chacune, vos sessions et les 500 dernières lignes de votre activité. --- # Supprimer votre compte URL: https://docs.wajub.com/fr/dashboard/account/delete > Supprimer votre compte utilisateur Wajub, ce qui ferme les organisations dont vous êtes propriétaire, et que faire si la suppression est refusée. Supprimer votre compte utilisateur retire votre accès à Wajub et ferme les organisations dont vous êtes propriétaire. C'est irréversible. Chaque membre peut supprimer son propre compte, quel que soit son [rôle](https://docs.wajub.com/fr/dashboard#roles), [en Test comme en Production](https://docs.wajub.com/fr/dashboard#sandbox-and-live). La suppression demande le [code de sécurité](https://docs.wajub.com/fr/dashboard#the-security-code). Avant de commencer, pour chaque organisation dont vous êtes propriétaire, retirez son solde par un [transfert](https://docs.wajub.com/dashboard/transfers/send) et attendez la fin des litiges, remboursements et transferts en cours, ou [cédez-la à un autre membre](https://docs.wajub.com/dashboard/settings/organizations#transfer-ownership). ## Les étapes 1. **Ouvrez votre profil** Ouvrez **Paramètres**, puis **Profil** dans le groupe **Personnel**. **Zone dangereuse** est en bas de la page. 2. **Lancez la suppression** **Supprimer le compte** ouvre **Supprimer votre compte ?**. La fenêtre nomme les organisations que vous possédez et qui seront fermées : leurs clés API cessent de marcher, leurs membres perdent l'accès, et leurs enregistrements sont conservés. Les organisations dont vous êtes seulement membre continuent sans vous. Si une organisation ne peut pas encore être fermée, la fenêtre la liste sous **Réglez d'abord ces points, puis supprimez votre compte :** et ne propose pas la suppression : voir [Si la suppression est refusée](#if-deletion-is-refused).  *La fenêtre nomme chaque organisation qui sera fermée.* 3. **Confirmez la suppression** Saisissez votre adresse e-mail dans **Saisissez votre adresse e-mail pour confirmer**, puis choisissez **Supprimer le compte**, qui demande le code de sécurité. Le compte est supprimé, avec ses méthodes de connexion et ses sessions, et vous êtes déconnecté. ## Si la suppression est refusée Sous **Réglez d'abord ces points, puis supprimez votre compte :**, la fenêtre nomme chaque organisation qui ne peut pas encore être fermée et dit pourquoi : un solde à retirer, ou un litige, un remboursement ou un transfert en cours. Réglez ce point, ou cédez l'organisation, puis rouvrez la fenêtre. Si la suppression est refusée une fois confirmée, **Votre compte n'a pas été supprimé** donne la raison de la même façon. --- # Régler vos préférences URL: https://docs.wajub.com/fr/dashboard/account/preferences > Choisir la langue du tableau de bord, une devise d'affichage et les e-mails que vous recevez, et activer les raccourcis clavier. **Préférences**, dans le groupe **Personnel** des paramètres, règle la langue du tableau de bord, une devise d'affichage et vos e-mails. Ces choix ne valent que pour vous. Chaque membre règle ses propres préférences, quel que soit son [rôle](https://docs.wajub.com/fr/dashboard#roles), [en Test comme en Production](https://docs.wajub.com/fr/dashboard#sandbox-and-live), sans [code de sécurité](https://docs.wajub.com/fr/dashboard#the-security-code). ## Langue et devise Ouvrez **Paramètres**, puis **Préférences** dans le groupe **Personnel**. **Langue d'interface** passe tout le tableau de bord en français ou en anglais. **Devise d'affichage** ajoute, à côté des principaux montants de l'[accueil](https://docs.wajub.com/dashboard/home/read), leur conversion au dernier taux de change ; les montants, le règlement et votre page de paiement ne changent pas. Le premier choix de la liste retire la conversion.  *La langue et la devise s'enregistrent dès que vous les choisissez.* ## Les e-mails **Notifications par e-mail** a un interrupteur par sujet, rangés en **Transactions** (**Paiements**, **Transferts**, **Factures**, **Litiges**), **Compte** (**Conformité**, **Organisation**, **Sécurité**) et **Autre** (**Mises à jour produit**, désactivé au départ). Une barre apparaît en bas de l'écran dès la première modification : **Enregistrer les modifications** applique vos choix, **Abandonner** les annule. Wajub n'envoie à un membre que les e-mails qui concernent son rôle. ## Les raccourcis clavier Les raccourcis se règlent hors de cette page. **Raccourcis clavier**, dans le menu de votre compte en haut à droite, les liste, et **Utiliser les raccourcis à une touche** les active ou les coupe. Une fois activés, la touche ? ouvre aussi cette liste. --- # Modifier votre profil URL: https://docs.wajub.com/fr/dashboard/account/profile > Changer votre nom, l'adresse e-mail avec laquelle vous vous connectez et le numéro de téléphone où Wajub envoie vos codes. **Profil**, dans le groupe **Personnel** des paramètres, porte votre nom, l'adresse e-mail et le numéro de téléphone où Wajub envoie vos codes de connexion et de vérification. Ils suivent votre compte dans toutes vos organisations. Chaque membre modifie son propre profil, quel que soit son [rôle](https://docs.wajub.com/fr/dashboard#roles), [en Test comme en Production](https://docs.wajub.com/fr/dashboard#sandbox-and-live). Changer d'adresse e-mail ne demande pas le [code de sécurité](https://docs.wajub.com/fr/dashboard#the-security-code) mais un code envoyé à chaque adresse ; vérifier un numéro de téléphone le demande. ## Changer d'adresse e-mail 1. **Ouvrez votre profil** Ouvrez **Paramètres**, puis **Profil** dans le groupe **Personnel**.  *Coordonnées réunit les deux adresses où arrivent vos codes.* 2. **Saisissez la nouvelle adresse** Dans **Coordonnées**, **Modifier** ouvre **Changer d'adresse e-mail**. Saisissez la **Nouvelle adresse e-mail**, puis **Envoyer le code**. Une adresse jetable est refusée : utilisez une adresse permanente. 3. **Vérifiez l'adresse actuelle** Saisissez le **Code de vérification** reçu à votre adresse actuelle, puis **Vérifier l'e-mail actuel**. 4. **Vérifiez la nouvelle adresse** Saisissez le code reçu à la nouvelle adresse, puis **Finaliser le changement d'e-mail**. Vous vous connectez désormais avec la nouvelle adresse. Tant que le changement n'est pas fini, **Coordonnées** affiche **Changement en attente vers** et la nouvelle adresse. **Continuer** reprend où vous en étiez, et **Annuler le changement d'e-mail** garde l'ancienne. ## Votre nom Remplacez votre **Nom complet** : une barre apparaît en bas de l'écran, et **Enregistrer le nom** l'applique. ## Votre numéro de téléphone Dans **Coordonnées**, **Ajouter un numéro de téléphone** ouvre une fenêtre du même nom. Saisissez le **Numéro de téléphone**, puis **Envoyer le code**, qui demande le code de sécurité. Saisissez le code à 6 chiffres reçu par SMS, puis **Vérifier le numéro de téléphone** : le numéro passe à **Vérifié**, et peut recevoir vos codes de connexion, comme décrit dans [Sécuriser votre connexion](https://docs.wajub.com/dashboard/account/security#other-methods). Un numéro pas encore vérifié a un bouton **Vérifier**, qui ouvre **Vérifier le numéro de téléphone**. Un numéro vérifié a un bouton **Modifier**, qui ouvre **Changer de numéro de téléphone**. Les deux fonctionnent de la même façon. **Vos données**, plus bas, exporte ce que Wajub garde sur vous : voir [Exporter vos données](https://docs.wajub.com/dashboard/account/activity-and-data#export-your-data). **Zone dangereuse** sert à [supprimer votre compte](https://docs.wajub.com/dashboard/account/delete). --- # Sécuriser votre connexion URL: https://docs.wajub.com/fr/dashboard/account/security > Configurer une application d'authentification, des clés d'accès ou des codes par e-mail ou SMS, changer votre mot de passe et fermer vos sessions. **Sécurité**, dans le groupe **Personnel** des paramètres, règle comment vous vous connectez : mot de passe, clés d'accès, double authentification et sessions. Les règles imposées à toute l'organisation se règlent dans [Sécuriser l'organisation](https://docs.wajub.com/dashboard/settings/security). Chaque membre sécurise son propre compte, quel que soit son [rôle](https://docs.wajub.com/fr/dashboard#roles), [en Test comme en Production](https://docs.wajub.com/fr/dashboard#sandbox-and-live). Configurer une application d'authentification, ajouter ou supprimer une clé d'accès, désactiver une méthode, créer de nouveaux codes de récupération et fermer une session demandent le [code de sécurité](https://docs.wajub.com/fr/dashboard#the-security-code). ## Configurer une application d'authentification 1. **Ouvrez la page Sécurité** Ouvrez **Paramètres**, puis **Sécurité** dans le groupe **Personnel**. Tant que vous n'avez ni double authentification ni clé d'accès, l'entrée porte **L'authentification à deux facteurs est désactivée**. **Méthodes de connexion** liste chaque méthode avec son état, **Activé** ou **Désactivé**.  *Sans double authentification ni clé d'accès, chaque méthode sauf le mot de passe est marquée Désactivé.* 2. **Lancez la configuration** Sur **Application d'authentification**, **Configurer** demande le code de sécurité, puis ouvre **Configurer l'application d'authentification**. 3. **Scannez le code QR** Scannez le code QR avec Google Authenticator, 1Password ou une application similaire. Si vous ne pouvez pas le scanner, saisissez la **Clé de configuration** dans l'application. 4. **Confirmez avec le code de l'application** Saisissez le code à 6 chiffres que montre l'application dans **Code de l'application**, puis **Activer l'application d'authentification**. 5. **Gardez vos codes de récupération** **Enregistrez vos codes de récupération** les affiche une seule fois. **Copier** ou **Télécharger** les garde : chacun vous connecte une fois si vous perdez votre téléphone. 6. **Terminez la configuration** Cochez **J'ai enregistré ces codes**, puis **Terminé**. L'application passe à **Activé**. ## Les autres méthodes **Clés d'accès**, marquées **Recommandé**, vous connectent avec votre empreinte, votre visage ou le verrouillage de l'écran. **Ajouter une clé d'accès** demande un nom, facultatif, puis votre navigateur prend le relais. Une clé d'accès compte comme deuxième étape. **Supprimer** retire une clé. **Code par e-mail** et **Code par SMS** envoient un code à chaque connexion. **Activer** vous envoie un premier code : saisissez-le, puis **Activer les codes par e-mail** ou **Activer les codes par SMS**. Le SMS demande un numéro vérifié dans votre [profil](https://docs.wajub.com/dashboard/account/profile#your-phone-number). **Désactiver** retire une méthode, après une confirmation. **Codes de récupération** propose **Créer de nouveaux codes** si vous avez perdu les vôtres : les anciens cessent aussitôt de marcher. ## Votre mot de passe **Changer le mot de passe** demande le **Mot de passe actuel**, le **Nouveau mot de passe** et **Confirmer le mot de passe**, puis **Mettre à jour le mot de passe**. Vos autres sessions restent connectées : fermez-les si vous l'avez changé par précaution. ## Vos sessions **Sessions** liste les appareils où votre compte est connecté, le vôtre marqué **Cet appareil**. **Se déconnecter** ferme une session, et **Déconnecter toutes les autres sessions** ferme toutes les autres. Déconnectez tout appareil que vous ne reconnaissez pas, puis changez votre mot de passe. --- # Ajouter un client URL: https://docs.wajub.com/fr/dashboard/customers/add > Créer la fiche d'un particulier ou d'une entreprise depuis le tableau de bord, et ce que fait l'alerte quand ce client existe déjà. La fiche d'un client garde ses coordonnées, ses préférences et vos étiquettes, et rassemble ensuite ses paiements, ses remboursements et ses litiges. Un client saisi avec un e-mail ou un téléphone sur une [facture](https://docs.wajub.com/dashboard/invoices/create) rejoint aussi votre répertoire. Le propriétaire, un Administrateur, un Spécialiste support ou un rôle personnalisé qui a **Gérer les clients** peut ajouter un client, avec tous les forfaits, en Test comme en Production. Aucun code de sécurité n'est demandé. ## Les étapes 1. **Ouvrez le formulaire** Ouvrez **Clients**, puis **Ajouter un client**. Le formulaire tient sur une seule page. 2. **Choisissez le type de client** Sous **Type de client**, choisissez **Particulier** ou **Entreprise**. Pour un particulier, **Informations personnelles** demande son **Nom complet**. Pour une entreprise, **Informations sur l'activité** demande le **Nom de l'entreprise**, seul champ obligatoire du formulaire, puis si besoin le **Numéro d'enregistrement**, le **Numéro d'identification fiscale** et le nom et le titre du représentant légal.  *Pour une entreprise, seul le nom de l'entreprise est obligatoire.* 3. **Saisissez ses coordonnées** Sous **Informations de contact**, saisissez son **E-mail** et son **Téléphone** : ses reçus et ses factures partent vers eux. Le tableau de bord vérifie aussitôt s'ils appartiennent déjà à un client, comme l'explique la section suivante. **Adresse** est facultative. 4. **Réglez ses préférences** Sous **Préférences**, la **Devise** est XAF par défaut. **Langue préférée** fixe la langue de ses factures, de ses reçus et de ses e-mails : l'anglais par défaut, ou le français. La **Description** n'est visible que de vos membres, et les **Étiquettes** s'ajoutent une à une avec la touche Entrée. 5. **Ajoutez le client** Choisissez **Ajouter un client**. Sa fiche s'ouvre avec **Client créé avec succès.** Si un champ est refusé, le formulaire le signale en rouge et rien n'est créé. ## Quand le client existe déjà Dans un même environnement, deux clients ne peuvent pas avoir le même e-mail. Si l'e-mail saisi est déjà pris, l'alerte **Cet e-mail est déjà utilisé** nomme le client qui l'a et propose de l'ouvrir : changez d'e-mail ou complétez plutôt sa fiche. Un téléphone déjà connu affiche **Ce client existe peut-être déjà**, sans bloquer : vous pouvez créer le client quand même, ou ouvrir la fiche existante. Si les deux fiches désignent la même personne, [fusionnez-les](https://docs.wajub.com/dashboard/customers/merge). ## Après la création La fiche du client s'ouvre. [Tenir à jour une fiche client](https://docs.wajub.com/dashboard/customers/profile) explique ce qu'elle montre et comment la modifier. --- # Bloquer, supprimer un client URL: https://docs.wajub.com/fr/dashboard/customers/block-disable-delete > Bloquer un client avec un motif et le débloquer, supprimer un client et ses données personnelles, puis retrouver ou restaurer une fiche supprimée. Ce que fait le blocage dépend de la version d'API de votre compte : à partir de `2026-11-02`, un client bloqué ne peut plus vous payer tant que vous ne le débloquez pas ; sur les versions antérieures, le blocage ne fait que le signaler à vos membres et à vos règles de routage. [Statut et blocage](https://docs.wajub.com/fr/payments/customers/manage#status-and-blocking) en dit plus. Supprimer un client efface ses données personnelles pour de bon et garde ses paiements. Le propriétaire, un Administrateur, un Spécialiste support ou un rôle personnalisé qui a **Gérer les clients** peut le faire, en Test comme en Production. Bloquer, débloquer et supprimer demandent le code de sécurité ; restaurer un client supprimé ne le demande pas. ## Les étapes 1. **Ouvrez le menu du client** Sur la fiche du client, ouvrez le menu à droite de **Modifier**, puis choisissez **Bloquer le client**. Dans **Clients**, le menu au bout de sa ligne propose la même action. 2. **Indiquez le motif** Un dialogue s'ouvre au nom du client, par exemple « Bloquer Restaurant Le Bastos ? ». **Motif (facultatif)** garde, en 500 caractères au plus, la raison du blocage pour vos membres : le client ne la voit pas.  *Seuls vos membres voient le motif.* 3. **Bloquez le client** Choisissez **Bloquer le client**, puis saisissez le code de sécurité. Sa fiche affiche **Ce client est bloqué**, avec le motif et la date du blocage, et son statut passe à **Bloqué** dans la liste. Pour lever le blocage, choisissez **Débloquer le client** dans le même menu, puis saisissez le code : le client redevient **Actif**. Un client bloqué entre aussi dans le segment **Clients bloqués** des [règles de routage](https://docs.wajub.com/dashboard/orchestration/routing-rules). ## Supprimer un client Dans le menu de sa fiche, ou au bout de sa ligne dans **Clients**, choisissez **Supprimer le client**, confirmez, puis saisissez le code de sécurité. Le client quitte votre liste et ne peut plus être débité avec ses moyens de paiement enregistrés. Son nom, son e-mail et son numéro de téléphone sont effacés aussitôt, sans retour possible. Ses paiements restent dans votre historique. [Suppression et effacement](https://docs.wajub.com/fr/payments/customers/delete) détaille ce qui est retiré. ## Restaurer un client supprimé Dans **Clients**, le filtre **Clients supprimés** affiche les fiches supprimées. Le menu au bout d'une ligne propose **Restaurer le client** : la fiche revient dans la liste, sans les données personnelles déjà effacées. > [!NOTE] > **Plusieurs clients à la fois** > > Pour bloquer, débloquer ou supprimer jusqu'à 100 clients d'un coup, sélectionnez-les dans la > liste : [Agir sur plusieurs clients](https://docs.wajub.com/dashboard/customers/bulk-actions). --- # Agir sur plusieurs clients URL: https://docs.wajub.com/fr/dashboard/customers/bulk-actions > Sélectionner des clients dans la liste pour les bloquer, les débloquer, les supprimer ou les exporter d'un coup, et exporter toute la liste filtrée. Depuis la liste **Clients**, vous pouvez bloquer, débloquer, supprimer ou exporter jusqu'à 100 clients à la fois, ou exporter toute la liste avec ses filtres. Le propriétaire, un Administrateur, un Spécialiste support ou un rôle personnalisé qui a **Gérer les clients** voit les cases de sélection et le bouton **Exporter**. Bloquer, débloquer et supprimer demandent le code de sécurité. L'export n'existe qu'en Production : le forfait **Pay as you go** en compte 10 par mois, tous exports du tableau de bord confondus, et **Growth** et les forfaits au-dessus n'ont pas de limite. ## Les étapes 1. **Sélectionnez les clients** Dans **Clients**, filtrez la liste si besoin, puis cochez la case de chaque client. Une barre apparaît en bas de l'écran avec le nombre de clients choisis. Au-delà de 100, elle affiche « Jusqu'à 100 à la fois. » et ses actions restent grisées. Les clients supprimés ne se sélectionnent pas.  *La barre ne propose que les actions qui s'appliquent aux clients choisis.* 2. **Choisissez l'action** **Bloquer** et **Débloquer** n'apparaissent que si la sélection contient des clients à bloquer ou à débloquer. Quand elle mélange les deux, le bouton donne le nombre concerné, par exemple « Bloquer 2 » : un client déjà bloqué garde son motif. **Bloquer** ouvre le dialogue du motif, comme pour [un seul client](https://docs.wajub.com/dashboard/customers/block-disable-delete), puis **Bloquer les clients**. **Supprimer** demande une confirmation : les noms, e-mails et numéros de téléphone sont effacés, les paiements restent. Confirmez avec **Supprimer les clients**. 3. **Saisissez le code de sécurité** Le code saisi, l'action s'applique et un message donne le nombre de clients traités, par exemple « 3 clients bloqués. ». La sélection se vide. ## Exporter les clients En Production, **Exporter**, en haut de la liste, ouvre **Exporter les clients** : le fichier contient les clients que la liste affiche avec ses filtres, rappelés sous **Filtres conservés**. Choisissez le **Format**, **CSV**, **Excel**, **PDF** ou **JSON**, et si besoin une période avec le bouton **Date** sous **Période** : une période prête comme **30 derniers jours**, ou une **Période personnalisée**. Sans période, toutes les dates sont exportées. Puis **Exporter en CSV**, **Exporter en Excel**, **Exporter en PDF** ou **Exporter JSON**, selon le format. Le fichier se télécharge, et « Votre export est prêt » donne son nom. L'export ne demande pas de code de sécurité. Pour n'exporter que certains clients, sélectionnez-les, puis **Exporter** dans la barre du bas : **Exporter les clients sélectionnés** reprend seulement ceux-là, sans période. > [!NOTE] > **En Test ou au bout de vos exports** > > En Test, le dialogue indique que les exports ne contiennent que des données de production. Une > fois les exports du mois utilisés, il l'indique : un membre qui a **Gérer le compte** voit > **Passer à un forfait supérieur**, les autres sont invités à s'adresser au propriétaire de > l'organisation. --- # Fusionner deux clients URL: https://docs.wajub.com/fr/dashboard/customers/merge > Réunir les deux fiches d'un même client en une seule, avec l'aperçu de ce qui passe d'une fiche à l'autre avant de confirmer. Quand un même client a deux fiches, la fusion réunit ses paiements, ses factures et ses notes sur celle que vous gardez, et archive l'autre. Le propriétaire, un Administrateur, un Spécialiste support ou un rôle personnalisé qui a **Gérer les clients** peut fusionner deux clients, avec tous les forfaits. La fusion n'existe qu'en Production et demande le code de sécurité. ## Les étapes 1. **Ouvrez l'outil de fusion** Ouvrez **Paramètres › Fusions de clients**. Depuis la fiche d'un client, **Fusionner avec un autre client**, dans le menu à droite de **Modifier**, ouvre l'outil avec ce client déjà choisi comme celui à garder. 2. **Choisissez le client à garder** Sous **Client à conserver**, cherchez-le par son nom, son e-mail, son téléphone ou son **ID client**. Cette fiche reste et reçoit tout ce que contient l'autre.  *La fiche à conserver reçoit tout ce que contient l'autre.* 3. **Choisissez le client à fusionner** Sous **Client à fusionner avec lui**, choisissez la fiche en double, qui sera archivée. Puis **Vérifier la fusion**. 4. **Relisez ce qui va passer** L'étape **Examiner** montre les deux fiches côte à côte, **Conservé** et **Fusionné, puis archivé**, avec leur e-mail, leur téléphone et leurs paiements réussis. Dessous, la liste de ce qui change de fiche compte les paiements de tous statuts, les litiges, les factures, les demandes de remboursement, les moyens de paiement enregistrés, les fiches des liens de paiement, les notes et les adresses. 5. **Fusionnez les clients** Choisissez **Fusionner les clients**, puis saisissez le code de sécurité. **Clients fusionnés** confirme que tout appartient désormais à la fiche gardée, avec un bouton pour l'ouvrir. ## Après la fusion La fiche gardée reçoit aussi les étiquettes de l'autre, ainsi que son e-mail, son téléphone, le nom de l'entreprise et la description quand elle n'en avait pas. Ses totaux de paiements s'additionnent, et son activité garde une note qui mentionne la fusion. La fiche fusionnée rejoint les **Clients supprimés** de la liste. > [!NOTE] > **Une fusion ne s'annule pas** > > Les données passées sur la fiche gardée y restent. Avant de confirmer, vérifiez à l'étape > **Examiner** que les deux fiches désignent bien la même personne. --- # Tenir à jour une fiche client URL: https://docs.wajub.com/fr/dashboard/customers/profile > Ce que montre la fiche d'un client, de ses paiements à ses adresses, et comment la modifier, gérer ses moyens de paiement et y laisser des notes pour l'équipe. La fiche d'un client réunit ce qu'il vous a payé, ses coordonnées, ses adresses, ses moyens de paiement enregistrés et les notes de votre équipe. Tous les rôles ouvrent les fiches clients. Les modifier, gérer les adresses et les moyens de paiement, écrire une note ou utiliser **Recalculer** est réservé au propriétaire, aux Administrateurs, aux Spécialistes support et aux rôles personnalisés qui ont **Gérer les clients**. La modification de la fiche demande le code de sécurité, tout comme [bloquer, débloquer ou supprimer](https://docs.wajub.com/dashboard/customers/block-disable-delete) le client et le [fusionner](https://docs.wajub.com/dashboard/customers/merge) avec un autre. ## Ce que montre la fiche Ouvrez **Clients**, puis le nom du client. L'en-tête donne son nom, son statut, son type et son **ID client**, à copier pour le support ou votre équipe technique. Les onglets **Paiements**, **Remboursements** et **Litiges** n'apparaissent que si le client en a ; **Chronologie** reprend toute son activité. Sur **Vue d'ensemble**, **Total dépensé** couvre les 12 derniers mois en Production et toute la relation en Test, à côté du nombre de **Paiements** et de la date **Client depuis**. En Production, **Analyses de paiement** résume les 30 derniers jours : **Volume réussi**, **Total des paiements**, **Taux de réussite** et paiements **Échoué**. **Recalculer** les met à jour. Suivent les **Coordonnées**, les **Détails de l'entreprise** pour une entreprise, et les **Préférences**.  *Les moyens de paiement et les adresses sont à droite de la fiche.* ## Modifier la fiche **Modifier** ouvre **Modifier le client**, en cinq onglets : **Général** pour le nom, les coordonnées, la devise, la langue et la description, puis **Adresse**, **Entreprise**, **Préférences** et **Étiquettes**. **Enregistrer les modifications** demande le code de sécurité. Les changements valent pour les prochains paiements, factures et reçus du client, pas pour ceux déjà émis. ## Adresses et moyens de paiement Sous **Moyens de paiement**, la fiche liste ceux que le client a enregistrés en payant, avec le badge **Par défaut**. Leur menu propose **Définir par défaut** ou **Retirer le moyen de paiement** : il ne pourra plus être débité, et le client pourra l'enregistrer de nouveau à son prochain paiement. Le tableau de bord ne permet pas d'en ajouter un. Sous **Adresses**, **Ajouter une adresse** demande son **Type**, **Facturation** ou **Livraison**, puis au moins la **Ligne d'adresse 1**, la **Ville** et le **Pays**. Cochez **En faire l'adresse par défaut** pour qu'elle remplace l'adresse par défaut de ce type. Le menu d'une adresse propose **Modifier l'adresse** et **Supprimer l'adresse**. ## Activité et notes **Activité et notes** liste les paiements, les remboursements et les litiges du client, du plus récent au plus ancien, et **Voir toute l'activité** ouvre la **Chronologie**. Pour laisser une consigne à l'équipe, écrivez-la dans le champ du bas, puis **Ajouter une note** : seuls vos membres voient les notes. Le menu d'une note propose **Épingler la note**, qui la garde en haut sous **Notes épinglées**, et **Supprimer la note**. --- # Passer en compte entreprise URL: https://docs.wajub.com/fr/dashboard/activation/switch-to-business > Faire vérifier une entreprise quand l'organisation a été vérifiée comme particulier, sans interrompre les paiements. Une organisation vérifiée comme **Individuel (Auto-entrepreneur, Freelance)** peut devenir une entreprise, une association ou un autre type d'organisation. Il faut pour cela un nouveau dossier, examiné par l'équipe conformité. Pendant ce temps, votre vérification actuelle reste active : les paiements et les transferts continuent jusqu'à l'approbation du nouveau dossier. Le propriétaire, un Administrateur ou un rôle personnalisé qui a **Gérer le compte** lance et suit le passage (voir [Rôles](https://docs.wajub.com/fr/dashboard#roles)). Il est ouvert avec tous les forfaits, en [Test comme en Production](https://docs.wajub.com/fr/dashboard#sandbox-and-live). Le lancer et l'abandonner demandent le [code de sécurité](https://docs.wajub.com/fr/dashboard#the-security-code) si votre dernière vérification a expiré. ## Les étapes 1. **Ouvrez la page Conformité** Ouvrez **Paramètres › Conformité**. Sous **Vérification terminée**, choisissez **Passer à un compte entreprise**. Le bouton n'apparaît que si le dossier en vigueur est celui d'un particulier vérifié. 2. **Choisissez le type d'organisation** La fenêtre rappelle ce que le nouveau dossier demande. Dans **Type d'organisation**, choisissez par exemple **Entreprise** ou **Association / ONG**, puis **Commencer la mise à niveau**. Si votre dernière vérification de sécurité a expiré, le code de sécurité est demandé d'abord. Le dossier entreprise s'ouvre alors à sa première étape.  *Le type choisi pourra encore changer dans l'étape Détails de l'entreprise.* 3. **Complétez le dossier entreprise** Le dossier reprend votre dossier de particulier : activité, adresse, présence en ligne, documents et votre fiche, dont vous devenez le représentant légal. Tout sera examiné à nouveau. Ajoutez ce que demande le nouveau type : les documents de l'entreprise, les bénéficiaires effectifs s'il y en a, et une nouvelle vidéo de vérification de présence, car l'ancienne n'est pas reprise. Chaque étape est décrite dans [Vérifier son entreprise](https://docs.wajub.com/dashboard/activation/verify-business). 4. **Envoyez-le pour vérification** À la dernière étape, **Vérifier et soumettre**, choisissez **Soumettre pour vérification**. ## Suivre le nouveau dossier Sur **Paramètres › Conformité**, la carte **Passage au compte entreprise** suit le nouveau dossier sous le statut de l'ancien, toujours **Vérifié**. Elle affiche son statut, la date d'envoi et **Continuer la mise à niveau** tant qu'il n'est pas envoyé. Ce que l'équipe conformité demande sur ce dossier apparaît dans **Actions requises sur votre dossier entreprise**, et se traite comme l'explique [Suivre sa vérification](https://docs.wajub.com/dashboard/activation/track-verification). Quand le dossier entreprise est approuvé, il remplace celui de particulier : l'organisation reste en Production et le nouveau type s'affiche sur la page. S'il est rejeté, votre vérification de particulier reste en vigueur ; **Corriger et soumettre à nouveau** le rouvre, avec sous **Motif** la raison donnée. ## Abandonner le passage Tant que le dossier entreprise n'est pas envoyé, ou après un rejet, la carte propose **Abandonner la mise à niveau**. Une fenêtre demande confirmation : le dossier entreprise est mis de côté et ne pourra plus être envoyé, mais l'organisation garde sa vérification actuelle. Vous pourrez lancer un nouveau passage plus tard. Pendant l'examen, le bouton n'apparaît plus : le dossier entreprise ne peut plus être abandonné. ## Si le bouton refuse de démarrer Si l'équipe conformité attend encore une réponse sur votre dossier actuel, la fenêtre affiche « Répondez d'abord aux demandes ouvertes sur votre dossier, puis commencez la mise à niveau. » Fournissez d'abord les éléments listés dans **Actions requises**, puis recommencez une fois que l'équipe conformité les a acceptés. --- # Suivre sa vérification URL: https://docs.wajub.com/fr/dashboard/activation/track-verification > Lire le statut du dossier, répondre aux actions requises et aux demandes de l'équipe conformité, et confirmer le dossier chaque année. Une fois le dossier envoyé, **Paramètres › Conformité** dit où il en est. L'onglet **Vue d'ensemble** affiche le statut et ce que Wajub attend de vous ; l'onglet **Demandes** rassemble les questions de l'équipe conformité. Le propriétaire de l'organisation reçoit un e-mail quand le dossier est validé ou rejeté, et quand Wajub attend quelque chose de vous. Le propriétaire, un Administrateur ou un rôle personnalisé qui a **Gérer le compte** voit cette page et y répond, en Test comme en Production, avec tous les forfaits. Un Développeur, un Observateur ou un autre [rôle](https://docs.wajub.com/fr/dashboard#roles) qui a **Voir les paramètres** voit **Paramètres › Statut du compte** : le statut, le **Mode production** et les **Restrictions actives**, sans le contenu du dossier. Répondre ne demande pas de [code de sécurité](https://docs.wajub.com/fr/dashboard#the-security-code). ## Les statuts du dossier | Statut | Ce qu'il veut dire | | --------------------- | ------------------------------------------------------------------------------------------------------------------------- | | **Non soumis** | Le dossier est commencé mais pas envoyé : **Continuer la vérification** reprend où vous en étiez. | | **En cours d'examen** | L'équipe conformité examine le dossier, qui ne se modifie plus. Rien à faire, la page indique le délai habituel. | | **Action requise** | L'équipe a besoin d'autre chose avant de décider. Le dossier repart en examen quand tout est fourni. | | **Vérifié** | La [Production](https://docs.wajub.com/dashboard/getting-started/test-and-live) est déverrouillée. La page affiche **Vérifié le** avec la date. | | **Rejeté** | Le dossier n'a pas été approuvé : voir [Si le dossier est rejeté](#if-the-file-is-rejected). |  *Chaque élément demandé a son échéance et son propre bouton.* ## Répondre à une action requise 1. **Ouvrez la liste des actions requises** Sous le statut, **Actions requises** compte les éléments à fournir. Chacun indique ce qui est demandé, la personne concernée s'il y a lieu, et son échéance. 2. **Fournissez l'élément demandé** Un document se téléverse sur place avec **Téléverser le document**. Pour le reste, le bouton de l'élément ouvre l'étape du dossier concernée, qui ne montre que ce qui est demandé : par exemple **Mettre à jour les informations de la société**, ou **Commencer la vérification de présence** pour une nouvelle vidéo, décrite dans [Vérifier une identité](https://docs.wajub.com/dashboard/activation/verify-identity). 3. **Attendez l'examen de votre réponse** L'élément passe à **En cours d'examen**, puis disparaît de la liste quand l'équipe conformité l'a accepté. ## Répondre à une demande Quand l'équipe conformité pose une question, elle apparaît dans **Demandes**, avec la date limite « Répondre avant le » suivie de la date. Ouvrez-la, écrivez dans **Votre réponse**, joignez au besoin jusqu'à dix fichiers de 10 Mo au plus avec **Ajouter un fichier**, puis **Envoyer**. Une fois la demande traitée, elle affiche **Cette demande est fermée. Vous ne pouvez plus répondre.** ## Quand une échéance est dépassée Un élément en retard passe à **En retard**. Si l'organisation est déjà vérifiée, ses transferts se mettent aussi en pause : l'élément affiche **Les transferts sont en pause jusqu'à son acceptation.** et la pause apparaît dans **Restrictions actives**. Fournir l'élément ne suffit pas : les transferts reprennent quand l'équipe conformité l'a accepté. Les paiements, eux, continuent d'arriver. ## La confirmation annuelle Un an après la vérification, Wajub demande de confirmer que le dossier est toujours exact. Avant cette date, **Actions requises** affiche une **Revue périodique**. Cochez **Je confirme que les informations de mon dossier sont toujours exactes**, décrivez au besoin un changement d'activité, d'adresse ou de propriétaires dans **Qu'est-ce qui a changé ? (facultatif)**, puis **Envoyer ma confirmation**. L'organisation continue de fonctionner jusqu'à l'échéance. Une pièce d'identité ou une licence qui arrive à expiration est demandée de la même façon, dans **Actions requises** : l'élément indique **Ce document a expiré ou expire bientôt. Merci d'en envoyer un en cours de validité.** ## Si l'adresse du propriétaire est jetable Quand le propriétaire de l'organisation se connecte avec une adresse e-mail jetable, **Restrictions actives** affiche **Gel du compte (lecture seule)**, **Révocation de l'accès API** et **Désactivation des webhooks**, chacune avec « Le propriétaire de cette organisation utilise une adresse e-mail jetable (...). Cette restriction est levée dès qu'il utilise une adresse permanente dans les paramètres de son compte. » Les paiements, les transferts et les remboursements s'arrêtent, les clés API ne marchent plus et les webhooks ne sont plus envoyés. Le propriétaire peut toujours se connecter : dès qu'il [change d'adresse e-mail](https://docs.wajub.com/dashboard/account/profile#change-your-email) pour une adresse permanente, les restrictions sont levées. ## Si le dossier est rejeté La page affiche **Vérification rejetée** et, sous **Motif**, la raison donnée par l'équipe conformité. Choisissez **Corriger et soumettre à nouveau** : le dossier se rouvre, vous corrigez ce qui est indiqué, puis vous l'envoyez comme la première fois. Si l'organisation était déjà vérifiée, la Production se verrouille et tous les membres repassent en Test jusqu'à une nouvelle validation. Pour une question sur votre dossier, **Contacter le support** en haut de la page écrit à l'équipe conformité. --- # Vérifier son entreprise URL: https://docs.wajub.com/fr/dashboard/activation/verify-business > Remplir et envoyer le dossier d'activation depuis Paramètres › Conformité, étape par étape, pour déverrouiller la Production. Avant d'encaisser de l'argent réel, Wajub vérifie qui vous êtes et ce que vous vendez. Le dossier se remplit en ligne, en six étapes au plus, et la Production se déverrouille quand Wajub l'a validé. Le propriétaire, un Administrateur ou un rôle personnalisé qui a **Gérer le compte** remplit et envoie le dossier ; un Développeur, un Observateur ou un autre [rôle](https://docs.wajub.com/fr/dashboard#roles) qui a **Voir les paramètres** voit seulement où il en est, dans **Paramètres › Statut du compte**. Le dossier se remplit en [Test](https://docs.wajub.com/fr/dashboard#sandbox-and-live), avec tous les forfaits. L'e-mail et le téléphone de l'entreprise sont confirmés par un code qui leur est envoyé, mais le [code de sécurité](https://docs.wajub.com/fr/dashboard#the-security-code) n'est pas demandé. ## Les étapes 1. **Ouvrez le dossier** Ouvrez **Paramètres › Conformité**, puis **Commencer la vérification**. Un compteur indique l'étape en cours ; **Continuer** l'enregistre et passe à la suivante, **Précédent** revient en arrière. Vous pouvez vous arrêter à tout moment : le bouton devient **Continuer la vérification**.  *Tant que le dossier n'est pas envoyé, la Production reste verrouillée.* 2. **Décrivez votre activité** Dans **Activité commerciale**, choisissez la **Catégorie d'entreprise** et l'**Activité précise**, puis rédigez la **Description de l'activité**, de 10 à 1 000 caractères : ce que vous vendez et à qui. Une activité réglementée affiche « Cette activité est réglementée : vous devrez fournir une licence. » 3. **Renseignez l'entreprise** Dans **Détails de l'entreprise**, choisissez le **Type d'organisation** et la **Structure juridique**, puis saisissez le **Nom légal** et l'**Identifiant fiscal ou numéro d'immatriculation** tels qu'ils figurent sur vos documents officiels, et l'**Adresse de l'entreprise**. Si personne ne détient 25 % ou plus de l'entreprise, cochez **Personne ne détient ni ne contrôle 25 % ou plus de l'entreprise** : ce choix ne peut plus changer une fois le dossier envoyé. 4. **Confirmez l'e-mail et le téléphone de l'entreprise** Sous **Contact de l'entreprise**, saisissez l'**E-mail professionnel** et le **Téléphone de l'entreprise**. Pour chacun, choisissez **Envoyer le code**, saisissez le code reçu dans **Code de vérification**, puis **Vérifier**. 5. **Ajoutez votre présence en ligne** Dans **Présence en ligne**, choisissez la **Plateforme** (site web, application, réseau social) et l'**Adresse (URL)**, puis **Ajouter ce canal**. Une présence au moins est obligatoire ; **Ajouter un canal** en ajoute une autre. 6. **Téléversez les documents de l'entreprise** **Documents d'entreprise** liste les pièces demandées pour votre type d'organisation, au format PDF, JPG ou PNG, jusqu'à 10 Mo chacune. Une société fournit par exemple le **Registre de commerce (RCCM)**, les **Statuts**, le **Plan de localisation** et l'**Attestation fiscale** ; une association, son **Récépissé, agrément ou autorisation** et l'**Acte de nomination du représentant légal**. Pour une activité réglementée, **Ajouter une licence** demande son type, son numéro, l'autorité qui l'a délivrée et le document. Avec le type **Individuel (Auto-entrepreneur, Freelance)** et sans activité réglementée, vous passez directement à l'étape suivante.  *Chaque pièce est examinée par l'équipe conformité de Wajub.* 7. **Ajoutez les personnes** Dans **Personnes**, choisissez **Ajouter une personne** pour le représentant légal, puis pour chaque **Bénéficiaire effectif**, qui détient ou contrôle 25 % ou plus de l'entreprise. Cochez son **Rôle**, remplissez son identité, puis **Enregistrer la personne** ; téléversez ensuite sa pièce d'identité, carte d'identité ou passeport, sur sa fiche. Une personne qui a plusieurs rôles n'est saisie qu'une fois, avec tous ses rôles cochés : une deuxième fiche pour la même personne est refusée. Sur la fiche du représentant légal, téléversez aussi un **Justificatif de domicile** ou, si aucune facture n'est à son nom, un **Plan de localisation du domicile**. Avec le type **Individuel (Auto-entrepreneur, Freelance)**, l'étape s'appelle **Votre identité** : choisissez **Ajouter mon profil**, puis fournissez les mêmes documents pour vous-même. Le représentant légal (ou vous-même, avec le type Individuel) enregistre aussi une courte vidéo : [Vérifier une identité](https://docs.wajub.com/dashboard/activation/verify-identity) explique comment. 8. **Envoyez le dossier** **Vérifier et soumettre** récapitule tout le dossier. **Informations manquantes** liste ce qui reste à faire, chaque section ayant son bouton **Modifier** ; sinon, la page affiche **Tout est prêt**. Choisissez **Soumettre pour vérification**. ## Après l'envoi **Paramètres › Conformité** affiche **Votre dossier est en cours d'examen**, avec le délai habituel en jours ouvrés, et le dossier ne se modifie plus. Wajub écrit au propriétaire de l'organisation dès que la décision est prise ou s'il lui faut autre chose ; en attendant, vous pouvez continuer en Test. [Suivre sa vérification](https://docs.wajub.com/dashboard/activation/track-verification) explique chaque statut et comment répondre à une demande. --- # Vérifier une identité URL: https://docs.wajub.com/fr/dashboard/activation/verify-identity > Enregistrer la vérification de présence du représentant légal, depuis l'ordinateur ou en envoyant un lien sur son téléphone. La **Vérification de présence** est un court selfie vidéo : il prouve que la personne de la pièce d'identité existe et se tient devant la caméra. Le représentant légal l'enregistre pour une entreprise ; avec le type **Individuel (Auto-entrepreneur, Freelance)**, vous l'enregistrez pour vous-même. Une autre personne du dossier ne l'enregistre que si Wajub le lui demande. Comme le reste du dossier, elle se lance depuis **Paramètres › Conformité** par le propriétaire, un Administrateur ou un rôle personnalisé qui a **Gérer le compte** (voir [Rôles](https://docs.wajub.com/fr/dashboard#roles)). Elle se fait en [Test](https://docs.wajub.com/fr/dashboard#sandbox-and-live), avec tous les forfaits, et ne demande pas de [code de sécurité](https://docs.wajub.com/fr/dashboard#the-security-code). La personne filmée, elle, n'a pas besoin de compte Wajub. ## Les étapes 1. **Ouvrez la fiche de la personne** Dans le dossier, ouvrez l'étape **Personnes**, ou **Votre identité** avec le type Individuel. Sous la fiche du représentant légal, le bloc **Vérification de présence** est marqué obligatoire et propose deux boutons.  *Le bloc n'apparaît que pour la personne qui doit enregistrer la vidéo.* 2. **Enregistrez la vidéo sur cet ordinateur** Si la personne est devant votre écran, choisissez **Enregistrer maintenant**. Elle lit la notice **Avant de commencer**, coche la case qui donne son accord et autorise la caméra. Elle suit ensuite les consignes à l'écran, qui durent environ une minute, puis envoie la vidéo. Aucun son n'est enregistré. 3. **Ou envoyez-lui un lien** Si elle est ailleurs, ou si votre ordinateur n'a pas de caméra, choisissez **Continuer sur un téléphone**. La fenêtre affiche un QR code, le **Lien de vérification de vivacité** à copier et sa date d'expiration. Si la personne est à côté de vous, elle scanne le QR code ; sinon, **Envoyer par WhatsApp** prépare un message avec le lien, à adresser au bon contact.  *Créer un nouveau lien désactive le précédent.* Sur son téléphone, elle arrive sur une page Wajub, dans la langue de son navigateur, qui nomme votre entreprise et la guide jusqu'à l'envoi de la vidéo. 4. **Suivez le résultat** Une fois la vidéo envoyée, le bloc affiche **En cours d'examen**, puis **Réussi** quand Wajub l'a validée. Vous n'avez pas besoin d'attendre : le dossier peut partir pour vérification dès que la vidéo est envoyée. ## Gérer le lien Tant qu'un lien peut servir, la fiche indique jusqu'à quelle date il est valable, et **Révoquer le lien** le désactive aussitôt, par exemple si vous l'avez envoyé au mauvais numéro. Le lien cesse aussi de fonctionner quand il expire, après quelques vidéos envoyées, quand une vidéo est validée ou refusée par l'équipe Wajub, ou quand le dossier est envoyé. La page dit alors à la personne de vous en demander un nouveau, ou qu'elle n'a plus rien à faire si sa vidéo a déjà été acceptée ou est en cours d'examen. Pour un nouveau lien, choisissez à nouveau **Continuer sur un téléphone**. ## Si la vidéo est refusée Le bloc passe à **Échoué** et affiche **Vérification de vivacité refusée** avec la raison donnée par Wajub. Les deux boutons reviennent : enregistrez une nouvelle vidéo de la même façon. Après plusieurs essais dans la journée, le tableau de bord répond « Trop de tentatives de vérification. Veuillez réessayer dans 24 heures. » Si Wajub demande une nouvelle vidéo après l'envoi du dossier, la demande apparaît dans **Paramètres › Conformité**, comme l'explique [Suivre sa vérification](https://docs.wajub.com/dashboard/activation/track-verification). ## Si la caméra ne s'ouvre pas La page dit ce qui bloque et comment le régler. Avec **L'accès à la caméra a été refusé**, autorisez la caméra pour ce site depuis l'icône à côté de la barre d'adresse, puis réessayez. Avec **Aucune caméra détectée**, passez par **Continuer sur un téléphone**. Un lien ouvert depuis WhatsApp, Instagram ou Facebook s'affiche parfois dans le navigateur de l'application, qui ne filme pas : la page demande alors de l'ouvrir dans Safari ou Chrome. --- # Trouver ses clés API URL: https://docs.wajub.com/fr/dashboard/developers/api-keys > Où sont les clés API dans le tableau de bord, qui les voit, et où lire comment les créer, les restreindre et les régénérer. Les clés API permettent à votre site ou à votre application d'appeler Wajub. Elles se trouvent dans **Paramètres › Développeurs › Clés API**. Leur création et leur usage sont décrits dans la documentation développeurs ; cette page dit seulement où les trouver. Le propriétaire, un Administrateur, un Développeur, un Utilisateur de test, en Test seulement, ou un rôle personnalisé qui a **Gérer les clés API** ouvre cette page ; pour les autres membres, l'entrée n'apparaît pas dans les paramètres. Tous les forfaits y ont accès. Créer, modifier, afficher, régénérer ou révoquer une clé demande le [code de sécurité](https://docs.wajub.com/fr/dashboard#the-security-code). ## Ce que montre la page Chaque [environnement](https://docs.wajub.com/fr/dashboard#sandbox-and-live) a ses propres clés : en Test, la page rappelle **Vous consultez des clés de test.**, et les clés de Production n'apparaissent qu'une fois passé en Production. La page range les clés en trois groupes. La **Clé publiable** identifie votre compte dans le code qui tourne chez le payeur et peut être partagée. Les **Clés secrètes** donnent un accès complet et ne servent que depuis votre serveur. Les **Clés restreintes** n'ouvrent que les permissions choisies, pour un outil tiers par exemple. **Créer une clé API** ouvre le formulaire de création. Sur une clé, **Afficher** montre de nouveau sa valeur, **Régénérer** la remplace, **Dans 24 heures** ou **Maintenant**, et **Révoquer la clé** la coupe pour de bon. **Copie rapide** donne la clé publiable et la première clé secrète, avec **Copier les lignes .env** pour les coller dans votre fichier d'environnement. ## Dans la documentation développeurs | Pour | Lire | | ------------------------------------------------ | --------------------------------------------------------------------------------------- | | Créer sa première clé et la placer dans son code | [Configurer votre compte](https://docs.wajub.com/fr/getting-started/dashboard-setup#3-create-your-first-api-key) | | Comprendre les types de clés | [Environnements et API keys](https://docs.wajub.com/fr/getting-started/environments#key-types) | | Limiter ce qu'une clé peut faire | [Environnements et API keys](https://docs.wajub.com/fr/getting-started/environments#narrowing-what-a-key-can-do) | | Régénérer une clé qui a fuité | [Configurer votre compte](https://docs.wajub.com/fr/getting-started/dashboard-setup#7-roll-a-key-that-leaked) | | Webhooks, Konsole et CLI | [Outils développeurs](https://docs.wajub.com/fr/developer-tools) | --- # Créer son compte URL: https://docs.wajub.com/fr/dashboard/getting-started/create-account > S'inscrire sur le tableau de bord Wajub, confirmer son e-mail, puis créer l'organisation qui encaissera les paiements. Votre compte vous connecte au tableau de bord ; l'organisation est l'entreprise pour laquelle vous encaissez, avec ses propres paiements, ses membres et ses réglages. Un même compte peut appartenir à plusieurs organisations. Tout le monde peut créer un compte et une organisation, sans carte bancaire. Vous devenez le propriétaire de l'organisation, avec tous les droits décrits dans [Rôles](https://docs.wajub.com/fr/dashboard#roles). L'organisation démarre en [Test](https://docs.wajub.com/fr/dashboard#sandbox-and-live), et aucun [code de sécurité](https://docs.wajub.com/fr/dashboard#the-security-code) n'est demandé. ## Les étapes 1. **Remplissez le formulaire d'inscription** Sur **Créez votre compte**, saisissez votre **Nom complet**, votre **E-mail professionnel** et un **Mot de passe** : au moins 12 caractères, avec des majuscules, des minuscules et des chiffres, et absent des listes de mots de passe divulgués. Acceptez les conditions d'utilisation et la politique de confidentialité, puis choisissez **Créer un compte gratuit**. Une adresse déjà inscrite est refusée : connectez-vous plutôt. Une adresse jetable est refusée aussi : utilisez une adresse permanente. 2. **Confirmez votre e-mail** L'écran **Vérifiez votre e-mail** attend le code à six chiffres que Wajub vient de vous envoyer. Saisissez-le dans **Code de vérification**, puis choisissez **Vérifier l'e-mail**. Le code expire au bout de 10 minutes ; **Renvoyer le code** en envoie un nouveau après une minute d'attente, et **Modifier l'e-mail** corrige une adresse mal saisie. 3. **Nommez votre organisation** **Créez votre organisation** ne demande que le **Nom de l'organisation**. Vos clients le voient sur les reçus et les pages de paiement, et vous pourrez le changer plus tard. Choisissez **Créer une organisation** : l'accueil du tableau de bord s'ouvre.  *L'e-mail et le téléphone de l'entreprise sont demandés plus tard, dans le dossier d'activation.* 4. **Dites ce que vous voulez faire en premier** Une fenêtre demande **Que voulez-vous faire en premier ?** et ne se ferme qu'avec une réponse : **Intégrer via l'API**, **Accepter des paiements avec des liens**, **En personne ou au détail** ou **Envoyer des transferts**. Pour encaisser sans écrire de code, choisissez **Accepter des paiements avec des liens**, marqué **Recommandé**. Le bouton du bas vous laisse décider plus tard. Votre choix ne bloque rien : il range seulement les étapes de la liste que l'accueil affiche en Production, que vous pouvez faire dans n'importe quel ordre. ## Après la création L'accueil affiche **Préparez le passage en production**. Ses deux premières étapes, les clés API et le paiement de test, servent à ceux qui branchent Wajub sur un site ; la troisième, la vérification de votre entreprise, concerne tout le monde. Tant qu'elle n'est pas validée, l'organisation reste en Test : [Vérifier son entreprise](https://docs.wajub.com/dashboard/activation/verify-business) décrit le dossier, et [Passer en Production](https://docs.wajub.com/dashboard/getting-started/test-and-live) ce qui change ensuite. Pour ajouter une autre organisation, ouvrez le sélecteur d'organisation en haut du menu, puis **Créer une organisation**. Chaque organisation a ses propres membres, ses données et sa propre vérification. --- # Découvrir le tableau de bord URL: https://docs.wajub.com/fr/dashboard/getting-started/dashboard-tour > Le menu, la barre du haut, la recherche, les raccourcis clavier, la langue et le passage d'une organisation à l'autre. Le tableau de bord tient en trois zones : le menu à gauche, la barre du haut et la page ouverte. Chaque membre voit le menu de son [rôle](https://docs.wajub.com/fr/dashboard#roles) : une entrée que son rôle n'ouvre pas n'apparaît pas. En [Test](https://docs.wajub.com/fr/dashboard#sandbox-and-live), les modules réservés à la Production quittent aussi le menu. Changer de langue, de thème ou d'organisation ne demande ni forfait particulier ni [code de sécurité](https://docs.wajub.com/fr/dashboard#the-security-code). ## Le menu En haut du menu, le sélecteur d'organisation affiche le nom de l'organisation ouverte, votre rôle et son statut. Viennent ensuite deux listes : la première avec **Tableau de bord**, **Paiements**, **Factures**, **Clients**, **Transferts**, **Liens de paiement** et **Sync**, puis la seconde, en bas, avec **Revenus**, **Taxe**, **Shield**, **Orchestration**, **Paramètres** et **Assistance**.  *Une entrée avec un cadenas ouvre la page de mise à niveau.* Un module que votre forfait n'inclut pas reste dans le menu, avec un cadenas : [Modules hors de votre forfait](https://docs.wajub.com/fr/dashboard#modules-outside-your-plan) dit ce qu'il affiche. Sur un téléphone ou une petite tablette, le menu devient une barre en bas de l'écran avec le tableau de bord et le module ouvert ; **Plus** ouvre les autres entrées. ## La barre du haut À gauche, la barre affiche le titre de la page. Le champ de recherche ouvre la palette de commandes. À droite, le sélecteur d'environnement passe de **Test** à **Production**, comme l'explique [Passer en Production](https://docs.wajub.com/dashboard/getting-started/test-and-live). Votre avatar ouvre le menu du compte. En Test, une bande en haut de chaque page rappelle « Données de test uniquement. Aucun argent réel ne circule ici. » ## La palette de commandes Ctrl + K, ou Cmd + K sur Mac, ouvre la palette depuis n'importe quelle page. Tapez le nom d'une page, d'une action ou d'un client : la palette propose les pages, les réglages et les données qui correspondent. Un premier caractère restreint la recherche : | Tapez | Pour chercher dans | | ----- | --------------------------------------------------------------------- | | `>` | **Actions** | | `@` | **Membres et organisations** | | `/` | **Rechercher des données** : paiements, clients, transferts, factures | | `?` | **Aide**, qui rappelle ces préfixes | Une entrée réservée à la Production ou absente de votre forfait reste visible avec la raison : **Production uniquement** ou **Pas dans votre forfait**. ## Les raccourcis clavier Les raccourcis s'enchaînent touche après touche. G puis une lettre ouvre un module : G puis P pour **Paiements**, G puis C pour **Clients**, G puis S pour **Paramètres**. C puis une lettre crée quelque chose : C puis L pour **Créer un lien de paiement**, C puis C pour **Ajouter un client**, C puis I pour **Créer une facture**, C puis T pour **Créer un transfert**. Dans le menu, une entrée montre son raccourci au survol, et toutes le montrent dès que vous appuyez sur G. La touche ? ouvre **Raccourcis clavier**, la liste complète. Les raccourcis ne se déclenchent jamais pendant que vous écrivez dans un champ. Si vous utilisez la saisie vocale, désactivez **Utiliser les raccourcis à une touche** dans cette même fenêtre : votre choix est gardé, et Ctrl + K reste actif. En Test, le raccourci d'un module réservé à la Production ne l'ouvre pas : un message indique « Disponible uniquement en production » et ce que vous pouvez faire. ## Langue, thème et devise Le menu du compte regroupe vos réglages personnels. **Langue** choisit le français ou l'anglais pour le tableau de bord et pour les e-mails que Wajub vous envoie ; la langue que vos clients voient au paiement ne change pas. Validez avec **Appliquer**. **Thème** propose **Système**, **Clair** ou **Sombre**. **Devise d'affichage** ajoute, pour vous seul, une conversion à côté des montants principaux de l'accueil ; les montants eux-mêmes ne changent pas. ## Changer d'organisation Si vous êtes membre de plusieurs organisations, cliquez sur le nom en haut du menu. **Vos organisations** les liste, chacune avec son identifiant et son statut ; au-delà de huit, un champ **Rechercher une organisation** apparaît. Choisissez-en une : le tableau de bord s'y ouvre, dans l'environnement où vous l'aviez laissée. Le même menu propose **Créer une organisation** et **Gérer les organisations**. --- # Recevoir un premier transfert URL: https://docs.wajub.com/fr/dashboard/getting-started/first-payout > Les huit étapes entre la création de votre compte Wajub et le premier transfert vers votre numéro Mobile Money ou votre compte bancaire. Cette page suit le chemin complet, de l'inscription au premier transfert vers votre propre compte. Chaque étape renvoie à la page qui la détaille. Tout le monde peut créer un compte et une organisation. Le dossier d'activation est envoyé par le propriétaire, un Administrateur ou un rôle personnalisé qui a **Gérer le compte**. Les liens de paiement, les factures et les transferts ne marchent qu'en Production, donc après l'activation. Ajouter un compte de versement et envoyer un transfert demandent le [code de sécurité](https://docs.wajub.com/fr/dashboard#the-security-code). ## Les étapes 1. **Créez votre compte** Sur **Créez votre compte**, saisissez votre **Nom complet**, votre **E-mail professionnel** et un **Mot de passe**, acceptez les conditions, puis choisissez **Créer un compte gratuit**. Wajub vous envoie un code à six chiffres : saisissez-le dans **Code de vérification**, sur l'écran **Vérifiez votre e-mail**. Le code expire au bout de 10 minutes, et **Renvoyer le code** en envoie un nouveau après une minute d'attente. [Créer son compte](https://docs.wajub.com/dashboard/getting-started/create-account) détaille chaque écran. 2. **Créez votre organisation** **Créez votre organisation** ne demande que le **Nom de l'organisation** : vos clients le voient sur les reçus et les pages de paiement, et vous pourrez le changer plus tard. Après **Créer une organisation**, vous en êtes le propriétaire. Le tableau de bord demande alors **Que voulez-vous faire en premier ?** : pour encaisser sans écrire de code, choisissez **Accepter des paiements avec des liens**. L'organisation démarre en **Test**, où les paiements sont simulés, et **Production** reste verrouillé. L'accueil affiche la liste **Préparez le passage en production**. Si vous avez choisi les liens, elle tient en une étape, la vérification du compte ; les clés API et le paiement de test ne sont demandés qu'à ceux qui branchent Wajub sur un site. [Passer en Production](https://docs.wajub.com/dashboard/getting-started/test-and-live) explique les deux environnements. 3. **Activez votre compte** Ouvrez **Paramètres › Conformité**, puis **Commencer la vérification**. Le dossier passe par votre **Activité commerciale**, les **Détails de l'entreprise**, votre **Présence en ligne**, les **Documents d'entreprise** et les **Personnes** qui dirigent l'entreprise (**Votre identité** avec le type **Individuel (Auto-entrepreneur, Freelance)**). Une fois le dossier envoyé, la page affiche **Votre dossier est en cours d'examen** avec le délai habituel. Quand Wajub valide le dossier, la Production se déverrouille et le sélecteur en haut à droite permet d'y passer. Si le dossier est refusé, la page indique ce qu'il faut corriger et propose **Corriger et soumettre à nouveau**. [Vérifier son entreprise](https://docs.wajub.com/dashboard/activation/verify-business) détaille chaque étape du dossier, et [Suivre sa vérification](https://docs.wajub.com/dashboard/activation/track-verification) chaque statut. Les pièces demandées sont listées dans [Activation du compte et KYC](https://docs.wajub.com/fr/getting-started/account-activation). 4. **Activez vos moyens de paiement** La validation du dossier ouvre la Production, mais ne branche aucun moyen de paiement. Tant qu'aucun n'est actif, l'accueil affiche **Activez vos moyens de paiement** : un lien ou une facture que vous partagez ne peut pas être payé. Passez en **Production**. Si vous avez déjà un compte chez un prestataire de paiement, choisissez **Connecter un fournisseur** et saisissez vos identifiants : il encaisse dès qu'il est connecté. Sinon, choisissez **Demander le rail Wajub** pour encaisser sur les contrats de Wajub (Mobile Money et plus) : vous choisissez vos pays et vos canaux, vous vérifiez les tarifs et vous signez. Wajub examine la demande, et l'accueil affiche **Vos moyens de paiement sont en cours d'examen** en attendant. [Connecter un fournisseur](https://docs.wajub.com/dashboard/orchestration/connect-provider) et [Demander le rail Wajub](https://docs.wajub.com/dashboard/orchestration/rail) détaillent les deux voies. 5. **Créez un lien de paiement ou une facture** En **Production**, ouvrez **Liens de paiement › Créer un lien** pour une page de paiement à partager, ou **Factures › Créer une facture** pour facturer un client précis. [Créer un lien de paiement](https://docs.wajub.com/dashboard/payment-links/create) et [Créer et envoyer une facture](https://docs.wajub.com/dashboard/invoices/create) détaillent chaque écran. 6. **Suivez le paiement** **Paiements** liste chaque paiement avec son statut. Un paiement **Réussi** est encaissé ; **En attente** et **En traitement** attendent encore le client ou l'opérateur. [Cycle de vie d'un paiement](https://docs.wajub.com/fr/payments/lifecycle) explique chaque statut. 7. **Ajoutez un compte de versement** Ouvrez **Paramètres › Transferts › Comptes de versement**, puis **Ajouter un compte de versement** : un numéro Mobile Money ou un compte bancaire. Le formulaire passe par **Pays**, **Méthode**, **Détails** et **Examiner**, et l'enregistrement demande le code de sécurité. Vous ne faites cette étape qu'une fois par compte. 8. **Envoyez votre premier transfert** **Transferts** affiche votre **Solde disponible**. Choisissez **Créer un transfert**, puis le **Compte de versement** et le **Montant**, et **Vérifier le transfert**. Le bouton suivant rappelle la somme, par exemple **Envoyer 150 000 FCFA**, et demande le code de sécurité. Un transfert envoyé ne peut plus être annulé, sauf tant que sa page affiche **En attente du moyen de paiement** : **Annuler le transfert** rend alors son montant à votre solde. Un transfert est traité sous 1 à 3 jours ouvrés selon le moyen de paiement. S'il est retenu pour vérification, sa page affiche **Ce transfert a été signalé et attend une vérification avant de pouvoir partir.** > [!NOTE] > **Quand un paiement devient disponible** > > Un paiement réussi ne rejoint pas tout de suite le **Solde disponible** : il est d'abord réglé, > et l'accueil indique la date à laquelle le montant en attente le sera. > [Solde et règlements](https://docs.wajub.com/fr/payouts/balance) explique ce délai. --- # Passer en Production URL: https://docs.wajub.com/fr/dashboard/getting-started/test-and-live > Quand la Production se déverrouille, comment passer de Test à Production et revenir, et pourquoi chaque membre a son propre environnement. Une nouvelle organisation travaille en **Test**, où les paiements sont simulés. La **Production**, où l'argent circule pour de vrai, se déverrouille quand Wajub a validé la vérification de votre entreprise. Les rôles qui peuvent basculer sont listés dans [Test et Production](https://docs.wajub.com/fr/dashboard#sandbox-and-live), avec les modules et les actions qui n'existent qu'en Production. Un Utilisateur de test, l'un des [rôles](https://docs.wajub.com/fr/dashboard#roles), reste toujours en Test. Les deux environnements existent avec tous les forfaits, et basculer ne demande pas de [code de sécurité](https://docs.wajub.com/fr/dashboard#the-security-code). ## Les étapes 1. **Vérifiez que la Production est déverrouillée** En haut à droite, le sélecteur d'environnement a deux boutons, **Test** et **Production**. Tant que l'organisation n'est pas activée, **Production** porte un cadenas. Cliquez dessus : **Mode production verrouillé** dit où en est la vérification et propose **Commencer la vérification**, **Voir où en est la vérification** pendant l'examen, ou **Examiner la vérification** si le dossier a été rejeté ou si Wajub attend une action de votre part.  *Le bouton mène à Paramètres › Conformité, où se trouve le dossier d'activation.* [Vérifier son entreprise](https://docs.wajub.com/dashboard/activation/verify-business) décrit ce dossier, et [Suivre sa vérification](https://docs.wajub.com/dashboard/activation/track-verification) ce qui se passe une fois envoyé. 2. **Passez en Production** Une fois l'organisation activée, le cadenas disparaît. Choisissez **Production** dans le sélecteur. Si un formulaire ouvert a des modifications non enregistrées, le tableau de bord demande d'abord **Quitter sans enregistrer ?** La page se recharge en Production : la bande de Test disparaît et les modules réservés à la Production reviennent dans le menu. 3. **Revenez en Test quand vous voulez** Choisissez **Test** dans le même sélecteur. La palette de commandes (Ctrl + K) propose aussi **Passer en production** ou **Passer en mode test**, selon l'environnement où vous êtes. ## Un environnement par membre L'environnement est un réglage personnel : passer en Production ne change rien pour les autres membres, qui restent là où ils étaient. Le tableau de bord le retient pour chaque organisation, et vous retrouvez la vôtre dans l'environnement où vous l'avez laissée. Une personne qui rejoint une organisation déjà activée arrive directement en Production. Celles qui étaient membres avant l'activation, vous compris, restent en Test jusqu'à ce qu'elles basculent. ## Quand une page n'existe qu'en Production En Test, un lien vers un module réservé à la Production vous ramène à la page précédente, ou à l'accueil, avec un message comme « Disponible uniquement en production : Factures. » Un raccourci clavier affiche le même message sans changer de page. La suite du message dit quoi faire selon votre situation : | Votre situation | Le message ajoute | | --------------------------------------- | --------------------------------------------------------------------------------------- | | Vous pouvez basculer | « Passez en production pour l'utiliser. » | | Votre rôle ne permet pas de basculer | « Demandez l'accès à la production à un administrateur de votre compte. » | | Vous êtes Utilisateur de test | « Votre rôle est limité à l'environnement de test. » | | L'organisation n'est pas encore activée | « Terminez la vérification de votre compte pour passer en production. » | | La vérification est en cours d'examen | « Votre vérification est en cours d'examen. Nous vous informerons une fois approuvée. » | Si votre dossier a été rejeté ou si Wajub attend une action de votre part, le message renvoie à **Conformité**, comme l'explique [Suivre sa vérification](https://docs.wajub.com/dashboard/activation/track-verification). --- # Retrouver un terme connu URL: https://docs.wajub.com/fr/dashboard/getting-started/vocabulary > Les mots que vous employiez sur une autre plateforme de paiement, ce qu'ils s'appellent dans Wajub et où les trouver dans le tableau de bord. Chaque plateforme de paiement a ses mots. Si vous arrivez d'une autre, cette page fait correspondre ceux que vous connaissez à ceux du tableau de bord, et dit où les trouver. Tout membre peut s'en servir, sur tous les forfaits. Chaque écran reste soumis à son [rôle](https://docs.wajub.com/fr/dashboard#roles), et plusieurs n'existent qu'en [Production](https://docs.wajub.com/fr/dashboard#sandbox-and-live). ## Chercher avec votre mot La recherche connaît ces mots. Ouvrez-la avec Ctrl + K, ou Cmd + K sur Mac, et tapez le vôtre, par exemple `retrait` : la ligne trouvée indique **« retrait » se dit ici « Transferts »**, et Entrée ouvre la page. [Découvrir le tableau de bord](https://docs.wajub.com/dashboard/getting-started/dashboard-tour) présente la recherche. ## L'argent qui entre | Vous disiez | Dans Wajub | Où | | ----------------------------------------------------------- | ------------------------------------------------------------------ | -------------------------------- | | Transaction, encaissement, collecte, pay-in, cash-in, dépôt | Un **paiement** | **Paiements** | | Page de paiement, bouton de paiement, boutique, cagnotte | Un **lien de paiement** | **Liens de paiement** | | Demande de paiement, facture client | Une **facture** | **Factures** | | Chargeback, rétrofacturation, contestation | Un **litige** | **Paiements › Litiges** | | Agrégateur, passerelle, PSP, prestataire | Un **fournisseur** | **Orchestration › Fournisseurs** | | Moyens de paiement, opérateurs Mobile Money | Les **canaux**, ouverts par le rail Wajub ou par votre fournisseur | **Orchestration › Wajub Rail** | Un compte vérifié n'encaisse rien tant qu'aucun fournisseur n'est actif : [Connecter un fournisseur](https://docs.wajub.com/dashboard/orchestration/connect-provider) explique comment brancher le vôtre, et [Demander le rail Wajub](https://docs.wajub.com/dashboard/orchestration/rail) comment encaisser sur les contrats de Wajub si vous n'en avez pas. ## L'argent qui sort | Vous disiez | Dans Wajub | Où | | -------------------------------------------------------------- | --------------------------------------------------------- | -------------------------------------------------- | | Retrait, payout, reversement, décaissement, virement, cash-out | Un **transfert** | **Transferts** | | Compte de retrait, compte de règlement, RIB | Un **compte de versement** : le vôtre | **Paramètres › Transferts › Comptes de versement** | | Destinataire, recipient | Un **bénéficiaire** : le compte d'un tiers que vous payez | **Transferts › Bénéficiaires** | | Reversement automatique, auto-settlement | Les **versements automatiques**, à activer vous-même | **Paramètres › Transferts › Comptes de versement** | | Recharge, top-up, approvisionner le compte | Un **approvisionnement** | **Revenus › Approvisionnement** | Un transfert sert aux deux usages : retirer votre solde vers votre propre compte, ou payer quelqu'un. [Envoyer un transfert](https://docs.wajub.com/dashboard/transfers/send) détaille l'écran. ## Le solde | Vous disiez | Dans Wajub | Où | | --------------------------------- | ------------------------------------------------------------------- | ------------------------------------------ | | Portefeuille, wallet, float | Le **Solde total** | **Tableau de bord**, **Revenus › Soldes** | | Solde retirable | Le **Solde disponible** : ce qu'un transfert peut sortir maintenant | **Transferts**, **Revenus › Soldes** | | Settlement, en cours de règlement | Le solde **En attente** : des paiements réussis, pas encore réglés | **Revenus › Soldes** | | Commission, frais de transaction | Les **Frais** | **Revenus**, et la page de chaque paiement | | Relevé, rapport | Les **Revenus** et leur export | **Revenus** | À côté de ces chiffres, le bouton d'aide (un i dans un cercle) ouvre la définition du terme. [Lire l'accueil](https://docs.wajub.com/dashboard/home/read) explique chaque chiffre de la vue d'ensemble. ## Le compte et l'équipe | Vous disiez | Dans Wajub | Où | | ----------------------------------------------- | -------------------------- | ------------------------------- | | Marchand, compte marchand, entreprise, business | Une **organisation** | **Paramètres › Général** | | KYC, KYB, activation du compte | La **conformité** | **Paramètres › Conformité** | | Équipe, utilisateurs | Les **membres** | **Paramètres › Membres** | | Abonnement, plan, tarifs | Le **forfait** | **Paramètres › Facturation** | | Mode test, sandbox, mode live | **Test** et **Production** | Le sélecteur en haut de la page | | Service client, ticket | L'**assistance** | **Assistance** | ## Les modules au nom propre | Vous disiez | Dans Wajub | Où | | -------------------------------------------------------------- | ----------------- | ------------------------------ | | Routage, bascule entre prestataires | **Orchestration** | **Orchestration** | | Sous-comptes, comptes connectés, marketplace, paiement partagé | **Sync** | **Sync** | | Antifraude, liste noire | **Shield** | **Shield** | | Espace développeur, journaux, console | **Konsole** | **Konsole**, en bas de l'écran | | IPN, callback, URL de notification | Un **webhook** | **Konsole › Webhooks** | | Apikey, clé secrète, identifiants API | Les **clés API** | **Paramètres › Clés API** | Dans le menu, le nom de ces modules affiche au survol une ligne qui dit ce qu'ils font ; sur téléphone, elle est écrite sous le nom dans **Plus**. --- # Contacter l'assistance URL: https://docs.wajub.com/fr/dashboard/help/support > Envoyer une demande à l'équipe Wajub depuis le tableau de bord, suivre ses réponses, puis la clore et noter l'aide reçue. L'équipe Wajub répond dans le tableau de bord : chaque demande devient une conversation que vous suivez dans **Assistance**, en bas du menu (G puis H) et dans le menu du compte. **Centre d'aide**, en haut de la page, ouvre le centre d'aide dans un nouvel onglet. Tous les rôles sauf Utilisateur de test peuvent écrire à l'assistance ; un rôle personnalisé a besoin de **Voir ses propres demandes d'assistance** et de **Créer des demandes d'assistance**. Un membre voit ses propres demandes et celles des collègues qui ont le même rôle que lui ; le propriétaire, les Administrateurs et un rôle personnalisé qui a **Voir toutes les demandes d'assistance** les voient toutes. L'assistance est ouverte à tous les forfaits, et aucun code de sécurité n'est demandé. ## Les étapes 1. **Ouvrez une nouvelle demande** Ouvrez **Assistance** dans le menu, puis **Nouvelle demande**. Le formulaire s'ouvre sur la section **Votre demande**.  *La section Joindre le contexte technique n'apparaît que pour les sujets techniques.* 2. **Choisissez le sujet** Dans **De quoi s'agit-il ?**, choisissez ce qui décrit le mieux votre demande, par exemple **Problème de paiement**, **Retard de versement**, **Intégration API** ou **Question générale**. Donnez ensuite un **Sujet**, jusqu'à 200 caractères. Pendant que vous le tapez, **Ceci répond peut-être déjà à votre question** propose des articles du centre d'aide. 3. **Décrivez le problème** Sous **Décrivez votre problème**, dites ce que vous faisiez, ce que vous attendiez et ce qui s'est passé. **Joindre un fichier**, facultatif, prend un PDF, une image, un CSV ou un fichier texte, jusqu'à 10 Mo. 4. **Joignez le contexte technique** Pour **Problème de paiement**, **Transaction échouée**, **Problème technique**, **Intégration API** et **Terminal de paiement**, la section **Joindre le contexte technique** apparaît. Cochez **Mes dernières erreurs API**, ou donnez l'identifiant d'une transaction ou d'une livraison de webhook. Seul ce que vous indiquez part : codes HTTP, horodatages, identifiants et messages d'erreur, jamais vos clés ni les données de vos clients. 5. **Envoyez la demande** **Envoyer la demande** ouvre la conversation, avec sa **Référence** et le délai de réponse attendu, en heures ouvrées. ## Suivre la conversation Les réponses arrivent dans la conversation, et **Assistance**, dans le menu, compte celles que vous n'avez pas lues. La liste des demandes a deux onglets, **Ouvert** et **Résolu**. Chaque demande affiche sa référence, la date de son dernier message, ses réponses non lues et son statut : **Ouvert**, **En attente de votre réponse** quand l'assistance attend votre réponse, ou **Résolu**. Une demande ouverte en Test porte **Test**, et la demande d'un collègue **Ouverte par** suivi de son nom. Dans la conversation, **Le support est en train d'écrire…** apparaît pendant qu'un agent écrit, et **Vu par le support le** suivi d'une date indique quand l'assistance l'a lue pour la dernière fois. Pour répondre, écrivez votre message sous la conversation, puis **Envoyer**, ou Ctrl+Entrée (⌘+Entrée sur un Mac). **Joindre un fichier** accepte les mêmes fichiers que le formulaire. Un fichier affiche **Analyse en cours…** jusqu'à ce qu'il ait été vérifié, et **Bloqué** s'il est refusé. Un message qui n'a pas pu partir affiche **Non envoyé** : **Renvoyer** l'envoie de nouveau. ## Les réponses par e-mail Une réponse que personne n'a lue dans le tableau de bord quelques minutes plus tard part aussi par e-mail. L'auteur reçoit « Le support a répondu à votre demande *référence* » ; chaque collègue qui a son rôle reçoit « Le support a répondu à la demande *référence* de *nom* », qui dit qui l'a ouverte. L'e-mail, dans votre langue, cite le début de la réponse avec le sujet et la référence de la demande, et **Lire la réponse** ouvre la conversation dans le tableau de bord, dans la bonne organisation. Vous répondez là : la conversation reste dans **Assistance**. Voir toutes les demandes n'apporte pas tous les e-mails : le propriétaire et les Administrateurs ne reçoivent que ceux de leurs propres demandes et des collègues qui partagent leur rôle. ## Suivre la demande d'un collègue Un collègue qui a le même rôle que l'auteur voit la demande, et peut y répondre, la marquer comme résolue ou la rouvrir, comme les siennes : une réponse n'attend pas une personne absente. Un rôle personnalisé sans **Créer des demandes d'assistance** peut lire une demande, mais pas y répondre. ## Clore et noter **Marquer comme résolue** clôt la demande, et **Rouvrir** la rouvre. Une demande résolue passe dans **Résolu** et affiche **Cette demande est résolue. Répondez pour la rouvrir.** : un nouveau message suffit aussi. Une fois la demande résolue, **Comment ça s'est passé ?** vous demande une note de 1 à 5, avec un commentaire facultatif. **Envoyer ma note** l'enregistre. --- # Adapter et exporter l'accueil URL: https://docs.wajub.com/fr/dashboard/home/customize > Choisir les blocs de votre accueil, partir d'un préréglage, et télécharger les chiffres de la période en CSV. Gardez sur l'accueil les blocs qui vous servent, puis téléchargez ses chiffres pour les reprendre ailleurs. Choisir ses blocs est réservé au propriétaire, aux Administrateurs et aux [rôles](https://docs.wajub.com/fr/dashboard#roles) personnalisés qui ont **Gérer les paramètres**, avec tous les forfaits. Chacun enregistre sa propre disposition : elle ne change pas l'accueil des autres membres. Tous les rôles peuvent exporter l'accueil, en [Production](https://docs.wajub.com/fr/dashboard#sandbox-and-live) uniquement. Aucune des deux tâches ne demande le [code de sécurité](https://docs.wajub.com/fr/dashboard#the-security-code). ## Les étapes 1. **Ouvrez Personnaliser** En haut de l'accueil, choisissez **Personnaliser**. **Personnaliser le tableau de bord** s'ouvre. La ligne du jour et les chiffres des paiements restent toujours affichés ; chaque autre bloc a son interrupteur.  *Un interrupteur par bloc, rangés en trois groupes.* 2. **Partez d'un préréglage** Sous **Préréglages**, **Finance** garde les soldes, les pays et la qualité du revenu. **Opérations** garde les tentatives, le volume crédité, les transferts, les fournisseurs, la qualité du revenu et les paiements récents. **Développeur** garde les tentatives, le volume crédité, les transferts, les fournisseurs et les paiements récents, avec **Santé API & webhook**, **Intelligence de routage** et **Métriques avancées**. Le compteur à droite indique combien de blocs sont actifs. 3. **Ajustez les blocs** Activez ou coupez un bloc avec son interrupteur. **Chiffres clés** contient **Solde Wajub**, qui affiche ou masque **Solde total**. **Graphiques** et **Autres sections** contiennent les blocs décrits dans [Lire l'accueil](https://docs.wajub.com/dashboard/home/read#the-blocks), dont **Soldes des fournisseurs**. 4. **Enregistrez** Choisissez **Enregistrer la disposition**. Le message « Préférences des métriques du tableau de bord mises à jour avec succès. » s'affiche, et l'accueil montre vos blocs. **Annuler** ferme le dialogue sans rien changer ; si vous avez changé un interrupteur, **Abandonner les modifications ?** vous demande d'abord de confirmer. Pour revenir plus tard à l'accueil d'origine, rouvrez **Personnaliser**, choisissez **Rétablir par défaut**, puis **Enregistrer la disposition**. ## Exporter l'accueil Choisissez la période dans **Période**, puis **Exporter** › **CSV**. Le fichier se télécharge, et « Votre export est prêt : » s'affiche avec son nom. Il reprend, pour la période choisie, le solde total, disponible et en attente, le volume, le volume net, le nombre de paiements, le taux de réussite, la croissance, le volume et le nombre de transferts, et les frais. Ses intitulés sont en anglais. En Test, **Exporter** n'apparaît pas. Chaque export compte dans la limite mensuelle de votre forfait : [Choisir ou changer de forfait](https://docs.wajub.com/dashboard/subscription/plans). Une fois la limite atteinte, le menu affiche « Vous avez atteint votre limite d'exportation mensuelle. Passez à un forfait supérieur. » et ses formats sont grisés. --- # Lire l'accueil URL: https://docs.wajub.com/fr/dashboard/home/read > Ce que disent les chiffres et les blocs de l'accueil, comment changer de période et ouvrir les paiements qu'un chiffre compte. L'accueil résume votre activité en Production : la journée en cours, votre solde, vos paiements réussis et échoués sur la période choisie, puis des graphiques et des listes. Tous les [rôles](https://docs.wajub.com/fr/dashboard#roles) ouvrent l'accueil. Choisir une période ne demande ni forfait particulier ni [code de sécurité](https://docs.wajub.com/fr/dashboard#the-security-code). En [Test](https://docs.wajub.com/fr/dashboard#sandbox-and-live), un accueil de test le remplace, décrit en bas de page. ## La période **Période**, en haut de l'accueil, propose **Aujourd'hui**, **7 derniers jours**, **30 derniers jours**, **90 derniers jours**, **12 derniers mois**, **Mois en cours**, **Mois dernier** et **Depuis le 1er janvier**, ou les jours de votre choix dans le calendrier, jusqu'à un an en arrière. L'accueil s'ouvre sur les 30 derniers jours. Les chiffres et les blocs suivent la période choisie, sauf la ligne du jour, les soldes, **Paiements récents** et **Activité des transferts**, qui couvre toujours les 30 derniers jours. ## La vue d'ensemble Sous **Vue d'ensemble**, à côté du nom de la période, une première ligne donne la journée en cours : **Volume aujourd'hui**, **Paiements aujourd'hui**, **Échoués aujourd'hui** et **Nouveaux clients aujourd'hui**. Elle se met à jour d'elle-même tant que la page reste ouverte. La ligne suivante couvre la période : - **Solde total** : votre solde, avec la part disponible, la part en attente et le prochain montant attendu avec sa date. Le libellé **mode direct** signale des fonds réglés sur vos propres comptes fournisseurs plutôt que chez Wajub. - **Volume brut** : les paiements crédités sur votre solde, avec le **Volume net** et l'écart en pourcentage « vs période précédente ». Il compte aussi vos approvisionnements, et le dit sous le montant quand il y en a. - **Paiements réussis** : leur nombre, et leur part des tentatives. - **Échoué** : les paiements qui ont échoué.  *La ligne du jour, puis les chiffres de la période choisie.* ## Ouvrir ce qu'un chiffre compte Un chiffre de la vue d'ensemble s'ouvre d'un clic sur la liste qu'il compte, sur la même période. **Volume aujourd'hui**, **Paiements aujourd'hui**, **Volume brut** et **Paiements réussis** ouvrent **Paiements** filtrés sur **Crédités sur le solde**. **Échoués aujourd'hui** et **Échoué** ouvrent les paiements échoués, **Nouveaux clients aujourd'hui** les clients arrivés dans la journée. **Solde total** ouvre [Revenus](https://docs.wajub.com/dashboard/home/revenue). [Trouver un paiement](https://docs.wajub.com/dashboard/payments/find) explique ces filtres. ## Les blocs Sous la vue d'ensemble, l'accueil affiche ces blocs, du haut vers le bas : | Bloc | Ce qu'il montre | | --------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ | | **Tentatives de paiement** | Les paiements réussis et échoués jour après jour, et **Où les paiements s'arrêtent** : les paiements non crédités, par statut. | | **Volume crédité** | Le volume crédité jour après jour, comparé à la période précédente, et sa répartition **Par moyen de paiement**. | | **Activité des transferts** | Le volume de vos transferts jour après jour, par statut, sur les 30 derniers jours. | | **Soldes et performances fournisseurs** | Où se trouvent vos fonds, et le volume, le taux de réussite et le coût de chaque fournisseur. | | **Meilleurs pays** | Les pays d'où viennent vos paiements, avec leur part du volume crédité. | | **Qualité du revenu** | La part du revenu des **Clients récurrents** et des **Nouveaux clients**, et le montant **Remboursé**. | | **Paiements récents** | Vos cinq derniers paiements, avec leur statut. **Tout voir** ouvre **Paiements**. | Trois blocs restent masqués tant que vous ne les ajoutez pas : **Métriques avancées**, **Santé API & webhook** et **Intelligence de routage**. [Adapter et exporter l'accueil](https://docs.wajub.com/dashboard/home/customize) dit comment choisir vos blocs. Au-dessus de la période, des avis signalent ce qui demande votre attention, par exemple un dossier d'activation à compléter, ou une baisse du taux de réussite ou du volume par rapport à la période précédente. ## L'accueil en Test En Test, l'accueil affiche **Solde de test**, le nombre de **Paiements**, de **Clients** et de **Webhooks envoyés**, le **Volume de paiements** des 7 derniers jours et des **Actions rapides** pour lancer une intégration. Une fois votre activation validée, **Passer en production** vous y emmène : [Passer en Production](https://docs.wajub.com/dashboard/getting-started/test-and-live). En Production, tant que votre organisation n'a encore ni paiement, ni client, ni transfert, l'accueil montre à la place les étapes pour démarrer. --- # Suivre ses revenus URL: https://docs.wajub.com/fr/dashboard/home/revenue > Revenu brut et net, frais et remboursements par période, détail de vos soldes et règlements à venir, évolution du solde, et export en Excel ou PDF. **Revenus** montre ce que vos paiements vous ont rapporté, où se trouve votre argent et comment votre solde a évolué. Les montants comptent l'argent encaissé, à la date où il l'a été. Le propriétaire, un Administrateur, un membre Finance, Analyste ou Observateur, ou un [rôle](https://docs.wajub.com/fr/dashboard#roles) personnalisé qui a **Voir les revenus** ouvre **Revenus**, avec tous les forfaits. Comme le rappelle [Test et Production](https://docs.wajub.com/fr/dashboard#sandbox-and-live), le module n'existe qu'en Production. Le lire ou l'exporter ne demande pas de [code de sécurité](https://docs.wajub.com/fr/dashboard#the-security-code). ## Vue d'ensemble Ouvrez **Revenus** dans le menu : **Vue d'ensemble** s'affiche, sur les 30 derniers jours. **Période** propose les mêmes choix que l'accueil, ou les jours de votre choix. Quatre chiffres résument la période : - **Revenu brut** : les paiements crédités sur votre solde. - **Revenus nets** : ce qui reste après remboursements et frais, avec l'écart par rapport à la période précédente de même durée. - **Remboursements** : ce que vous avez rendu à vos clients. - **Frais** : les frais de traitement de la période. **Revenus par canal** répartit le volume entre Mobile Money, cartes et virements bancaires, avec le nombre de paiements et la part de chaque canal. **Revenus par devise** suit, avec le volume de chaque devise. Avec des abonnements actifs, **Revenu récurrent** donne leur nombre, le **Revenu récurrent mensuel (MRR)** et le **Revenu récurrent annuel (ARR)**.  *Les quatre chiffres de la période, puis le volume par canal.* ## Soldes **Soldes** décrit votre argent à l'instant présent, sans période à choisir. **Résumé du solde** donne le **Solde total**, la part **Disponible** pour un transfert, la part **En attente** de règlement et la part **En transit** dans un transfert en cours. **Montants retenus** isole ce qui est **Réservé** pour des litiges, bloqué temporairement ou **Contesté**. Quand des litiges retiennent une partie du solde, **Litiges affectant le solde** le signale, avec **Voir les litiges**. **Frais par type** et **Frais par fournisseur** couvrent les 30 derniers jours. **Règlements estimés** liste, par fournisseur, les fonds crédités récemment qui ne sont pas encore réglés, avec le délai et la **Date estimée** de leur règlement. ## Progressions **Progressions** suit l'évolution de votre solde sur la période choisie. **Regrouper par** découpe le graphique **Progression du solde** par **Jour**, **Semaine** ou **Mois**. Le tableau **Par période** donne, pour chaque tranche, les paiements, les remboursements, les frais, les **Transferts sortants**, la **Variation nette** et le **Solde en fin de période**. ## Exporter un rapport Sur **Vue d'ensemble**, **Soldes** et **Progressions**, **Exporter** propose **Excel** ou **PDF**. Le fichier reprend la page ouverte, avec sa période et, pour **Progressions**, son regroupement. Chaque export compte dans la limite mensuelle de votre forfait : [Choisir ou changer de forfait](https://docs.wajub.com/dashboard/subscription/plans). Le quatrième onglet, **Approvisionnement**, sert à créditer votre solde : [Approvisionner son solde](https://docs.wajub.com/dashboard/home/top-up). --- # Approvisionner son solde URL: https://docs.wajub.com/fr/dashboard/home/top-up > Créditer votre solde Wajub par Mobile Money ou par virement bancaire, envoyer la preuve d'un virement et suivre chaque approvisionnement. Approvisionner votre solde y ajoute de l'argent sans passer par un paiement client, par exemple pour envoyer un transfert avant que vos encaissements soient réglés. Les rôles qui ouvrent [Revenus](https://docs.wajub.com/dashboard/home/revenue) peuvent approvisionner le solde, avec tous les forfaits. Comme **Revenus**, l'approvisionnement n'existe qu'en [Production](https://docs.wajub.com/fr/dashboard#sandbox-and-live). Il ne demande pas de [code de sécurité](https://docs.wajub.com/fr/dashboard#the-security-code). ## Les étapes 1. **Ouvrez l'approvisionnement** Ouvrez **Revenus › Approvisionnement**, puis choisissez **Ajouter des fonds**. La page affiche votre **Solde actuel** et trois étapes : **Méthode**, **Détails** et **Examiner**. 2. **Choisissez la méthode** Sous **Moyen de paiement**, choisissez **Mobile Money** ou **Virement bancaire**, marqué **Validation manuelle** : votre solde n'est crédité qu'après la vérification de votre preuve par Wajub. Le virement bancaire n'apparaît que lorsque Wajub l'accepte. Choisissez **Continuer**.  *Le virement bancaire n'est crédité qu'après vérification de la preuve.* 3. **Indiquez le montant** Pour Mobile Money, choisissez d'abord l'**Opérateur** du téléphone qui paie, rangé par pays. Saisissez le **Montant à ajouter** : 1 000 FCFA au moins, ou leur équivalent dans votre devise. En FCFA, des boutons proposent des montants tout faits. Pour Mobile Money, saisissez le **Numéro de téléphone** qui paie. La **Note**, facultative, reste attachée à l'approvisionnement. Choisissez **Examiner**. 4. **Vérifiez et envoyez** Le récapitulatif reprend la méthode et le montant ; **Modifier les informations** revient en arrière. Choisissez le bouton « Ajouter », suivi du montant. Pour Mobile Money, la page de l'approvisionnement s'ouvre et le téléphone reçoit une demande de paiement de l'opérateur : votre solde est crédité dès que le titulaire du numéro la confirme. Pour un virement, la page de l'approvisionnement s'ouvre sur les instructions de virement. ## Après un virement bancaire Sous **Instructions de virement bancaire**, la page donne le compte Wajub où envoyer le montant : **Motif du virement**, **Nom du compte**, **Banque**, **Numéro de compte**, puis **IBAN** et **SWIFT / BIC** quand le compte en a. Chaque ligne se copie, et **Tout copier** les copie toutes. Recopiez le motif tel quel dans votre virement : c'est lui qui rattache l'argent reçu à votre approvisionnement. Une fois le virement parti, remplissez **Justificatif de virement** sur la même page : **Votre banque**, **Votre numéro de compte ou IBAN** et le **Reçu** émis par votre banque, en PDF, JPG ou PNG de 10 Mo au plus. Choisissez **Envoyer la preuve et notifier Wajub** : l'équipe Wajub vérifie le virement, puis crédite votre solde. ## Suivre un approvisionnement **Revenus › Approvisionnement** liste vos approvisionnements avec leur montant, leur statut, leur méthode et leur date. Au-dessus, la page donne votre **Solde disponible**, le total **Crédité** et le nombre d'approvisionnements **En cours** et **Échoué**. Sur la page d'un approvisionnement, **Disponible à l'envoi** dit quand vous pourrez transférer l'argent. Quand un montant crédité reste bloqué un temps, **Fonds pas encore disponibles pour un transfert** l'indique, avec la date où il se libère. Une **Note de Wajub** s'affiche quand l'équipe en a laissé une. Une fois la preuve d'un virement envoyée, et tant que l'approvisionnement n'est ni crédité ni refusé, **Échanges avec Wajub** vous permet d'écrire à l'équipe et de joindre des fichiers. --- # Corriger ou annuler sa facture URL: https://docs.wajub.com/fr/dashboard/invoices/correct-cancel-refund > Modifier un brouillon, annuler et dupliquer une facture envoyée, réduire ce que doit le client avec un avoir, ou lui rembourser ce qu'il a payé. Un brouillon se modifie librement. Une facture envoyée garde son numéro : pour la corriger, annulez-la et dupliquez-la, ou réduisez ce que doit le client avec un avoir. Le propriétaire, un Administrateur, un membre Finance ou un rôle personnalisé qui a **Gérer les factures** peut le faire. Seul l'avoir demande le [code de sécurité](https://docs.wajub.com/fr/dashboard#the-security-code). ## Modifier un brouillon Sur la page d'un brouillon qui n'a reçu aucun paiement, **Modifier le brouillon** rouvre le formulaire. Une facture envoyée ne se modifie plus. Les brouillons inutiles se suppriment depuis la liste, avec [**Supprimer les brouillons**](https://docs.wajub.com/dashboard/invoices/export-and-bulk#bulk-actions). ## Corriger une facture envoyée 1. **Annulez la facture** Sur la page de la facture, choisissez **Annuler la facture** dans le menu à droite des boutons. Le dialogue **Annuler cette facture ?** rappelle que le client ne pourra plus la payer, qu'aucune relance ne partira et qu'elle garde son numéro. Ce qui a déjà été payé n'est pas remboursé. Confirmez avec **Annuler la facture** : elle passe à **Annulée**, et c'est définitif. 2. **Dupliquez-la** Dans le même menu, **Dupliquer en nouveau brouillon** crée un brouillon avec le même client et les mêmes lignes, et ouvre sa modification avec **Facture dupliquée avec succès**. 3. **Corrigez, puis envoyez le brouillon** Corrigez ce qui doit l'être, puis [envoyez la facture](https://docs.wajub.com/dashboard/invoices/create#after-creating-it) : elle reçoit un nouveau numéro. ## Émettre un avoir Un avoir réduit ce que doit le client sans annuler la facture, par exemple pour un article rendu ou une remise accordée après coup. Il porte un numéro de sa propre série, se télécharge en PDF et ne peut pas être annulé. 1. **Ouvrez Émettre un avoir** Sur la page d'une facture envoyée, choisissez **Émettre un avoir** dans le menu à droite des boutons. Le dialogue s'ouvre. 2. **Saisissez le montant et le motif** Le **Montant à créditer** va jusqu'à ce que la facture représente encore. Le **Motif**, obligatoire, est imprimé sur l'avoir. Sous les champs, le dialogue montre l'effet sur la facture : **Statut de la facture ensuite**, **Crédité au total** et **Montant dû ensuite**.  *Le dialogue montre l'effet de l'avoir avant de l'émettre.* 3. **Choisissez de l'envoyer** **Envoyer au client** l'envoie par e-mail, avec le PDF en pièce jointe. Si la facture n'a pas d'adresse e-mail, remettez vous-même le PDF de l'avoir au client. 4. **Émettez l'avoir** Cliquez sur « Émettre un avoir de » suivi du montant, puis saisissez le code de sécurité. Un message confirme le numéro de l'avoir, qui apparaît sous **Avoirs** sur la page de la facture, avec son PDF. Ensuite, la facture affiche **Partiellement créditée** et ne demande plus que son montant dû. Si l'avoir couvre ce qui restait dû après un paiement partiel, elle passe à **Payée**. Créditée en totalité, elle passe à **Annulée** si rien n'avait été payé, à **Remboursé** sinon : rendez alors l'argent au client comme ci-dessous. ## Rembourser le client Un avoir ne rend pas d'argent. Pour rendre ce que le client a payé en ligne, ouvrez le paiement depuis **Historique** avec **Ouvrir le paiement**, puis [remboursez-le](https://docs.wajub.com/dashboard/payments/refund). Une fois ses paiements en ligne remboursés en totalité, la facture passe à **Remboursé**, sauf si un paiement y a été enregistré à la main. Un paiement reçu hors de Wajub se rend hors de Wajub. --- # Créer et envoyer une facture URL: https://docs.wajub.com/fr/dashboard/invoices/create > Facturer un client précis depuis le tableau de bord, du client aux lignes et aux conditions de paiement, puis l'envoyer par e-mail avec son PDF et son lien de paiement. Une facture s'adresse à un client précis : il la reçoit par e-mail, avec le PDF et un lien pour la payer en ligne. Le propriétaire, un Administrateur, un membre Finance ou un rôle personnalisé qui a **Gérer les factures** peut créer et envoyer une facture. Le forfait **Pay as you go** permet 10 factures en tout ; **Growth** et les forfaits au-dessus n'ont pas de limite. Aucun code de sécurité n'est demandé, sauf pour émettre un avoir. ## Les étapes 1. **Ouvrez le formulaire** En **Production**, ouvrez **Factures**, puis **Créer une facture**. Le formulaire passe par quatre étapes : **Client**, **Lignes**, **Paiement** et **Examiner**. **Continuer** vérifie chaque étape avant de passer à la suivante et signale le champ à corriger. 2. **Choisissez le client** Sous **Pour qui est-elle ?**, cherchez un client existant dans **Client de votre répertoire** par son nom ou son e-mail : le choisir remplit les champs. Sinon, saisissez son **Nom**, seul champ obligatoire, et si besoin son **E-mail**, le **Nom de l'entreprise**, son **Téléphone** et son **Adresse**. Sans e-mail, la facture ne peut pas lui être envoyée par Wajub.  *Un client saisi avec un e-mail ou un téléphone rejoint votre répertoire.* 3. **Ajoutez les lignes** Sous **Que facturez-vous ?**, choisissez la **Devise**, puis remplissez chaque ligne : **Nom de l'article**, **Quantité** et **Prix unitaire** sont obligatoires, **Description** et **Unité** facultatives. **Taxe et remise** règle la taxe et la remise de la ligne, et **Ajouter une ligne** en ajoute une autre. Sous les lignes, **Remise sur la facture** et **Livraison** s'appliquent à toute la facture. Le **Résumé**, à droite, suit le total.  *Le Résumé se met à jour à chaque ligne.* 4. **Fixez les conditions de paiement** Sous **Quand et comment est-elle payée ?**, laissez **Numéro de facture** vide pour que la facture reçoive le numéro suivant de votre séquence à l'envoi. Les **Conditions de paiement**, de **Payable à réception** à 90 jours, calculent la **Date d'échéance** à partir de la **Date de facture**. Sous **Comment le client paie**, choisissez **En un seul paiement**, ou **En plusieurs échéances** pour [répartir le total sur 2 à 12 dates](https://docs.wajub.com/dashboard/invoices/installments). Plus bas, **Facture récurrente** [émet une copie de la facture](https://docs.wajub.com/dashboard/invoices/recurring) à chaque date choisie : seuls le propriétaire et les Administrateurs la voient, à partir du forfait **Growth**. Les **Notes**, les **Conditions générales** et le **Pied de page** sont imprimés sur la facture, et **Moyens de paiement** limite ceux que le client se voit proposer.  *La date d'échéance suit les conditions de paiement.* 5. **Vérifiez, puis créez la facture** **Vérifier la facture** reprend le client, les lignes, le paiement et le total. Sous **Ce qui va se passer**, choisissez **Enregistrer en brouillon** pour la garder modifiable, ou **La créer et l'envoyer par e-mail** pour l'envoyer tout de suite au client. Le bouton devient **Enregistrer le brouillon** ou **Créer et envoyer**.  *Une facture envoyée reçoit son numéro et ne peut plus être modifiée.* La page de la facture s'ouvre avec **Facture créée et envoyée avec succès**, ou **Facture créée avec succès** pour un brouillon. ## Ce que reçoit le client Le client reçoit un e-mail avec la facture en PDF et un bouton **Payer en ligne**, qui ouvre sa page de paiement sur invoice.wajub.com, ou sur votre domaine si vous en avez choisi un dans [**Paramètres › Factures › Adresse des factures**](https://docs.wajub.com/dashboard/invoices/settings#invoice-address). Quand la facture a une date d'échéance, il reçoit aussi des [rappels par e-mail](https://docs.wajub.com/dashboard/invoices/track-and-remind#automatic-reminders), qui s'arrêtent dès qu'elle est payée ou annulée. ## Après la création Sur la page d'un brouillon, **Envoyer la facture** l'envoie et **Modifier le brouillon** le reprend. Si le client n'a pas d'e-mail, **Envoyer la facture** n'apparaît pas : modifiez le brouillon pour en ajouter un, ou choisissez **Émettre sans e-mail** dans le menu à droite des boutons. La facture est alors numérotée sans rien envoyer, et vous transmettez vous-même le PDF ou le lien de paiement. Une facture envoyée ne se modifie plus. **Renvoyer** envoie à nouveau l'e-mail, et **Télécharger le PDF** ou **Copier le lien de paiement** permettent de la transmettre autrement. Pour [corriger une erreur](https://docs.wajub.com/dashboard/invoices/correct-cancel-refund#correct-a-sent-invoice), choisissez **Annuler la facture** dans le menu, puis **Dupliquer en nouveau brouillon** : une facture émise garde son numéro et ne peut pas être supprimée. > [!NOTE] > **Une facture commencée reste sur cet appareil** > > Tant que la facture n'est pas créée, ce que vous saisissez est gardé dans ce navigateur. Au > prochain **Créer une facture**, le formulaire vous propose **La reprendre** ou > **L'abandonner**. Un autre navigateur ou une navigation privée ne la retrouve pas. --- # Agir sur plusieurs factures URL: https://docs.wajub.com/fr/dashboard/invoices/export-and-bulk > Sélectionner des factures dans la liste pour les envoyer, les annuler, supprimer des brouillons ou les exporter d'un coup, et exporter toute la liste filtrée. Depuis la liste **Factures**, vous pouvez envoyer, annuler, supprimer ou exporter jusqu'à 100 factures à la fois, ou exporter toute la liste avec ses filtres. Le propriétaire, un Administrateur, un membre Finance ou un rôle personnalisé qui a **Gérer les factures** voit les cases de sélection et le bouton **Exporter**. Aucun code de sécurité n'est demandé. Le forfait **Pay as you go** compte 10 exports par mois, tous exports du tableau de bord confondus, et **Growth** et les forfaits au-dessus n'ont pas de limite. ## Les actions groupées 1. **Sélectionnez les factures** Dans **Factures**, filtrez la liste si besoin, puis cochez la case de chaque facture. Une barre apparaît en bas de l'écran avec le nombre de factures choisies. Au-delà de 100, elle affiche « Jusqu'à 100 à la fois. » et ses actions restent grisées.  *Entre parenthèses, le nombre de factures concernées par l'action.* 2. **Choisissez l'action** La barre ne propose que les actions qui s'appliquent à la sélection, avec entre parenthèses le nombre concerné quand ce ne sont pas toutes les factures choisies. **Envoyer** numérote les brouillons et les envoie par e-mail aux clients qui ont une adresse, comme [un envoi seul](https://docs.wajub.com/dashboard/invoices/create#after-creating-it). **Annuler les factures** porte sur celles qui ne sont ni payées, ni annulées, ni remboursées : ce qui a déjà été payé n'est pas remboursé, et c'est définitif. **Supprimer les brouillons** efface les brouillons qui n'ont reçu aucun paiement. 3. **Confirmez** Le dialogue rappelle ce que l'action va faire, puis confirmez avec **Envoyer les factures**, **Annuler les factures** ou **Supprimer les brouillons**. Un message donne le nombre de factures traitées, par exemple « 2 factures traitées. », et la sélection se vide. ## Exporter les factures **Exporter**, en haut de la liste, ouvre **Exporter les factures** : le fichier contient les factures que la liste affiche avec ses filtres, rappelés sous **Filtres conservés**. Choisissez le **Format**, **CSV**, **Excel**, **PDF** ou **JSON**, et si besoin une période de dates de facture avec le bouton **Date** sous **Période** : une période prête comme **30 derniers jours**, ou une **Période personnalisée**. Sans période, toutes les dates sont exportées. Puis **Exporter en CSV**, **Exporter en Excel**, **Exporter en PDF** ou **Exporter JSON**, selon le format. Le fichier se télécharge, et « Votre export est prêt » donne son nom. Les avoirs ne sont pas exportés. Pour n'exporter que certaines factures, sélectionnez-les, puis **Exporter** dans la barre du bas : **Exporter les factures sélectionnées** reprend seulement celles-là, sans période. Une fois les exports du mois utilisés, le dialogue l'indique. Un membre qui a **Gérer le compte** voit **Passer à un forfait supérieur** ; les autres sont invités à s'adresser au propriétaire de l'organisation, et seul **Fermer** s'affiche. --- # Faire payer en plusieurs fois URL: https://docs.wajub.com/fr/dashboard/invoices/installments > Répartir le total d'une facture sur 2 à 12 échéances, chacune avec sa date et son montant, puis suivre celles que le client a payées. Une facture en plusieurs échéances garde un seul total, réparti sur 2 à 12 dates : le client paie chaque échéance à sa date. Les échéances se fixent en [créant une facture](https://docs.wajub.com/dashboard/invoices/create), avec les mêmes droits : le propriétaire, un Administrateur, un membre Finance ou un rôle personnalisé qui a **Gérer les factures**. Tous les forfaits les proposent, et aucun code de sécurité n'est demandé. Une fois la facture envoyée, l'échéancier ne change plus. ## Les étapes 1. **Choisissez le paiement en plusieurs échéances** Dans le formulaire de facture, à l'étape **Paiement**, choisissez **En plusieurs échéances** sous **Comment le client paie**. Deux échéances apparaissent, chacune avec la moitié du total : la première à la **Date de facture**, la seconde 30 jours plus tard. 2. **Fixez le nombre d'échéances** Choisissez de 2 à 12 échéances dans **Nombre d'échéances**. Chaque échéance ajoutée tombe 30 jours après la précédente, et le total est de nouveau réparti à parts égales. 3. **Ajustez les dates et les montants** Modifiez la **Date d'échéance** et le **Montant** de chaque échéance. La dernière prend le reste du total : son montant se calcule seul, et **Répartir à parts égales** remet des montants égaux. Chaque échéance tombe à la date de facture ou après, et pas avant la précédente. Si les montants dépassent le total, un message vous demande d'en baisser un.  *La dernière échéance prend le reste du total.* 4. **Créez la facture** La **Date d'échéance** de la facture devient celle de la dernière échéance : le statut **En retard** et les rappels suivent cette date. Continuez jusqu'à **Examiner**, puis enregistrez le brouillon ou envoyez la facture. ## Suivre les échéances Sur la page de la facture, la section **Échéances** indique combien sont payées, par exemple « 1 échéance payée sur 3 », puis chaque échéance avec sa date, son montant et son statut : **Payée**, **En attente** ou **En retard**. Dès qu'une échéance est réglée, la facture passe à **Partiellement payé**, puis à **Payée** avec la dernière. Un paiement reçu hors de Wajub, [enregistré à la main](https://docs.wajub.com/dashboard/invoices/record-payment), règle les échéances dans l'ordre. ## Ce que voit le client Sur sa page de paiement, le client règle une échéance à la fois, la première qui reste à payer. --- # Enregistrer un paiement reçu URL: https://docs.wajub.com/fr/dashboard/invoices/record-payment > Ajouter à une facture un paiement reçu hors de Wajub, en espèces ou par virement, pour tout le solde ou une partie, ou la marquer comme payée en un clic. Quand un client vous règle hors de Wajub, en espèces ou par virement, enregistrez ce paiement sur sa facture : le montant dû baisse, et rien n'est débité au client. Le propriétaire, un Administrateur, un membre Finance ou un rôle personnalisé qui a **Gérer les factures** peut enregistrer un paiement, sur tous les forfaits. Aucun code de sécurité n'est demandé. ## Les étapes 1. **Ouvrez la facture** Dans **Factures**, ouvrez la facture. **Enregistrer le paiement** apparaît en tête tant qu'il reste un montant dû, même sur un brouillon, pour un client qui paie avant l'envoi. 2. **Choisissez le montant reçu** Cliquez sur **Enregistrer le paiement** : le dialogue **Enregistrer un paiement** s'ouvre. Sous **Montant reçu**, choisissez **Tout le solde**, ou **Une partie** puis saisissez le **Montant**, jusqu'au montant dû. 3. **Datez le paiement** **Reçu le** propose la date du jour : changez-la si l'argent est arrivé plus tôt, sans remonter avant la création de la facture. **Moyen de paiement** et **Notes** sont facultatifs, et les notes ne sont visibles que de vos membres.  *Le bouton reprend le montant enregistré.* 4. **Enregistrez le paiement** Le bouton reprend le montant, par exemple « Enregistrer 174 000 FCFA ». Pour tout le solde, la facture passe à **Payée** avec **Facture marquée comme payée**. Pour une partie, elle passe à **Partiellement payé** avec « Paiement enregistré. Le reste de la facture reste dû. ». Le paiement apparaît dans **Historique**, avec son moyen et ses notes. Sur une facture en plusieurs échéances, le paiement règle les [échéances](https://docs.wajub.com/dashboard/invoices/installments#track-the-installments) dans l'ordre. ## Marquer comme payée Sur une facture envoyée, **Marquer comme payée** enregistre d'un coup tout le montant dû, reçu hors de Wajub et daté d'aujourd'hui. Confirmez dans **Marquer cette facture comme payée ?** : la facture passe à **Payée**. ## Ce que voit le client Le client ne reçoit aucun message : sa page de paiement ne lui demande plus que ce qui reste dû. --- # Créer une facture récurrente URL: https://docs.wajub.com/fr/dashboard/invoices/recurring > Faire préparer une copie d'une facture chaque jour, semaine, mois, trimestre ou année, l'envoyer après vérification, et arrêter la série quand elle n'a plus lieu d'être. Une facture récurrente prépare une nouvelle facture pour le même client à chaque période, avec les mêmes lignes : vous la vérifiez, puis vous l'envoyez. Seuls le propriétaire et les Administrateurs rendent une facture récurrente, à partir du forfait **Growth** : pour les autres, l'option n'apparaît pas dans le formulaire. Arrêter une série est ouvert à tous ceux qui peuvent [créer une facture](https://docs.wajub.com/dashboard/invoices/create). Aucun code de sécurité n'est demandé. ## Les étapes 1. **Commencez une facture** Ouvrez **Factures**, puis **Créer une facture**, et remplissez le client et les lignes comme pour [une facture ponctuelle](https://docs.wajub.com/dashboard/invoices/create). Saisissez l'**E-mail** du client : sans lui, aucune copie ne pourra lui être envoyée. Saisi sans e-mail ni téléphone, le client n'entre pas dans votre répertoire et aucune copie n'est préparée. 2. **Activez Facture récurrente** À l'étape **Paiement**, plus bas, activez **Facture récurrente**. Trois champs apparaissent : **Fréquence**, **Première copie le** et **Dernière copie au plus tard le**. 3. **Choisissez le rythme** Choisissez la **Fréquence**, de **Chaque jour** à **Chaque année**. Sans **Première copie le**, la première copie arrive une période après la **Date de facture**. Sans **Dernière copie au plus tard le**, la série continue jusqu'à ce que vous l'arrêtiez.  *Les deux dates sont facultatives.* 4. **Créez la facture** Terminez avec **Examiner**, puis créez la facture. Sur sa page, **Détails de la facture** affiche **Récurrent** avec la fréquence et la date de la prochaine copie. ## Chaque copie À chaque date, une nouvelle facture apparaît dans **Factures** en **Brouillon**, datée de ce jour, avec les lignes, la devise et les notes de la facture d'origine, et le client tel qu'il est alors dans votre répertoire. Rien ne part tout seul : filtrez la liste sur le **Statut** **Brouillon**, vérifiez chaque copie, puis **Envoyer la facture**. Si la préparation d'une copie échoue, une notification vous prévient. Si votre forfait ne comprend plus les factures récurrentes, les copies s'interrompent, et reprennent quand vous repassez à [**Growth** ou au-dessus](https://docs.wajub.com/dashboard/subscription/plans). ## Arrêter la série Sur la page de la facture d'origine, choisissez **Arrêter la récurrence** dans le menu à droite des boutons, puis confirmez. Plus aucune copie n'est préparée, celles déjà créées restent telles quelles, et **Récurrent** disparaît de **Détails de la facture**. L'option n'existe que sur la facture d'origine, pas sur ses copies. [Annuler la facture d'origine](https://docs.wajub.com/dashboard/invoices/correct-cancel-refund) arrête aussi la série. --- # Paramétrer les factures URL: https://docs.wajub.com/fr/dashboard/invoices/settings > Choisir l'adresse où les clients ouvrent leurs factures, la numérotation, et le délai de paiement, la façon de payer et la devise de chaque nouvelle facture. **Paramètres › Factures** donne l'adresse de vos factures, leur numérotation, ce avec quoi commence chaque nouvelle facture et les rappels envoyés à vos clients. Le propriétaire, un Administrateur ou un rôle personnalisé qui a **Gérer les paramètres** modifie ces réglages. Aucun code de sécurité n'est demandé. ## Adresse des factures Le **Domaine** est l'adresse où vos clients ouvrent et paient leurs factures : par défaut « L'adresse de Wajub (invoice.wajub.com) ». Pour utiliser la vôtre, [ajoutez et vérifiez un domaine](https://docs.wajub.com/dashboard/settings/custom-domains) pour les factures, puis choisissez-le dans la liste. ## Numérotation Une facture reçoit son numéro à l'envoi : les brouillons n'en ont pas. Choisissez le **Préfixe** (lettres, chiffres, tirets et tirets bas), le **Format**, avec ou sans l'année, et le **Prochain numéro**. **Prochain numéro de facture** montre le résultat, par exemple INV-2026-0001. Un numéro déjà donné est sauté.  *L'aperçu suit le préfixe, le format et le prochain numéro.* Avec un format qui affiche l'année, **Repartir de 1 chaque année** donne le numéro 1 à la première facture envoyée dans une nouvelle année. Le préfixe ne peut pas être celui des avoirs, AV-, pour que factures et avoirs gardent chacun leur série. ## Paiement Ces valeurs remplissent chaque nouvelle facture, qui peut les changer. Le **Délai de paiement (jours)**, de 1 à 365, place la date d'échéance après la date de facture. **Comment les clients paient** choisit la façon de payer proposée, et **Devise** la devise de départ. ## Rappels **Envoyer les relances automatiquement** écrit à vos clients au sujet de leurs factures encore dues, pour les factures qui ont une échéance, jusqu'à ce qu'elles soient payées en entier ou annulées. Une fois l'interrupteur activé, cochez les jours sous **Avant l'échéance** et **Après l'échéance** : 1, 3, 7 ou 14 jours. Tant que vous n'avez pas enregistré votre choix, le formulaire montre l'interrupteur activé, avec 7, 3 et 1 jours avant l'échéance et 1 et 7 jours après. Chaque rappel apparaît dans l'[**Historique**](https://docs.wajub.com/dashboard/invoices/track-and-remind#automatic-reminders) de la facture. ## Enregistrer Une barre apparaît en bas dès qu'un réglage change : **Enregistrer les modifications** enregistre toutes les sections modifiées, **Abandonner** les remet comme avant. Si un champ est refusé, il s'affiche en rouge avec la raison. --- # Suivre et relancer une facture URL: https://docs.wajub.com/fr/dashboard/invoices/track-and-remind > Retrouver une facture, lire son statut et ce qu'il reste à payer, suivre les rappels envoyés au client et lui renvoyer la facture. La liste **Factures** et la page de chaque facture montrent ce que vos clients ont payé et ce qu'ils doivent encore. Le client est relancé par e-mail, et vous pouvez lui renvoyer la facture à tout moment. Tous les rôles qui lisent les factures ([Rôles](https://docs.wajub.com/fr/dashboard#roles)) suivent leur statut. **Renvoyer** demande **Gérer les factures**, comme [la création](https://docs.wajub.com/dashboard/invoices/create). Aucun code de sécurité n'est demandé. ## Trouver une facture En haut de **Factures**, quatre chiffres résument l'activité : **Factures**, **Facturé**, **Payée** et **En retard**. Cherchez une facture dans le champ **Numéro, client ou e-mail**, et filtrez par **Date de facture**, **Statut**, **Client**, **Date d'échéance**, **Montant** ou **Récurrent**. Les avoirs ne figurent pas dans la liste : ils sont sur la page de leur facture. | Statut | Ce qu'il veut dire | | ---------------------- | -------------------------------------------------------------------------------- | | **Brouillon** | Pas encore envoyée : sans numéro, encore modifiable. | | **Envoyée** | Numérotée et payable, pas encore ouverte par le client. | | **Vu** | Le client a ouvert sa page de paiement. | | **Partiellement payé** | Une partie est payée, le reste est dû. | | **Payée** | Réglée en totalité. | | **En retard** | La date d'échéance est passée et il reste un montant dû. | | **Annulée** | Le client ne peut plus la payer. | | **Remboursé** | Ce qui a été payé en ligne est remboursé en totalité, ou des avoirs le couvrent. | ## Lire la page d'une facture En tête, la page donne le client, la **Date d'échéance** et le **Montant dû**. Une facture en retard affiche **Cette facture est en retard**, avec le montant et la date où il était dû. À droite, **Paiement** répartit le total entre ce qui est payé, crédité et dû, et **Lien de paiement** donne le lien de paiement, avec **Copier**.  *Une facture en retard le signale sous son en-tête.* **Historique** retrace les paiements, les rappels et chaque version de la facture, du plus ancien au plus récent. **Télécharger en CSV** en exporte les paiements. ## Les rappels automatiques Quand une facture envoyée a une date d'échéance, le client reçoit des rappels par e-mail aux jours réglés sous [**Rappels**](https://docs.wajub.com/dashboard/invoices/settings#reminders) dans **Paramètres › Factures**, jusqu'à ce qu'elle soit payée en entier ou annulée. Après un paiement partiel, ils continuent pour ce qu'il reste à payer. Chaque rappel, prévu ou parti, apparaît dans **Historique** avec son type et son statut. Pour une facture en plusieurs échéances, les rappels suivent la [dernière échéance](https://docs.wajub.com/dashboard/invoices/installments). ## Renvoyer la facture Sur la page d'une facture envoyée et pas encore réglée, **Renvoyer** envoie de nouveau l'e-mail de la facture au client. Le dialogue rappelle son adresse ; confirmez avec **Renvoyer**, et **E-mail de facture renvoyé avec succès** s'affiche. Rien d'autre ne change sur la facture. Pour la transmettre autrement, **Télécharger le PDF**, en tête de page, ou **Copier le lien de paiement**, dans le menu à droite des boutons. --- # Créer une alerte URL: https://docs.wajub.com/fr/dashboard/orchestration/alerts > Prévenir vos membres par e-mail quand le taux de réussite, le volume ou les webhooks de vos paiements franchissent un seuil, ou quand l'acceptation d'un fournisseur passe sous son niveau habituel, puis suivre les alertes déclenchées. Une alerte surveille un indicateur de vos paiements et prévient vos membres par e-mail quand il franchit un seuil, par exemple une baisse du taux de réussite sur MTN Mobile Money. Le propriétaire, un Administrateur, un Développeur ou un rôle personnalisé qui a **Gérer les paramètres** ou **Gérer les paramètres développeur** crée les alertes ; **Voir les paramètres** suffit pour les lire. Les alertes font partie de tous les forfaits, sauf **Acceptation sous son niveau habituel**, qui vient avec les forfaits **Growth**, **Scale** et **Enterprise**. Elles ne surveillent que la [Production](https://docs.wajub.com/fr/dashboard#sandbox-and-live). Aucun code de sécurité n'est demandé. ## Les étapes 1. **Ouvrez le dialogue** En **Production**, ouvrez **Orchestration**, l'onglet **Alertes**, puis **Créer l'alerte**. Le dialogue **Créer l'alerte** s'ouvre. 2. **Nommez l'alerte** Saisissez un **Nom** que vos membres reconnaîtront dans l'e-mail, par exemple « Taux de réussite de MTN Cameroun ». 3. **Choisissez l'indicateur** Sous **Métrique**, choisissez ce que l'alerte mesure, comme le **Taux de réussite**, le **Taux d'erreur**, le **Nombre de transactions**, le **Volume**, le **Taux de livraison des webhooks**, le **Nombre d'échecs de webhook**, le **Taux d'abandon du tunnel** ou l'**Acceptation sous son niveau habituel**, qui vous prévient quand un fournisseur accepte moins de paiements que d'habitude sur un canal. Sur un autre forfait, celle-ci affiche **Pas dans votre forfait**. 4. **Fixez le seuil** Réglez la **Condition**, par exemple « descend sous », le **Seuil**, puis la **Fenêtre** sur laquelle l'indicateur est calculé : 5 minutes, 15 minutes, 1 heure ou 24 heures. Pour **Acceptation sous son niveau habituel**, réglez à la place la **Baisse d'au moins**, en points sous le niveau habituel, et les **Tentatives minimum** en dessous desquelles rien n'est comparé. 5. **Choisissez ce qu'elle surveille** Sous **Ce qu'elle surveille**, gardez **Tous les paiements**, ou limitez l'alerte à **Un fournisseur**, **Un canal** ou **Une règle de routage**. Seuls le taux de réussite, le taux d'erreur, le nombre de transactions et le volume se limitent ainsi ; les alertes sur les webhooks et l'abandon couvrent tout votre compte. **Acceptation sous son niveau habituel** surveille **Tous les fournisseurs et canaux**, **Un fournisseur** ou **Un canal**. 6. **Choisissez les destinataires** Sous **Destinataires**, vous figurez déjà ; cliquez sur **En ajouter** pour choisir d'autres membres : seuls les membres de votre organisation peuvent recevoir l'e-mail. Sans destinataire, l'alerte est seulement enregistrée sur la page. Le **Délai de répit**, de 5 à 1 440 minutes, l'empêche de se déclencher de nouveau trop tôt ; pour **Acceptation sous son niveau habituel**, il compte pour chaque fournisseur et canal, une fois revenu à la normale.  *Seuls les membres de l'organisation peuvent recevoir une alerte.* 7. **Créez l'alerte** Laissez **Actif** activé, puis cliquez sur **Créer l'alerte**. Le message **Règle d'alerte créée.** s'affiche, et l'alerte rejoint les **Définitions d'alertes**. ## Après la création Une alerte active est vérifiée toutes les 5 minutes. Quand elle franchit son seuil, ses destinataires reçoivent un e-mail, puis elle reste silencieuse pendant son délai de répit. **Alertes récentes** liste les derniers déclenchements, et chaque alerte affiche son **Dernier déclenchement**. Si une alerte active ne prévient personne, un avertissement le signale en haut de la page. [Alertes](https://docs.wajub.com/fr/orchestration/analytics#alerts) détaille ce que compte chaque indicateur. Une alerte **Acceptation sous son niveau habituel** affiche aussi les fournisseurs et canaux sous leur niveau habituel, et sa **Dernière vérification**. Sur un forfait qui ne la comprend pas, elle est marquée **Pas dans votre forfait** et n'est pas vérifiée ; vous pouvez toujours la désactiver ou la supprimer. Le menu d'une alerte propose **Modifier l'alerte**, **Désactiver l'alerte**, qui la garde sans plus la vérifier, et **Supprimer l'alerte**, qui demande confirmation : ses déclenchements passés restent listés. --- # Définir une politique de canal URL: https://docs.wajub.com/fr/dashboard/orchestration/channel-policies > Choisir comment Wajub classe vos fournisseurs sur un canal d'opérateur, par acceptation, coût ou rapidité, avec un ordre fixe et des garde-fous, depuis la matrice de routage. Une politique de canal classe vos fournisseurs sur un canal d'opérateur, comme MTN Mobile Money au Cameroun, pour chaque paiement qu'aucune règle de routage ne capte. Sans politique, c'est la priorité de chaque connexion qui décide. Le propriétaire, un Administrateur, un Développeur ou un rôle personnalisé qui a **Gérer les paramètres** ou **Gérer les paramètres développeur** définit une politique ; **Voir les paramètres** suffit pour lire la matrice. Les politiques font partie de tous les forfaits et n'existent qu'en [Production](https://docs.wajub.com/fr/dashboard#sandbox-and-live). Aucun code de sécurité n'est demandé. ## Les étapes 1. **Ouvrez la matrice** En **Production**, ouvrez **Orchestration**, puis l'onglet **Matrice**. Sous **Canaux opérateurs**, chaque canal montre ses routes, une par fournisseur qui le sert. Les **Méthodes de paiement mondiales**, comme la carte, n'ont pas de politique. 2. **Ouvrez la politique du canal** Cliquez sur **Définir une politique** au bout de la ligne du canal, ou sur **Modifier la politique** s'il en a déjà une. Le dialogue **Politique du canal** s'ouvre, titré avec le nom du canal, par exemple MTN CM. 3. **Choisissez l'objectif** Dans **Objectif de routage**, **Acceptation maximale** place en tête le fournisseur qui réussit le plus de paiements sur cet opérateur, **Coût le plus bas** le moins cher, d'après les frais saisis sur chaque connexion, et **Le plus rapide** celui qui répond le plus vite. 4. **Fixez un ordre, si besoin** Avec au moins deux connexions sur le canal, activez **Ordre de cascade fixe** : la liste des connexions s'affiche, et **Monter** et **Descendre** règlent l'ordre dans lequel elles sont essayées, avant que l'objectif classe les autres. 5. **Posez des garde-fous** Sous **Garde-fous**, une connexion sous la **Santé minimale**, de 0 à 100 %, ou au-dessus du **Plafond de coût**, en frais par paiement dans la devise du paiement, passe après les autres. Elle n'est jamais écartée.  *Une règle de routage qui correspond au paiement passe toujours avant la politique.* 6. **Enregistrez la politique** Laissez **Actif** activé, puis cliquez sur **Enregistrer la politique**. Un message confirme l'enregistrement, et la ligne du canal affiche un badge qui résume la politique. ## Ce que la politique décide La politique ne vaut que pour son canal, et seulement pour les paiements qu'aucune [règle de routage](https://docs.wajub.com/dashboard/orchestration/routing-rules) n'a captés. Elle y remplace la priorité de vos connexions. Une politique dont vous désactivez **Actif** est gardée, et la priorité reprend la main. [L'instruction la plus précise passe en premier](https://docs.wajub.com/fr/orchestration#the-most-specific-instruction-goes-first) détaille cet ordre. Pour revenir à la priorité des connexions, rouvrez la politique et cliquez sur **Retirer la politique**, puis confirmez. ## Lire la matrice Chaque ligne porte un diagnostic, comme **Opérationnel**, **Opérateur hors service**, **Problème d'agrégateur**, **Chemin unique** ou **Aucune donnée**, et chaque route son taux de réussite et l'état de son circuit. **Collecte** et **Transfert**, en haut, changent d'opération, et **Actualiser** recharge les chiffres. [La matrice et le diagnostic qu'elle permet](https://docs.wajub.com/fr/orchestration/analytics#the-matrix-and-the-diagnosis-it-enables) dit quoi faire d'une ligne ou d'une cellule rouge. --- # Connecter un fournisseur URL: https://docs.wajub.com/fr/dashboard/orchestration/connect-provider > Connecter votre propre compte chez un fournisseur de paiement, régler sa priorité et ses frais, coller son URL de webhook, puis le mettre en pause ou le déconnecter. Une connexion relie votre propre compte chez un fournisseur de paiement à Wajub. Avec deux connexions ou plus, un paiement refusé par l'une peut être repris par une autre. Le propriétaire, un Administrateur, un Développeur ou un rôle personnalisé qui a **Gérer les paramètres** ou **Gérer les paramètres développeur** connecte un fournisseur ; **Prévenez-moi quand disponible** demande **Gérer les paramètres**. Le forfait **Pay as you go** permet 2 fournisseurs, **Growth** 6, **Scale** et **Enterprise** n'ont pas de limite, et le rail Wajub ne compte pas. Les connexions n'existent qu'en [Production](https://docs.wajub.com/fr/dashboard#sandbox-and-live). Le [code de sécurité](https://docs.wajub.com/fr/dashboard#the-security-code) n'est demandé que pour régénérer l'URL du webhook ou déconnecter un fournisseur. ## Les étapes 1. **Ouvrez le catalogue** En **Production**, ouvrez **Orchestration**, l'onglet **Fournisseurs**, puis **Ajouter un fournisseur**. La recherche et les filtres **Pays**, **Région**, **Type** et **Statut** réduisent le catalogue. Si votre forfait est plein, la page affiche **Limite de fournisseur atteinte** avec **Passer à un forfait supérieur**. 2. **Choisissez le fournisseur** Cliquez sur **Connecter** sous sa carte. Un fournisseur à venir propose **Prévenez-moi quand disponible** à la place. Le rail Wajub n'est pas dans le catalogue : [Demander le rail Wajub](https://docs.wajub.com/dashboard/orchestration/rail). 3. **Saisissez les identifiants** Sous **Identifiants API**, remplissez les champs que ce fournisseur demande, tels que votre tableau de bord chez lui les affiche. Certains fournisseurs ont des identifiants par pays : remplissez au moins un pays. Cliquez sur **Continuer**. 4. **Choisissez les canaux** Sous **Canaux de paiement**, cochez les canaux à confier à ce fournisseur, ou **Tout sélectionner** ; seuls les canaux des pays dont vous avez saisi les identifiants sont proposés. Il faut au moins un canal. 5. **Réglez le routage** Sous **Paramètres de routage**, la **Priorité** la plus haute est essayée en premier, et le **Poids (%)** répartit le trafic entre fournisseurs de même priorité. Désactivez **L'activer dès sa connexion** pour le connecter en pause. **Frais (pour le routage au moindre coût)** est facultatif : votre **Taux variable (%)**, vos **Frais fixes**, les **Devises** acceptées (vide pour toutes) et des **Personnalisations par canal**.  *Une règle de routage ou une politique de canal passe avant la priorité.* 6. **Connectez le fournisseur** L'étape **Examiner** résume vos choix et essaie vos identifiants sous **Vérification de la connexion**. Si l'essai échoue, le fournisseur sera connecté en pause, sauf si vous cochez **L'activer quand même**. Cliquez sur **Connecter le fournisseur** : sa page s'ouvre avec le message **Fournisseur activé avec succès.** Si vous quittez en cours de route, la page affiche à votre retour dans le même onglet, pendant 24 heures, **Nous avons restauré votre configuration inachevée** : vos choix reviennent, pas les identifiants. **Repartir de zéro** efface le tout. ## Après la connexion Sur la page du fournisseur, l'onglet **Paramètres** affiche l'**Endpoint de webhook** : copiez-le avec **Copier l'URL du webhook** et collez-le dans votre tableau de bord chez le fournisseur, pour que Wajub apprenne l'issue de vos paiements. **Tester la connexion**, sous **Diagnostics**, vérifie vos identifiants.  *Sans cette URL chez le fournisseur, Wajub n'apprend pas l'issue des paiements.* Le même onglet règle le routage, les frais, les canaux et les devises, enregistrés avec **Enregistrer les modifications**. L'interrupteur sous **Statut** met le fournisseur en pause tout de suite, sans rien supprimer. L'onglet **Identifiants** remplace un identifiant avec **Mettre à jour les identifiants** ; les secrets enregistrés ne s'affichent jamais. **Régénérer l'URL** demande le code de sécurité. L'ancienne URL cesse aussitôt de fonctionner : collez la nouvelle chez le fournisseur. Si le fournisseur refuse vos identifiants, la liste affiche **Connexion refusée** et sa page propose **Corriger la connexion** : [Lorsqu'une connexion rencontre un problème](https://docs.wajub.com/fr/orchestration/providers#when-a-connection-goes-bad). ## Déconnecter un fournisseur Sous **Zone dangereuse**, cliquez sur **Déconnecter le fournisseur**, saisissez son nom, puis le code de sécurité. La connexion, ses identifiants et ses réglages sont supprimés, ainsi que les règles de routage qui lui envoient des paiements ; celles dont il était le fournisseur de repli le perdent. Le message « Campay déconnecté. » le confirme. Pour le reconnecter, il faudra saisir de nouveau ses identifiants. Le rail Wajub ne se déconnecte pas ici. --- # Suivre la santé du routage URL: https://docs.wajub.com/fr/dashboard/orchestration/overview > Lire la vue d'ensemble de l'orchestration, ses incidents et ses recommandations, le statut en temps réel de vos routes, les paiements de la période et la performance de vos fournisseurs et des opérateurs. L'orchestration répartit vos paiements entre les fournisseurs que vous connectez. Sa vue d'ensemble dit si vos routes de paiement marchent, ce qu'il faut corriger, et comment vos fournisseurs ont fonctionné sur la période choisie. Le propriétaire, un Administrateur, un Développeur, un Observateur ou un rôle personnalisé qui a **Voir les paramètres** ouvre l'orchestration. La modifier demande **Gérer les paramètres** ou **Gérer les paramètres développeur** : le propriétaire, un Administrateur ou un Développeur. L'orchestration fait partie de tous les forfaits et n'existe qu'en [Production](https://docs.wajub.com/fr/dashboard#sandbox-and-live). Aucun code de sécurité n'est demandé pour la lire. ## Les onglets En **Production**, ouvrez **Orchestration** dans le menu. Les onglets mènent aux autres tâches : **Wajub Rail** ([Demander le rail Wajub](https://docs.wajub.com/dashboard/orchestration/rail)), **Fournisseurs** ([Connecter un fournisseur](https://docs.wajub.com/dashboard/orchestration/connect-provider)), **Matrice** ([Définir une politique de canal](https://docs.wajub.com/dashboard/orchestration/channel-policies)), **Règles de routage** ([Créer une règle de routage](https://docs.wajub.com/dashboard/orchestration/routing-rules)) et **Alertes** ([Créer une alerte](https://docs.wajub.com/dashboard/orchestration/alerts)). **Canaux** compare vos fournisseurs canal par canal : le **Taux de réussite**, les **Tentatives**, le **Volume**, le **Meilleur fournisseur**, le **Moins bon fournisseur** et l'**Écart** entre eux, puis la même chose **Par pays**. Une ligne ouvre la page du canal, où ses fournisseurs sont côte à côte. L'onglet vient avec les forfaits **Growth**, **Scale** et **Enterprise** ; sur un autre forfait, il affiche **Non inclus dans votre forfait** avec **Voir les forfaits**. ## La période et les filtres En haut, **Période** choisit les jours que couvre la page, et **Comparer à** fixe ce à quoi chaque chiffre est comparé : **Période précédente**, **Même période l'an dernier** ou **Aucune comparaison**. **Fournisseur**, **Canal**, **Pays** et **Devise** restreignent les chiffres de la période, et **Effacer les filtres** les retire. ## Incidents et recommandations **Incidents et recommandations** liste ce qui demande une action, chaque ligne marquée **Critique**, **Avertissement** ou **Attention**. Un incident sur l'un de vos canaux propose **Examiner**, qui ouvre la matrice. Un incident chez un opérateur précise qu'il vient de l'opérateur, pas de votre configuration, et propose **Voir l'état des opérateurs**. Une recommandation propose son propre bouton ; vous pouvez la masquer, et elle reste masquée dans ce navigateur. ## Le statut en temps réel **Statut de routage en temps réel** affiche **Vos routes de paiement sont saines**, ou le nombre de canaux qui demandent votre attention, avec **Ouvrir la matrice de routage**. **Fournisseurs en ce moment** donne la santé de chaque fournisseur : **Sain**, **Dégradé**, **En échec**, **Trop peu de trafic** ou **En pause** ; un fournisseur ouvre sa page. En dessous viennent le nombre de canaux surveillés et de fournisseurs actifs, et **Dernière mise à jour**, qui dit de quand date le dernier relevé. Le statut se met à jour tout seul.  *Le statut en temps réel se met à jour tout seul.* ## Les paiements de la période **Paiements sur la période** donne le **Taux de réussite**, le **Volume crédité**, avec le délai médian de crédit, les **Paiements terminés**, réussis et échoués, sans ceux encore en attente, et les paiements **Sauvés par un repli** : ceux qu'un autre fournisseur a encaissés après l'échec du premier. Chaque chiffre montre son évolution par rapport à la comparaison. Le taux de réussite, le volume et les paiements terminés ouvrent les paiements correspondants. **Acceptation par fournisseur** trace, sur la période, la part des tentatives terminées de chaque fournisseur qu'il a acceptées. ## La performance des fournisseurs **Performance des fournisseurs** compare vos fournisseurs : **Acceptation**, **Tentatives**, **Échecs du fournisseur**, **Temps de réponse**, **Volume** et **Échec le plus fréquent**. Un fournisseur avec peu de tentatives est marqué **Échantillon faible**. Une ligne ouvre la page du fournisseur, et **Gérer les fournisseurs** ouvre l'onglet **Fournisseurs**. Sans tentative sur la période, le tableau affiche **Aucune tentative de fournisseur sur cette période**. **Fournisseurs par canal** montre l'acceptation de chaque fournisseur sur chaque canal par rapport à la moyenne du canal ; une case ouvre le canal. **Où les paiements échouent** répartit les tentatives échouées selon l'endroit où elles se sont arrêtées, **Côté fournisseur**, **Côté client**, **Abandonné** ou **Inconnu**, puis liste les motifs les plus fréquents ; un motif ouvre ses paiements. ## L'état des opérateurs **État des opérateurs** montre les opérateurs par lesquels vous routez, sur l'ensemble de Wajub : leur état en ce moment et leur disponibilité sur les 90 derniers jours. --- # Demander le rail Wajub URL: https://docs.wajub.com/fr/dashboard/orchestration/rail > Demander l'accès au rail de paiement de Wajub pour encaisser sur ses contrats partenaires, signer l'accord, suivre la demande puis ajouter des pays ou des canaux. Le rail Wajub encaisse vos paiements sur les contrats partenaires de Wajub, sans contrat à signer avec chaque opérateur. Il ne se connecte pas comme un autre fournisseur : vous envoyez une demande signée, et Wajub l'examine. Le propriétaire, un Administrateur ou un rôle personnalisé qui a **Gérer les paramètres** fait la demande et la signe ; un Développeur, un Observateur ou un rôle qui a **Voir les paramètres** suit son statut. Le rail est ouvert à tous les forfaits et ne compte pas dans leur limite de fournisseurs. Il n'existe qu'en [Production](https://docs.wajub.com/fr/dashboard#sandbox-and-live), et aucun code de sécurité n'est demandé. Votre compte doit être vérifié : [Vérifier son entreprise](https://docs.wajub.com/dashboard/activation/verify-business). ## Les étapes 1. **Ouvrez Wajub Rail** En **Production**, ouvrez **Orchestration**, puis l'onglet **Wajub Rail**. La page présente la **Couverture disponible**, pays par pays. Cliquez sur **Démarrer la demande** ; tant que le compte n'est pas vérifié, le bouton est **Terminez la vérification du compte**.  *La couverture affichée est celle que le rail propose aujourd'hui.* 2. **Présentez votre entreprise** À l'étape **Votre entreprise**, décrivez votre produit ou service en 50 caractères au moins, choisissez le **Type de produit** et le **Cas d'utilisation principal**, ajoutez les liens de votre site ou de vos réseaux, puis estimez votre activité mensuelle. Cliquez sur **Continuer**. 3. **Donnez ce que l'examen demande** À l'étape **Pour l'examen**, **Ce dont Wajub a besoin pour examiner votre demande**, choisissez sous **Où vos clients paient-ils ?** : **Sur un site web**, **Dans une application mobile** ou **Ailleurs**. Les champs qui suivent dépendent de cette réponse et de ce que vous vendez : sur un site web, la **Page des conditions de vente** et la **Page de la politique de remboursement** ; ailleurs, **Où vos clients vous trouvent** et **Comment un client achète et paie** ; pour une application qui n'est pas encore en boutique, une **Version de test de l'application**. Sous **Compte de test pour l'examen**, donnez l'identifiant et le mot de passe d'un compte créé pour l'examen, jamais votre propre accès administrateur. Il est facultatif, sauf si votre produit s'utilise avec une connexion, comme une application mobile ou un abonnement. Cliquez sur **Continuer**. 4. **Choisissez les pays** À l'étape **Pays**, cochez les pays où vous voulez encaisser. Seuls les pays que le rail couvre sont proposés. 5. **Choisissez les canaux** À l'étape **Canaux**, cochez les opérateurs à demander. Ceux que votre compte a déjà apparaissent sous **Déjà accordés**, inutile de les redemander.  *Wajub peut accorder une partie seulement des canaux demandés.* 6. **Vérifiez la tarification** L'étape **Tarification** donne, pour chaque canal, les **Frais de paiement de référence** et les **Frais de transfert de référence** de votre forfait actuel. Le taux final peut varier selon la route de traitement, et vous connaissez les frais avant de confirmer une transaction. 7. **Signez et envoyez la demande** À l'étape **Vérifier et signer**, lisez le contrat sous **Lire et signer l'accord**, saisissez votre **Nom légal complet** tel qu'il figure dans votre dossier de vérification, cochez la déclaration, puis cliquez sur **Signer et soumettre**. Le message **Votre demande a été soumise pour examen.** s'affiche. ## Suivre la demande **Votre demande** indique sa date d'envoi, et Wajub vous répond par e-mail. Une seule demande peut être en cours à la fois. **Vos demandes** liste chacune avec son statut : **En cours d'examen**, **Approuvé**, **Partiellement approuvé**, où les canaux cochés sont ceux accordés, ou **Rejeté**. Après un refus, la page affiche **Votre dernière demande a été refusée.**, avec le motif quand Wajub en a donné un, et propose **Faire une nouvelle demande**. Le contrat ne prend effet qu'une fois la demande acceptée. Si votre compte utilisait déjà le rail avant ces demandes, la page affiche **Signez votre contrat Wajub Rail** avec une date limite. Saisissez votre **Nom légal complet**, cochez la déclaration, puis cliquez sur **Signer l'accord** avant cette date : passé ce délai, Wajub suspend votre connexion au rail, et il faut envoyer une nouvelle demande. ## Après l'approbation **Votre rail Wajub** indique l'état de votre connexion, ses **Marchés** et ses **Canaux actifs**. **Gérer la connexion** ouvre la page du rail parmi vos fournisseurs : vous y réglez sa priorité, le mettez en pause ou désactivez un canal accordé, comme pour un [fournisseur connecté](https://docs.wajub.com/dashboard/orchestration/connect-provider#after-creating-it). En dessous, la page suit le rail sur la période choisie, par canal ou par pays si vous le souhaitez : **Performance**, **Acceptation dans le temps**, **Par canal et opérateur**, **Là où le rail fait mieux**, **Motifs d'échec** et **Temps de réponse et de confirmation**. **État des opérateurs** donne l'état des opérateurs que le rail dessert. **Tarification et frais** met le prix signé pour chaque canal à côté des frais facturés sur la période, et **Quand l'argent est disponible** indique quand l'argent de ses paiements a rejoint votre solde disponible. Pour encaisser dans d'autres pays, **Couverture** liste les pays et les opérateurs que le rail couvre : **Demander ce pays**, sur la ligne d'un pays, ou **Demander d'autres canaux** ouvre une nouvelle demande. **Contrat et demandes** donne le contrat signé, que **Télécharger l'accord** enregistre en PDF, et l'historique de vos demandes. --- # Créer une règle de routage URL: https://docs.wajub.com/fr/dashboard/orchestration/routing-rules > Envoyer certains paiements vers un fournisseur choisi, avec un fournisseur de repli, mesurer l'effet d'une règle sur vos derniers paiements, puis tester le routage. Une règle de routage envoie les paiements qui remplissent ses conditions vers le fournisseur de votre choix, par exemple Orange Money au Cameroun vers une connexion moins chère. Le propriétaire, un Administrateur, un Développeur ou un rôle personnalisé qui a **Gérer les paramètres** ou **Gérer les paramètres développeur** crée les règles ; **Voir les paramètres** suffit pour les lire, pas pour lancer l'aperçu ni le simulateur. Les règles font partie des forfaits **Growth**, **Scale** et **Enterprise** : avec **Pay as you go**, l'onglet n'apparaît pas. Elles n'existent qu'en [Production](https://docs.wajub.com/fr/dashboard#sandbox-and-live), et aucun code de sécurité n'est demandé. Il faut au moins un [fournisseur connecté](https://docs.wajub.com/dashboard/orchestration/connect-provider). ## Les étapes 1. **Ouvrez le dialogue** En **Production**, ouvrez **Orchestration**, l'onglet **Règles de routage**, puis **Créer la règle**. Sans fournisseur connecté, la page affiche **Connectez d'abord un fournisseur**. 2. **Nommez la règle** Saisissez un **Nom de la règle** qui dit ce qu'elle fait : la liste et le simulateur l'affichent. 3. **Choisissez le fournisseur** Sous **Router vers le fournisseur**, choisissez la connexion qui prendra ces paiements. Le **Fournisseur de repli**, facultatif, est essayé juste après lui s'il échoue, et à sa place quand il ne peut pas prendre le paiement. 4. **Fixez les conditions** Sous **Conditions**, remplissez ce qui compte parmi **Pays**, **Canal**, **Devise**, **Montant minimum** et **Montant maximum**, ces deux derniers dans la devise du paiement. Une condition vide accepte toutes les valeurs, et la règle ne s'applique que si toutes sont remplies. **Conditions avancées** ajoute des **Fenêtres horaires**, des **Segments clients**, des **Filtres de métadonnées** et des **Plafonds de fréquence**, et des **Étiquettes** qui servent seulement à retrouver la règle. 5. **Mesurez l'impact** Sous **Aperçu de l'impact**, cliquez sur **Exécuter l'aperçu**. Vos paiements des 7 derniers jours sont rejoués : le panneau dit combien seraient allés vers un autre fournisseur, fournisseur par fournisseur.  *L'aperçu donne le maximum que la règle peut déplacer, pas une prévision.* 6. **Créez la règle** Laissez **Actif** activé, puis cliquez sur **Créer la règle**. Le message **Règle de routage créée avec succès.** s'affiche, et la règle prend sa place dans la liste. ## L'ordre des règles Un paiement va à la première règle de la liste qui lui correspond : la priorité la plus haute d'abord, puis à priorité égale celle qui a le plus de conditions. **Monter** et **Descendre** déplacent une règle, et toutes les priorités sont alors renumérotées depuis le haut. Des règles de même priorité et avec autant de conditions se partagent les paiements selon leur **Poids**. [Quelle règle l'emporte](https://docs.wajub.com/fr/orchestration/routing-rules#which-rule-wins) détaille le classement, et [L'instruction la plus précise passe en premier](https://docs.wajub.com/fr/orchestration#the-most-specific-instruction-goes-first) dit ce qui décide quand aucune règle ne correspond. Chaque ligne affiche les paiements correspondants sur 30 jours et leur taux d'acceptation. Son menu propose **Modifier la règle** et **Supprimer la règle** : les paiements qu'elle visait suivent alors vos autres règles, puis la politique du canal, puis la priorité de vos connexions. ## Tester le routage **Tester le routage** ouvre le **Simulateur de routage**. Choisissez l'un des **Scénarios rapides**, ou un **Canal de paiement** et un **Montant** avec sa devise, puis cliquez sur **Exécuter la simulation**. Le résultat donne le fournisseur essayé en premier, l'ordre des suivants, les connexions écartées sous **Écartés** avec leur motif, et le **Journal des décisions**. Rien n'est débité. [Le simulateur](https://docs.wajub.com/fr/orchestration/routing-rules#the-simulator-on-the-routing-rules-page) dit ce qu'il ne peut pas reproduire. --- # Créer un lien de paiement URL: https://docs.wajub.com/fr/dashboard/payment-links/create > Créer depuis le tableau de bord une page de paiement avec sa propre adresse, choisir son type, la décrire et la publier pour la partager par WhatsApp, SMS ou code QR. Un lien de paiement est une page de paiement avec sa propre adresse : vous la partagez par WhatsApp, par SMS ou avec un code QR, et toute personne qui a le lien peut payer. Le propriétaire et les [rôles](https://docs.wajub.com/fr/dashboard#roles) Administrateur, Développeur et Finance créent des liens, comme un rôle personnalisé qui a **Gérer les liens de paiement** ; un Analyste, un Observateur ou un rôle qui a seulement **Voir les liens de paiement** les consulte sans les modifier. Le forfait **Pay as you go** permet 25 liens, archivés compris ; **Growth** et les forfaits au-dessus n'ont pas de limite. Les liens n'existent qu'en [Production](https://docs.wajub.com/fr/dashboard#sandbox-and-live). Créer un lien ne demande pas de [code de sécurité](https://docs.wajub.com/fr/dashboard#the-security-code). ## Les quatre types de lien - [Vendre quelque chose](https://docs.wajub.com/dashboard/payment-links/sell-something) : un article, un contenu numérique ou un service, à prix fixe. - [Vendre des billets](https://docs.wajub.com/dashboard/payment-links/sell-tickets) : des places pour un concert, une formation ou un gala. - [Collecter des fonds](https://docs.wajub.com/dashboard/payment-links/raise-funds) : des contributions vers un objectif à atteindre. - [Recevoir des dons](https://docs.wajub.com/dashboard/payment-links/donations) : des dons du montant que choisit chaque donateur. ## Les étapes 1. **Ouvrez le formulaire** En **Production**, ouvrez **Liens de paiement**, puis **Créer un lien**. La page **Nouveau lien de paiement** montre le formulaire et, sur un grand écran, l'aperçu de la page de paiement telle que vos clients la verront, mis à jour à chaque modification. Sur un téléphone, le bouton **Aperçu** l'ouvre. 2. **Choisissez le type** Sous **Pour quoi voulez-vous encaisser ?**, choisissez l'un des quatre types. Pour **Vendre quelque chose**, choisissez aussi sous **De quel type ?** : **Article physique**, **Contenu numérique** ou **Service**.  *Une fois le lien payé, son type ne peut plus changer.* 3. **Partez d'un modèle si besoin** Sous **Partir de :**, un modèle préremplit quelques réglages du type choisi, jamais le titre ni le prix. Les modèles disparaissent dès que le titre est rempli ; chaque page de type dit ce que préparent les siens. 4. **Décrivez l'offre** Dans **L'offre**, le **Titre** est obligatoire, de 3 à 120 caractères. Ajoutez si besoin une **Photo** et une **Description**. Les autres champs de la section dépendent du type. 5. **Remplissez les sections du type** Le prix, les montants ou les billets, puis la livraison ou l'accès, changent avec le type : suivez les étapes de sa page, [Vendre quelque chose](https://docs.wajub.com/dashboard/payment-links/sell-something#the-steps), [Vendre des billets](https://docs.wajub.com/dashboard/payment-links/sell-tickets#the-steps), [Collecter des fonds](https://docs.wajub.com/dashboard/payment-links/raise-funds#the-steps) ou [Recevoir des dons](https://docs.wajub.com/dashboard/payment-links/donations#the-steps). Les questions au client, les codes promo et les moyens de paiement valent pour les quatre : voir [Régler ce que remplit le client](https://docs.wajub.com/dashboard/payment-links/payer-fields). 6. **Choisissez l'adresse du lien** Dans **Adresse et accès**, **Adresse du lien** donne la fin de l'adresse, par exemple wajub.link/sac-adaora ; laissez-la vide pour une adresse courte générée automatiquement. Le formulaire dit tout de suite si elle est libre. Le mot de passe, la date de fermeture, **Fermer après le premier paiement** et les autres réglages d'accès sont décrits dans [Partager un lien](https://docs.wajub.com/dashboard/payment-links/share#address-and-access). 7. **Publiez le lien** **Publier le lien** crée le lien et le met en ligne ; le bouton devient **Créer le lien hors ligne** quand **Page en ligne** est désactivé. S'il reste des champs à corriger, le formulaire les liste, et un clic sur l'un d'eux y mène. Une fois la limite du forfait atteinte, la publication est bloquée et le brouillon reste enregistré. ## Les autres sections Les sections repliées résument leur réglage ; ouvrez-les au besoin. **Bouton et remerciement** change le **Texte du bouton**, que la page complète avec le montant, et affiche un **Message de remerciement** sur la confirmation. **Après le paiement, envoyer le client vers** l'envoie quelques secondes après le paiement vers une page de votre site, avec la référence du paiement dans l'adresse. **Votre organisation** range le lien avec une **Catégorie**, des **Étiquettes** pour filtrer la liste et une **Référence externe**, votre propre identifiant. Rien de cette section n'est montré aux clients. ## Ce que voit le client Le client ouvre la page à l'adresse du lien, remplit ce que le lien demande, paie avec l'un de vos moyens de paiement et reçoit son reçu par e-mail. ## Après la publication La fenêtre **Votre lien est en ligne** s'ouvre pour le partager : voir [Partager un lien](https://docs.wajub.com/dashboard/payment-links/share). Pour le changer, le mettre hors ligne ou le supprimer, voir [Modifier ou retirer un lien](https://docs.wajub.com/dashboard/payment-links/edit-offline-delete). > [!NOTE] > **Un lien commencé reste en brouillon** > > Tant que le lien n'est pas publié, le formulaire s'enregistre tout seul et l'en-tête affiche > **Brouillon enregistré**. Au prochain **Créer un lien**, le formulaire propose **Reprendre** ou > **Recommencer**. Le brouillon suit votre compte, pas l'appareil, et vous n'en avez qu'un à la > fois. --- # Recevoir des dons URL: https://docs.wajub.com/fr/dashboard/payment-links/donations > Créer un lien de dons avec des montants suggérés, des paliers qui disent ce que permet un don, un mur des donateurs et des dons anonymes. Le type **Recevoir des dons** accepte des dons du montant que choisit chaque donateur, sans objectif à atteindre : une offrande d'église, le soutien à une association. Pour viser un montant, créez plutôt un lien pour [collecter des fonds](https://docs.wajub.com/dashboard/payment-links/raise-funds). Il demande les mêmes droits qu'un [lien de paiement](https://docs.wajub.com/dashboard/payment-links/create) : **Gérer les liens de paiement**, la [Production](https://docs.wajub.com/fr/dashboard#sandbox-and-live), et une place dans la limite de liens du forfait. Aucun [code de sécurité](https://docs.wajub.com/fr/dashboard#the-security-code) n'est demandé. ## Les étapes 1. **Choisissez Recevoir des dons** Dans **Nouveau lien de paiement**, choisissez **Recevoir des dons**. Sous **Partir de :**, **Offrande ou dîme d'église** et **Association ou ONG** permettent les dons anonymes et proposent quatre montants courants, 1 000, 2 500, 5 000 et 10 000 FCFA ; seul le second affiche les derniers donateurs. 2. **Présentez la cause** Remplissez **L'offre** et **Organisé par** comme pour une [collecte de fonds](https://docs.wajub.com/dashboard/payment-links/raise-funds#the-steps). 3. **Proposez des montants** Dans **Montants**, choisissez la **Devise**, puis jusqu'à 6 **Montants suggérés** ; le donateur peut toujours donner un autre montant. **Don minimum** et **Don maximum** sont facultatifs et encadrent aussi les montants suggérés.  *Chaque palier est un montant en un geste, avec ce qu'il finance.* 4. **Dites ce que permet un don** Sous **Ce que permet un don**, **Ajouter un palier** associe un **Montant** à **Ce que cela finance**, par exemple 5 000 FCFA pour un kit scolaire, avec des **Détails** facultatifs. Jusqu'à 6 paliers. 5. **Choisissez ce que montre la page** Dans **Ce que montre la page**, **Afficher les derniers donateurs et le total donné** montre les derniers dons ; désactivé, la page n'affiche ni montant ni donateur. **Permettre les dons anonymes** laisse le donateur cacher son nom. 6. **Publiez le lien** Choisissez l'adresse dans **Adresse et accès**, comme pour un [lien de paiement](https://docs.wajub.com/dashboard/payment-links/create#the-steps), puis **Publier le lien**. ## Les dons anonymes Un don anonyme cache le nom du donateur sur la page seulement. Dans l'onglet **Donateurs** du lien, la ligne garde son nom avec le badge **Anonyme sur la page**, et l'export aussi : voir [Suivre un lien](https://docs.wajub.com/dashboard/payment-links/track#people-and-export). ## Ce que voit le donateur Le donateur choisit un palier ou un montant suggéré, ou saisit le sien, puis paie. ## Après la publication Des **Actualités** se publient comme pour une [collecte de fonds](https://docs.wajub.com/dashboard/payment-links/raise-funds#after-publishing). Le total donné et les dons se suivent sur la page du lien : voir [Suivre un lien](https://docs.wajub.com/dashboard/payment-links/track#what-the-link-gathered). Un lien de dons reste ouvert tant que vous ne le mettez pas hors ligne, sauf si vous avez réglé **Fermer la page le** ou **Nombre maximum de paiements** dans [Adresse et accès](https://docs.wajub.com/dashboard/payment-links/share#address-and-access). --- # Modifier ou retirer un lien URL: https://docs.wajub.com/fr/dashboard/payment-links/edit-offline-delete > Modifier un lien de paiement publié, le mettre hors ligne, l'archiver, le dupliquer ou le supprimer, et rouvrir un lien expiré. Ces actions demandent **Gérer les liens de paiement**, comme pour [créer un lien](https://docs.wajub.com/dashboard/payment-links/create), et se font en [Production](https://docs.wajub.com/fr/dashboard#sandbox-and-live). Seule la suppression demande le [code de sécurité](https://docs.wajub.com/fr/dashboard#the-security-code). ## Modifier un lien 1. **Ouvrez le formulaire du lien** Sur la page du lien, choisissez **Modifier**, ou dans la liste **Liens de paiement**, le même choix dans le menu de la ligne. 2. **Changez ce qu'il faut** Le formulaire est celui de la création, sans les modèles. L'en-tête affiche **Modifications non enregistrées** tant que vous n'avez pas enregistré. 3. **Enregistrez** **Enregistrer les modifications**, ou Ctrl+S (Cmd+S sur Mac). La page publiée change tout de suite. Une fois le lien payé, son type ne peut plus changer. Pour un événement, les types de billets se figent à la première vente : voir [Vendre des billets](https://docs.wajub.com/dashboard/payment-links/sell-tickets#after-the-first-sale). ## Mettre hors ligne ou archiver Le menu en haut de la page du lien, comme celui de chaque ligne de la liste, propose deux façons de fermer la page : - **Mettre hors ligne** : l'adresse répond « page introuvable » jusqu'à ce que vous choisissiez **Mettre en ligne**, dans le menu ou dans le bandeau **Cette page est hors ligne**. Rien n'est supprimé. - **Archiver** : la page dit aux clients que le lien n'est plus disponible, ses paiements restent, et la liste le cache sauf avec le filtre **Liens archivés**. **Désarchiver** lui rend son état d'avant.  *Supprimer n'apparaît que pour un lien qui n'a encore reçu aucun paiement.* ## Plusieurs liens à la fois Dans la liste, cochez jusqu'à 100 liens : la barre qui apparaît les met en ligne ou hors ligne, les archive ou les désarchive ensemble. ## Dupliquer un lien **Dupliquer**, dans le menu, ouvre le formulaire rempli avec les réglages du lien et le titre « Copie de » suivi du sien. L'adresse, les dates, le mot de passe, le fichier hébergé, les codes promo, les actualités et la référence externe ne sont pas copiés. La copie est en ligne par défaut et compte comme un nouveau lien dans la limite du forfait. ## Supprimer un lien Seul un lien qui n'a reçu aucun paiement se supprime : **Supprimer**, en bas du menu de la page du lien, puis **Supprimer le lien** et le code de sécurité. Le lien, sa page et ses réglages disparaissent pour de bon, et son adresse répond « page introuvable ». Un lien déjà payé s'archive à la place, pour garder ses paiements. ## Un lien expiré Passé sa date de fermeture, la page du lien affiche **Ce lien a expiré**. **Changer la date de fermeture** ouvre le formulaire pour en choisir une nouvelle ou la retirer. Un lien expiré ou archivé ne se remet pas en ligne tel quel : changez d'abord sa date, ou désarchivez-le. --- # Prévenir votre serveur URL: https://docs.wajub.com/fr/dashboard/payment-links/notify-server > Ajouter à un lien de paiement un endpoint webhook qui prévient votre serveur à chaque paiement, billet, don ou remboursement, et gérer son secret de signature. L'onglet **Webhooks** d'un lien envoie ses événements à une adresse de votre serveur, signés avec un secret propre à chaque endpoint. Toute personne qui voit les liens de paiement voit l'onglet ; ajouter, modifier ou supprimer un endpoint demande **Gérer les liens de paiement**. Ces actions, comme afficher ou régénérer le secret d'un endpoint, demandent le [code de sécurité](https://docs.wajub.com/fr/dashboard#the-security-code). Les liens n'existent qu'en [Production](https://docs.wajub.com/fr/dashboard#sandbox-and-live). Le contenu des événements et la vérification de la signature sont décrits dans la documentation développeur : [Les webhooks d'un lien](https://docs.wajub.com/fr/payments/link/tracking#webhooks-of-one-link). ## Les étapes 1. **Ouvrez l'onglet Webhooks** Sur la page du lien, ouvrez l'onglet **Webhooks**, puis **Ajouter un endpoint**. 2. **Donnez l'adresse de votre serveur** Dans **URL de l'endpoint**, saisissez une adresse HTTPS publique de votre serveur. 3. **Choisissez les événements** Sous **Événements**, cochez ceux que l'endpoint doit recevoir : **Paiement terminé avec succès**, **Billet d'événement acheté**, **Don reçu**, **Commande passée**, **Paiement remboursé, ou perdu en litige** et **Lien expiré**. Il ne reçoit que ceux-là.  *L'endpoint ne reçoit que les événements cochés.* 4. **Enregistrez l'endpoint** **Ajouter un endpoint**, en bas de la fenêtre, l'enregistre après le code de sécurité. Quand votre organisation a déjà autant d'endpoints que permis, la fenêtre le dit sous **URL de l'endpoint** : supprimez-en un dont vous ne vous servez plus pour en ajouter un autre. 5. **Copiez le secret de signature** Dans le menu de l'endpoint, **Afficher le secret de signature** donne, après le code de sécurité, le **Secret de signature** que votre serveur utilise pour vérifier chaque envoi. 6. **Envoyez un test** **Envoyer un test**, dans le menu de l'endpoint, envoie un événement d'essai et dit si votre serveur l'a accepté. Après trop de tests, le message dit quand réessayer. La **Dernière livraison**, sur la ligne de l'endpoint, ne compte que les vrais événements, avec le statut HTTP reçu. ## Gérer un endpoint Le menu de chaque endpoint propose aussi **Copier l'URL** et **Modifier l'endpoint**, où **Actif** désactivé garde ses réglages sans rien lui envoyer. **Régénérer le secret de signature** ouvre **Régénérer le secret de signature ?**, qui dit quand l'ancien secret cesse de marcher. **Régénérer le secret**, après le code de sécurité, signe les envois avec un nouveau secret et l'affiche sous **Secret de signature** : mettez-le sur votre serveur pour qu'il continue d'accepter les envois. **Supprimer l'endpoint** demande **Supprimer cet endpoint ?** : l'endpoint ne reçoit plus les événements du lien et son secret est perdu, sans retour possible. Pour recevoir les événements de tous vos liens à la fois, utilisez plutôt les [webhooks de la console développeur](https://docs.wajub.com/fr/developer-tools/webhooks) ; la liste de leurs événements est dans [Liens de paiement](https://docs.wajub.com/fr/developer-tools/webhooks/events#payment-links). --- # Régler ce que remplit le client URL: https://docs.wajub.com/fr/dashboard/payment-links/payer-fields > Ajouter des questions au client, des codes promo, limiter les moyens de paiement et proposer la page en plusieurs langues et devises, pour tous les types de lien. Ces réglages valent pour les quatre types de lien et se trouvent dans le formulaire du lien, à la création comme avec **Modifier**. Ils demandent les mêmes droits qu'un [lien de paiement](https://docs.wajub.com/dashboard/payment-links/create) : **Gérer les liens de paiement** et la [Production](https://docs.wajub.com/fr/dashboard#sandbox-and-live). Aucun [code de sécurité](https://docs.wajub.com/fr/dashboard#the-security-code) n'est demandé. Chaque client donne son e-mail pour le reçu et peut ajouter son nom et son téléphone. Ajoutez seulement ce dont vous avez vraiment besoin. ## Les questions au client Dans **Ce que remplit le client**, **Ajouter une question** pose jusqu'à 10 questions. Chacune a un libellé, **Question**, et un type de **Réponse** : **Texte court**, **Texte long**, **E-mail**, **Téléphone**, **Liste déroulante** avec jusqu'à 20 **Choix**, ou **Case à cocher**. **Réponse obligatoire** empêche de payer sans répondre ; pour une case, l'interrupteur devient **Doit être cochée pour payer**, utile pour des conditions à accepter. Les réponses arrivent dans [l'export des clients](https://docs.wajub.com/dashboard/payment-links/track#people-and-export). Pour un événement, les informations demandées pour chaque billet se règlent à part : voir [Vendre des billets](https://docs.wajub.com/dashboard/payment-links/sell-tickets).  *Les réponses arrivent dans l'export des clients du lien.* ## Les codes promo Sous **Codes promo**, **Ajouter un code** crée jusqu'à 20 codes. Le **Code** tient en 32 caractères : lettres majuscules, chiffres, tirets et soulignés. Choisissez la **Remise**, en **Pourcentage** ou en **Montant fixe**, puis sa **Valeur**. **Nombre d'utilisations** et **Valable jusqu'au** sont facultatifs ; **Actif** suspend un code sans le supprimer. Le champ du code n'apparaît sur la page que tant qu'au moins un code est actif. ## Les moyens de paiement Par défaut, le client se voit proposer tous les moyens sur lesquels vous encaissez. Sous **Moyens de paiement**, réduisez le choix avec **Uniquement ces pays**, **Uniquement ces moyens de paiement** ou **Uniquement ces types de moyens de paiement** (**Mobile Money**, **Cartes**, **Banque**, **Crypto**), seuls ou ensemble. Les cartes et la crypto ne dépendent d'aucun pays. Sous **Devise**, **Tous les moyens** convertit le montant quand les devises diffèrent ; **Même devise uniquement** garde les moyens qui encaissent dans la devise du paiement. ## Les langues et les devises Dans **Langues et devises**, la **Langue principale** est celle dans laquelle vous écrivez la page, français ou anglais. Sous **Langues proposées aux visiteurs**, cochez les langues dans lesquelles le visiteur peut voir la page : chacune ouvre un bloc pour traduire le titre, la description, le texte du bouton et le message de remerciement ; un champ vide reprend le texte de la langue principale. **Autres devises de paiement proposées aux visiteurs** laisse payer dans une autre devise, au cours du jour. Seules les devises acceptées par l'un de vos moyens de paiement sont proposées. --- # Collecter des fonds URL: https://docs.wajub.com/fr/dashboard/payment-links/raise-funds > Créer un lien de collecte avec un objectif, des montants suggérés, une barre de progression, des étapes et une date de fin, puis publier des actualités. Le type **Collecter des fonds** réunit des contributions vers un objectif : un projet associatif, des frais médicaux, une cotisation. Chaque contributeur choisit son montant. Il demande les mêmes droits qu'un [lien de paiement](https://docs.wajub.com/dashboard/payment-links/create) : **Gérer les liens de paiement**, la [Production](https://docs.wajub.com/fr/dashboard#sandbox-and-live), et une place dans la limite de liens du forfait. Aucun [code de sécurité](https://docs.wajub.com/fr/dashboard#the-security-code) n'est demandé. ## Les étapes 1. **Choisissez Collecter des fonds** Dans **Nouveau lien de paiement**, choisissez **Collecter des fonds**. Sous **Partir de :**, **Projet associatif** affiche la progression et les contributeurs ; **Frais médicaux** affiche la progression et cache les contributeurs. 2. **Présentez la collecte** Remplissez **L'offre** comme pour tout [lien de paiement](https://docs.wajub.com/dashboard/payment-links/create#the-steps). **Organisé par** nomme la personne ou l'organisation derrière la collecte ; la page le montre comme vérifié quand votre compte Wajub l'est. 3. **Fixez l'objectif** Dans **Objectif et montants**, saisissez l'**Objectif** et choisissez sa devise dans le même champ. **Montants suggérés** propose jusqu'à 6 montants en un geste ; le contributeur peut toujours en saisir un autre. **Contribution minimale** est facultative et reste sous l'objectif.  *Le contributeur peut toujours saisir un autre montant que ceux suggérés.* 4. **Choisissez ce que montre la page** Dans **Ce que montre la page**, **Afficher le montant collecté et la barre de progression** montre où en est la collecte ; désactivé, la page n'affiche que l'objectif. **Afficher les contributeurs** montre leur nombre et le nom des huit derniers, jamais leurs coordonnées ; leurs montants n'apparaissent que tant que **Afficher le montant collecté et la barre de progression** est activé. 5. **Choisissez ce qui se passe à l'objectif** Avec **Continuer la collecte une fois l'objectif atteint** désactivé, la page n'accepte plus de contribution une fois l'objectif atteint et le dit ; un remboursement qui ramène le total sous l'objectif la rouvre. Activé, la collecte continue au-delà de son objectif. 6. **Fixez la fin de la campagne** **Fin de la campagne** est facultative : à cette date, la page se ferme d'elle-même, et elle affiche un compte à rebours pendant les 30 derniers jours. Elle remplace la date de fermeture des autres types. 7. **Ajoutez des étapes** **Ajouter une étape** marque un palier de l'objectif, jusqu'à 10, avec son **Montant**, un **Titre** facultatif et **Ce qu'elle permet**. Tant que le montant collecté est affiché, la page coche chaque étape atteinte. 8. **Publiez le lien** Choisissez l'adresse dans **Adresse et accès**, comme pour un [lien de paiement](https://docs.wajub.com/dashboard/payment-links/create#the-steps), puis **Publier le lien**. ## Ce que voit le contributeur Le contributeur voit l'objectif, la progression si vous l'affichez, choisit ou saisit un montant et paie. ## Après la publication Pour raconter à quoi sert l'argent, ouvrez **Modifier**, puis **Publier une actualité** dans **Actualités**, avec un **Titre**, une **Date** et le **Texte de l'actualité** ; la page montre les quatre dernières, sur 20 au plus. Le montant collecté et les contributions se suivent sur la page du lien : voir [Suivre un lien](https://docs.wajub.com/dashboard/payment-links/track#what-the-link-gathered). La collecte s'arrête à la **Fin de la campagne**, à l'objectif sauf si **Continuer la collecte une fois l'objectif atteint** est activé, au **Nombre maximum de paiements** si vous l'avez fixé dans **Adresse et accès**, ou quand vous mettez le lien hors ligne ou l'archivez : voir [Modifier ou retirer un lien](https://docs.wajub.com/dashboard/payment-links/edit-offline-delete#offline-or-archive). --- # Vendre quelque chose URL: https://docs.wajub.com/fr/dashboard/payment-links/sell-something > Vendre un article physique, un contenu numérique ou un service à prix fixe avec un lien de paiement, avec ses options, son stock, sa livraison ou son accès. Le type **Vendre quelque chose** vend à prix fixe un article livré ou retiré sur place, un fichier ou un lien à télécharger, ou un rendez-vous. Il demande les mêmes droits qu'un [lien de paiement](https://docs.wajub.com/dashboard/payment-links/create) : **Gérer les liens de paiement**, la [Production](https://docs.wajub.com/fr/dashboard#sandbox-and-live), et une place dans la limite de liens du forfait. Aucun [code de sécurité](https://docs.wajub.com/fr/dashboard#the-security-code) n'est demandé. ## Les étapes 1. **Choisissez le type de produit** Dans **Nouveau lien de paiement**, choisissez **Vendre quelque chose**, puis sous **De quel type ?** : **Article physique**, **Contenu numérique** ou **Service**. Sous **Partir de :**, **Vêtement ou accessoire** demande une adresse de livraison et ajoute l'option **Taille** de S à XL ; **Formation en ligne ou e-book** prépare un lien de téléchargement ; **Consultation** prépare un service en ligne de 60 minutes. 2. **Décrivez le produit** Remplissez **L'offre** comme pour tout [lien de paiement](https://docs.wajub.com/dashboard/payment-links/create#the-steps). **Autres photos** ajoute jusqu'à 10 images dans l'ordre de la page. Une **Vidéo** MP4 ou WebM remplace la photo en haut de la page. 3. **Fixez le prix** Dans **Prix et options**, saisissez le **Prix** et choisissez sa devise dans le même champ. Le prix est obligatoire et le client ne peut pas le changer. Pour laisser chacun choisir son montant, créez plutôt un lien pour [collecter des fonds](https://docs.wajub.com/dashboard/payment-links/raise-funds) ou [recevoir des dons](https://docs.wajub.com/dashboard/payment-links/donations). 4. **Ajoutez des options** **Ajouter une option** crée une taille, une couleur ou un format, jusqu'à 5 options de 20 choix chacune. **Affichage** les montre en **Boutons avec texte** ou en **Pastilles de couleur**, et un choix peut coûter plus que le prix de base. Le client choisit un élément de chaque option avant de payer.  *Un choix peut coûter plus que le prix de base.* 5. **Réglez la livraison ou l'accès** La section suivante dépend du type de produit : [un article physique](#a-physical-item), [un contenu numérique](#digital-content) ou [un service](#a-service). 6. **Publiez le lien** Choisissez l'adresse dans **Adresse et accès**, comme pour un [lien de paiement](https://docs.wajub.com/dashboard/payment-links/create#the-steps), puis **Publier le lien**. ## Un article physique Le **Stock**, sous le prix, ne s'affiche pas sur la page, mais le client ne peut pas commander plus qu'il n'en reste : une fois épuisé, la page n'accepte plus de commande, sauf si **Continuer à vendre en rupture de stock** est activé pour livrer plus tard. Laissez-le vide si vous ne suivez pas le stock. Dans **Livraison et retours**, **Demander une adresse de livraison** se désactive pour un article retiré sur place. Les **Frais de livraison** s'ajoutent une fois par commande ; vide ou 0, la livraison est gratuite. Les **Conditions de retour** s'affichent sur la page. Le choix d'option et l'adresse de chaque acheteur arrivent dans [l'export des clients](https://docs.wajub.com/dashboard/payment-links/track#people-and-export). ## Un contenu numérique Dans **Accès au contenu**, **Comment le client le reçoit** propose deux choix : - **Un lien de téléchargement** : l'adresse https de votre fichier, sur Drive, Dropbox ou votre site. - **Un fichier hébergé par Wajub** : jusqu'à 500 Mo, à partir du forfait **Growth**. Après le paiement, le client reçoit par e-mail un lien d'accès propre à son paiement, avec vos **Instructions d'accès**, qui s'affichent aussi sur la page. L'adresse du fichier n'apparaît jamais sur la page. **Accès valable** fixe en jours, à partir du paiement, la durée pendant laquelle ce lien marche, jusqu'à 365 : 30 jours sur un nouveau lien, sans limite si le champ est vide. Avec **Accès à usage unique**, le lien d'accès ne fonctionne plus après le premier téléchargement : chaque acheteur télécharge une fois, et le lien de paiement reste ouvert aux acheteurs suivants. Un client remboursé en totalité perd l'accès. Avec **Un lien de téléchargement**, le client arrive sur votre propre adresse et la garde : c'est à vous de la protéger. ## Un service Dans **Déroulement du service**, **Où cela se passe** propose **En ligne**, **En personne** ou **Les deux**. En ligne ou pour les deux, le **Lien de la réunion** est obligatoire : il part par e-mail après le paiement, avec **Ce que le client doit préparer**, qui s'affiche aussi sur la page, comme la **Durée** (de 5 minutes à 24 heures) et les **Conditions d'annulation**. Aucun créneau n'est réservé : convenez de l'heure avec le client. ## Ce que voit le client Le client choisit ses options et sa quantité, jusqu'à 100, donne son e-mail et son adresse si l'article est livré, puis paie le prix affiché. --- # Vendre des billets URL: https://docs.wajub.com/fr/dashboard/payment-links/sell-tickets > Vendre des places pour un concert, une formation ou un gala avec un lien de paiement, des types de billets, un billet avec code QR et la liste des participants. Un lien de billetterie est un lien de paiement de type **Vendre des billets** : l'acheteur choisit un type de billet et le nombre de places, paie, et reçoit par e-mail un billet avec un code QR. Il demande les mêmes droits qu'un [lien de paiement](https://docs.wajub.com/dashboard/payment-links/create) : **Gérer les liens de paiement**, la [Production](https://docs.wajub.com/fr/dashboard#sandbox-and-live), et une place dans la limite de liens du forfait. Aucun [code de sécurité](https://docs.wajub.com/fr/dashboard#the-security-code) n'est demandé. ## Les étapes 1. **Choisissez Vendre des billets** En **Production**, ouvrez **Liens de paiement**, puis **Créer un lien**, et choisissez **Vendre des billets** sous **Pour quoi voulez-vous encaisser ?**. Sous **Partir de :**, **Concert ou spectacle** crée deux billets, Standard et VIP, et **Formation ou conférence** un billet Participant qui demande le nom et l'entreprise de chaque participant. 2. **Décrivez l'événement** Dans **L'offre**, donnez un **Titre**, une **Affiche ou photo** et une **Description** : le programme, les artistes ou intervenants, ce que comprend le billet. Indiquez quand il commence dans **Débute**, et si besoin quand il finit dans **Se termine**, puis le **Fuseau horaire de l'événement** : les participants voient les horaires dans ce fuseau. Le **Lieu** est obligatoire, une salle ou « En ligne » ; **Adresse**, **Ville** et **Pays** sont facultatifs. 3. **Créez les types de billets** Dans **Billets**, choisissez la **Devise**, puis donnez à chaque billet un **Nom**, un **Prix** et une **Quantité**. Un prix de 0 rend le billet gratuit, et une quantité vide ne le limite pas. **Ajouter un type de billet** en ajoute un autre, jusqu'à 20, et **Capacité du lieu** plafonne le total, tous billets confondus.  *Dès le premier billet vendu, les types de billets ne changent plus.* 4. **Réglez le billet envoyé** Dans **Billets et remboursements**, **Envoyer un billet avec QR code** est activé par défaut. Ajoutez vos **Conditions de remboursement** : elles figurent dans l'e-mail du billet.  *Un seul e-mail part, vers l'acheteur, avec un code QR pour tout l'achat.* L'e-mail va à l'adresse de l'acheteur, pas à chaque participant : il contient un code QR qui vaut pour tout l'achat, avec le nombre de billets. 5. **Demandez les informations des participants** Dans **Ce que remplit le client**, **Informations demandées pour chaque participant** ajoute jusqu'à 10 champs remplis une fois par billet, par exemple **Nom complet** ou **Taille de t-shirt**. Les réponses arrivent dans l'onglet **Participants** du lien et dans son export, pas sur le billet. 6. **Publiez le lien** Choisissez l'adresse dans **Adresse et accès**, comme pour un [lien de paiement](https://docs.wajub.com/dashboard/payment-links/create#the-steps), puis **Publier le lien**. Il n'y a pas de date de fermeture à régler : la vente s'arrête d'elle-même à **Se termine**, ou au début de l'événement si **Se termine** est vide. ## Ce que fait l'acheteur L'acheteur choisit un type de billet et jusqu'à 100 places, remplit les informations de chaque participant et paie ; la page signale un billet épuisé et ferme la vente une fois l'événement terminé, ou une fois qu'il a commencé s'il n'a pas de fin. ## Le jour de l'événement Wajub ne scanne pas les billets et n'enregistre pas les entrées. Pour contrôler l'accès, servez-vous de l'onglet **Participants** : une ligne par achat, avec l'acheteur, le type et le nombre de billets, les participants et le montant. **Rechercher des participants** retrouve un nom, un e-mail, un téléphone ou un participant, et **Exporter** télécharge la liste en CSV. Comme un code QR vaut pour tout un achat, vérifiez dans la liste combien de billets il couvre. La page du lien suit les **Billets vendus**, les **Acheteurs** et les **Billets restants**. ## Après la première vente Dès le premier billet vendu, les types de billets ne changent plus : nom, prix, quantité et ordre restent figés. La **Capacité du lieu** et le reste du lien restent modifiables. Un type dont toutes les ventes ont été remboursées peut être renommé, pas retiré. Après l'événement, la page de paiement ferme la vente, mais le lien reste **En ligne** dans le tableau de bord : **Archiver**, dans le menu de la page du lien, le range. --- # Choisir le domaine des liens URL: https://docs.wajub.com/fr/dashboard/payment-links/settings > Servir vos liens de paiement sur votre propre domaine plutôt que sur wajub.link, depuis les paramètres des liens de paiement. Par défaut, l'adresse d'un lien commence par wajub.link. Avec un domaine à vous, vérifié, vos liens peuvent s'ouvrir sur votre propre adresse ; les domaines personnalisés font partie des forfaits **Scale** et **Enterprise**. Le propriétaire, un Administrateur, un Développeur ou un Observateur ouvre ce réglage, comme un rôle personnalisé qui a **Voir les paramètres** ; seuls le propriétaire, un Administrateur ou un rôle qui a **Gérer les paramètres** l'enregistrent (voir les [rôles](https://docs.wajub.com/fr/dashboard#roles)). Il n'existe qu'en [Production](https://docs.wajub.com/fr/dashboard#sandbox-and-live), et aucun [code de sécurité](https://docs.wajub.com/fr/dashboard#the-security-code) n'est demandé. ## Les étapes 1. **Vérifiez votre domaine** Le domaine doit d'abord être connecté et vérifié : voir [Connecter votre domaine](https://docs.wajub.com/dashboard/settings/custom-domains). 2. **Ouvrez les paramètres des liens** Dans **Paramètres**, sous **Produits**, ouvrez **Liens de paiement**. La page s'appelle **Liens**. 3. **Choisissez le domaine** Dans **Domaine du lien de paiement**, choisissez votre domaine sous **Domaine**, ou **Par défaut (wajub.link)** pour revenir à l'adresse Wajub. Sans domaine vérifié, la page le signale et propose **Ajouter un domaine**.  *Seuls les domaines vérifiés sont proposés.* 4. **Enregistrez** La barre du bas propose **Enregistrer les modifications**, ou **Abandonner** pour revenir au réglage d'avant. ## Ce qui change Le domaine choisi sert à tous les liens qui n'ont pas leur propre domaine, y compris ceux déjà publiés, et il est proposé d'office pour chaque nouveau lien. Pour qu'un lien garde une autre adresse, choisissez son **Domaine** dans le formulaire du lien : voir [Partager un lien](https://docs.wajub.com/dashboard/payment-links/share#address-and-access). --- # Partager un lien URL: https://docs.wajub.com/fr/dashboard/payment-links/share > Envoyer l'adresse d'un lien de paiement par WhatsApp ou SMS, imprimer son code QR, mettre un bouton de paiement sur votre site et régler l'adresse et l'accès à la page. Toute personne qui voit les liens de paiement peut ouvrir la fenêtre de partage. Changer l'adresse ou l'accès d'un lien demande **Gérer les liens de paiement**, comme pour [créer un lien](https://docs.wajub.com/dashboard/payment-links/create). Les liens n'existent qu'en [Production](https://docs.wajub.com/fr/dashboard#sandbox-and-live). Aucun [code de sécurité](https://docs.wajub.com/fr/dashboard#the-security-code) n'est demandé. ## Les étapes 1. **Ouvrez la fenêtre de partage** Elle s'ouvre seule après la publication, avec pour titre **Votre lien est en ligne**, ou **Votre lien est créé, hors ligne pour l'instant** si la page n'est pas encore en ligne. Plus tard, **Partager le lien** en haut de la page du lien la rouvre. 2. **Envoyez l'adresse** Copiez l'**Adresse du lien**, ou choisissez sous **Partager avec** : WhatsApp, SMS, Telegram, X, Facebook ou e-mail, qui préparent un message avec le lien. Sur un téléphone, un bouton ouvre aussi le partage de l'appareil.  *Le code QR ouvre la page de paiement du lien.* 3. **Imprimez le code QR** **Télécharger le code QR** enregistre l'image à imprimer sur un flyer ou une carte de comptoir : scanné, il ouvre la page de paiement. ## Le bouton pour votre site L'onglet **Bouton pour votre site** prépare un bouton à coller dans votre site. **Par-dessus votre site** fait payer le client sans quitter votre page ; **Sur la page de paiement** est un simple lien qui marche partout, même là où les scripts sont interdits. Réglez le **Texte du bouton**, la **Couleur**, la **Forme** (**Carré**, **Arrondi** ou **Pilule**) et la **Taille** ; pour un lien simple, **Ouvrir la page dans** choisit **Nouvel onglet** ou **Même onglet**. L'**Aperçu** montre le bouton, puis **Copier** copie le **Code à coller** dans le bloc « Code », « HTML » ou « Intégrer » de Systeme.io, WordPress, Wix, Webflow ou Shopify. Si vous avez déclaré des sites dans [Les sites qui affichent la page](https://docs.wajub.com/dashboard/settings/checkout-page#embedding), la fenêtre par-dessus votre site ne s'ouvre que sur eux ; ailleurs, le bouton propose la page dans un nouvel onglet. Tant que la liste est vide, elle s'ouvre sur n'importe quel site.  *Le code se colle dans le bloc HTML de votre site.* ## L'adresse et l'accès Ces réglages se trouvent dans **Adresse et accès**, à la création ou avec **Modifier** : - **Adresse du lien** : la fin de l'adresse, de 3 à 100 lettres, chiffres, tirets ou tirets bas, libre sur tout Wajub. - **Domaine** : n'apparaît qu'avec un domaine vérifié ; voir [Choisir le domaine des liens](https://docs.wajub.com/dashboard/payment-links/settings). - **Page en ligne** : désactivée, la page répond « introuvable » jusqu'à sa mise en ligne. - **Fermer la page le** : une date de fermeture, sauf pour un événement ou une collecte de fonds, qui s'arrêtent seuls. - **Nombre maximum de ventes**, ou **Nombre maximum de paiements** pour un don ou une collecte : la page se ferme une fois le nombre atteint. - **Fermer après le premier paiement** : pour un seul payeur. Une fois le paiement réussi, la page indique aux visiteurs que le lien a déjà été utilisé, et pendant qu'un paiement est en cours, les autres visiteurs en sont avertis. Le lien se rouvre si ce paiement n'aboutit pas ; un remboursement ne le rouvre pas. Si un second paiement réussit malgré tout, le propriétaire, les Administrateurs et les membres Finance reçoivent un e-mail qui nomme le paiement à rembourser. - **Mot de passe pour ouvrir la page** : de 4 à 100 caractères, à donner avec le lien ; ensuite, **Changer le mot de passe** ou **Retirer le mot de passe**. - **Fermer après ce nombre de visites** : la page se ferme au-delà de ce nombre de visites. Les champs vides ne posent aucune limite. --- # Suivre un lien URL: https://docs.wajub.com/fr/dashboard/payment-links/track > Lire les visites, les ventes et le taux de conversion d'un lien de paiement, sa collecte ou ses billets, ses paiements et ses clients, et exporter ses clients en CSV. Toute personne qui voit les liens de paiement lit ces chiffres ; exporter demande **Gérer les liens de paiement**. Les liens n'existent qu'en [Production](https://docs.wajub.com/fr/dashboard#sandbox-and-live). Ouvrez **Liens de paiement**, puis le lien : sa page se lit par onglets, **Vue d'ensemble**, **Paiements**, l'onglet de ses clients et **Webhooks**. ## La performance Sous **Performance**, la **Période** vaut les 30 derniers jours par défaut. Quatre chiffres la résument : **Visites**, **Ventes**, **Revenus** et **Taux de conversion**, avec sous les trois premiers le total depuis la création du lien, et sous le taux, dès qu'il y a une vente, la vente moyenne de la période. **Visites et ventes** les trace jour par jour, et **Afficher sous forme de tableau** montre les mêmes chiffres en tableau. **Meilleurs pays** dit d'où viennent les visites, **Appareils** sur quoi la page a été ouverte. ## Ce que le lien a réuni Plus bas, un bloc dépend du type, depuis le début : - Collecte de fonds : **Progression de la collecte de fonds**, le montant collecté sur l'objectif, la **Progression de l'objectif** et le nombre de **Donateurs**. - Dons : **Dons**, avec le nombre de **Donateurs** et le **Total donné**. - Événement : **Billets**, avec les **Billets vendus**, les **Acheteurs** et les billets restants. Les montants reçus dans une autre devise que celle du lien s'affichent à part, sous le total. **Détails du lien** reprend ensuite ses réglages : devise, stock, livraison, durée ou lieu, fin de la campagne, mot de passe, catégorie et étiquettes. ## Les paiements L'onglet **Paiements** liste les paiements du lien avec leur montant, leur statut, le client, le moyen de paiement, l'identifiant du paiement et la date. ## Les clients et l'export L'onglet suivant s'appelle **Clients**, **Donateurs** pour un don ou une collecte, ou **Participants** pour un événement. Il montre une ligne par achat ou par don, avec les badges **Anonyme sur la page** ou **Litige perdu**. La recherche trouve un nom, un e-mail ou un téléphone, et le menu de chaque ligne mène à **Ouvrir le paiement** ou **Voir le client**. **Exporter** télécharge un CSV de 50 000 lignes au plus, avec la recherche et les dates de l'onglet. Il ajoute les réponses aux questions du lien et des colonnes selon le type : quantité, option choisie et adresse de livraison pour un produit ; type de billet et participants pour un événement ; don anonyme ou non pour un don ou une collecte. Chaque export compte dans la limite mensuelle d'exports de votre [forfait](https://docs.wajub.com/dashboard/subscription/plans).  *Les réponses aux questions du lien n'apparaissent que dans l'export.* --- # Répondre à un litige URL: https://docs.wajub.com/fr/dashboard/payments/disputes > Lire un litige, envoyer vos preuves et écrire au client avant l'échéance, puis accepter le litige ou le marquer comme gagné. Un litige conteste un paiement : pour un paiement encaissé par Wajub, le montant contesté est retenu sur votre solde jusqu'à ce que le litige se termine, et vous avez jusqu'à une échéance pour répondre. Il vient d'un client qui conteste depuis son portail Pocket, après une demande de remboursement, ou de la banque du client, par le fournisseur qui a traité le paiement : c'est alors une rétrofacturation. Tous les [rôles](https://docs.wajub.com/fr/dashboard#roles) voient les litiges, avec tous les forfaits. Envoyer des preuves, écrire au client, écrire une note, accepter un litige ou le marquer comme gagné est réservé au propriétaire, aux Administrateurs, aux membres Spécialiste support et aux rôles personnalisés qui ont **Gérer les litiges**. Accepter et marquer comme gagné demandent le [code de sécurité](https://docs.wajub.com/fr/dashboard#the-security-code). Les litiges de [Test](https://docs.wajub.com/fr/dashboard#sandbox-and-live) restent séparés de ceux de Production et n'envoient aucun e-mail. ## La liste des litiges Quand un litige s'ouvre en Production, le propriétaire, les Administrateurs et les membres Spécialiste support reçoivent un e-mail avec un lien vers le litige. Dans le tableau de bord, ouvrez **Paiements**, puis l'onglet **Litiges**. La liste réunit les litiges et les demandes de remboursement ; choisissez **Étape** › **Litige** pour ne garder que les litiges. Les demandes ont leur page : [Répondre à une demande](https://docs.wajub.com/dashboard/payments/refund-requests). Chaque ligne donne le **Montant**, l'**Étape**, le **Statut**, la date **Répondre avant le** avec le temps qui reste, le **Motif**, le **Client** et la date d'**Ouverture**. Un litige né d'une demande porte **Issu d'une demande de remboursement**. Choisissez l'en-tête **Répondre avant le** pour voir d'abord les échéances les plus proches. Un litige est **Ouvert** jusqu'à votre première preuve, puis **En cours d'examen**. Il se termine **Gagné**, **Perdu** ou **Résolu**. La barre de recherche trouve un litige par son identifiant, celui de son paiement ou son motif. **Date**, **Étape**, **Statut** et **Montant** filtrent la liste. Le menu au bout d'une ligne propose **Ouvrir le litige**, **Copier l'identifiant du litige**, **Voir le paiement** et, quand le litige a un client, **Voir le client**. ## Lire un litige Choisissez la ligne du litige, ou **Répondre au litige** sur la page du paiement. L'en-tête donne le montant contesté, le statut, l'**ID du litige** et la date d'ouverture. Dessous, un encadré rappelle l'échéance et le temps qui reste ; il devient rouge à moins de trois jours, puis annonce que le délai est dépassé.  *L'échéance juste sous le montant contesté.* Les faits sous l'en-tête donnent la date **Répondre avant le**, le **Motif** du litige, et le **Paiement** contesté avec le nom du client. **Détails du litige** donne de quoi joindre le client, puis ses mots : l'**Explication du client** pour un litige ouvert depuis Pocket, ou les **Détails transmis par le fournisseur** pour une rétrofacturation. Pour un litige né d'une demande, la section **Demande de remboursement** reprend la date de la demande, le **Montant demandé**, puis votre réponse si vous l'aviez refusée, ou **Sans réponse dans le délai**, et la date à laquelle le client l'a transformée en litige. **Preuves** liste ce que vous avez envoyé, **Conversation** vos échanges avec le client, et l'historique déroule le litige depuis son ouverture. À droite, **Paiement contesté** donne la date du paiement et son **ID du paiement**. Le menu de l'en-tête propose **Voir le paiement** et **Voir le client**. Un litige ouvert depuis Pocket vous laisse sept jours pour répondre. Passé ce délai, il reste ouvert jusqu'à ce que vous ou l'équipe Wajub le régliez. ## Envoyer des preuves 1. **Choisissez Soumettre des preuves** En haut de la page du litige, choisissez **Soumettre des preuves**. La fenêtre du même nom s'ouvre.  *Un type de preuve, une description et un fichier.* 2. **Choisissez le type de preuve** Sous **Type de preuve**, choisissez ce que la preuve montre, par exemple **Preuve de livraison**, **Échanges avec le client** ou **Reçu**. 3. **Décrivez la preuve** Sous **Description**, dites ce que la preuve établit, en 2 000 caractères au plus. 4. **Joignez le document** Sous **Fichier (facultatif)**, ajoutez un PDF, une image JPG ou PNG, un document Word ou un fichier texte, de 10 Mo au plus. 5. **Envoyez la preuve** Choisissez **Soumettre des preuves**. Le message « Preuves soumises avec succès. » s'affiche, la preuve apparaît sous **Preuves** et le litige passe à **En cours d'examen**. Le litige garde une preuve par type : une nouvelle preuve du même type remplace la précédente. ## Écrire au client 1. **Partez d'un modèle si besoin** Sous **Modèles de réponse**, choisissez un modèle, par exemple **Produit livré**, **Service rendu** ou **Paiement autorisé par le client**. Son texte remplit **Répondre au client**. 2. **Écrivez le message** Sous **Répondre au client**, écrivez ou adaptez le message, en 5 000 caractères au plus. 3. **Joignez des fichiers si besoin** Choisissez **Joindre un fichier** pour ajouter un PDF, une image JPG ou PNG, un document Word ou un fichier texte, de 10 Mo au plus chacun. 4. **Envoyez** Choisissez **Envoyer**. Le message « Message envoyé avec succès. » s'affiche et votre message rejoint **Conversation**. Le client suit le statut du litige et la conversation dans son portail Pocket, où il peut vous répondre ; il ne voit ni vos preuves ni vos notes. ## Accepter le litige Accepter un litige reconnaît que le client a raison : vous perdez le litige, sans retour possible. 1. **Choisissez Accepter le litige** En haut de la page du litige, choisissez **Accepter le litige**. **Accepter le litige ?** rappelle que le client sera remboursé et que vous perdrez le litige. 2. **Confirmez avec le code de sécurité** Choisissez **Accepter le litige**, puis saisissez le code de sécurité. Le message « Litige accepté. » s'affiche et le litige passe à **Perdu**. Pour un litige ouvert depuis Pocket sur un paiement réussi, le client est remboursé du montant contesté, dans la limite de ce qui reste à rembourser sur le paiement. Les frais de ce remboursement sont à votre charge, quel que soit votre [choix par défaut](https://docs.wajub.com/dashboard/payments/refund#the-default-fee-choice), et il apparaît dans [Suivre les remboursements](https://docs.wajub.com/dashboard/payments/track-refunds). Une rétrofacturation acceptée n'est pas remboursée : la banque du client lui a déjà rendu l'argent, et le montant contesté est retiré de votre solde. Tant qu'une rétrofacturation est en cours sur un paiement, un litige ouvert depuis Pocket sur ce même paiement ne peut pas être accepté ; la fenêtre en donne la raison. ## Marquer le litige comme gagné **Marquer comme gagné** enregistre qu'un litige ouvert depuis Pocket s'est terminé en votre faveur. 1. **Choisissez Marquer comme gagné** Dans le menu de l'en-tête, choisissez **Marquer comme gagné**. **Marquer le litige comme gagné ?** s'ouvre. 2. **Confirmez avec le code de sécurité** Choisissez **Marquer comme gagné**, puis saisissez le code de sécurité. Le message « Le litige a été marqué comme gagné. » s'affiche et le litige passe à **Gagné**. Le montant retenu revient sur votre solde disponible. Le menu ne propose pas **Marquer comme gagné** pour une rétrofacturation : seule la banque du client la tranche. ## Les notes Les notes d'un litige s'écrivent en bas de l'historique, sous « Que doivent savoir vos membres sur ce litige ? », et s'épinglent ou se suppriment comme celles d'un paiement : [Les notes](https://docs.wajub.com/dashboard/payments/read#notes). Elles existent aussi en Test. --- # Trouver un paiement URL: https://docs.wajub.com/fr/dashboard/payments/find > Chercher un paiement par référence ou par client, filtrer la liste par statut, montant, fournisseur ou métadonnée, et l'exporter en CSV, Excel, PDF ou JSON. **Paiements** liste les paiements de vos clients, avec leur montant, leur statut et le client qui a payé. La recherche et les filtres retrouvent un paiement précis ; l'export emporte la liste dans un fichier. Tous les [rôles](https://docs.wajub.com/fr/dashboard#roles) ouvrent **Paiements**, avec tous les forfaits. Exporter est réservé au propriétaire, aux Administrateurs, aux membres Finance et Spécialiste support, et aux rôles personnalisés qui ont **Gérer les paiements**, en [Production](https://docs.wajub.com/fr/dashboard#sandbox-and-live) uniquement. Rien sur cette page ne demande le [code de sécurité](https://docs.wajub.com/fr/dashboard#the-security-code). ## La liste Ouvrez **Paiements** dans le menu. Les onglets en haut mènent aussi à **Remboursements** et à **Litiges** ; le nombre affiché sur **Litiges** compte les demandes de remboursement qui attendent votre réponse. Chaque ligne donne le **Montant**, le **Statut**, la **Description** avec l'identifiant du paiement, le **Client**, le **Moyen de paiement** et la **Date**. La description n'apparaît que sur un écran large, et le moyen de paiement se masque sur un écran étroit. Un paiement réglé en plusieurs fois porte le nombre de ses échéances. **Client supprimé** remplace le nom d'un client effacé depuis, **Aucun client** signale un paiement sans client. Choisissez l'en-tête **Montant** ou **Date** pour trier la liste.  *La recherche et les filtres au-dessus, un paiement par ligne.* Le menu au bout d'une ligne propose **Ouvrir le paiement**, **Copier l'identifiant du paiement** et, quand le paiement a un client, **Voir le client**. Pour un paiement **Réussi**, **Partiellement remboursé** ou **Remboursé**, il ajoute **Télécharger le reçu**. Cochez des lignes, jusqu'à 100, pour **Copier les identifiants** de toutes à la fois ou les exporter. ## Chercher et filtrer La barre de recherche trouve un paiement par sa référence, sa description, ou le nom, l'e-mail ou le téléphone du client. **Date** limite la liste à une période toute prête ou aux jours de votre choix. Les autres filtres se combinent : - **Statut** : un ou plusieurs statuts, par exemple **Réussi**, **En attente** ou **Échoué**. - **Montant** : un minimum, un maximum, ou les deux. - **Fournisseur** : le fournisseur qui a traité le paiement. Ce filtre n'apparaît que si votre organisation a connecté un fournisseur : [Connecter un prestataire](https://docs.wajub.com/dashboard/orchestration/connect-provider). - **Canal** : le canal par lequel le client a payé, ou **Tous les canaux**. - **Motif de l'échec** : en Production, la raison de l'échec d'un paiement, rangée sous **Du côté du fournisseur**, **Du côté du client** et **Autre**, par exemple **Fonds insuffisants**. - **Intégration** : le SDK ou la page depuis lequel le paiement a été fait. **Paiement (page hébergée ou Wajub.js)** regroupe les paiements faits sur une page de paiement qui n'a pas dit laquelle des deux, et **Inconnu** ceux qui n'indiquent aucune intégration. - **Échéances** : **Avec échéances** ou **Sans échéances**. - **Métadonnées** : une **Clé** envoyée par votre intégration, et sa **Valeur (optionnelle)**. Choisissez **Appliquer**. Un chiffre de l'accueil ouvre cette liste avec deux filtres de plus : **Période**, la période exacte que comptait le chiffre, et **Crédités sur le solde**, ou **Statut** pour un chiffre d'échecs. Choisissez des jours dans **Date** pour remplacer la période. Chaque filtre se retire avec sa croix. ## Exporter Choisissez **Exporter** en haut de la page, ou dans la barre qui apparaît quand des lignes sont cochées. **Exporter les paiements** s'ouvre : le fichier reprend la liste avec ses filtres, ou les seules lignes cochées. Chaque paiement du fichier donne son **Intégration**. 1. **Choisissez le format** Sous **Format**, choisissez **CSV**, **Excel**, **PDF** ou **JSON**. 2. **Choisissez la période** Sans lignes cochées, sous **Période**, choisissez une période toute prête, ou remplissez **De** et **À** sous **Période personnalisée** puis choisissez **Appliquer**. Sans période, toutes les dates sont exportées. **Filtres conservés** rappelle la recherche et les filtres que le fichier appliquera. 3. **Exportez** Choisissez **Exporter en CSV**, **Exporter en Excel**, **Exporter en PDF** ou **Exporter JSON**, selon le format. Le fichier se télécharge, et « Votre export est prêt : » s'affiche avec son nom. En Test, la fenêtre explique que les exports ne contiennent que des données de production et ne propose pas d'exporter. Chaque export compte dans la limite mensuelle de votre forfait : [Choisir ou changer de forfait](https://docs.wajub.com/dashboard/subscription/plans). Une fois la limite atteinte, la fenêtre le dit et n'exporte plus. Le propriétaire, les Administrateurs et les rôles personnalisés qui ont **Gérer le compte** voient **Passer à un forfait supérieur** ; les autres membres sont invités à s'adresser au propriétaire. --- # Lire un paiement URL: https://docs.wajub.com/fr/dashboard/payments/read > Le statut, l'historique et la répartition d'un paiement, son reçu, les notes de l'équipe et le renvoi du lien de paiement au client. La page d'un paiement réunit ce qui lui est arrivé : son statut, chaque tentative, ce qu'il vous rapporte une fois les frais retirés, et les litiges ouverts dessus. Tous les [rôles](https://docs.wajub.com/fr/dashboard#roles) ouvrent un paiement, avec tous les forfaits. Écrire une note et renvoyer le lien de paiement demandent **Gérer les paiements**, qu'ont le propriétaire, les Administrateurs, les membres Finance et Spécialiste support, et l'Utilisateur de test en Test. L'onglet **Échéances** n'existe qu'à partir du forfait **Growth**, et les notes qu'en [Production](https://docs.wajub.com/fr/dashboard#sandbox-and-live). Hormis le remboursement, rien sur cette page ne demande le [code de sécurité](https://docs.wajub.com/fr/dashboard#the-security-code). ## L'en-tête Ouvrez un paiement depuis **Paiements** : [Trouver un paiement](https://docs.wajub.com/dashboard/payments/find). L'en-tête donne le montant, le statut, l'**ID du paiement** et sa date. **Retenue pour risque** signale un paiement crédité sur votre solde dont l'argent est retenu un temps avant de pouvoir être transféré. Dessous, **Client** mène à la fiche du client, **Moyen de paiement** nomme le moyen et le fournisseur, et **Créé depuis** dit d'où vient le paiement, par exemple un lien de paiement, une facture, l'API ou le tableau de bord. **Retour aux paiements** revient à la liste. Les boutons de l'en-tête dépendent du statut. **Reçu** apparaît pour un paiement réussi, remboursé ou partiellement remboursé ; **Rembourser** est décrit dans [Rembourser un paiement](https://docs.wajub.com/dashboard/payments/refund). Le menu à côté propose, selon le paiement, **Voir le client**, **Télécharger le reçu (PDF)** et **Envoyer le lien de paiement**.  *Le paiement à gauche, ce qu'il vous rapporte à droite.* Quand un client conteste le paiement, l'encadré **Ce paiement est contesté** donne le montant contesté, le motif et l'échéance de votre réponse. **Répondre au litige** ouvre le litige : [Répondre à un litige](https://docs.wajub.com/dashboard/payments/disputes). Une fois le litige terminé, l'encadré devient **Litige gagné** ou **Litige clos**, avec **Voir le litige**. ## Les onglets **Vue d'ensemble** s'ouvre en premier. **Remboursements** apparaît quand le paiement en a, avec le montant, le motif et le statut de chacun : [Suivre les remboursements](https://docs.wajub.com/dashboard/payments/track-refunds). **Échéances** apparaît pour un paiement réglé en plusieurs fois, avec le détail de chaque échéance. ## La vue d'ensemble Un paiement qui n'a pas abouti commence par un encadré. **Paiement échoué** donne le **Code d'erreur** et une **Action suggérée** à transmettre au client. **Paiement expiré** et **Paiement annulé** disent que le paiement s'est arrêté avant d'être terminé. **Détails du paiement** donne la date **Crédité le**. Pendant une retenue, **Fonds disponibles le** dit quand elle se lève ; une fois levée, **Fonds devenus disponibles le** dit depuis quand vous pouvez transférer l'argent. Suivent le **Taux de change** et **Payé en** quand le client a payé dans une autre devise, l'**Intégration**, le SDK ou la page depuis lequel le paiement a été fait, la **Description**, et le **Descripteur de relevé** que le client voit sur son relevé. Les sections suivantes n'apparaissent que si le paiement en a : **Articles de commande**, à titre d'information, **Taxe**, **Références** avec **Votre référence**, **Référence de traitement** et **Référence fournisseur**, **Adresses**, puis **Paiements liés**. **Historique** déroule les étapes du paiement et chacune de ses tentatives, avec le fournisseur qui l'a traitée ; **Tout développer** les ouvre toutes. Pour un paiement qui n'a pas réussi, **Réviser le routage** mène au choix de fournisseur qu'a fait Wajub. **Webhooks** liste les événements envoyés à votre serveur pour ce paiement, avec la réponse reçue et les nouvelles tentatives. **Métadonnées** montre les données ajoutées par votre intégration. ## La répartition des revenus À droite, **Répartition des revenus** part du **Montant brut**, retire chaque frais avec son taux, puis ce qui a été **Remboursé** et ce qui a été **Perdu dans un litige**. Le **Montant net** est ce qui vous reste ; « Sera versé le » donne, quand elle est connue, la date de son versement. Tant que le paiement n'a pas réussi, les frais sont **Facturé en cas de succès** et le montant net **Non réglé**. Dessous, **Moyen de paiement** détaille le moyen utilisé, et **Risque et sécurité** donne le score de risque et ce que le contrôle a relevé. ## Les notes Les notes s'écrivent en bas de **Historique**, pour les membres de votre équipe ; le client ne les voit jamais. Saisissez le texte sous « Que doivent savoir vos membres sur ce paiement ? », puis choisissez **Ajouter une note**. Le menu d'une note propose **Épingler la note**, qui la range sous **Notes épinglées** en tête de l'historique, et **Supprimer la note**. ## Le reçu **Reçu** ouvre le reçu tel que le client le voit : le montant payé, la date, le moyen de paiement et les coordonnées de votre organisation. **Télécharger le PDF** l'enregistre, **Imprimer le reçu** l'imprime. **Télécharger le reçu (PDF)**, dans le menu, l'enregistre sans l'ouvrir. ## Renvoyer le lien de paiement Un client qui n'a pas terminé son paiement peut le reprendre depuis un lien envoyé par e-mail. Il faut un paiement **En attente** ou **En traitement**, pas encore expiré, et rattaché à un client. 1. **Choisissez Envoyer le lien de paiement** Dans le menu de l'en-tête, choisissez **Envoyer le lien de paiement**. Si le client a une adresse e-mail, une fenêtre la rappelle et demande confirmation. 2. **Indiquez l'adresse si besoin** Si le client n'a pas d'adresse e-mail, saisissez-la dans **E-mail du client**. Elle n'est enregistrée sur sa fiche que si votre rôle peut gérer les clients. 3. **Envoyez le lien** Choisissez **Envoyer le lien**. Le client reçoit un e-mail avec le lien pour terminer son paiement. --- # Répondre à une demande URL: https://docs.wajub.com/fr/dashboard/payments/refund-requests > Approuver ou refuser la demande de remboursement qu'un client a faite depuis son portail Pocket, avant qu'il puisse la transformer en litige. Un client qui veut récupérer son argent commence par une demande de remboursement, depuis son portail Pocket. C'est l'étape à l'amiable, avant tout litige : votre réponse décide s'il récupère son argent ou s'il peut contester le paiement. Tous les [rôles](https://docs.wajub.com/fr/dashboard#roles) voient les demandes. Approuver est réservé au propriétaire, aux Administrateurs, aux membres Spécialiste support et aux rôles personnalisés qui ont **Rembourser les paiements**, et demande le [code de sécurité](https://docs.wajub.com/fr/dashboard#the-security-code). Refuser est ouvert au propriétaire, aux Administrateurs, aux membres Finance et Spécialiste support et aux rôles personnalisés qui ont **Gérer les paiements**, sans code de sécurité. Les demandes n'existent qu'en [Production](https://docs.wajub.com/fr/dashboard#sandbox-and-live), avec tous les forfaits. ## Ouvrir une demande Quand une demande arrive, le propriétaire et les membres qui peuvent l'approuver ou la refuser reçoivent un e-mail, puis, si elle attend toujours, un rappel deux jours avant que le client puisse ouvrir un litige. Ces e-mails suivent la préférence **Litiges** de chacun : [Préférences](https://docs.wajub.com/dashboard/account/preferences). Le lien de l'e-mail ouvre directement la demande. Dans le tableau de bord, ouvrez **Paiements**, puis l'onglet **Litiges** : le nombre affiché sur l'onglet compte les demandes qui attendent votre réponse. Choisissez **Étape** › **Demande** pour ne garder qu'elles, puis choisissez la ligne. **Examiner la demande de remboursement** s'ouvre.  *Le montant demandé, le motif du client et la date limite de votre réponse.* La fenêtre donne le **Montant demandé**, le **Paiement** et ce qui reste à rembourser dessus (**Reste à rembourser dessus**), ce que **Le client reçoit** une fois la part des frais Wajub réglée, et le **Motif du client**. **Répondre avant le** est la date après laquelle le client peut ouvrir un litige si vous n'avez pas répondu. ## Approuver 1. **Vérifiez ce que fait l'approbation** L'encadré **Ce que fait l'approbation** dit combien le client récupère, depuis votre solde. La part des frais suit votre choix par défaut : [Le choix par défaut des frais](https://docs.wajub.com/dashboard/payments/refund#the-default-fee-choice). 2. **Approuvez** Choisissez le bouton « Approuver et rembourser », suivi du montant demandé, puis saisissez le code de sécurité. Le message « Demande de remboursement approuvée. Le remboursement a été enregistré. » s'affiche. Le remboursement part comme tout autre remboursement : [Suivre les remboursements](https://docs.wajub.com/dashboard/payments/track-refunds). Dans la liste des litiges, le menu de la demande propose ensuite **Voir le remboursement**. ## Refuser 1. **Choisissez Rejeter** Dans la fenêtre de la demande, choisissez **Rejeter**. **Refuser la demande de remboursement** s'affiche : aucun argent ne bouge. 2. **Écrivez votre réponse** Sous **Votre réponse au client**, dites pourquoi vous refusez et ce que le client peut faire à la place, en 1 000 caractères au plus. La réponse est obligatoire. 3. **Refusez la demande** Choisissez **Refuser la demande**. Le message « Demande de remboursement refusée. » s'affiche. Le client lit votre réponse dans son portail Pocket. ## Quand l'approbation est bloquée Un encadré remplace **Ce que fait l'approbation** quand la demande ne peut pas être remboursée telle quelle : | Encadré | Ce qu'il faut faire | | ----------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | | **Ce paiement ne peut pas être remboursé** | Seul un paiement réussi et crédité sur votre solde se rembourse. Refusez en expliquant pourquoi. | | **Un litige est ouvert sur ce paiement** | Répondez au litige plutôt qu'à la demande, pour ne pas payer le client deux fois. **Ouvrir le litige** y mène. | | **Une rétrofacturation est en cours sur ce paiement** | La banque du client décide ; le paiement ne peut pas être remboursé avant sa décision. | | **Il ne reste rien à rembourser** | Le paiement a déjà été rendu en entier. Refusez et dites-le au client. | | **Plus que ce qui reste à rembourser** | Le client demande plus que ce qui reste. Si vous refusez, il peut ouvrir un litige pour ce qui reste. | | **Déjà approuvée** | La demande a été approuvée et le remboursement fait, mais la réponse s'est perdue. **Terminer l'approbation** la clôt, sans second remboursement. | ## Quand le client ouvre un litige Le client peut transformer sa demande en litige depuis Pocket sept jours après l'avoir faite si vous n'avez pas répondu, ou dans les 30 jours qui suivent votre refus. La demande passe alors à **Transformée en litige**, et le litige apparaît dans la même liste, marqué **Issu d'une demande de remboursement** : [Répondre à un litige](https://docs.wajub.com/dashboard/payments/disputes). --- # Rembourser un paiement URL: https://docs.wajub.com/fr/dashboard/payments/refund > Rendre tout ou partie d'un paiement à votre client, choisir qui supporte les frais Wajub, et régler ce choix par défaut dans Paramètres › Remboursements. Un remboursement renvoie au client tout ou partie de ce qu'il a payé. Il ne peut pas être annulé. Rembourser est réservé au propriétaire, aux Administrateurs, aux membres Spécialiste support et aux [rôles](https://docs.wajub.com/fr/dashboard#roles) personnalisés qui ont **Rembourser les paiements**, avec tous les forfaits : un membre Finance ne peut pas rembourser. Rembourser demande le [code de sécurité](https://docs.wajub.com/fr/dashboard#the-security-code). En [Test](https://docs.wajub.com/fr/dashboard#sandbox-and-live), il se fait aussitôt, sans argent réel. ## Les étapes 1. **Ouvrez le paiement** Ouvrez le paiement depuis **Paiements** : [Trouver un paiement](https://docs.wajub.com/dashboard/payments/find). **Rembourser** apparaît en haut de la page pour un paiement **Réussi** ou **Partiellement remboursé** dont il reste un montant à rendre. 2. **Choisissez Rembourser** Choisissez **Rembourser**. **Rembourser ce paiement** s'ouvre sur le **Montant du paiement**, ce qui est **Déjà remboursé**, ce qui a été **Perdu dans un litige** s'il y en a, et le montant **Disponible pour remboursement**.  *Le montant est prérempli avec tout ce qui reste à rembourser.* 3. **Indiquez le montant** **Montant du remboursement** est prérempli avec tout ce qui reste à rembourser. Pour un remboursement partiel, saisissez un montant plus petit, ou choisissez 25 % ou 50 % du montant restant ; **Montant total** revient à tout ce qui reste. 4. **Ajoutez un motif** Le **Motif**, facultatif et de 500 caractères au plus, reste attaché au remboursement. 5. **Choisissez qui supporte les frais** Si le paiement a coûté des frais Wajub, **Qui supporte les frais Wajub sur ce remboursement ?** propose deux cartes. **Vous** rend au client tout ce qu'il a payé, y compris des frais qu'il aurait payés en plus, pris sur votre solde. **Client** laisse la part des frais au client : elle est déduite de ce qu'il récupère. La carte choisie d'avance suit le réglage par défaut, décrit plus bas. 6. **Vérifiez ce que fait le remboursement** Une fois le montant valide, **Ce que fait ce remboursement** montre le **Montant du remboursement**, ce que **Le client reçoit**, la **Part des frais Wajub** s'il y en a une, ce qui est **Débité de votre solde** et ce qui **Reste à rembourser ensuite**. Pour un paiement encaissé sur votre propre compte chez un fournisseur, **Débité de votre solde** indique **Rien** et dit de le rembourser depuis ce compte. Le bouton de remboursement attend que ces chiffres s'affichent ; s'ils ne peuvent pas l'être, choisissez **Réessayer**. 7. **Confirmez avec le code de sécurité** Choisissez le bouton « Rembourser », suivi du montant, puis saisissez le code de sécurité. Le message de confirmation dit ce qui se passe ensuite, selon le cas décrit ci-dessous. ## Après le remboursement Pour un paiement encaissé par Wajub, Wajub envoie le remboursement au client. Pour un paiement encaissé sur votre propre compte chez un fournisseur, le remboursement est enregistré, mais c'est à vous de le faire depuis ce fournisseur ; il se met à jour dans Wajub une fois que le fournisseur le confirme. Dans les deux cas, l'onglet **Remboursements** du paiement le suit : [Suivre les remboursements](https://docs.wajub.com/dashboard/payments/track-refunds). Quand le remboursement est refusé, la raison s'affiche sous **Montant du remboursement** ; tout autre problème s'affiche sous **Le remboursement n'a pas été effectué**. Pendant une rétrofacturation, la banque du client décide seule et le paiement ne peut pas être remboursé : **Rembourser** disparaît jusqu'à sa décision. Un compte dont les remboursements sont restreints doit d'abord [contacter l'assistance](https://docs.wajub.com/dashboard/help/support). ## Le choix par défaut des frais **Paramètres › Remboursements** fixe qui supporte les frais quand vous remboursez, pour la part des frais qui correspond au montant rendu. Wajub garde ses frais dans tous les cas. Le tableau de bord préremplit ce choix dans chaque remboursement, et l'API l'applique quand un remboursement ne précise rien. Sous **Qui supporte les frais lors d'un remboursement**, choisissez : - **Celui qui les a payés au paiement** : vous continuez de supporter les frais que vous aviez payés, et un client qui les avait payés en plus ne les récupère pas. C'est le choix de départ. - **Vous** : le client récupère tout ce qu'il a payé, frais compris, pris sur votre solde. - **Le client** : la part des frais reste au client, déduite de ce qu'il récupère quand c'est vous qui les aviez payés. Choisissez **Enregistrer les modifications**. Changer ce réglage est réservé au propriétaire, aux Administrateurs et aux rôles personnalisés qui ont **Gérer les paramètres** ; un Développeur ou un Observateur le lit sans pouvoir le changer. --- # Suivre les remboursements URL: https://docs.wajub.com/fr/dashboard/payments/track-refunds > Retrouver un remboursement, savoir où il en est et ce que le client a reçu, et exporter la liste des remboursements. **Remboursements** liste l'argent rendu à vos clients, que le remboursement vienne du tableau de bord, de l'API ou d'une demande de remboursement approuvée, et dit où en est chacun. Tous les [rôles](https://docs.wajub.com/fr/dashboard#roles) ouvrent **Remboursements**, avec tous les forfaits. Exporter est réservé au propriétaire, aux Administrateurs, aux membres Finance et Spécialiste support, et aux rôles personnalisés qui ont **Gérer les paiements**, en [Production](https://docs.wajub.com/fr/dashboard#sandbox-and-live) uniquement. Rien sur cette page ne demande le [code de sécurité](https://docs.wajub.com/fr/dashboard#the-security-code). ## La liste Ouvrez **Paiements**, puis l'onglet **Remboursements**. Chaque ligne donne le **Montant**, le **Statut**, le **Client** et le **Paiement** remboursé, avec la **Date**. Un remboursement passe par **En attente** et **En traitement** avant d'être **Réussi** ; il peut aussi finir **Échoué** ou **Annulée**.  *Un remboursement par ligne, avec le paiement qu'il rembourse.* La barre de recherche trouve un remboursement par son identifiant, celui de son paiement, son motif, ou le nom ou l'e-mail du client. **Date**, **Statut** et **Montant** filtrent la liste. Le menu au bout d'une ligne propose **Ouvrir le remboursement**, **Copier l'identifiant du remboursement**, **Voir le paiement** et, quand le remboursement a un client, **Voir le client**. Cochez des lignes pour **Copier les identifiants** de toutes à la fois ou les exporter. ## Le détail d'un remboursement La page d'un remboursement donne son montant, son statut et son **Identifiant du remboursement**. Dessous, **Paiement** mène au paiement remboursé, **Client** à la fiche du client, et **Le client reçoit** donne ce qu'il récupère, avec qui a supporté les frais. **Détails du remboursement** reprend le **Motif**, la **Description**, la date **Terminé le** et, quand le paiement en portait, la **Taxe** annulée en proportion du remboursement. L'historique suit le remboursement de **Remboursement demandé** à **Remboursement effectué**, ou à **Remboursement échoué** ou **Remboursement annulé** ; entre les deux, **En attente du fournisseur** montre qu'il est en cours. À droite, **Paiement d'origine** résume le paiement. Sur la page du paiement, l'onglet **Remboursements** liste aussi ses remboursements. Pour un remboursement en cours, il précise si l'équipe Wajub s'en charge, s'il est en route vers le client, ou s'il vous reste à le faire depuis votre compte chez le fournisseur. ## Exporter Choisissez **Exporter** en haut de l'onglet, ou dans la barre qui apparaît quand des lignes sont cochées. **Exporter les remboursements** fonctionne comme l'export des paiements, avec les mêmes formats et la même limite mensuelle : [Exporter des paiements](https://docs.wajub.com/dashboard/payments/find#export). --- # Consulter le journal d'audit URL: https://docs.wajub.com/fr/dashboard/settings/audit-log > Retrouver qui a changé quoi dans l'organisation, quand et depuis quelle adresse IP, et vérifier que le journal n'a pas été modifié. Le **Journal d'audit** garde les modifications faites sur l'organisation, chacune avec le membre qui l'a faite, son adresse IP, son appareil et l'heure : - le nom de l'organisation, les membres, les invitations, les rôles et les rôles personnalisés ; - les clés API et les secrets de signature des webhooks ; - les sites autorisés à intégrer la page de paiement, la sécurité des transferts et les domaines personnalisés ; - la vérification de l'entreprise, la facturation et l'abonnement ; - les remboursements, les litiges, les liens de paiement envoyés et les avoirs ; - les clients ; - les transferts, les transferts récurrents et les bénéficiaires ; - les fournisseurs de paiement et les règles de routage ; - les connexions Sync et les applications connectées ; - ce que fait le support Wajub dans l'organisation. Des réglages comme l'image de marque, les champs de la page de paiement, sa langue et ses devises ne sont pas enregistrés. Vos propres connexions, mot de passe, méthode de double authentification et clés d'accès sont dans [Votre activité](https://docs.wajub.com/dashboard/account/activity-and-data). Le propriétaire, un Administrateur, un Développeur, un Observateur ou un rôle personnalisé qui a **Voir les paramètres** ouvre le journal. Personne ne peut le modifier, et il n'a pas d'export. Le même journal s'affiche en Test et en Production. ## Ouvrir le journal Ouvrez **Paramètres**, puis **Journal d'audit** dans le groupe **Organisation**. Chaque ligne donne l'**Action**, le **Membre** qui l'a faite, l'**Adresse IP et appareil** et la **Date**. Une action faite par Wajub lui-même porte **Système** à la place du membre. Les entrées vont de la plus récente à la plus ancienne, 50 par page. Ce que fait le support Wajub porte **Support Wajub** à la place du membre, par exemple **Le support Wajub a ouvert l'organisation**, **Fin de la session du support Wajub** ou **Informations de l'organisation modifiées par le support Wajub**. Chaque fois que le support ouvre l'organisation, le propriétaire reçoit aussi un e-mail.  *Chaque ligne dit qui a fait quoi, depuis où et quand.* La plupart des modifications du propriétaire ajoutent aussi une ligne **Le propriétaire a utilisé son accès complet**. Pour ne suivre qu'une sorte de modification, filtrez par **Action**. ## Chercher une action La recherche porte sur l'e-mail du membre, l'adresse IP ou l'action. Les filtres **Date**, jusqu'à 365 jours en arrière, **Action** et **Membre** se combinent ; un membre qui a quitté l'organisation reste proposé dans le filtre **Membre**, comme **Support Wajub** dès que le support y a agi. ## Vérifier l'intégrité Chaque entrée est liée à la précédente, ce qui rend visible toute entrée modifiée, supprimée ou déplacée. **Vérifier l'intégrité** contrôle tout le journal et affiche **Le journal d'audit est intact**, avec le nombre d'entrées vérifiées, ou **Le journal d'audit a été altéré**, avec la première entrée qui ne correspond pas. Dans ce cas, contactez le [support](https://docs.wajub.com/dashboard/help/support). --- # Personnaliser votre marque URL: https://docs.wajub.com/fr/dashboard/settings/branding > Mettre votre logo, vos couleurs et votre police sur la page de paiement, les factures, les reçus et les e-mails envoyés à vos clients, avec un aperçu en direct. **Paramètres › Image de marque** donne à ce que voient vos clients votre logo, vos couleurs et votre police : la page de paiement, les factures, les reçus et les e-mails. Le propriétaire, un Administrateur, un Développeur, un Observateur ou un rôle personnalisé qui a **Voir les paramètres** ouvre la page. Seuls le propriétaire, un Administrateur ou un rôle personnalisé qui a **Gérer les paramètres** enregistre une marque. Il faut le forfait **Growth** ou au-dessus ; sinon, voir [Modules hors de votre forfait](https://docs.wajub.com/fr/dashboard#modules-outside-your-plan). La marque vaut en Test comme en Production, et aucun code de sécurité n'est demandé. ## Les étapes 1. **Ouvrez le studio de marque** Ouvrez **Paramètres**, puis **Image de marque** dans le groupe **Produits**. Le **Studio de marque** montre les réglages à gauche et l'aperçu à droite.  *Les autres réglages sont dans les onglets Couleurs, Typographie et Avancé.* 2. **Importez vos logos** Dans l'onglet **Identité**, importez une **Icône** carrée de 512 × 512 px et un **Logo** large, en PNG ou JPG, jusqu'à 2 Mo chacun. 3. **Choisissez vos couleurs** Dans l'onglet **Couleurs**, partez d'un des **Préréglages**, puis ajustez au besoin les **Jetons de couleur** un par un, en saisissant un code comme #007492. 4. **Réglez la présentation** Dans l'onglet **Typographie**, choisissez l'**Apparence** (**Suivre l'appareil**, **Clair** ou **Sombre**), la **Densité**, le **Traitement des médias**, la **Famille de police** et le **Rayon des coins**. 5. **Vérifiez l'aperçu** Au-dessus de l'aperçu, passez de la page de paiement à la facture, au reçu ou à l'e-mail, en **Mobile**, **Tablette** ou **Bureau**. 6. **Enregistrez la marque** **Enregistrer les modifications**, dans la barre en bas de l'écran, applique tous les réglages d'un coup ; **Abandonner** les annule. ## Les réglages avancés L'onglet **Avancé** règle le **Domaine de paiement** de la page de paiement : **Par défaut (pay.wajub.com)** ou l'un de vos [domaines personnalisés](https://docs.wajub.com/dashboard/settings/custom-domains). Un domaine personnalisé qui sert la page de paiement y est choisi de lui-même une fois vérifié. Les liens de paiement et les factures choisissent le leur dans **Paramètres › Liens de paiement** et **Paramètres › Factures**. **Sauvegarde du thème** exporte vos réglages avec **Exporter JSON** et les reprend avec **Importer du JSON**, par exemple dans une autre organisation. **Tout réinitialiser** remet les couleurs, la police, les coins et la présentation par défaut ; rien ne change tant que vous n'enregistrez pas. Un logo retiré disparaît de la page de paiement, des factures et des e-mails au prochain enregistrement. La page avertit aussi quand aucun site n'est déclaré pour afficher votre page de paiement : voir [Régler la page de paiement](https://docs.wajub.com/dashboard/settings/checkout-page#embedding). --- # Régler la page de paiement URL: https://docs.wajub.com/fr/dashboard/settings/checkout-page > Ajouter des champs à remplir avant de payer, choisir la langue et les devises de la page de paiement, et déclarer les sites qui peuvent l'afficher dans un cadre. **Paramètres › Paiement** règle ce que la page de paiement Wajub demande au client, dans quelle langue et avec quelles devises elle s'affiche, et sur quels sites elle peut apparaître. Le propriétaire, un Administrateur, un Développeur, un Observateur ou un rôle personnalisé qui a **Voir les paramètres** ouvre ces réglages. Seuls le propriétaire, un Administrateur ou un rôle personnalisé qui a **Gérer les paramètres** les change ; la liste des sites, un Développeur ou un rôle qui a **Gérer les paramètres développeur** peut aussi la changer. Tous les forfaits ont ces réglages, valables en Test comme en Production. Seul l'enregistrement de la liste des sites demande le code de sécurité. ## Ajouter un champ 1. **Ouvrez les champs** Ouvrez **Paramètres › Paiement**. L'onglet **Champs** liste vos **Champs personnalisés**, à côté d'un aperçu de la page de paiement en **Mobile**, **Tablette** ou **Bureau**.  *Chaque champ affiche son type et son texte indicatif.* 2. **Ouvrez le formulaire du champ** **Ajouter un champ personnalisé** ouvre la fenêtre du même nom. 3. **Choisissez le type de champ** Sous **Type de champ**, choisissez **Texte court**, **Texte long**, **Numéro** pour un nombre, **E-mail**, **Téléphone**, **Menu déroulant** ou **Case à cocher**. Pour un menu déroulant, ajoutez ses choix sous **Options** avec **Ajouter l'option**. 4. **Rédigez la question** Saisissez le **Libellé (question)**, et si besoin un **Texte indicatif (optionnel)** qui s'affiche dans le champ vide. **Champ requis** oblige le client à le remplir pour payer. 5. **Ajoutez le champ** **Ajouter un champ personnalisé** enregistre le champ : la page de paiement le demande aussitôt. Le menu au bout d'un champ le modifie, le masque du paiement sans le supprimer ou le supprime définitivement ; les flèches à sa gauche changent sa place dans la liste. Le client remplit ces champs sur la page de paiement, avant de payer. ## Choisir la langue Dans l'onglet **Langue**, la **Langue par défaut** est **Détection automatique**, **Anglais** ou **Français**. **Enregistrer les modifications** applique le choix. ## Les devises Dans l'onglet **Devises**, la **Devise de base** est celle dans laquelle le tableau de bord présente vos chiffres et facture par défaut, la même pour tous les membres. Elle ne change pas la devise de règlement, celle de vos versements, affichée dans **Paramètres › Général**. **Activer la conversion automatique** montre les prix dans la devise du client, parmi les **Devises affichées** que vous choisissez ; le client paie toujours dans la devise du paiement. **Activer les paiements fractionnés manuels** permet à votre intégration de découper un paiement en deux, trois ou quatre échéances, selon le **Nombre de fractionnements autorisés** et au-dessus du **Montant minimum pour fractionnement manuel**. **Enregistrer les modifications** applique ces réglages. ## Les sites qui affichent la page Si votre site affiche la page de paiement dans un cadre, déclarez-le dans l'onglet **Intégration**, sous **Sites autorisés**, un par ligne : https\:// suivi du domaine, sans chemin, jusqu'à 20 sites. Seuls ces sites peuvent alors l'afficher, en Test comme en Production. Tant que la liste est vide, n'importe quel site le peut, et la page vous en avertit. **Enregistrer les modifications** demande le code de sécurité.  *Une liste vide laisse n'importe quel site afficher votre page de paiement.* --- # Connecter votre domaine URL: https://docs.wajub.com/fr/dashboard/settings/custom-domains > Servir la page de paiement, les liens de paiement et les factures sur un sous-domaine à vous, comme pay.example.com, en publiant deux enregistrements DNS. Un domaine personnalisé remplace l'adresse Wajub par défaut par un sous-domaine qui vous appartient, comme pay.example.com, pour la page de paiement, les liens de paiement et les factures. Le propriétaire, un Administrateur, un Développeur ou un rôle personnalisé qui a **Gérer les paramètres** ou **Gérer les paramètres développeur** connecte et gère les domaines ; un Observateur ou un rôle qui n'a que **Voir les paramètres** les voit. Il faut le forfait **Scale** ou **Enterprise** ; sinon, voir [Modules hors de votre forfait](https://docs.wajub.com/fr/dashboard#modules-outside-your-plan). Seule la suppression d'un domaine demande le code de sécurité. ## Les étapes 1. **Ouvrez les domaines personnalisés** Ouvrez **Paramètres**, puis **Domaines personnalisés** dans le groupe **Produits**. 2. **Ajoutez le sous-domaine** Sous **Ajouter un domaine personnalisé**, saisissez le sous-domaine, par exemple pay.example.com, sans https\:// ni chemin, puis cliquez sur **Ajouter un domaine personnalisé**. Il apparaît sous **Domaines connectés**, marqué **En attente de vérification**, avec les deux enregistrements DNS à publier.  *Chaque hôte et chaque valeur a son bouton pour le copier.* 3. **Publiez les enregistrements DNS** Chez votre fournisseur DNS, ajoutez l'enregistrement TXT, qui prouve que le domaine est à vous, et le CNAME, qui dirige les visiteurs vers Wajub. Gardez le CNAME tant que vous utilisez le domaine. Avec Cloudflare, réglez le CNAME sur « DNS only », le nuage gris. 4. **Vérifiez le DNS** **Vérifier le DNS** contrôle les deux enregistrements. Une modification DNS peut prendre jusqu'à 48 heures : si la vérification échoue, **Ce que nous voyons dans votre DNS** montre ce que Wajub a trouvé, et **Vérifier le DNS** relance le contrôle. Une fois le DNS confirmé, le domaine reste en **Sécurisation de la connexion** le temps que Wajub prépare son certificat, puis passe à **Vérifié** et sert vos pages, après quelques minutes. 5. **Choisissez ce qu'il sert** Sous **Utiliser ce domaine pour**, gardez **Tous les modules**, ou limitez-le à la page de paiement, aux liens de paiement ou aux factures. Un domaine qui sert la page de paiement y est utilisé dès qu'il est vérifié ; l'[image de marque](https://docs.wajub.com/dashboard/settings/branding#advanced-settings) peut le changer. 6. **Choisissez-le pour les liens et les factures** Les liens de paiement et les factures gardent l'adresse Wajub tant que vous n'y choisissez pas le domaine, sous **Domaine**, dans **Paramètres › Liens de paiement** pour les liens et **Paramètres › Factures** pour les factures. Ces deux pages ne s'ouvrent qu'en Production. ## Si le domaine ne pointe plus vers Wajub Si le CNAME disparaît ou change, le propriétaire, les Administrateurs et les Développeurs reçoivent un e-mail, et le domaine affiche **Ce domaine ne pointe plus vers Wajub**, avec le délai avant sa déconnexion. Corrigez l'enregistrement avant ce délai. Sinon, le domaine est déconnecté, un second e-mail le signale, et la page de paiement, les liens de paiement et les factures reprennent l'adresse Wajub par défaut. Une fois l'enregistrement corrigé, **Réessayer** sur le domaine le reconnecte. ## Supprimer un domaine **Supprimer le domaine** demande le code de sécurité, puis retire le domaine définitivement : les pages qui l'utilisaient passent aussitôt à l'adresse Wajub par défaut. Un domaine déjà connecté à une autre organisation Wajub ne peut pas être ajouté. > [!NOTE] > **Un sous-domaine plutôt que le domaine racine** > > La plupart des fournisseurs DNS refusent un CNAME sur le domaine lui-même, comme example.com. > Connectez un sous-domaine, ou utilisez un enregistrement ALIAS ou ANAME si votre fournisseur le > propose. --- # Renommer l'organisation URL: https://docs.wajub.com/fr/dashboard/settings/general > Changer le nom de l'organisation, et retrouver dans Paramètres › Général les détails de son entreprise, son numéro de compte, son ID de support et sa devise de règlement. **Paramètres › Général** porte le nom de l'organisation, les détails de son entreprise et les numéros à donner au support ou à une autre organisation Wajub. Le propriétaire, un Administrateur, un Développeur, un Observateur ou un rôle personnalisé qui a **Voir les paramètres** ouvre la page. Seuls le propriétaire, un Administrateur ou un rôle personnalisé qui a **Gérer les paramètres** peut renommer l'organisation. Le nom est le même en Test et en Production, et aucun code de sécurité n'est demandé. ## Les étapes 1. **Ouvrez la page Général** Ouvrez **Paramètres**, puis **Général** dans le groupe **Organisation**.  *Le numéro de compte et l'ID de support ont chacun un bouton Copier.* 2. **Saisissez le nouveau nom** Dans **Nom de l'organisation**, remplacez le nom actuel : il est obligatoire, jusqu'à 255 caractères. Une barre apparaît en bas de l'écran dès la première modification. 3. **Enregistrez le nom** **Enregistrer les modifications** applique le nouveau nom ; **Abandonner** remet l'ancien. Le nouveau nom apparaît aussitôt dans le tableau de bord et dans les e-mails de vos membres. ## Ce que montre la page **Détails de l'entreprise** reprend votre dossier de vérification, déposé depuis **Conformité** : nom légal, type de compte, site web, e-mail professionnel, téléphone, pays et propriétaire. Voir [Vérifier votre entreprise](https://docs.wajub.com/dashboard/activation/verify-business). **Identifiants** donne le **Numéro de compte**, qu'une autre organisation Wajub utilise pour vous envoyer un transfert, et l'**ID de support**, à donner au [support](https://docs.wajub.com/dashboard/help/support) pour qu'il retrouve votre compte. **Paiements en production** indique si l'organisation peut déjà encaisser en Production. La **Devise de règlement**, celle dans laquelle Wajub vous verse votre solde, est fixée à la création du compte et ne change plus. La devise de base se règle à part : voir [Régler la page de paiement](https://docs.wajub.com/dashboard/settings/checkout-page#currencies). Le propriétaire voit en bas de la page une **Zone dangereuse**, pour céder ou fermer l'organisation : voir [Gérer vos organisations](https://docs.wajub.com/dashboard/settings/organizations). --- # Inviter et gérer les membres URL: https://docs.wajub.com/fr/dashboard/settings/members > Inviter une personne dans l'organisation avec un rôle, suivre les invitations en attente, changer le rôle d'un membre, le retirer ou quitter l'organisation. Chaque personne qui travaille dans votre organisation y entre par une invitation, avec un [rôle](https://docs.wajub.com/fr/dashboard#roles) qui fixe ce qu'elle voit et ce qu'elle peut faire. Le propriétaire, un Administrateur ou un rôle personnalisé qui a **Gérer les membres** et **Voir les paramètres** gère les membres. Le forfait limite leur nombre, propriétaire non compris : 3 avec **Pay as you go**, 5 avec **Growth**, sans limite avec **Scale** et **Enterprise**. Inviter, changer un rôle, retirer un membre et quitter l'organisation demandent le code de sécurité ; renvoyer ou annuler une invitation, non. ## Les étapes 1. **Ouvrez la liste des membres** Ouvrez **Paramètres › Membres**. Chaque membre y figure avec son e-mail et son rôle ; le propriétaire est marqué **Propriétaire**, et votre ligne **Vous**.  *Le menu au bout de chaque ligne change le rôle du membre ou le retire.* 2. **Ouvrez l'invitation** **Inviter un membre** ouvre la fenêtre du même nom. 3. **Saisissez l'adresse e-mail** Dans **Adresse e-mail**, saisissez l'adresse de la personne à inviter. Une adresse jetable est refusée : **Les adresses e-mail jetables ne sont pas acceptées sur Wajub. Utilisez une adresse permanente.** 4. **Choisissez son rôle** Sous **Rôle**, choisissez l'un des sept rôles ou un [rôle personnalisé](https://docs.wajub.com/dashboard/settings/roles). Un rôle qui comprend des permissions que vous ne détenez pas est grisé : seule une personne qui les détient peut le donner.  *Chaque rôle de la liste dit ce qu'il permet.* 5. **Envoyez l'invitation** **Inviter un membre** demande le code de sécurité, puis envoie l'e-mail. L'invitation apparaît dans la liste des invitations en attente. ## Ce que reçoit la personne invitée La personne reçoit un e-mail avec un lien pour rejoindre l'organisation, valable 7 jours. Pour accepter, elle se connecte à Wajub avec l'adresse invitée, ou crée son compte avec cette adresse si elle n'en a pas. Si l'organisation a atteint entre-temps la limite de son forfait, l'acceptation est refusée : les invitations en attente ne comptent pas dans la limite tant qu'elles ne sont pas acceptées. ## Les invitations en attente **Renvoyer l'invitation** envoie un nouvel e-mail et repart pour 7 jours. **Annuler l'invitation** coupe le lien de l'e-mail et prévient la personne ; **Garder l'invitation** referme la fenêtre sans rien changer. ## Changer un rôle ou retirer un membre Le menu au bout de la ligne d'un membre propose **Changer le rôle**, qui prend effet tout de suite, et **Supprimer le membre** : la personne perd aussitôt l'accès, et vous pourrez l'inviter à nouveau plus tard. Un membre qui détient des permissions que vous n'avez pas ne peut être changé ou retiré que par quelqu'un qui les détient. Le propriétaire ne se retire pas : il [cède l'organisation](https://docs.wajub.com/dashboard/settings/organizations#transfer-ownership) d'abord. Sur votre propre ligne, **Quitter l'organisation** vous en retire aussitôt ; seul un membre qui gère les membres pourra vous inviter à nouveau. > [!NOTE] > **Un membre sans « Gérer les membres » ne peut pas partir seul** > > **Quitter l'organisation** se trouve sur cette page, que seuls ouvrent les membres qui gèrent > les membres. Un Développeur, un membre Finance, un Analyste, un Spécialiste support, un > Observateur ou un Utilisateur de test demande au propriétaire ou à un Administrateur de le > retirer. ## Les e-mails de chaque rôle Wajub envoie les e-mails de chaque sujet aux rôles ci-dessous. Le propriétaire reçoit ce que reçoit un Administrateur. | Sujet | Rôles | | ------------------------------------------------------------------------------------------------------- | ------------------------------------------- | | Paiements, factures, transferts, ajustements de solde, vérification de l'entreprise | **Administrateur**, **Finance** | | Litiges | **Administrateur**, **Spécialiste support** | | Sync, alertes techniques comme un endpoint webhook en échec ou un domaine qui ne pointe plus vers Wajub | **Administrateur**, **Développeur** | | Sécurité, rail Wajub | **Administrateur** | --- # Gérer vos organisations URL: https://docs.wajub.com/fr/dashboard/settings/organizations > Créer une autre organisation, passer de l'une à l'autre, céder une organisation à un autre membre ou la fermer. Une organisation a ses propres paiements, membres et paramètres. Un même compte Wajub peut en créer plusieurs, par exemple une par activité, et être membre d'organisations créées par d'autres. Tout le monde peut créer une organisation et en devient le propriétaire. Céder ou fermer une organisation est réservé à son propriétaire, et demande le code de sécurité. ## Créer une organisation 1. **Ouvrez le sélecteur d'organisation** Cliquez sur le nom de l'organisation, en haut du menu, puis sur **Créer une organisation**. 2. **Nommez l'organisation** Saisissez le **Nom de l'organisation** : vos clients le voient sur les reçus et les pages de paiement, et vous pourrez le changer plus tard. 3. **Créez-la** **Créer une organisation** la crée et vous y fait passer. Elle commence en Test : pour encaisser en Production, [vérifiez son entreprise](https://docs.wajub.com/dashboard/activation/verify-business). La nouvelle organisation prend le pays de votre inscription, qui fixe sa devise de règlement. ## Passer d'une organisation à l'autre Le sélecteur en haut du menu liste **Vos organisations** ; un clic sur l'une d'elles vous y fait passer, et à partir de neuf, **Rechercher une organisation** les filtre. **Gérer les organisations** ouvre **Paramètres › Organisations**, qui liste toutes celles dont vous êtes membre, avec **Actuel** sur celle où vous êtes, **Propriétaire** sur les vôtres, et un bouton **Changer** sur les autres.  *Une organisation qui n'est pas la vôtre affiche votre rôle et son propriétaire.* Pour quitter une organisation dont vous êtes membre, voir [Inviter et gérer les membres](https://docs.wajub.com/dashboard/settings/members#change-a-role-or-remove-a-member). ## Céder l'organisation 1. **Ouvrez la zone dangereuse** Ouvrez **Paramètres › Général** et descendez jusqu'à la **Zone dangereuse**.  *Seul le propriétaire voit la Zone dangereuse.* 2. **Choisissez le nouveau propriétaire** **Transférer la propriété** ouvre une fenêtre : choisissez le membre dans **Nouveau propriétaire**. Seul un membre de l'organisation peut en devenir propriétaire ; s'il n'y a pas d'autre membre, [invitez-le](https://docs.wajub.com/dashboard/settings/members) d'abord. 3. **Envoyez l'invitation** **Envoyer l'invitation de transfert** demande le code de sécurité, puis envoie l'invitation par e-mail. Elle est valable 7 jours ; une nouvelle invitation remplace la précédente. Le membre invité ouvre **Transfert de propriété de l'organisation** et choisit **Accepter le transfert** ou **Refuser**. Jusque-là, vous restez propriétaire. S'il accepte, il devient propriétaire, avec le contrôle des paramètres et de la facturation, et vous devenez Administrateur. ## Fermer l'organisation Dans la **Zone dangereuse**, **Fermer l'organisation** ouvre une fenêtre. Tant que l'organisation a un solde, même en attente ou réservé, un litige ouvert, ou un remboursement ou un transfert en cours, la fenêtre les liste sous **Réglez d'abord ces points, puis fermez l'organisation** et ne permet pas de la fermer. Sinon, saisissez le nom de l'organisation dans **Saisissez le nom de l'organisation pour confirmer**, puis **Fermer l'organisation** demande le code de sécurité. Ses clés API cessent aussitôt de fonctionner, chaque membre perd l'accès et plus aucun paiement ne peut être encaissé. Les données sont conservées, mais seul le [support](https://docs.wajub.com/dashboard/help/support) peut la rouvrir. --- # Créer un rôle personnalisé URL: https://docs.wajub.com/fr/dashboard/settings/roles > Préparer un rôle avec les permissions de votre choix quand aucun des sept rôles ne convient, le donner à un membre, puis le modifier ou le supprimer. Quand aucun des [sept rôles](https://docs.wajub.com/fr/dashboard#roles) ne convient, un rôle personnalisé réunit exactement les permissions que vous choisissez, par exemple pour un comptable qui lit les paiements, les transferts et les rapports sans rien modifier. Le propriétaire, un Administrateur ou un rôle personnalisé qui a **Gérer les membres** crée les rôles personnalisés, et ne peut y mettre que des permissions qu'il détient lui-même. Créer ou supprimer un rôle ne demande pas de code de sécurité ; le modifier, si, car le changement s'applique aussitôt aux membres qui l'ont. ## Les étapes 1. **Ouvrez les rôles personnalisés** Ouvrez **Paramètres › Membres › Rôles personnalisés**. Depuis la liste des membres, **Gérer les rôles personnalisés** y mène aussi. 2. **Ouvrez le formulaire** **Créer un rôle personnalisé** ouvre le formulaire sur la page. 3. **Nommez le rôle** Le **Nom du rôle** est obligatoire, jusqu'à 50 caractères, et doit être unique dans l'organisation. La **Description** est facultative, jusqu'à 255 caractères, et s'affiche à côté du rôle. 4. **Cochez ses permissions** Sous **Permissions**, cochez-en au moins une. Elles sont rangées par module, chacun avec **Tout sélectionner** ; une case grisée est une permission que vous ne détenez pas.  *Les permissions sont rangées par module.* 5. **Créez le rôle** **Créer un rôle personnalisé** enregistre le rôle. Il apparaît dans la liste, marqué **Attribué à aucun membre**. 6. **Donnez le rôle à un membre** Dans **Paramètres › Membres**, choisissez-le en invitant quelqu'un ou avec **Changer le rôle** sur la ligne d'un membre : voir [Inviter et gérer les membres](https://docs.wajub.com/dashboard/settings/members). ## Les permissions des paramètres Cinq permissions ouvrent les paramètres de l'organisation. **Voir les paramètres** les ouvre sans rien changer. **Gérer les paramètres** change la sécurité, la page de paiement, l'image de marque, les domaines, les remboursements, les liens de paiement et les factures, les réglages des transferts (comptes de versement, transferts récurrents et sécurité des transferts), et bascule entre Test et Production. **Gérer les paramètres développeur** ne change que les réglages techniques : les domaines personnalisés, les sites qui intègrent la page de paiement et le routage des paiements ; elle bascule aussi entre Test et Production. **Gérer les membres** invite et retire des membres, change leur rôle et crée des rôles personnalisés. **Gérer le compte** s'occupe de la vérification de l'entreprise et de la facturation de l'abonnement. ## Modifier ou supprimer un rôle Le menu au bout d'un rôle propose **Modifier le rôle**, qui rouvre le formulaire : **Enregistrer le rôle** demande le code de sécurité, et un nouveau nom suit le rôle chez ses membres et dans les invitations en attente. **Supprimer le rôle** l'efface définitivement, mais seulement si aucun membre ne l'a et qu'aucune invitation en attente ne le donne : changez d'abord leur rôle ou annulez l'invitation. Un rôle qui accorde des permissions que vous ne détenez pas ne peut être modifié ou supprimé que par quelqu'un qui les détient. --- # Sécuriser l'organisation URL: https://docs.wajub.com/fr/dashboard/settings/security > Exiger la double authentification de tous les membres et limiter l'accès au tableau de bord à certaines adresses IP, dans Paramètres › Sécurité de l'organisation. Deux règles protègent l'organisation entière : chaque membre confirme ses connexions par une deuxième étape, et le tableau de bord ne s'ouvre que depuis les adresses IP que vous autorisez. La double authentification de votre propre compte se règle à part, dans [Sécuriser votre compte](https://docs.wajub.com/dashboard/account/security). Le propriétaire, un Administrateur, un Développeur, un Observateur ou un rôle personnalisé qui a **Voir les paramètres** lit ces règles. Seuls le propriétaire, un Administrateur ou un rôle personnalisé qui a **Gérer les paramètres** les change, et l'enregistrement demande le code de sécurité. Les règles valent en Test comme en Production. ## Exiger la double authentification 1. **Ouvrez la sécurité de l'organisation** Ouvrez **Paramètres**, puis **Sécurité de l'organisation** dans le groupe **Organisation**.  *Les deux règles s'enregistrent ensemble, avec le code de sécurité.* 2. **Activez la règle** Sous **Politique d'authentification à deux facteurs**, activez **Exiger l'authentification à deux facteurs pour tous les membres**. 3. **Enregistrez** **Enregistrer les modifications**, dans la barre en bas de l'écran, demande le code de sécurité puis applique la règle. La règle s'applique dès l'enregistrement. Un membre qui n'a pas encore de double authentification arrive, à sa prochaine action, sur **Configurer l'authentification à deux facteurs**, et n'ouvre plus rien dans l'organisation tant qu'il n'a pas choisi une méthode : **Application d'authentification**, **Code par e-mail**, **Clé d'accès** ou, s'il a un numéro de téléphone vérifié, **Code par SMS**. Un membre déjà connecté sans avoir passé sa deuxième étape est déconnecté et se reconnecte avec elle. **Faire confiance à cet appareil pour 30 jours**, qu'un membre peut cocher en saisissant son code à la connexion, dispense ce navigateur de la deuxième étape pendant 30 jours. Une organisation qui exige la double authentification ne l'accepte pas : ses membres passent la deuxième étape à chaque connexion. ## Limiter les adresses IP 1. **Ajoutez votre propre adresse** Sous **Liste blanche IP du tableau de bord**, la page affiche votre adresse IP actuelle. **Ajouter mon adresse IP** la met dans la liste. Tant qu'elle n'y est pas, la page vous avertit que vous perdriez l'accès et refuse d'enregistrer. 2. **Ajoutez les autres adresses** Dans **Adresse IP ou plage**, saisissez une adresse IPv4 ou IPv6, ou une plage comme 10.0.0.0/24, puis cliquez sur **Ajouter**. Recommencez pour chaque bureau ou réseau. 3. **Enregistrez la liste** **Enregistrer les modifications** demande le code de sécurité puis applique la liste. Une liste vide, marquée **Aucune restriction d'adresse IP**, laisse ouvrir le tableau de bord de partout. Un membre qui se connecte depuis une autre adresse arrive sur **Accès refusé** : il peut **Passer à une autre organisation**, ouvrir ses **Paramètres personnels** ou **Se déconnecter**, et demande à un Administrateur d'ajouter son adresse. La liste ne concerne que le tableau de bord : elle ne limite pas les appels faits avec vos clés API. Une clé API a sa propre liste d'adresses autorisées, voir [Environnements et API keys](https://docs.wajub.com/fr/getting-started/environments#narrowing-what-a-key-can-do). --- # Activer Shield URL: https://docs.wajub.com/fr/dashboard/shield/enable > Activer Shield pour voir ses décisions sur vos paiements, régler sa sévérité et traiter les paiements qu'il signale. Shield évalue le risque de fraude de chaque paiement en Production. La protection par défaut de Wajub s'applique déjà à vos paiements : activer Shield vous montre ses décisions et vous permet de les ajuster. Le propriétaire, un Administrateur ou un rôle personnalisé qui a **Gérer Shield** peut activer Shield ; avec **Voir Shield** seul, un rôle personnalisé lit ses écrans sans rien changer. Les autres [rôles](https://docs.wajub.com/fr/dashboard#roles) ne voient pas Shield. Shield fait partie de tous les forfaits, et n'existe qu'en [Production](https://docs.wajub.com/fr/dashboard#sandbox-and-live). Aucun code de sécurité n'est demandé. ## Les étapes 1. **Ouvrez Shield** En **Production**, ouvrez **Shield** dans le menu. Tant que Shield n'est pas activé, la page présente la **Protection contre la fraude** sous le titre **Arrêtez la fraude avant qu'elle ne vous coûte.**, sans onglets.  *Sans la permission Gérer Shield, un message remplace le bouton.* 2. **Activez Shield** Cliquez sur **Activer Shield**. Sans la permission, la page affiche à la place **Demandez à un administrateur de votre organisation d'activer Shield.** Le message **Shield est maintenant actif.** s'affiche, et la page devient la vue d'ensemble, avec les onglets **Vue d'ensemble**, **Examens**, **Règles**, **Listes** et **Contrôles de risque**. ## Ce que l'activation change Vos propres réglages s'appliquent à la place de ceux de Wajub : vos seuils, plus stricts que ceux de Wajub, jamais plus souples, et avec **Shield Advanced** vos règles, votre liste de blocage et le 3D Secure automatique. [Régler les contrôles de risque](https://docs.wajub.com/dashboard/shield/settings) les décrit. Un paiement que Shield signale est encaissé comme les autres, puis rejoint les **Examens**, où vous décidez quoi faire du client : [Examiner un paiement signalé](https://docs.wajub.com/dashboard/shield/reviews). Une tentative bloquée y figure aussi, sans rien encaisser. ## La vue d'ensemble En haut, **Analysées ce mois**, **Signalé** et **En attente de révision** comptent le mois en cours, comparé au mois précédent, et **Litiges ouverts** les litiges en cours. **Distribution des risques ce mois** montre la part des paiements signalés envoyés en examen et celle des paiements bloqués. **En attente de votre révision** liste les derniers paiements signalés, et **Tout réviser** ouvre les examens. **Performance des règles** classe vos règles personnalisées par nombre de déclenchements, avec **Gérer les règles**. Les litiges se traitent depuis les paiements : [Gérer un litige](https://docs.wajub.com/dashboard/payments/disputes).  *Les trois premiers chiffres comptent le mois en cours.* ## Couper Shield Dans **Contrôles de risque**, désactivez **Utiliser mes réglages Shield**, puis cliquez sur **Enregistrer les modifications**. La protection par défaut de Wajub continue de s'appliquer, et Shield revient à sa page d'activation. Vos seuils sont gardés pour la prochaine activation. ## Ce que voit le client Un paiement autorisé ou signalé se déroule normalement pour le client, parfois avec une confirmation 3D Secure de sa banque ; un paiement bloqué est refusé, avec une référence à donner au support. --- # Gérer les listes Shield URL: https://docs.wajub.com/fr/dashboard/shield/lists > Ajouter une adresse e-mail, un numéro, une adresse IP, un pays ou un BIN de carte à la liste de blocage de Shield, et retirer un client autorisé. L'onglet **Listes** réunit les clients que vous laissez toujours passer et les valeurs que Shield refuse d'emblée. Les deux s'appliquent tout de suite aux paiements suivants. Le propriétaire, un Administrateur ou un rôle personnalisé qui a **Gérer Shield** modifie les listes ; **Voir Shield** suffit pour les lire. Les **Clients autorisés** existent avec tous les forfaits. La **Liste de blocage** fait partie de **Shield Advanced**, inclus dans les forfaits **Scale** et **Enterprise** et proposé en [option](https://docs.wajub.com/dashboard/subscription/add-ons) sur les autres ; sans lui, l'onglet affiche **Les listes font partie de Shield Advanced**. Shield doit être [activé](https://docs.wajub.com/dashboard/shield/enable). Aucun code de sécurité n'est demandé. ## Les étapes 1. **Ouvrez les listes** Dans **Shield**, ouvrez l'onglet **Listes**. Le formulaire **Ajouter à la liste de blocage** se trouve sous les **Clients autorisés**. 2. **Choisissez le type** Sous **Type**, choisissez **Adresse e-mail**, **Numéro de téléphone**, **Adresse IP**, **Pays** ou **BIN de carte**. Le champ suivant dit ce qu'il attend : l'adresse entière, le numéro avec son indicatif, une seule adresse IP, un pays dont les adresses IP sont refusées, ou les 6 à 8 premiers chiffres d'une carte. 3. **Saisissez la valeur** Remplissez le champ qui porte le nom du type choisi, **Adresse e-mail** par exemple, puis si besoin **Motif (facultatif)**, que seuls vos membres voient. 4. **Ajoutez l'entrée** Cliquez sur **Ajouter à la liste de blocage**. Le message **Entrée ajoutée à la liste de blocage.** s'affiche, et l'entrée apparaît en tête de la **Liste de blocage**. Chaque ajout active aussi **Appliquer la liste de blocage** dans les [contrôles de risque](https://docs.wajub.com/dashboard/shield/settings).  *Chaque paiement qui correspond à une entrée est refusé.* ## La liste de blocage Au-delà de 10 entrées, une recherche au-dessus de la liste les filtre par valeur, type ou motif, et le bouton sous la liste charge les suivantes, 50 à la fois. Le menu d'une entrée propose **Copier la valeur** et **Supprimer l'entrée** : après confirmation, elle ne bloque plus rien. Une règle peut aussi s'appuyer sur la liste avec la condition **Correspond à une entrée de la liste de blocage** : [Créer une règle Shield](https://docs.wajub.com/dashboard/shield/rules). ## Les clients autorisés Un client entre dans **Clients autorisés** quand vous choisissez **Toujours autoriser ce client** sur l'un de ses paiements, dans les [examens](https://docs.wajub.com/dashboard/shield/reviews). Ses paiements passent quel que soit leur score, sauf s'il figure sur votre liste de blocage ou sur une liste de sanctions. Le tableau montre le **Client**, **Identifié par** (son e-mail ou son téléphone) et **Autorisé depuis**. Le menu de sa ligne propose **Ne plus autoriser**. Après confirmation, Shield évalue ses paiements suivants comme ceux de tout le monde, et le message **Ce client n'est plus toujours autorisé.** s'affiche. --- # Examiner un paiement signalé URL: https://docs.wajub.com/fr/dashboard/shield/reviews > Vérifier un paiement que Shield juge suspect ou une tentative qu'il a bloquée, puis l'approuver, autoriser le client pour de bon ou le bloquer et rembourser. Un paiement que Shield juge suspect est encaissé comme les autres, puis il rejoint les **Examens** ; une tentative que Shield a bloquée y figure aussi, sans rien encaisser. Shield ne retient jamais l'argent : si c'est une fraude, vérifiez avant de livrer, puis bloquez le client et remboursez-le. Le propriétaire, un Administrateur ou un rôle personnalisé qui a **Gérer Shield** décide ; **Voir Shield** suffit pour lire la liste. Approuver et autoriser un client marchent avec tous les forfaits. Bloquer le client demande **Shield Advanced**, inclus dans les forfaits **Scale** et **Enterprise** et proposé en [option](https://docs.wajub.com/dashboard/subscription/add-ons) sur les autres. Rembourser en même temps demande aussi **Rembourser les paiements** et le [code de sécurité](https://docs.wajub.com/fr/dashboard#the-security-code). ## Les étapes 1. **Ouvrez les examens** Dans **Shield**, ouvrez l'onglet **Examens**. Le tableau couvre les 90 derniers jours, avec le **Montant**, le **Score**, le **Client**, les **Motifs** du signalement, le **Moyen de paiement** et la date sous **Signalé**. Le filtre **Décision** garde les paiements signalés (**Examiner**) ou les tentatives bloquées (**Bloquer**).  *Chaque paiement de la liste a déjà été encaissé, sauf les tentatives bloquées.* 2. **Vérifiez le paiement** Cliquez sur la ligne pour ouvrir la page du paiement : [Lire un paiement](https://docs.wajub.com/dashboard/payments/read). Le menu au bout de la ligne propose aussi **Copier l'identifiant du paiement** et **Voir le client**. 3. **Approuvez un paiement légitime** Cliquez sur **Approuver**. Le paiement quitte la liste sans autre changement, et le message **Revue clôturée.** s'affiche. Pour un client de confiance, choisissez plutôt **Toujours autoriser ce client** dans le menu de la ligne : ses paiements suivants passeront, et il rejoint les [clients autorisés](https://docs.wajub.com/dashboard/shield/lists#allowed-customers). Le menu ne le propose que si le client a un e-mail ou un téléphone. ## Bloquer le client Si c'est une fraude, choisissez **Bloquer le client** dans le menu de la ligne. Une fenêtre s'ouvre au nom du client, par exemple « Bloquer Moussa Diallo ? ». Pour un paiement encaissé, **Bloquer sans rembourser** bloque le client et laisse l'argent, et **Bloquer et rembourser** rend le montant total au client après le code de sécurité. Pour une tentative bloquée, rien n'a été encaissé : le bouton est **Bloquer le client**.  *Bloquer seul ne rend pas l'argent au client.* L'e-mail et le téléphone du client rejoignent la [liste de blocage](https://docs.wajub.com/dashboard/shield/lists), qui s'applique désormais : ses paiements suivants sont refusés. Le remboursement se suit sur la page du paiement : [Rembourser un paiement](https://docs.wajub.com/dashboard/payments/refund). > [!NOTE] > **Avant l'activation de Shield** > > Tant que Shield n'est pas activé, les **Examens** ne listent que les paiements dont le payeur > porte un nom proche d'une personne sous sanctions, et la page **Shield** les signale avec **Les > examiner**. Ces paiements ont été encaissés : vérifiez-les avant de livrer, puis cliquez sur > **Marquer comme vérifié**. --- # Créer une règle Shield URL: https://docs.wajub.com/fr/dashboard/shield/rules > Créer une règle Shield qui bloque, envoie en examen, exige le 3D Secure ou autorise un paiement selon vos conditions, puis la classer, la couper ou la supprimer. Une règle personnalisée décide d'un paiement selon vos propres conditions : son montant, sa devise, son moyen de paiement, l'e-mail ou le téléphone du client, le pays de son adresse IP. Le propriétaire, un Administrateur ou un rôle personnalisé qui a **Gérer Shield** crée et modifie les règles ; **Voir Shield** suffit pour les lire. Les règles personnalisées font partie de **Shield Advanced**, inclus dans les forfaits **Scale** et **Enterprise** et proposé en [option](https://docs.wajub.com/dashboard/subscription/add-ons) sur les autres. Sans lui, l'onglet affiche **Les règles personnalisées font partie de Shield Advanced**. Shield doit être [activé](https://docs.wajub.com/dashboard/shield/enable). Aucun code de sécurité n'est demandé. ## Les étapes 1. **Ouvrez le dialogue** Dans **Shield**, ouvrez l'onglet **Règles**, puis cliquez sur **Créer la règle**. Le dialogue **Créer la règle** s'ouvre. 2. **Nommez la règle** Le **Nom** est obligatoire, en 120 caractères au plus. La **Description (optionnelle)** dit à vos membres à quoi sert la règle. 3. **Choisissez l'action** Sous **Action**, **Bloquer** refuse le paiement. **Envoyer pour examen** le laisse passer et l'ajoute aux **Examens**, sauf si Shield le bloque déjà. **Exiger le 3D Secure** fait confirmer un paiement par carte auprès de la banque du client, là où le prestataire de la carte le permet. **Autoriser (contourne les autres règles)** laisse passer le paiement, sauf s'il correspond à votre liste de blocage ou exactement à un nom sous sanctions. 4. **Choisissez le mode** Sous **Mode**, **Appliquée** agit sur les paiements. **Observation** compte les paiements qui correspondent sans rien décider : la règle porte le badge **Observation**, et ses déclenchements s'affichent comme les autres, de quoi la juger avant de l'appliquer. 5. **Ajoutez les conditions** Sous **Quand toutes ces conditions sont vraies**, choisissez un **Champ**, un **Opérateur** et une **Valeur**. **Ajouter une condition** en ajoute une autre, jusqu'à 10 : la règle ne s'applique que si toutes sont vraies. Les champs sont **Montant de la transaction**, **Devise**, **Moyen de paiement**, **E-mail du client**, **Téléphone du client**, **Pays de l'IP**, **Première transaction de ce client** et **Correspond à une entrée de la liste de blocage**.  *La règle ne s'applique que si toutes ses conditions sont vraies.* 6. **Créez la règle** Laissez **Actif** activé pour qu'elle s'applique tout de suite, puis cliquez sur **Créer la règle**. Le message **Règle créée.** s'affiche, et la règle s'ajoute en bas de **Vos règles personnalisées**. ## L'ordre des règles Shield lit vos règles de haut en bas, et la première règle appliquée qui correspond au paiement décide ; une règle en **Observation** ne décide jamais. Les flèches de chaque ligne la montent ou la descendent d'une place. Un client autorisé depuis les examens devient une règle **Autoriser** placée en tête de liste. [Les règles](https://docs.wajub.com/fr/risk/shield/rules#which-one-wins) de la documentation développeur détaillent ce qui l'emporte. ## Modifier, couper ou supprimer une règle L'interrupteur de chaque ligne coupe la règle ou la rallume : une règle inactive est gardée, et jamais évaluée. Le menu de la ligne propose **Modifier la règle**, qui rouvre le dialogue, et **Supprimer la règle**, qui demande confirmation : les paiements qu'elle aurait visés passent alors sans changement. Si votre forfait perd **Shield Advanced**, vos règles sont gardées mais ne s'appliquent plus ; elles reprennent si vous retrouvez l'option. Les clients autorisés depuis les examens restent autorisés avec tous les forfaits. ## Les protections intégrées Sous vos règles, **Protections intégrées** résume les contrôles que Shield applique à chaque paiement, sans configuration. **Shield Advanced** en ajoute d'autres. --- # Régler les contrôles de risque URL: https://docs.wajub.com/fr/dashboard/shield/settings > Régler les seuils d'examen et de blocage de Shield, le 3D Secure automatique, la liste de blocage et ce qui arrive à un payeur proche d'un nom sous sanctions. **Contrôles de risque** règle la sévérité de Shield : à partir de quel score un paiement est envoyé en examen ou refusé, et ce que Shield fait de plus. Le propriétaire, un Administrateur ou un rôle personnalisé qui a **Gérer Shield** voit cet onglet ; **Voir Shield** ne suffit pas. Les seuils et le criblage sanctions marchent avec tous les forfaits. Le 3D Secure automatique et la liste de blocage font partie de **Shield Advanced**, inclus dans les forfaits **Scale** et **Enterprise** et proposé en [option](https://docs.wajub.com/dashboard/subscription/add-ons) sur les autres. Aucun code de sécurité n'est demandé. ## Les étapes 1. **Ouvrez les contrôles de risque** Dans **Shield**, ouvrez l'onglet **Contrôles de risque**. La page réunit les sections **Scoring** et **Criblage sanctions**, et avec **Shield Advanced** les sections **3D Secure** et **Liste de blocage**. 2. **Appliquez vos réglages** Sous **Scoring**, activez **Utiliser mes réglages Shield** : vos seuils, et avec **Shield Advanced** votre liste de blocage et vos règles, s'appliquent à chaque paiement en Production. Désactivé, la protection par défaut de Wajub s'applique seule, et Shield revient à sa page d'activation. 3. **Réglez les seuils** Un paiement dont le score atteint le **Seuil d'examen** passe, puis apparaît dans vos [examens](https://docs.wajub.com/dashboard/shield/reviews). À partir du **Seuil de blocage**, il est refusé. Un seuil plus bas est plus strict, et vous pouvez être plus strict que Wajub, jamais plus souple : la page indique les limites autorisées.  *La bande de score montre ce qui s'applique en ce moment.* 4. **Choisissez le 3D Secure automatique** Avec **Shield Advanced**, **Auto 3D Secure** demande le 3D Secure aux paiements par carte dont le score atteint votre seuil d'examen, là où le prestataire de la carte le permet. Sans **Shield Advanced**, une carte **Auto 3D Secure** propose à la place **Mettre à niveau pour activer**. 5. **Appliquez la liste de blocage** Avec **Shield Advanced**, **Appliquer la liste de blocage** refuse les paiements qui correspondent à l'une de vos entrées. Il s'active tout seul dès qu'une entrée est ajoutée, et **Gérer la liste de blocage** ouvre l'onglet **Listes** : [Gérer les listes Shield](https://docs.wajub.com/dashboard/shield/lists). 6. **Choisissez la réponse aux sanctions** Wajub compare chaque payeur aux listes de sanctions, avec tous les forfaits, et refuse toujours une correspondance exacte. Sous **Un payeur proche d'un nom sous sanctions**, **Signaler en revue** laisse passer le paiement et l'ajoute à vos examens, et **Refuser le paiement** le refuse comme une correspondance exacte. 7. **Enregistrez** Dès la première modification, la barre du bas propose **Enregistrer les modifications** et **Abandonner**. Le message **Paramètres Shield mis à jour.** confirme l'enregistrement. --- # Activer un module URL: https://docs.wajub.com/fr/dashboard/subscription/add-ons > Ajouter à votre forfait un module complémentaire, comme Sync ou Shield Advanced, sans changer de forfait, puis le renouveler ou l'annuler. Un module complémentaire ajoute un module que votre forfait n'inclut pas, comme Sync ou Shield Advanced, sans changer de forfait. Son prix est mensuel, et il se renouvelle à la même date que le forfait. Le propriétaire, un Administrateur ou un [rôle](https://docs.wajub.com/fr/dashboard#roles) personnalisé qui a **Gérer le compte** active les modules. Un module activé vaut pour toute l'organisation, [en Test et en Production](https://docs.wajub.com/fr/dashboard#sandbox-and-live), et aucun [code de sécurité](https://docs.wajub.com/fr/dashboard#the-security-code) n'est demandé. ## Les étapes 1. **Ouvrez la facturation** Ouvrez **Paramètres**, puis **Facturation** dans le groupe **Organisation**. Sur l'onglet **Abonnement**, la carte **Modules complémentaires** liste chaque module avec son prix par mois ; elle n'apparaît pas quand votre forfait les inclut tous. 2. **Choisissez le module** **Activer**, sur la ligne du module, ouvre la fenêtre d'activation. Elle indique le montant **Débité aujourd'hui**, calculé au prorata jusqu'au renouvellement de votre forfait, puis le **Prix mensuel**. Un module gratuit s'active tout de suite, sans fenêtre.  *Le premier paiement couvre seulement les jours restants jusqu'au renouvellement du forfait.* 3. **Choisissez le moyen de paiement** Choisissez **Carte**, **Mobile Money**, **Crypto** ou **Virement bancaire**. Si votre abonnement a déjà un moyen de paiement, la fenêtre propose celui-là ; **Payer avec un autre moyen** affiche les autres. 4. **Payez le module** Le bouton **Payer**, suivi du montant, ouvre une page de paiement sécurisée pour une carte, Mobile Money ou Crypto ; le module s'active dès que le paiement est confirmé. Pour un virement, les instructions arrivent par e-mail, et le module s'active quand Wajub confirme le virement. Quand vous ouvrez un module que votre forfait n'inclut pas, sa page propose aussi **Activer le module complémentaire**, à côté des forfaits qui l'incluent : voir [Modules hors de votre forfait](https://docs.wajub.com/fr/dashboard#modules-outside-your-plan). ## Le renouvellement Chaque module se renouvelle à la date de votre forfait, et sa ligne dit comment. Soit il est facturé avec le forfait, soit il se paie à part, depuis l'onglet **Factures** avec **Payer maintenant**, avant cette date : voir [Payer une facture Wajub](https://docs.wajub.com/dashboard/subscription/wajub-invoices). Sans paiement, il s'arrête ce jour-là, et **Activer** le remet en route. ## Annuler un module **Annuler le module complémentaire**, sur sa ligne, ouvre une confirmation qui donne sa date de fin. Le même bouton confirme ; **Conserver le module complémentaire** referme sans rien changer. Le module reste actif jusqu'à cette date, puis se désactive. D'ici là, **Reprendre** le garde. --- # Demander l'offre Enterprise URL: https://docs.wajub.com/fr/dashboard/subscription/enterprise > Demander l'offre Enterprise à l'équipe commerciale de Wajub depuis la facturation, suivre la demande, puis payer la proforma par virement. L'offre **Enterprise** a des tarifs négociés, tout en illimité, un support dédié et un SLA. Vous la demandez à l'équipe commerciale de Wajub depuis la facturation, et vous la payez par virement. Le propriétaire, un Administrateur ou un [rôle](https://docs.wajub.com/fr/dashboard#roles) personnalisé qui a **Gérer le compte** envoie la demande, [en Test comme en Production](https://docs.wajub.com/fr/dashboard#sandbox-and-live), sans [code de sécurité](https://docs.wajub.com/fr/dashboard#the-security-code). L'organisation a une seule demande en cours : une nouvelle n'est possible qu'après un refus. ## Les étapes 1. **Ouvrez la demande** Ouvrez **Paramètres**, puis **Facturation** dans le groupe **Organisation**. Sur l'onglet **Abonnement**, **Contacter le service commercial**, dans l'encadré **Entreprise**, ouvre la fenêtre du même nom. Le même bouton figure dans la fenêtre **Changer de forfait**. 2. **Décrivez votre besoin** Le **Nom de l'entreprise** est obligatoire. Le **Volume mensuel de transactions**, le **Téléphone de contact** et les **Besoins** aident l'équipe à préparer son devis.  *Seul le nom de l'entreprise est obligatoire.* 3. **Envoyez la demande** **Envoyer la demande** la transmet à l'équipe commerciale. L'encadré **Entreprise** affiche ensuite son statut et **Voir la demande**. ## Suivre la demande **Voir la demande** ouvre **Demande Enterprise** : le **Statut de la demande**, vos besoins et les **Notes de notre équipe**. L'équipe commerciale répond sous 1 à 2 jours ouvrés, avec un devis ou des questions. Une demande refusée affiche **Demande refusée**. ## Payer la proforma Quand l'équipe envoie son devis, la page affiche la **Référence proforma**, le **Montant dû** et les **Instructions de paiement**. 1. **Téléchargez la proforma** **Télécharger la proforma** enregistre la facture proforma, avec le compte bancaire à créditer. 2. **Faites le virement** Virez le **Montant dû** sur ce compte, avec la **Référence proforma** dans le libellé du virement. 3. **Téléversez le justificatif** Choisissez votre justificatif sous **Téléverser un justificatif de paiement**, puis **Téléverser**. L'équipe l'examine. **Paiement confirmé** s'affiche quand l'équipe a reçu le virement : l'activation prend en général moins d'un jour ouvré. La page affiche ensuite **Forfait Enterprise actif**. Les renouvellements se paient aussi par virement, depuis la facturation : voir [Payer par virement](https://docs.wajub.com/dashboard/subscription/manage#bank-transfer). --- # Gérer l'abonnement URL: https://docs.wajub.com/fr/dashboard/subscription/manage > Annuler ou reprendre l'abonnement Wajub de l'organisation, comprendre son renouvellement et payer un forfait réglé par virement. L'onglet **Abonnement** de la facturation montre votre forfait et sa période. Vous y annulez l'abonnement, le reprenez avant sa fin, et payez un forfait réglé par virement. Le propriétaire, un Administrateur ou un [rôle](https://docs.wajub.com/fr/dashboard#roles) personnalisé qui a **Gérer le compte** gère l'abonnement, [en Test comme en Production](https://docs.wajub.com/fr/dashboard#sandbox-and-live), sans [code de sécurité](https://docs.wajub.com/fr/dashboard#the-security-code). ## Annuler l'abonnement 1. **Ouvrez la facturation** Ouvrez **Paramètres**, puis **Facturation** dans le groupe **Organisation**. Sur l'onglet **Abonnement**, **Annuler l'abonnement** se trouve dans la carte **Forfait actuel**, pour un forfait payant. 2. **Lancez l'annulation** **Annuler l'abonnement** ouvre **Annuler votre abonnement ?**, avec la date jusqu'à laquelle votre forfait reste actif.  *Rien ne change avant la date de fin.* 3. **Confirmez l'annulation** **Annuler l'abonnement** confirme ; **Conserver l'abonnement** referme sans rien changer. La carte **Forfait actuel** affiche alors la date de fin. Votre forfait et ses modules restent actifs jusqu'à cette date, puis l'organisation passe au forfait **Pay as you go**. ## Reprendre l'abonnement Jusqu'à la date de fin, **Reprendre l'abonnement**, dans **Forfait actuel**, annule l'annulation : le forfait continue comme avant. ## Le renouvellement Payé par carte, le forfait se renouvelle tout seul à la fin de chaque période. Payé par Mobile Money ou Crypto, il ne se renouvelle pas tout seul : un rappel avec un lien de paiement arrive par e-mail avant la date de fin. À la date de fin, si le renouvellement n'est pas payé, les modules du forfait s'arrêtent et l'organisation passe au forfait **Pay as you go**. Pendant quelques jours encore, pour un forfait payé par Mobile Money ou Crypto, **Payer maintenant**, dans l'onglet **Factures**, règle le renouvellement et remet les modules en route : voir [Payer une facture Wajub](https://docs.wajub.com/dashboard/subscription/wajub-invoices). Passé ce délai, il faut choisir de nouveau un forfait. ## Payer par virement Un forfait réglé par virement, comme l'offre [Enterprise](https://docs.wajub.com/dashboard/subscription/enterprise), affiche la carte **Virement bancaire** quand un paiement est dû. Elle donne le **Montant dû** et la **Référence** à indiquer sur votre virement. Une fois le virement fait, choisissez votre justificatif sous **Téléverser un justificatif de paiement** (PDF, PNG ou JPG, 5 Mo au plus), ajoutez si vous voulez la **Référence du virement chez votre banque**, puis **Téléverser**. **Justificatif reçu** s'affiche alors : l'équipe Wajub le vérifie sous 1 jour ouvré, et votre forfait démarre ou se renouvelle dès que le virement est confirmé. **Envoyer un autre justificatif** en ajoute un. --- # Changer de forfait URL: https://docs.wajub.com/fr/dashboard/subscription/plans > Passer à un autre forfait Wajub depuis Paramètres › Facturation, choisir la période de facturation et le moyen de paiement, puis payer. Le forfait fixe les modules et les limites de votre organisation, comme le nombre de membres ou de liens de paiement. Vous en changez depuis la facturation, et le nouveau forfait vaut pour toute l'organisation. Le propriétaire, un Administrateur ou un [rôle](https://docs.wajub.com/fr/dashboard#roles) personnalisé qui a **Gérer le compte** gère l'abonnement ; les autres rôles n'ouvrent pas **Facturation**. Le forfait est le même [en Test et en Production](https://docs.wajub.com/fr/dashboard#sandbox-and-live), et aucun [code de sécurité](https://docs.wajub.com/fr/dashboard#the-security-code) n'est demandé. ## Les étapes 1. **Ouvrez la facturation** Ouvrez **Paramètres**, puis **Facturation** dans le groupe **Organisation**. L'onglet **Abonnement** montre votre **Forfait actuel**, le tableau **Comparer les forfaits**, l'**Utilisation** de la période et l'**Historique des abonnements**. Le menu de votre organisation, en haut du menu latéral, y mène aussi : sa dernière ligne donne votre forfait. **Comparer les forfaits** met les forfaits côte à côte : les frais par paiement sur le rail Wajub, les limites (liens de paiement, factures, exports, membres, fournisseurs) et les modules inclus. Sous un forfait, **Choisir** ouvre la fenêtre sur ce forfait.  *Changer de forfait se trouve dans la carte Forfait actuel.* 2. **Choisissez le forfait** **Changer de forfait** ouvre la fenêtre du même nom. Sous **Choisissez votre forfait**, chaque forfait donne son prix, ses frais par paiement, ses limites et ce qu'il ajoute au vôtre. Sélectionnez le forfait voulu : le vôtre est marqué **Actuel** et ne peut pas être choisi. Puis **Choisir la période de facturation**.  *Les quatre étapes de la fenêtre sont en haut : Forfait, Période de facturation, Moyen de paiement, Examiner.* Pour l'offre **Enterprise**, **Contacter le service commercial** ouvre une demande : voir [Demander l'offre Enterprise](https://docs.wajub.com/dashboard/subscription/enterprise). 3. **Choisissez la période** Sous **Période de facturation**, choisissez **Mensuel**, **3 mois**, **6 mois** ou **Annuel**. Une période plus longue affiche ce que vous économisez et le prix sans remise. Puis **Choisir le moyen de paiement**. 4. **Choisissez le moyen de paiement** Avec une **Carte**, le forfait se renouvelle tout seul à la fin de chaque période. Avec **Mobile Money** ou **Crypto**, vous recevez avant la fin de la période un rappel avec un lien de paiement. Le virement bancaire est réservé à l'offre Enterprise. Puis **Vérifier le changement**. 5. **Vérifiez et payez** **Examiner** reprend le forfait, la période, la **Remise**, le moyen de paiement et le **Renouvellement**. En dessous, le **Prix du forfait**, la remise et, si votre forfait payant actuel court encore, les **Jours non utilisés de votre forfait actuel** donnent le montant **À payer aujourd'hui**. Si le moyen de paiement choisi ne peut pas déduire ces jours, un avertissement le signale. **Payer**, suivi du montant, ouvre une page de paiement sécurisée. Quand rien n'est dû, le bouton devient **Changer de forfait** et le forfait change tout de suite. ## Essayer un forfait Une organisation qui n'a jamais payé de forfait peut en essayer un. Dans **Comparer les forfaits**, **Essayer 7 jours pour 1 000 FCFA** ouvre une fenêtre qui dit tout avant le paiement : - vous payez 1 000 FCFA sur la page de paiement Wajub, et le forfait s'ouvre pour 7 jours dès que le paiement est confirmé ; - pour le garder ensuite, vous payez son prix par mois ; un rappel avec un lien de paiement vous arrive avant la fin de l'essai ; - sans paiement, votre organisation revient au forfait gratuit, et rien d'autre n'est prélevé. Il y a un seul essai par organisation. Pendant l'essai, **Forfait actuel** porte la mention **Essai** et sa date de fin. Si vous changez de forfait pendant l'essai, les jours qui en restent sont déduits du prix du nouveau forfait pour ce qu'ils vous ont coûté, pas pour le prix du forfait. ## L'assistant selon le forfait Chaque forfait inclut l'assistant IA ; ce qui change est le nombre de questions que votre organisation peut poser par mois : | Forfait | Questions par mois | | ------------- | ------------------ | | Pay as you go | 30 | | Growth | 300 | | Scale | 2 000 | Sur le forfait gratuit, l'assistant s'ouvre quand votre organisation passe en production. Avant, le bouton **Assistant** de la barre du haut et les boutons qui l'interrogent sur un élément (**Analyser le paiement**, **Résumer la période**…) s'affichent avec un petit cadenas : un clic dit que l'assistant s'ouvre avec la production, et nomme le forfait qui l'inclut dès aujourd'hui. L'assistant du forfait gratuit répond dans son panneau ; ses e-mails (les alertes et le résumé du lundi) viennent avec un forfait payant. Le panneau affiche les questions qui restent ce mois-ci. Une fois épuisées, il le dit et nomme le forfait qui en inclut davantage ; le compte repart le 1er. Un membre qui ne peut pas changer de forfait est invité à demander au propriétaire. ## Quand un forfait se rembourse Les frais du rail Wajub baissent avec le forfait. Quand les frais qu'un forfait vous aurait fait économiser sur les 30 derniers jours dépassent son prix, **Facturation** et **Revenus** affichent **Le forfait … se rembourserait**, avec vos frais payés, l'économie estimée et le prix du forfait. C'est une estimation faite sur ce que vous avez encaissé par le rail Wajub : elle suit votre volume. Rien ne s'affiche tant qu'aucun forfait ne vous ferait gagner d'argent. ## Avant d'atteindre une limite À partir de 80 % d'une limite de votre forfait, la page concernée le dit : **Liens de paiement**, **Factures**, **Membres**, **Fournisseurs** et la fenêtre d'export affichent par exemple « 21 liens de paiement utilisés sur 25 », avec **Voir les forfaits**. ## Après le paiement Le nouveau forfait remplace l'ancien dès que le paiement est confirmé, et **Forfait actuel** l'affiche. Si vous quittez la page de paiement sans payer, l'onglet **Abonnement** affiche **Paiement en attente** avec le forfait demandé, et **Finaliser le paiement** rouvre la page de paiement. > [!NOTE] > **Revenir au forfait gratuit** > > Choisir **Pay as you go** dans cette fenêtre change le forfait tout de suite, avec > **Changer de forfait** comme dernier bouton, et les jours déjà payés de votre forfait actuel > sont perdus. Pour le garder jusqu'à sa date de fin, [annulez > l'abonnement](https://docs.wajub.com/dashboard/subscription/manage#cancel) à la place. --- # Payer une facture Wajub URL: https://docs.wajub.com/fr/dashboard/subscription/wajub-invoices > Payer ce que l'organisation doit à Wajub pour son forfait, ses modules et son usage, télécharger les factures et régler les détails qui y figurent. L'onglet **Factures** de la facturation regroupe ce que votre organisation doit à Wajub : forfait, modules complémentaires et dépassements d'usage. Vous y payez le montant dû et téléchargez vos factures. Le propriétaire, un Administrateur ou un [rôle](https://docs.wajub.com/fr/dashboard#roles) personnalisé qui a **Gérer le compte** paie les factures, [en Test comme en Production](https://docs.wajub.com/fr/dashboard#sandbox-and-live), sans [code de sécurité](https://docs.wajub.com/fr/dashboard#the-security-code). ## Les étapes 1. **Ouvrez les factures** Ouvrez **Paramètres**, puis **Facturation** dans le groupe **Organisation**, et l'onglet **Factures**. La carte **Montant dû** donne le total, son détail et son échéance : **En retard**, une échéance dans les 7 jours, la date du renouvellement ou **À venir**.  *Payer maintenant n'apparaît que lorsqu'un montant est dû.* 2. **Lancez le paiement** **Payer maintenant** ouvre **Payer la facture**, avec le montant à payer. 3. **Choisissez le moyen de paiement** Le moyen de paiement de votre abonnement est déjà choisi ; vous pouvez en prendre un autre. 4. **Payez la facture** Par carte, Mobile Money ou Crypto, le bouton **Payer**, suivi du montant, ouvre une page de paiement sécurisée. Si le montant dû a changé entre-temps, rien n'est prélevé : la fenêtre affiche le nouveau montant, à payer à son tour. Si la facture a été payée ou remplacée entre-temps, la fenêtre indique **Plus rien n'est dû** et rien n'est prélevé. ## Télécharger une facture **Historique des factures** liste chaque facture avec sa date et son **Statut**, et le filtre **Statut** en garde une partie. Le bouton de téléchargement, sur la ligne, télécharge la facture. Une ligne dépliée montre ses **Tentatives de paiement**. Plus bas, **Tentatives de paiement échouées** liste les paiements qui n'ont pas abouti, avec leur raison. ## Les détails de facturation L'onglet **Paramètres de facturation** règle ce qui figure sur vos factures : l'**E-mail de facturation**, qui reçoit les factures et les avis de facturation, le **N° d'identification fiscale / TVA** et le **N° de bon de commande / référence**. **Enregistrer les modifications** les applique. **Prélèvement automatique des dépassements d'usage** débite chaque mois votre carte pour les dépassements d'usage BYOP, sans attendre que vous les payiez. Il ne s'active que pour un abonnement payé par carte. --- # Suivre l'activité Sync URL: https://docs.wajub.com/fr/dashboard/sync/activity > Lire le volume, les paiements et les commissions de vos marchands connectés, ensemble ou compte par compte. Les onglets de **Sync** suivent ce que vos marchands connectés encaissent par votre plateforme et ce que vous y gagnez. Le propriétaire, un Administrateur, un membre Finance, un Analyste, un Observateur, ou un rôle personnalisé qui a **Voir les transferts** ou **Gérer les transferts**, voit cette activité. Le forfait est celui de [Connecter un marchand](https://docs.wajub.com/dashboard/sync/connect-merchant) : **Scale**, **Enterprise** ou l'option **Sync**. Chaque environnement montre ses propres connexions et ses propres paiements : [Test et Production](https://docs.wajub.com/fr/dashboard#sandbox-and-live). ## Vue d'ensemble Sync s'ouvre sur **Vue d'ensemble**. **Comptes connectés** compte toutes vos connexions, dont vos marchands actifs et vos invitations en attente. Pour la **Période** choisie, **Volume**, **Paiements** et **Commissions** sont comparés à la période précédente, et le graphique **Volume et commissions** les suit par jour ou par mois.  *Le volume, les paiements et les commissions sont comparés à la période précédente.* En dessous, **Derniers paiements** liste les paiements récents, **Top comptes** classe vos marchands par volume, **Canaux de paiement** répartit les paiements par moyen de paiement, et **Depuis le début** donne le volume, les paiements et les commissions cumulés. ## Les paiements L'onglet **Paiements** liste les paiements encaissés par tous vos comptes connectés. La recherche prend l'identifiant du paiement, sa référence, sa description, ou le nom ou l'e-mail du client ; **Compte** limite la liste à un marchand, et **Date de paiement** à une période. Un paiement ouvert affiche **Votre commission** sur ce paiement. ## Les revenus L'onglet **Revenus** affiche **Revenus de commission** pour la **Période** choisie : **Commissions sur la période**, comparées à la période précédente, **Commissions depuis le début** et **Marchands connectés**, puis un graphique des commissions dans le temps. **Revenus par marchand** classe vos marchands du plus gros montant au plus petit, avec une ligne par devise quand un marchand est payé en plusieurs devises. Si vous gagnez dans plusieurs devises, **Commissions par devise** les montre côte à côte, sans jamais les additionner. ## Les frais collectés Dans le menu **Paiements**, l'onglet **Frais collectés** liste votre commission sur chaque paiement encaissé pour un marchand connecté, avec le **Total collecté** en tête. La recherche prend l'identifiant, la référence ou la description du paiement, et les filtres la date et le montant des frais ; chaque frais mène au paiement d'où il vient. L'onglet demande aussi le forfait **Growth** ou un forfait au-dessus : avec l'option **Sync** sur **Pay as you go**, il n'apparaît pas. Un rôle personnalisé a besoin en plus de **Voir les paiements**. ## Le détail d'un compte La page d'un marchand, ouverte depuis **Sync › Comptes**, a ses propres onglets. [Gérer un compte connecté](https://docs.wajub.com/dashboard/sync/connected-account#open-an-account) décrit sa vue d'ensemble. Les autres onglets suivent les permissions que le marchand a accordées : | Onglet | Apparaît avec la permission | | ---------------------------- | ------------------------------------- | | **Paiements** et **Litiges** | **Paiements** ou **Accès en lecture** | | **Transferts** | **Transferts** | | **Remboursements** | **Remboursements** | | **Clients** | **Clients** | Ces onglets n'apparaissent qu'une fois le marchand connecté. **Chronologie**, toujours présent, affiche l'**Historique** : ce qui s'est passé sur la connexion, du plus récent au plus ancien. --- # Connecter un marchand URL: https://docs.wajub.com/fr/dashboard/sync/connect-merchant > Inviter un marchand à connecter son compte Wajub à votre plateforme, avec votre commission et les permissions demandées, puis lui partager le lien d'invitation. Sync sert aux plateformes qui encaissent pour les marchands qui vendent chez elles : vous prenez une commission sur chacun de leurs paiements. Vous préparez une connexion avec vos conditions, et le marchand l'accepte depuis un lien d'invitation. Le propriétaire, un Administrateur, un membre Finance ou un rôle personnalisé qui a **Gérer les transferts** peut connecter un marchand ; un Analyste, un Observateur ou un rôle personnalisé qui a **Voir les transferts** suit les comptes connectés sans pouvoir en créer. Sync demande le forfait **Scale** ou **Enterprise**, ou l'option **Sync**, qui s'ajoute à n'importe quel forfait : [Ajouter une option](https://docs.wajub.com/dashboard/subscription/add-ons). Sync marche en Test comme en Production, avec des connexions séparées dans chaque environnement. Aucun code de sécurité n'est demandé pour créer une connexion. ## Les étapes 1. **Ouvrez le formulaire** Ouvrez **Sync**, puis l'onglet **Créer**. La page **Connecter un marchand** passe par trois étapes : **Compte**, **Conditions** et **Examiner**. 2. **Choisissez le type de compte** Sous **Type de compte**, **Direct** convient à un marchand qui a un compte Wajub complet et le gère lui-même. **Lite** lui donne un espace simplifié, et il encaisse toujours via Wajub. Ce choix ne change plus ensuite : il fait partie de ce que le marchand accepte.  *Relay n'est pas encore disponible : pour payer quelqu'un sans compte Wajub, passez par un compte de versement.* **Relay** est marqué **Pas encore disponible**. Pour payer un bénéficiaire qui n'a pas de compte Wajub, [ajoutez un compte de versement](https://docs.wajub.com/dashboard/transfers/payout-accounts). 3. **Donnez l'e-mail du marchand** **E-mail du marchand** est facultatif : c'est l'adresse où vous pourrez envoyer l'invitation, et où partent des rappels avant son expiration. Sans adresse, vous partagez le lien vous-même. **Continuer** passe aux conditions. 4. **Fixez votre commission** Dans **Tarification**, la commission part de vos réglages par défaut, que vous changez ici pour ce marchand : un **Pourcentage** de chaque paiement, de 0 à 100, et des **Frais fixes** ajoutés au pourcentage, dans la **Devise des montants**. **Frais minimum** et **Frais maximum** sont facultatifs. Sans pourcentage ni frais fixes, le formulaire prévient que vous ne prendrez rien sur les paiements de ce marchand. 5. **Choisissez les permissions** **Permissions** dit ce que votre plateforme pourra faire sur le compte du marchand : **Accès en lecture**, **Paiements**, toujours demandé, **Transferts**, **Remboursements**, **Litiges**, **Clients** et **Factures**. Le marchand voit cette liste avant d'accepter et peut retirer votre accès à tout moment. **Continuer** ouvre l'examen. 6. **Créez la connexion** **Examiner** résume le compte et les conditions ; **Modifier** ramène à l'étape d'une section. **Créer une connexion** crée la connexion et ouvre sa page sur **En attente de la connexion du marchand**, avec le lien d'invitation. ## Partager le lien d'invitation La section **Lien d'invitation** donne le lien à copier, le bouton **Partager sur WhatsApp** et un code QR, que le marchand peut scanner avec son téléphone, à télécharger avec **Télécharger en PNG** ou **Télécharger en SVG**. Le lien ne sert qu'une fois, et toute personne qui l'ouvre peut connecter un compte à votre plateforme : envoyez-le au marchand seulement.  *Le lien n'apparaît qu'une fois, juste après la création.* Le lien expire au bout de 30 jours, à la date indiquée sous le code QR, et des rappels partent à l'adresse du marchand pendant ses 3 derniers jours. Il ne s'affiche qu'à la création : plus tard, **Régénérer le lien** en donne un nouveau, et l'ancien cesse de fonctionner. Avec une adresse e-mail, **Renvoyer l'invitation** envoie un nouveau lien au marchand, et celui que vous aviez partagé cesse aussi de fonctionner. Dans les deux cas, le nouveau lien a de nouveau 30 jours. ## Ce que voit le marchand Le marchand ouvre le lien, se connecte à Wajub ou crée son compte, choisit l'entreprise à connecter, termine sa vérification si elle manque, puis lit vos conditions et les accepte. ## Après l'acceptation La connexion passe au statut **Actif** dans **Sync › Comptes**. Jusque-là, vous pouvez encore changer la tarification et les permissions sur sa page ; ensuite, un changement doit être accepté par le marchand. [Gérer un compte connecté](https://docs.wajub.com/dashboard/sync/connected-account) décrit cette page, et [Paramétrer Sync](https://docs.wajub.com/dashboard/sync/settings) les réglages par défaut d'une nouvelle invitation. --- # Gérer un compte connecté URL: https://docs.wajub.com/fr/dashboard/sync/connected-account > Lire la page d'un marchand connecté, changer sa commission ou ses permissions, suspendre ses paiements, annuler une invitation ou déconnecter le marchand. Chaque marchand invité a sa page dans Sync : son activité, les conditions de la connexion et les actions pour la faire évoluer ou y mettre fin. Le propriétaire, un Administrateur, un membre Finance ou un rôle personnalisé qui a **Gérer les transferts** gère un compte connecté ; un Analyste, un Observateur ou un rôle personnalisé qui a **Voir les transferts** le consulte. Le forfait est celui de [Connecter un marchand](https://docs.wajub.com/dashboard/sync/connect-merchant) : **Scale**, **Enterprise** ou l'option **Sync**. Suspendre ou réactiver les paiements et déconnecter un marchand demandent le [code de sécurité](https://docs.wajub.com/fr/dashboard#the-security-code) ; changer les conditions, régénérer le lien ou annuler une invitation, non. ## Ouvrir un compte Ouvrez **Sync**, puis l'onglet **Comptes**. **Comptes synchronisés** liste les marchands connectés et les invitations en attente, avec leur **Statut**, le montant **Collecté**, leurs **Paiements** et la date de création. Cliquez sur un compte pour ouvrir sa page. L'en-tête donne le nom du marchand, l'**ID de connexion** et le statut de la connexion : **En attente**, **Actif**, **Expiré** ou **Annulée**. Une fois le marchand connecté, un second badge dit s'il peut encaisser par votre plateforme : **Paiements activés**, **Paiements suspendus** ou **Paiements inactifs**. En Production, une nouvelle connexion reste **Paiements inactifs** jusqu'à ce que Wajub accepte la vérification du marchand, et pour un compte Lite son contrat Wajub Rail, puis passe d'elle-même à **Paiements activés** ; en Test, elle encaisse tout de suite.  *Le second badge dit si le marchand peut encaisser par votre plateforme.* **Performance** montre le **Volume**, les **Commissions**, les **Paiements** et le **Taux de réussite** sur la période choisie, avec les **Derniers paiements** en dessous. **Détails de la connexion** reprend le type de compte, l'e-mail du marchand et les dates. Les autres onglets du compte sont décrits dans [Suivre l'activité Sync](https://docs.wajub.com/dashboard/sync/activity#one-account). ## Changer les conditions 1. **Modifiez la tarification ou les permissions** Sur la page du compte, changez le **Pourcentage**, les **Frais fixes**, les **Frais minimum** ou les **Frais maximum** dans **Tarification**, ou cochez d'autres cases dans **Permissions**. La tarification affiche la commission prise sur un paiement d'exemple. 2. **Ajoutez un message** Quand le marchand est déjà connecté, **Message au marchand**, facultatif, accompagne votre proposition. Tant que l'invitation attend, il n'y a pas de message : le marchand découvrira les conditions en ouvrant le lien. 3. **Enregistrez ou proposez** Pour une invitation en attente, **Enregistrer la tarification** ou **Enregistrer les autorisations** applique le changement tout de suite. Pour un marchand connecté, le bouton devient **Proposer une nouvelle tarification** ou **Proposer de nouvelles autorisations** : le marchand reçoit la proposition par e-mail et l'accepte ou la refuse. En attendant sa réponse, un encadré en haut de la page rappelle la proposition et sa date, et la connexion garde ses conditions actuelles. ## Suspendre ou réactiver les paiements **Suspendre les paiements**, en haut de la page, empêche le marchand d'encaisser par votre plateforme ; les paiements déjà faits ne changent pas. Après la confirmation et le code de sécurité, le badge passe à **Paiements suspendus** et le marchand est prévenu par e-mail, sauf s'il a coupé cet e-mail. **Réactiver les paiements** fait l'inverse. ## Régénérer ou annuler une invitation Tant que le marchand ne s'est pas connecté, le menu **Actions sur la connexion**, à droite de l'en-tête, propose **Régénérer le lien** et **Annuler la connexion**. [Partager le lien d'invitation](https://docs.wajub.com/dashboard/sync/connect-merchant#share-the-invitation) dit ce que change un nouveau lien. Annuler la connexion rend le lien inutilisable, sans retour possible ; **Le garder** referme la fenêtre sans rien changer. Une invitation expirée ou annulée affiche **Cette invitation a expiré** ou **Cette connexion est terminée** : **Créer une connexion** en prépare une nouvelle. ## Déconnecter un marchand Dans le menu **Actions sur la connexion**, **Déconnecter** suivi du nom du marchand coupe tout de suite l'accès de votre plateforme à son compte : son accès API est révoqué et il ne peut plus encaisser par vous. Les paiements déjà faits restent dans les deux comptes. Après la confirmation et le code de sécurité, la page affiche **Cette connexion est terminée** et garde l'historique. C'est définitif : pour reconnecter ce marchand, créez une nouvelle connexion et envoyez-lui la nouvelle invitation. Le marchand peut aussi se déconnecter de son côté : [Répondre à une plateforme](https://docs.wajub.com/dashboard/sync/connected-to-a-platform#disconnect-from-a-platform). --- # Répondre à une plateforme URL: https://docs.wajub.com/fr/dashboard/sync/connected-to-a-platform > Quand votre organisation est connectée à une plateforme par Sync, voir ce qu'elle peut faire sur votre compte, accepter ou refuser ses nouvelles conditions, et vous en déconnecter. Une plateforme qui encaisse pour vous par Sync vous envoie un lien d'invitation. Une fois connectée, elle prend une commission sur vos paiements et agit sur votre compte selon les permissions que vous lui avez accordées. **Paramètres › Applications connectées**, dans le groupe **Organisation**, liste ces plateformes. Le propriétaire, un Administrateur, un Développeur, un Observateur ou un rôle personnalisé qui a **Voir les paramètres** voit cette page ; seuls le propriétaire, un Administrateur ou un rôle personnalisé qui a **Gérer les paramètres** acceptent une connexion, répondent à de nouvelles conditions ou déconnectent une plateforme. La page est ouverte à tous les forfaits. Elle montre les connexions de l'[environnement](https://docs.wajub.com/fr/dashboard#sandbox-and-live) en cours : une connexion faite en Test n'apparaît pas en Production. Se déconnecter demande le [code de sécurité](https://docs.wajub.com/fr/dashboard#the-security-code). ## Accepter une connexion Le lien d'invitation s'ouvre hors du tableau de bord : vous vous connectez à Wajub, choisissez l'organisation à connecter, puis lisez les conditions de la plateforme et les acceptez. Seul un membre qui peut gérer les paramètres de cette organisation peut l'accepter. La plateforme apparaît ensuite dans **Applications connectées**, avec la date de connexion et les **Permissions accordées**.  *Une proposition de la plateforme ne change rien tant que vous ne l'acceptez pas.* ## Répondre à de nouvelles conditions Une plateforme connectée peut proposer une autre commission ou d'autres permissions. Vous recevez la proposition par e-mail, et rien ne change tant que vous ne l'acceptez pas. 1. **Ouvrez la proposition** Ouvrez **Paramètres › Applications connectées**. Sous le nom de la plateforme, l'encadré **Nouvelle tarification proposée** ou **Nouvelles autorisations proposées** met côte à côte la colonne **Aujourd'hui** et la colonne **Proposé**, avec le message de la plateforme si elle en a écrit un. 2. **Acceptez ou refusez** **Accepter** ouvre **Accepter les nouvelles conditions ?** : après **Accepter les nouvelles conditions**, elles s'appliquent à tout ce qui se passe ensuite, et les ventes déjà faites gardent les anciennes. **Refuser** ouvre **Refuser les nouvelles conditions ?** : après **Refuser les nouvelles conditions**, la connexion garde ses conditions actuelles, et la plateforme pourra en proposer d'autres plus tard. ## Se déconnecter d'une plateforme Ouvrez le menu de la plateforme, à droite de sa ligne, puis **Déconnecter**. Après la confirmation et le code de sécurité, la plateforme perd tout de suite tous ses accès à votre compte et la ligne disparaît. Les paiements déjà traités restent dans votre historique. Pour vous reconnecter, il faut une nouvelle invitation de la plateforme. La plateforme peut aussi vous déconnecter ou suspendre vos paiements ; les e-mails qui vous en préviennent se règlent dans [Les e-mails du compte connecté](https://docs.wajub.com/dashboard/sync/settings#connected-account-emails), avec le forfait **Scale** ou **Enterprise**, ou l'option **Sync**. --- # Paramétrer Sync URL: https://docs.wajub.com/fr/dashboard/sync/settings > Choisir les permissions et la commission par défaut d'une nouvelle invitation Sync, et les e-mails reçus quand une plateforme agit sur votre compte. **Paramètres › Sync** a deux onglets : **Plateforme**, les conditions par défaut de vos nouvelles invitations, et **Compte connecté**, les e-mails que vous recevez quand une plateforme à laquelle vous êtes connecté agit sur votre compte. Le propriétaire, un Administrateur, un Développeur, un Observateur ou un rôle personnalisé qui a **Voir les paramètres** ouvre ces réglages ; seuls le propriétaire, un Administrateur ou un rôle personnalisé qui a **Gérer les paramètres** les modifient. Les deux onglets demandent le forfait **Scale** ou **Enterprise**, ou l'option **Sync** : sans eux, l'entrée reste visible mais [verrouillée](https://docs.wajub.com/fr/dashboard#modules-outside-your-plan). Les réglages valent pour Test comme pour Production, et aucun code de sécurité n'est demandé. ## Les conditions par défaut 1. **Ouvrez les réglages Sync** Ouvrez **Paramètres › Sync**. La page s'ouvre sur l'onglet **Plateforme**.  *Ces conditions remplissent chaque nouvelle invitation, que vous pouvez encore changer.* 2. **Cochez les permissions par défaut** Sous **Permissions par défaut**, cochez ce qu'une nouvelle invitation demande au marchand. **Paiements** est toujours demandé. Dès le premier changement, la barre **Vous avez des modifications non enregistrées** apparaît en bas de la page. 3. **Fixez la commission par défaut** Sous **Commission par défaut**, saisissez le **Pourcentage (%)** et les **Frais fixes**, dans votre devise de règlement. Laissez **Plafond de frais** vide pour ne pas plafonner la commission. 4. **Enregistrez** **Enregistrer les modifications** applique les nouvelles valeurs ; **Abandonner** revient aux précédentes. Ces valeurs ne servent qu'aux invitations créées ensuite dans le tableau de bord, et vous pouvez encore les changer pour chaque marchand dans le formulaire. Une connexion existante garde ses conditions : elles se changent sur sa page, voir [Changer les conditions](https://docs.wajub.com/dashboard/sync/connected-account#change-the-terms). Une connexion créée par l'API prend les permissions et la commission que nomme sa requête, et aucune commission quand elle n'en nomme pas : [Capacités du compte](https://docs.wajub.com/fr/sync/account-types#pricing). ## Les e-mails du compte connecté L'onglet **Compte connecté** concerne votre organisation quand elle est elle-même connectée à une plateforme. Sous **Notifications par e-mail**, trois interrupteurs : | Interrupteur | L'e-mail part quand | | ------------------------------ | ------------------------------------------------------------------ | | **Capacités modifiées** | la plateforme active ou désactive des permissions sur votre compte | | **Statut du paiement modifié** | la plateforme suspend ou réactive vos paiements | | **Connexion terminée** | la plateforme vous déconnecte | Un interrupteur coupé arrête cet e-mail. Les nouvelles conditions qu'une plateforme propose arrivent toujours par e-mail, puisqu'elles attendent votre réponse : [Répondre à une plateforme](https://docs.wajub.com/dashboard/sync/connected-to-a-platform#answer-new-terms). Enregistrez avec **Enregistrer les modifications**. --- # Paramétrer la taxe URL: https://docs.wajub.com/fr/dashboard/tax/settings > Activer le calcul de la TVA ou de la GST sur vos paiements, dire si vos prix l'incluent, choisir le pays par défaut et enregistrer votre immatriculation fiscale. Une fois la collecte activée, Wajub calcule la taxe de chaque paiement crédité, d'après le pays du payeur, et la range dans [votre rapport](https://docs.wajub.com/dashboard/tax/track). Vos clients paient toujours le prix que vous avez fixé. Le propriétaire, un Administrateur, un membre Finance ou un rôle personnalisé qui a **Gérer les taxes** règle la taxe, à partir du forfait **Growth**. Comme le rappelle [Test et Production](https://docs.wajub.com/fr/dashboard#sandbox-and-live), le module n'existe qu'en Production. Aucun code de sécurité n'est demandé. ## Les étapes 1. **Ouvrez les paramètres fiscaux** Dans **Taxe**, cliquez sur **Configurer la taxe**, ou sur l'onglet **Paramètres** si la collecte est déjà activée. La page **Paramètres fiscaux** s'ouvre. 2. **Activez la collecte** Activez **Activer la collecte de taxes**. **Tarification taxe incluse**, **Pays par défaut** et **Immatriculation fiscale** apparaissent. L'encadré **Taux de taxe par pays** rappelle que le taux normal de chaque pays est déjà prêt. 3. **Dites si vos prix incluent la taxe** Activé, **Tarification taxe incluse** compte la taxe à l'intérieur de chaque prix. Désactivé, le rapport compte le taux en plus de chaque prix. Les paiements et les liens facturent toujours le prix fixé ; seules les factures peuvent ajouter la taxe en plus. 4. **Choisissez le pays par défaut** Le **Pays par défaut** sert quand le pays du payeur est inconnu. 5. **Saisissez votre immatriculation fiscale** Choisissez le **Type de numéro fiscal**, puis saisissez le **Numéro d'immatriculation fiscale** : les deux sont obligatoires pour activer la collecte, et le numéro doit suivre le format de son type. Il est gardé avec vos paramètres, sans être imprimé sur les factures ni les reçus pour l'instant.  *Le numéro d'immatriculation est obligatoire pour activer la collecte.* 6. **Enregistrez** Cliquez sur **Enregistrer les modifications** dans la barre du bas : **Paramètres fiscaux mis à jour.** s'affiche. **Taxe** montre désormais le rapport, avec les onglets **Vue d'ensemble** et **Paramètres**. ## Dans vos factures Tant que la collecte est activée, le formulaire de facture propose **Collecter la taxe automatiquement** à l'étape des lignes : il applique vos paramètres fiscaux et le pays du client. Désactivez-le pour fixer vous-même la taxe de chaque ligne, comme pour [toute facture](https://docs.wajub.com/dashboard/invoices/create#the-steps). ## Désactiver la collecte Désactivez **Activer la collecte de taxes**, puis enregistrez. Les nouveaux paiements ne sont plus taxés, et **Taxe** affiche de nouveau [sa présentation](https://docs.wajub.com/dashboard/tax/track#before-turning-it-on) à la place du rapport. Pour la réactiver, repassez par **Configurer la taxe**. --- # Suivre la taxe collectée URL: https://docs.wajub.com/fr/dashboard/tax/track > Lire la taxe calculée sur vos paiements pour une période, par pays et par devise, et l'exporter en CSV pour votre comptable. **Taxe** montre la TVA ou la GST que Wajub a calculée sur les paiements crédités, en ligne et au TPE, pour la période choisie. Le calcul ne change pas ce que paient vos clients. Le module est inclus à partir du forfait **Growth** ([Modules hors de votre forfait](https://docs.wajub.com/fr/dashboard#modules-outside-your-plan)) et n'existe qu'en [Production](https://docs.wajub.com/fr/dashboard#sandbox-and-live). Tous les rôles qui lisent la taxe voient le rapport ([Rôles](https://docs.wajub.com/fr/dashboard#roles)). L'export demande **Gérer les taxes** : le propriétaire, un Administrateur, un membre Finance ou un rôle personnalisé qui l'a. Aucun code de sécurité n'est demandé. ## Avant l'activation Tant que la collecte n'est pas activée, **Taxe** présente le module avec le badge **Collecte de taxes**. Ceux qui ont **Gérer les taxes** y trouvent **Configurer la taxe**, qui ouvre [les paramètres fiscaux](https://docs.wajub.com/dashboard/tax/settings). Les autres lisent « Demandez à un administrateur de votre organisation de configurer la collecte des taxes. ». Si la collecte est désactivée plus tard, cette présentation revient à la place du rapport. ## Lire le rapport Choisissez la **Période** en haut à droite : **30 derniers jours** par défaut, une autre période toute faite, ou le premier et le dernier jour dans le calendrier, puis **Appliquer**. Trois chiffres résument la période : **Taxe collectée** et **Montant taxable** (hors taxes), tous deux convertis dans la devise de votre compte, puis **Pays**, le nombre de pays où des paiements ont été taxés.  *Les totaux et la taxe par pays sont convertis dans la devise du compte.* **Taxe par pays** détaille, pour chaque pays de payeur, le montant taxable, la taxe et le nombre de **Paiements**. **Taxe par devise** reprend les mêmes chiffres dans le montant propre à chaque devise. Une devise sans taux de change est laissée hors des totaux et de la taxe par pays : l'encadré **Certaines devises sont exclues des totaux** le signale. Un remboursement réussi retire sa part de taxe du rapport. Sans paiement taxé sur la période, le tableau affiche **Aucune taxe collectée pour cette période**. ## Exporter le rapport **Exporter**, à côté de la période, puis **CSV** sous **Télécharger en** : le fichier reprend les totaux, la taxe par pays et la taxe par devise de la période affichée, et « Votre export est prêt » donne son nom. --- # Gérer les bénéficiaires URL: https://docs.wajub.com/fr/dashboard/transfers/beneficiaries > Retrouver les bénéficiaires que votre intégration paie par l'API, lire leur page, les modifier, les archiver ou les supprimer, et les exporter. L'onglet **Bénéficiaires** de **Transferts** liste les destinataires que votre intégration crée et paie par l'API, comme l'explique [Créer un bénéficiaire](https://docs.wajub.com/fr/payouts/beneficiaries/create). Le tableau de bord n'en crée pas : pour retirer votre solde vers l'un de vos propres comptes, [liez un compte de versement](https://docs.wajub.com/dashboard/transfers/payout-accounts). Tant que votre intégration n'a créé aucun bénéficiaire, une page de présentation remplace la liste. Tous ceux qui ont **Voir les transferts** ouvrent la liste et les bénéficiaires, en Test comme en Production : chaque environnement a ses propres bénéficiaires. Le propriétaire, un Administrateur, un membre Finance ou un rôle personnalisé qui a **Gérer les bénéficiaires** modifie, archive, restaure, supprime et exporte, en Production. Toutes ces actions sauf l'export demandent le code de sécurité. ## La liste  *La liste ne montre que les bénéficiaires créés par l'API.* Chaque ligne donne le **Bénéficiaire**, son **Moyen de paiement**, son **Statut**, ses **Transferts** avec le nombre de réussis, et la date **Créé**. Les filtres portent sur la **Date de création**, le **Statut**, **Actif** ou **Inactif**, et **Bénéficiaires archivés**, qui n'affiche que les bénéficiaires archivés. La recherche trouve un bénéficiaire par son nom, son e-mail, son téléphone ou son ID. Le menu au bout d'une ligne propose **Ouvrir le bénéficiaire**, **Copier l'ID du bénéficiaire** et, en Production, **Modifier**. ## La page d'un bénéficiaire L'en-tête donne le nom, le statut, le type **Bénéficiaire API** et l'**ID du bénéficiaire** à copier. Trois chiffres suivent : le nombre de **Transferts**, le montant **Reçu**, devise par devise, et le **Taux de réussite**. Viennent ensuite les **Détails du bénéficiaire**, l'**Activité des transferts** des 30 derniers jours et les **Transferts récents** : **Voir tous les transferts** ouvre la liste des transferts filtrée sur ce bénéficiaire. Sur le côté, **Moyen de paiement** et **Par statut** résument où il est payé et comment ses transferts ont fini. La même page s'ouvre pour un compte de versement, par exemple depuis **Voir le bénéficiaire** sur un transfert. Elle porte alors le type **Compte de versement** et, en Production, pour qui peut envoyer un transfert, le bouton **Envoyer le transfert** quand le compte est actif et non archivé : il ouvre le formulaire de transfert sur ce compte. ## Modifier un bénéficiaire 1. **Ouvrez le formulaire** Sur la page du bénéficiaire, ou dans le menu de sa ligne, choisissez **Modifier**. 2. **Corrigez le contact** Sous **Contact**, corrigez le **Nom**, obligatoire, l'**E-mail**, le **Téléphone** ou le **Pays**. 3. **Changez le moyen de paiement** Sous **Transferts**, le **Type** reste celui choisi à la création. Le **Moyen de paiement** propose les moyens déjà enregistrés pour vos bénéficiaires. 4. **Activez ou désactivez le bénéficiaire** Désactivé, **Actif** fait refuser tout transfert vers ce bénéficiaire, par l'API comme depuis le tableau de bord. 5. **Enregistrez** Choisissez **Enregistrer les modifications**, puis saisissez le code de sécurité. La page du bénéficiaire s'ouvre sur « Bénéficiaire mis à jour avec succès. ». La **Note**, en bas du formulaire, garde une information que seuls vos membres voient. ## Archiver, restaurer ou supprimer Le menu de la page du bénéficiaire propose **Archiver le bénéficiaire** : il quitte la liste et ne peut plus être payé, et ses transferts restent. Le filtre **Bénéficiaires archivés** le retrouve ; sa page affiche **Ce bénéficiaire est archivé** et son menu propose **Restaurer le bénéficiaire**. **Supprimer définitivement** efface le bénéficiaire et ses statistiques, sans retour possible. Un bénéficiaire dont un transfert est encore en cours ne peut pas être supprimé : archivez-le plutôt. Chacune de ces trois actions demande le code de sécurité. ## Exporter les bénéficiaires En Production, **Exporter**, en haut de la liste, ouvre **Exporter les bénéficiaires** : le fichier, en CSV, Excel, PDF ou JSON, reprend les bénéficiaires que la liste affiche avec ses filtres et son ordre. Chaque export compte dans la limite mensuelle du forfait **Paiement à l'usage**. --- # Lier un compte de versement URL: https://docs.wajub.com/fr/dashboard/transfers/payout-accounts > Ajouter le numéro Mobile Money ou le compte bancaire qui reçoit vos transferts, le faire vérifier, y activer les versements automatiques, puis le modifier ou l'archiver. Un transfert part de votre solde vers un compte de versement : un numéro Mobile Money, un compte bancaire ou un compte Wajub, le vôtre ou celui de quelqu'un que vous payez. Vous l'ajoutez une fois, puis vous le choisissez à chaque [transfert](https://docs.wajub.com/dashboard/transfers/send). Le propriétaire, un Administrateur ou un rôle personnalisé qui a **Gérer les paramètres** ajoute, modifie et fait vérifier les comptes de versement, avec tous les forfaits. Un membre Finance envoie des transferts mais n'ouvre pas cette page. Elle n'existe qu'en Production, et ajouter, modifier ou faire vérifier un compte demande le code de sécurité. ## Les étapes 1. **Ouvrez le formulaire** Ouvrez **Paramètres › Transferts**, onglet **Comptes de versement**, puis **Ajouter un compte de versement**. Le formulaire passe par quatre étapes, **Pays**, **Méthode**, **Détails** et **Examiner**, et **Continuer** mène de l'une à l'autre. 2. **Choisissez le pays** Sous **Pays du compte**, choisissez le pays où le numéro ou le compte bancaire est enregistré. 3. **Choisissez le moyen de versement** **Moyen de versement** propose les moyens ouverts dans ce pays : Mobile Money, banque, virement bancaire ou compte Wajub selon le pays. Une carte ne peut pas recevoir de transfert. Si aucun moyen n'est encore ouvert pour votre organisation, le formulaire le dit et propose, selon le cas, **Demander l'accès**, **Signer le contrat** ou **Voir la demande**. 4. **Saisissez le numéro ou le compte** Pour Mobile Money, saisissez le **Numéro mobile**. Pour MTN, Orange Money et Express Union au Cameroun, le tableau de bord interroge l'opérateur et affiche « Nom enregistré : » suivi du nom du titulaire, avec **Utiliser ce nom**. Pour un compte bancaire, saisissez le **Numéro de compte** ; pour un virement bancaire, le **Nom de la banque**, la **Devise du compte**, l'IBAN ou le numéro de compte, le SWIFT/BIC ou le code bancaire local, et l'**Attestation de compte bancaire** quand elle est demandée. Pour un compte Wajub, le **Numéro de compte Wajub**. 5. **Indiquez le titulaire** **Nom du titulaire du compte** est le nom sous lequel le compte est enregistré, tel que la banque le connaît pour un virement. **E-mail de notification**, facultatif, reçoit les confirmations de versement. 6. **Ajoutez le compte** L'étape **Examiner** reprend **Où va l'argent** et **Titulaire du compte** : l'argent part vers ce compte exactement tel que saisi. Choisissez **Ajouter un compte de versement**, puis saisissez le code de sécurité. Si vous veniez du formulaire de transfert, vous y revenez avec ce compte déjà choisi. ## Faire vérifier le compte Un transfert ne part que vers un compte **Vérifié**. À l'ajout, un compte Mobile Money est vérifié quand le nom enregistré chez l'opérateur correspond au titulaire saisi, à la raison sociale de votre dossier d'activation ou à l'une des personnes qu'il déclare. Un compte Wajub l'est quand son titulaire correspond. Sinon, la liste l'affiche **Non vérifié**. Pour un compte Mobile Money **Non vérifié**, **Vérifier auprès de l'opérateur** relance la comparaison et demande le code de sécurité. Si les noms correspondent, le compte passe **Vérifié**. Sinon, le propriétaire de l'organisation reçoit par e-mail un code à six chiffres, valable 15 minutes : saisissez-le dans le champ qui apparaît sur la ligne du compte, puis **Vérifier**. Le tableau de bord ne permet pas de faire vérifier un compte bancaire. ## Versements automatiques Au-dessus de la liste, **Versements automatiques** verse vos ventes sur l'un de vos comptes de versement chaque nuit, sans transfert de votre part. Ils sont désactivés tant que vous ne les activez pas : sinon, votre argent reste sur votre solde jusqu'à ce que vous envoyiez un [transfert](https://docs.wajub.com/dashboard/transfers/send). 1. **Activer** Activez **Verser mon solde automatiquement**. 2. **Choisir le compte** Sous **Versé sur**, choisissez le compte de versement qui reçoit l'argent. Avec un seul compte, il est déjà choisi. Sans compte, ajoutez-en un d'abord : la section vous le dit. 3. **Enregistrer** Choisissez **Enregistrer**, puis saisissez le code de sécurité. Chaque nuit, Wajub verse les ventes pas encore versées, moins leurs remboursements, leurs frais et les litiges perdus, et jamais plus que ce qui est disponible sur votre solde avec les frais du payout en plus : ce que vous avez déjà envoyé vous-même n'est pas renvoyé, et les fonds que vous avez ajoutés à votre solde y restent. Le premier versement après l'activation comprend les ventes déjà sur votre solde, dans la limite de ce qui est disponible. Rien n'est envoyé sous 1 000. [Solde et règlements](https://docs.wajub.com/fr/payouts/balance#settlement-to-your-payout-account) donne le détail. Si le compte choisi est archivé ou désactivé, rien n'est versé et la section vous demande d'en choisir un autre. Désactivez l'interrupteur et enregistrez pour arrêter les versements automatiques à tout moment. ## Modifier ou archiver un compte Le menu au bout d'une ligne propose **Modifier** : **Modifier le compte de versement** change le contact, le **Moyen de paiement**, la case **Actif** et une **Note** que seuls vos membres voient. **Enregistrer les modifications** demande le code de sécurité. Changer le moyen de paiement remet le compte **Non vérifié** et envoie une alerte de sécurité par e-mail au propriétaire. **Archiver**, dans le même menu, retire le compte de la liste : plus aucun transfert ne peut lui être envoyé, et ses transferts restent. Archiver demande le code de sécurité et la permission **Gérer les bénéficiaires**. Pour le retrouver ensuite, ouvrez l'un de ses transferts, puis **Voir le bénéficiaire** : sa page propose **Restaurer le bénéficiaire**. > [!NOTE] > **Les bénéficiaires de votre intégration** > > Les destinataires que votre intégration paie par l'API sont aussi des bénéficiaires, mais pas > des comptes de versement : ils sont dans > [Gérer les bénéficiaires](https://docs.wajub.com/dashboard/transfers/beneficiaries). --- # Programmer des transferts URL: https://docs.wajub.com/fr/dashboard/transfers/recurring > Créer un calendrier qui envoie le même montant à un compte de versement chaque heure, chaque jour, chaque semaine ou chaque mois, puis le suspendre, le modifier ou le supprimer. Un transfert récurrent paie le même compte de versement selon un calendrier : un fournisseur chaque mois, votre propre compte chaque semaine. Chaque exécution est un vrai transfert, avec les mêmes limites, les mêmes contrôles et la même [vérification](https://docs.wajub.com/dashboard/transfers/under-review) qu'un transfert envoyé à la main. Le propriétaire, un Administrateur ou un rôle personnalisé qui a **Gérer les paramètres** crée et gère les calendriers, en Production. Créer, modifier ou reprendre un calendrier demande le forfait **Growth** ou un forfait au-dessus. Créer, modifier et supprimer demandent le code de sécurité ; suspendre et reprendre ne le demandent pas. ## Les étapes 1. **Ouvrez le formulaire** Ouvrez **Paramètres › Transferts**, onglet **Transferts récurrents**, puis **Créer un transfert récurrent**. Si votre forfait ne les inclut pas, la page affiche **Non inclus dans votre forfait** et le bouton mène aux forfaits. 2. **Choisissez le compte et le montant** Sous **Destinataire et montant**, choisissez le **Compte de versement**, puis le **Montant de chaque exécution**, dans les limites rappelées au-dessus du champ. Le **Nom**, facultatif, aide à retrouver le calendrier dans la liste ; la **Description**, facultative, s'affiche sur chaque transfert. 3. **Réglez le calendrier** Sous **Planification**, choisissez la **Fréquence** : **Toutes les heures**, **Quotidien**, **Hebdomadaire** avec le **Jour de la semaine**, ou **Mensuel** avec le **Jour du mois**, de 1 à 31. Un mois plus court utilise son dernier jour. Sauf pour l'envoi horaire, réglez l'**Heure (UTC)**, 09:00 par défaut : le calendrier tourne en UTC, et 09:00 UTC correspond à 10:00 au Cameroun.  *Les heures du calendrier sont en UTC.* 4. **Relisez le calendrier** Choisissez **Examiner**. L'étape reprend le destinataire, le montant de chaque exécution et le rythme, par exemple « Le 5 de chaque mois à 09:00 UTC ». **Modifier les informations** revient au formulaire. 5. **Créez le calendrier** Choisissez **Créer un transfert récurrent**, puis saisissez le code de sécurité. Le message de confirmation donne la date du premier envoi, et le calendrier rejoint la liste, **Actif**. ## Suivre et modifier un calendrier Chaque ligne de **Transferts récurrents** donne le compte, le montant, le rythme, la prochaine exécution et la dernière avec son statut. Les transferts qu'il envoie portent la source **Récurrent** dans [la liste des transferts](https://docs.wajub.com/dashboard/transfers/track#the-list). Le menu au bout d'une ligne propose **Modifier** : **Enregistrer les modifications** recalcule alors la prochaine exécution à partir de maintenant. **Mettre le calendrier en pause** arrête les envois. **Reprendre le calendrier** le relance à sa prochaine date, sans rattraper les envois manqués, et remet son compteur d'échecs à zéro ; sans le forfait, le menu affiche **Changer de forfait pour reprendre**. **Supprimer le calendrier** arrête définitivement les envois, et les transferts déjà envoyés restent. ## Quand une exécution échoue Une exécution échoue quand Wajub refuse le transfert, par exemple faute de solde, ou quand **Transferts autorisés depuis** est sur **API uniquement**, que **Arrêter tous les transferts** est activé ou que le montant sort des limites des [paramètres généraux](https://docs.wajub.com/dashboard/transfers/settings#general-settings). La ligne affiche alors le nombre d'échecs consécutifs et la dernière erreur, et le calendrier passe à sa date suivante. Après trois échecs de suite, il passe **En pause** et le propriétaire reçoit un e-mail. Reprenez-le une fois la cause réglée. Si votre forfait n'inclut plus les transferts récurrents, vos calendriers actifs passent en pause en quelques minutes et le propriétaire est prévenu. Vous pouvez toujours les voir et les supprimer. Ils repartent d'eux-mêmes quand votre forfait les inclut de nouveau, à leur prochaine date. > [!NOTE] > **Temporairement indisponible** > > Quand Wajub suspend les transferts récurrents, la page l'indique par cet encadré : aucun envoi ne > part, vos calendriers restent tels quels, et chaque transfert arrivé à échéance pendant ce temps > part une fois au retour du service. --- # Envoyer un transfert URL: https://docs.wajub.com/fr/dashboard/transfers/send > Envoyer de l'argent de votre solde vers l'un de vos comptes de versement, relire les frais avant l'envoi, et ce qui fait refuser un transfert. Un transfert envoie de l'argent de votre solde vers l'un de vos [comptes de versement](https://docs.wajub.com/dashboard/transfers/payout-accounts). Pour payer le même compte à date fixe, [programmez des transferts](https://docs.wajub.com/dashboard/transfers/recurring). Le propriétaire, un Administrateur, un membre Finance ou un rôle personnalisé qui a **Gérer les transferts** peut envoyer un transfert, avec tous les forfaits. Le formulaire n'existe qu'en Production, et l'envoi demande le code de sécurité. ## Les étapes 1. **Ouvrez le formulaire** Ouvrez **Transferts**, puis **Créer un transfert**. En haut, le formulaire donne le **Solde disponible**, ce que vous pouvez envoyer, et le montant **En attente**, pas encore disponible pour un envoi. [Solde et règlements](https://docs.wajub.com/fr/payouts/balance) explique ce délai. 2. **Choisissez le compte** Sous **Compte de versement**, choisissez le compte qui reçoit l'argent. Chacun porte son statut, **Vérifié** ou **Non vérifié** : un compte non vérifié affiche **Ce compte n'est pas encore vérifié** et ne peut pas recevoir le transfert. La liste reprend vos 100 comptes les plus récents. 3. **Saisissez le montant** Saisissez le **Montant** et, si besoin, changez de devise. Au-dessus du champ, le formulaire rappelle le minimum et les frais, qui s'ajoutent au montant : le compte reçoit tout le montant saisi, et votre solde paie le montant plus les frais. **Description**, facultative, s'affiche sur le transfert.  *Les frais s'ajoutent au montant que reçoit le compte.* 4. **Vérifiez le transfert** Choisissez **Vérifier le transfert** : le tableau de bord calcule les frais et passe à l'étape **Examiner**. **Destinataire** reprend le **Titulaire du compte**, le compte et sa **Vérification** ; **Montant** donne le montant, les frais et le total. **Modifier les informations** revient au formulaire. 5. **Envoyez le transfert** Le bouton rappelle la somme, par exemple « Envoyer 150 000 FCFA ». Choisissez-le, puis saisissez le code de sécurité. **Transferts** s'ouvre sur « Transfert lancé. ». Si le transfert est retenu pour vérification, sa page s'ouvre à la place : [Suivre un transfert retenu](https://docs.wajub.com/dashboard/transfers/under-review) explique la suite. ## Quand l'envoi est refusé Le formulaire affiche la raison sous le montant et rien ne part. Les réglages de [sécurité des transferts](https://docs.wajub.com/dashboard/transfers/settings#security-settings) refusent l'envoi quand **Transferts autorisés depuis** est sur **API uniquement** ou que **Arrêter tous les transferts** est activé, quand la double authentification est exigée et n'a pas été confirmée récemment, quand les transferts sont réservés aux adresses IP de la liste alors que la liste est vide, ou quand le nombre ou le montant maximum du jour est atteint. Le montant doit aussi rester dans les limites des [paramètres généraux](https://docs.wajub.com/dashboard/transfers/settings#general-settings). Wajub refuse aussi un transfert vers un compte non vérifié, et tout transfert tant que votre solde est négatif ou qu'une restriction bloque les transferts de votre organisation. > [!NOTE] > **Un transfert ne s'annule pas** > > Une fois envoyé, il part tel quel. Seule exception : un transfert dont la page affiche **En > attente du moyen de paiement**, que vous pouvez > [annuler tant qu'il attend](https://docs.wajub.com/dashboard/transfers/track#cancel-a-waiting-transfer). Si la page > semble ne pas répondre, n'en ouvrez pas une autre : renvoyé depuis le même formulaire, le > transfert n'est pas payé deux fois, et le formulaire affiche **Un transfert a déjà été envoyé > depuis ce formulaire**. --- # Régler les transferts URL: https://docs.wajub.com/fr/dashboard/transfers/settings > Les paramètres généraux des transferts, de la devise aux limites et aux e-mails, et les paramètres de sécurité qui décident d'où un transfert peut partir. **Paramètres › Transferts** réunit, dans les onglets **Général** et **Sécurité**, les règles que suivent tous vos transferts. Les deux autres onglets ont leur page : [Comptes de versement](https://docs.wajub.com/dashboard/transfers/payout-accounts) et [Transferts récurrents](https://docs.wajub.com/dashboard/transfers/recurring). Le propriétaire, un Administrateur ou un rôle personnalisé qui a **Gérer les paramètres** modifie ces réglages, avec tous les forfaits. Un membre Finance n'ouvre pas cette page. Elle n'existe qu'en Production. Enregistrer l'onglet **Sécurité** demande le code de sécurité, l'onglet **Général** non. ## Paramètres généraux  *L'onglet Général s'enregistre sans code de sécurité.* Sous **Limites de transfert**, **Montant minimum de transfert**, laissé vide, reprend le minimum de Wajub ; **Montant maximum de transfert**, laissé vide, ne fixe pas de plafond. Ces limites valent pour les transferts du tableau de bord, ponctuels et récurrents. Ceux de l'API ne sont comparés qu'au minimum de Wajub. Sous **Vérification par Wajub**, **Retenir chaque transfert pour vérification** fait attendre chaque transfert la décision de l'équipe Wajub avant son envoi. **Pas de vérification sous ce montant**, facultatif, en dispense les petits montants, qui peuvent rester retenus pour une autre raison : [Suivre un transfert retenu](https://docs.wajub.com/dashboard/transfers/under-review). **Devise par défaut** est la devise sur laquelle s'ouvrent les formulaires de transfert, de transfert récurrent et de compte de versement bancaire. Les transferts envoyés par l'API indiquent leur propre devise. **Transferts qui ne peuvent pas partir** vaut pour chaque transfert de Production, du tableau de bord ou de l'API, sauf les [versements automatiques](https://docs.wajub.com/dashboard/transfers/payout-accounts#automatic-payouts) vers votre propre compte : - **Annuler les transferts non envoyés après (heures)**, de 1 à 168, 24 par défaut : un transfert qu'aucun opérateur n'a reçu au bout de ce délai, parce qu'il attend encore votre confirmation ou sa place dans la file, est annulé et son montant revient au solde. - **Réessayer une fois un transfert refusé pour une raison passagère**, désactivé par défaut : quand tous les opérateurs refusent un transfert pour une raison de leur côté qui passe, indisponibilité ou fonds épuisés par exemple, il repart une fois 10 minutes plus tard. Un compte invalide, une limite ou votre solde ne sont jamais réessayés. Sous **E-mails**, **Envoyer les e-mails de transfert**, activé par défaut, prévient quand un transfert du tableau de bord part, et quand un transfert de Production échoue ou est annulé après le délai ci-dessus. L'e-mail va au propriétaire, aux Administrateurs et aux membres Finance, sauf à ceux qui ont coupé ces e-mails dans leurs préférences. Les e-mails de sécurité partent toujours. **Enregistrer les modifications** applique l'onglet. ## Paramètres de sécurité Sous **Qui peut envoyer des transferts**, **Transferts autorisés depuis** propose trois choix : | Choix | Effet | | ------------------------------ | ---------------------------------------------------------------------------------------------------------- | | **API et tableau de bord** | Votre intégration et le tableau de bord envoient des transferts. | | **API uniquement** | Le tableau de bord refuse tout envoi, ponctuel ou récurrent. | | **Tableau de bord uniquement** | Wajub refuse les transferts de Production créés par l'API, avec l'erreur transfers\_disabled\_for\_source. | **Arrêter tous les transferts** refuse chaque transfert de Production, du tableau de bord comme de l'API, ponctuel ou récurrent, jusqu'à ce que vous le désactiviez. Les [versements automatiques](https://docs.wajub.com/dashboard/transfers/payout-accounts#automatic-payouts) vers votre propre compte, si vous les avez activés, continuent. Le tableau de bord demande une confirmation avant d'enregistrer. Les autres réglages ajoutent des contrôles : - **Exiger l'authentification à deux facteurs pour les transferts** : un transfert du tableau de bord demande une double authentification récente. - **Vérifier les transferts à partir de ce montant** : à partir de ce montant, le transfert attend la vérification de Wajub. - **Nombre maximum de transferts par jour** et **Montant maximum par jour** : au-delà, Wajub refuse le transfert, qu'il vienne du tableau de bord, d'un calendrier ou de l'API. Le montant se saisit en XAF, et les autres devises sont converties au taux du moment. - **N'autoriser les transferts que depuis les adresses IP de la liste** : un transfert du tableau de bord doit venir d'une adresse de la liste de l'organisation, et il est refusé tant que la liste est vide. **Modifier la liste d'adresses IP autorisées** ouvre [Limiter les adresses IP](https://docs.wajub.com/dashboard/settings/security#restrict-ip-addresses). Sous **Détection de menaces**, **La détection d'anomalies est toujours active** rappelle que Wajub retient un premier transfert, ou un montant très au-dessus de l'habitude, sur tous les comptes. > [!NOTE] > **Un réglage sans effet** > > **Exiger la vérification du bénéficiaire** ne change rien : Wajub refuse déjà tout transfert vers > un compte non vérifié, que la case soit cochée ou non. --- # Suivre ses transferts URL: https://docs.wajub.com/fr/dashboard/transfers/track > Lire la liste des transferts, ses chiffres et ses filtres, ce que montre la page d'un transfert, y laisser des notes, annuler un transfert en attente et exporter les transferts. **Transferts** liste chaque transfert parti de votre solde : depuis le tableau de bord, par un calendrier de transferts récurrents ou par votre intégration. Le propriétaire, un Administrateur, un membre Finance, un Analyste, un Observateur ou un rôle personnalisé qui a **Voir les transferts** ouvre la liste et les transferts, en Test comme en Production. Exporter, écrire une note et annuler un transfert en attente demandent **Gérer les transferts** et la Production. L'annulation ne demande pas le code de sécurité. ## La liste En haut, quatre chiffres : le **Solde disponible**, les transferts **En cours**, avec le nombre retenus pour vérification quand il y en a, le montant **Terminé** et le nombre de transferts **Échoué**, échoués ou annulés. Les trois derniers comparent les 15 derniers jours aux 15 précédents, et un clic sur l'un d'eux filtre la liste.  *Un clic sur En cours, Terminé ou Échoué filtre la liste.* Les filtres portent sur la **Date du transfert**, le **Statut**, le **Montant**, la **Devise**, le **Fournisseur** et la **Source** : API, **Tableau de bord**, **Récurrent**, Webhook ou **Tiers**. Le menu au bout d'une ligne propose **Ouvrir le transfert**, **Copier l'ID du transfert** et **Voir le bénéficiaire**. | Statut | Ce qu'il veut dire | | ----------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- | | **En attente** | Créé, pas encore remis à l'opérateur ou à la banque. | | **En cours d'examen** | Retenu pour vérification par Wajub : [Suivre un transfert retenu](https://docs.wajub.com/dashboard/transfers/under-review). | | **En traitement** | Remis à l'opérateur ou à la banque, qui ne l'a pas encore confirmé, ou [en attente de son moyen de paiement](#cancel-a-waiting-transfer). | | **Réussi** | L'opérateur ou la banque a confirmé l'envoi. | | **Échoué**, **Annulée** | Rien n'est parti, et le montant revient au solde disponible. | ## La page d'un transfert L'en-tête donne le montant, le statut, l'**ID du transfert** à copier pour le support, puis le bénéficiaire, son **Moyen de paiement** et la source, sous **Envoyé depuis**. Un transfert échoué affiche **Transfert échoué** avec sa raison. Pour un virement bancaire, l'encadré **Virement bancaire** donne la date limite d'envoi par Wajub, puis, une fois le virement parti, sa date et la référence bancaire. Suivent les **Détails du transfert**, la **Répartition du montant**, où les frais s'ajoutent au montant reçu, et l'**Historique**, qui suit chaque étape et chaque tentative auprès d'un opérateur. En Production, le champ **Note interne** de l'historique laisse une consigne à l'équipe, avec **Ajouter une note** : seuls vos membres voient les notes. Le menu d'une note propose **Épingler la note**, qui la garde sous **Notes épinglées**, et **Supprimer la note**. ## Annuler un transfert en attente Quand son moyen de paiement est temporairement indisponible, un transfert reste **En traitement** et sa page affiche **En attente du moyen de paiement**, comme son **Historique**. Il part de lui-même dès le retour du moyen de paiement, et son montant reste réservé d'ici là. En Production, pour l'arrêter entre-temps, cliquez sur **Annuler le transfert** dans cet encadré. **Annuler ce transfert ?** demande confirmation : **Annuler le transfert** l'annule, **Continuer d'attendre** le laisse tel quel. Le transfert passe **Annulée**, le bénéficiaire ne reçoit rien, et son montant est de nouveau disponible sur votre solde. S'il est parti entre-temps, l'annulation est refusée et le transfert suit son cours. ## Exporter les transferts En Production, **Exporter**, en haut de la liste, ouvre **Exporter les transferts** : le fichier reprend les transferts que la liste affiche avec ses filtres. Pour n'en exporter que certains, cochez-les, jusqu'à 100, puis **Exporter** dans la barre du bas, qui ouvre **Exporter les transferts sélectionnés**. La même barre propose **Copier les identifiants**. Chaque export compte dans la limite mensuelle du forfait **Pay as you go**. --- # Suivre un transfert retenu URL: https://docs.wajub.com/fr/dashboard/transfers/under-review > Pourquoi Wajub retient un transfert pour vérification, ce que vous voyez pendant ce temps, ce qui se passe quand il est accepté ou rejeté, et comment confirmer un ancien transfert en attente. Avant de partir, un transfert peut être retenu pour une vérification par l'équipe Wajub. Il reste alors **En cours d'examen** jusqu'à sa décision, que le tableau de bord ne permet pas de prendre : c'est ce qui vous protège si votre propre compte est compromis. Tous ceux qui voient les transferts suivent un transfert retenu. Confirmer ou rejeter un ancien transfert **En attente de confirmation** demande **Gérer les transferts** et la Production, et seule la confirmation demande le code de sécurité. ## Pourquoi un transfert est retenu Wajub retient un transfert en Production, qu'il vienne du tableau de bord, d'un calendrier ou de votre intégration. Un premier transfert, ou un transfert bien au-dessus de vos montants habituels, est retenu pour vérification par Wajub, sur tous les comptes. Un transfert est aussi retenu dans ces cas : - une restriction posée par Wajub sur votre organisation, qui soumet ses transferts à vérification ; - **Retenir chaque transfert pour vérification** activé dans vos [paramètres généraux](https://docs.wajub.com/dashboard/transfers/settings#general-settings), sauf sous le montant choisi dans **Pas de vérification sous ce montant** ; - un montant égal ou supérieur à **Vérifier les transferts à partir de ce montant**, dans vos [paramètres de sécurité](https://docs.wajub.com/dashboard/transfers/settings#security-settings). ## Pendant la vérification Juste après l'envoi, la page du transfert s'ouvre sur « Ce transfert a été signalé et attend une vérification avant de pouvoir partir. ». Dans **Transferts**, le chiffre **En cours** indique combien de transferts sont retenus, par exemple « 2 en révision manuelle », et le filtre **Statut** les retrouve. Son montant reste réservé sur votre solde. Un transfert en cours d'examen n'est jamais annulé par le délai de [Transferts qui ne peuvent pas partir](https://docs.wajub.com/dashboard/transfers/settings#general-settings) : ce délai ne compte qu'à partir de son acceptation. ## La décision de Wajub Accepté, le transfert part vers l'opérateur ou la banque et passe **En traitement**, puis **Réussi**. Rejeté, il passe **Échoué**, et son montant revient au solde disponible. ## Confirmer un ancien transfert Quand la page d'un transfert affiche l'encadré **En attente de confirmation**, le transfert reste **En attente** jusqu'à ce que vous le confirmiez ou le rejetiez. **Confirmer le transfert** ouvre une fenêtre titrée avec le montant et le bénéficiaire, par exemple « Envoyer 150 000 FCFA à Kribi Coffee SARL ? », puis demande le code de sécurité. Le transfert passe alors les mêmes contrôles qu'un nouveau : il part, il est retenu à son tour pour vérification, ou il est refusé et continue d'attendre. **Rejeter le transfert** demande un **Motif du rejet**, sans code : le transfert passe **Annulée** et son montant revient au solde disponible. Sans réponse, il est annulé au bout du délai de **Transferts qui ne peuvent pas partir**. --- # Automatiser ses transferts URL: https://docs.wajub.com/fr/dashboard/use-cases/automatic-payouts > Recevoir votre argent sans y penser, en liant votre compte de versement puis en programmant un transfert du même montant chaque jour, chaque semaine ou chaque mois. Un transfert récurrent envoie le même montant de votre solde vers votre compte à date fixe : vous n'avez plus à penser à vous payer. Chaque étape renvoie à la page qui la détaille. Le propriétaire, un Administrateur ou un [rôle](https://docs.wajub.com/fr/dashboard#roles) personnalisé qui a **Voir les paramètres** et **Gérer les paramètres** fait tout ce parcours ; un membre Finance envoie des transferts à la main, mais ne crée ni compte de versement ni calendrier. Les transferts récurrents demandent le forfait **Growth** ou un forfait au-dessus. Tout se fait en [Production](https://docs.wajub.com/fr/dashboard#sandbox-and-live), et ajouter ou faire vérifier le compte comme créer le calendrier demandent le [code de sécurité](https://docs.wajub.com/fr/dashboard#the-security-code). ## Les étapes 1. **Ajoutez votre compte de versement** Liez le numéro Mobile Money ou le compte bancaire qui recevra l'argent : [Lier un compte de versement](https://docs.wajub.com/dashboard/transfers/payout-accounts#the-steps). 2. **Faites vérifier le compte** Un transfert, récurrent ou non, ne part que vers un compte **Vérifié** : [Faire vérifier le compte](https://docs.wajub.com/dashboard/transfers/payout-accounts#verify-the-account). 3. **Choisissez un montant que votre solde couvre** Chaque envoi transfère le même montant, quelles que soient vos ventes : choisissez-le pour que votre solde disponible le couvre à chaque date, sinon l'envoi échoue. Voir [Quand une exécution échoue](https://docs.wajub.com/dashboard/transfers/recurring#when-a-run-fails). 4. **Programmez le transfert** Créez le calendrier avec ce compte, ce montant et la fréquence de votre choix : [Programmer des transferts](https://docs.wajub.com/dashboard/transfers/recurring#the-steps). 5. **Surveillez les envois** La liste des calendriers donne la prochaine exécution et le statut de la dernière ; un calendrier qui échoue plusieurs fois de suite se met en pause : [Suivre et modifier un calendrier](https://docs.wajub.com/dashboard/transfers/recurring#manage-a-schedule). --- # Facturer un client URL: https://docs.wajub.com/fr/dashboard/use-cases/bill-a-customer > Facturer un client en une fois, en plusieurs échéances ou chaque mois, laisser partir les rappels par e-mail et noter un paiement reçu en espèces ou par virement. Une facture s'adresse à un client précis, qui la reçoit par e-mail avec un lien pour la payer en ligne. Chaque étape renvoie à la page qui la détaille. Le propriétaire, un Administrateur, un membre Finance ou un [rôle](https://docs.wajub.com/fr/dashboard#roles) personnalisé qui a **Gérer les factures** fait tout ce parcours, en [Production](https://docs.wajub.com/fr/dashboard#sandbox-and-live). Un membre Finance ouvre **Clients** mais saisit le client sur la facture : y ajouter un client demande **Gérer les clients**. Seuls le propriétaire et les Administrateurs rendent une facture récurrente, à partir du forfait **Growth** ; le forfait **Pay as you go** permet 10 factures en tout. Aucun [code de sécurité](https://docs.wajub.com/fr/dashboard#the-security-code) n'est demandé. ## Les étapes 1. **Ajoutez le client** Ajoutez-le dans **Clients** : [Ajouter un client](https://docs.wajub.com/dashboard/customers/add). Vous pouvez aussi le saisir directement sur la facture. 2. **Créez la facture** Ouvrez **Factures › Créer une facture**, puis choisissez le client et ajoutez les lignes : [Créer et envoyer une facture](https://docs.wajub.com/dashboard/invoices/create#the-steps). 3. **Choisissez le rythme de paiement** Sous **Comment le client paie**, gardez **En un seul paiement**, ou choisissez **En plusieurs échéances** pour [répartir le total](https://docs.wajub.com/dashboard/invoices/installments). Pour facturer chaque mois, rendez la facture [récurrente](https://docs.wajub.com/dashboard/invoices/recurring) : chaque copie attend en brouillon que vous l'envoyiez. 4. **Envoyez la facture** Créez et envoyez la facture : le client reçoit le PDF et un bouton pour payer. [Ce que reçoit le client](https://docs.wajub.com/dashboard/invoices/create#what-the-customer-receives). 5. **Suivez la facture** La page de la facture dit ce qui est payé et ce qui reste dû. Avec une date d'échéance, le client est relancé par e-mail sans que vous ayez rien à faire : [Suivre et relancer une facture](https://docs.wajub.com/dashboard/invoices/track-and-remind). 6. **Notez un paiement reçu hors de Wajub** Si le client paie en espèces ou par virement, enregistrez-le sur la facture : [Enregistrer un paiement reçu](https://docs.wajub.com/dashboard/invoices/record-payment). --- # Vendre un produit numérique URL: https://docs.wajub.com/fr/dashboard/use-cases/digital-products > Vendre une formation, un e-book ou un fichier avec un lien de paiement, et laisser Wajub envoyer l'accès au client après chaque paiement. Un lien **Vendre quelque chose** de type **Contenu numérique** encaisse le paiement, puis envoie lui-même au client l'accès à votre formation, votre e-book ou votre fichier. Chaque étape renvoie à la page qui la détaille. Comme tout lien de paiement, il demande **Gérer les liens de paiement** ([rôles](https://docs.wajub.com/fr/dashboard#roles)) et la [Production](https://docs.wajub.com/fr/dashboard#sandbox-and-live), sans [code de sécurité](https://docs.wajub.com/fr/dashboard#the-security-code). Un lien de téléchargement vers votre propre adresse marche avec tous les forfaits ; un fichier hébergé par Wajub demande le forfait **Growth** ou un forfait au-dessus. ## Les étapes 1. **Choisissez Contenu numérique** Créez un lien **Vendre quelque chose** de type **Contenu numérique**, ou partez du modèle **Formation en ligne ou e-book** : [Vendre quelque chose](https://docs.wajub.com/dashboard/payment-links/sell-something#the-steps). 2. **Choisissez comment le client reçoit le contenu** Sous **Comment le client le reçoit**, choisissez **Un lien de téléchargement** ou **Un fichier hébergé par Wajub**, et réglez la durée de l'accès : [Un contenu numérique](https://docs.wajub.com/dashboard/payment-links/sell-something#digital-content). 3. **Partagez le lien** Envoyez l'adresse à vos abonnés ou mettez un bouton sur votre site : [Partager un lien](https://docs.wajub.com/dashboard/payment-links/share). 4. **Suivez les ventes** L'onglet **Paiements** du lien liste chaque vente, et l'onglet **Clients** chaque acheteur : [Suivre un lien](https://docs.wajub.com/dashboard/payment-links/track#payments). --- # Collecter pour une cause URL: https://docs.wajub.com/fr/dashboard/use-cases/fundraising > Recevoir des dons ou financer un projet pour une association, une église ou une cause avec un lien de paiement, montrer les donateurs et raconter à quoi sert l'argent. Un lien de dons ou de collecte laisse chacun donner le montant qu'il choisit, et sa page peut montrer qui a déjà donné. Chaque étape renvoie à la page qui la détaille. Créer le lien, publier une actualité et exporter les donateurs demandent **Gérer les liens de paiement** ; toute personne qui voit les liens de paiement suit la collecte ([rôles](https://docs.wajub.com/fr/dashboard#roles)). Le forfait **Pay as you go** permet 25 liens. Tout se fait en [Production](https://docs.wajub.com/fr/dashboard#sandbox-and-live), sans [code de sécurité](https://docs.wajub.com/fr/dashboard#the-security-code). ## Les étapes 1. **Choisissez le type de lien** **Recevoir des dons** accepte des dons sans objectif, comme une offrande ou le soutien à une association ; **Collecter des fonds** vise un montant, avec une barre de progression et une date de fin si vous le voulez. Voir [Les quatre types de lien](https://docs.wajub.com/dashboard/payment-links/create#the-four-types). 2. **Créez le lien** Suivez [Recevoir des dons](https://docs.wajub.com/dashboard/payment-links/donations#the-steps) ou [Collecter des fonds](https://docs.wajub.com/dashboard/payment-links/raise-funds#the-steps). 3. **Montrez les donateurs** À la création, choisissez sous **Ce que montre la page** si les derniers donateurs et le total apparaissent. Sur un lien de dons, chacun peut aussi donner sans montrer son nom : [Les dons anonymes](https://docs.wajub.com/dashboard/payment-links/donations#anonymous-gifts). 4. **Partagez le lien** Envoyez l'adresse dans vos groupes ou imprimez le code QR pour le lieu de culte ou l'événement : [Partager un lien](https://docs.wajub.com/dashboard/payment-links/share#the-steps). 5. **Publiez des actualités** Racontez sur la page à quoi sert l'argent reçu : [Après la publication](https://docs.wajub.com/dashboard/payment-links/raise-funds#after-publishing). 6. **Suivez la collecte** La page du lien donne le montant réuni et le nombre de donateurs : [Suivre un lien](https://docs.wajub.com/dashboard/payment-links/track#what-the-link-gathered). 7. **Remerciez les donateurs** Exportez l'onglet **Donateurs** pour avoir le nom et l'e-mail de chacun, même ceux qui ont donné anonymement : [Les clients et l'export](https://docs.wajub.com/dashboard/payment-links/track#people-and-export). --- # Préparer sa comptabilité URL: https://docs.wajub.com/fr/dashboard/use-cases/monthly-accounting > Exporter chaque mois les paiements, les remboursements, les transferts et les factures, le rapport des revenus et les factures Wajub à remettre à votre comptable. Une fois par mois, réunissez en quelques fichiers ce que votre comptable demande : ce que vous avez encaissé, remboursé, transféré et facturé, et ce que Wajub vous a facturé. Chaque étape renvoie à la page qui la détaille. Les exports n'existent qu'en [Production](https://docs.wajub.com/fr/dashboard#sandbox-and-live). Le propriétaire, un Administrateur ou un membre Finance fait tous ceux de cette page ; un Analyste n'y fait que celui des revenus ([rôles](https://docs.wajub.com/fr/dashboard#roles)). Les factures Wajub demandent **Gérer le compte** : le propriétaire, un Administrateur ou un rôle personnalisé qui l'a. Avec le forfait **Pay as you go**, chaque export compte dans la limite de 10 par mois, tous exports du tableau de bord confondus, et ce parcours en utilise jusqu'à cinq. Aucun [code de sécurité](https://docs.wajub.com/fr/dashboard#the-security-code) n'est demandé. ## Les étapes 1. **Exportez les paiements du mois** Exportez la liste **Paiements** avec pour période le premier et le dernier jour du mois : [Exporter des paiements](https://docs.wajub.com/dashboard/payments/find#export). 2. **Exportez les remboursements** Faites de même dans l'onglet **Remboursements** : [Exporter les remboursements](https://docs.wajub.com/dashboard/payments/track-refunds#export). 3. **Exportez les transferts** Filtrez **Transferts** sur la **Date du transfert** du mois, puis exportez : [Exporter les transferts](https://docs.wajub.com/dashboard/transfers/track#export-transfers). 4. **Exportez vos factures** Si vous facturez vos clients, exportez les factures du mois : [Exporter les factures](https://docs.wajub.com/dashboard/invoices/export-and-bulk#export-invoices). 5. **Exportez le rapport des revenus** Dans **Revenus**, réglez la **Période** sur le mois, puis exportez **Vue d'ensemble** en Excel ou en PDF : [Suivre ses revenus](https://docs.wajub.com/dashboard/home/revenue#export-a-report). 6. **Téléchargez vos factures Wajub** Récupérez les factures de votre forfait et de votre usage : [Télécharger une facture](https://docs.wajub.com/dashboard/subscription/wajub-invoices#download-an-invoice). --- # Organiser un événement URL: https://docs.wajub.com/fr/dashboard/use-cases/paid-event > Vendre les places d'un concert, d'une formation ou d'un gala avec un lien de paiement, suivre les ventes et contrôler les entrées avec la liste des participants. Un lien **Vendre des billets** vend vos places en ligne et garde la liste des participants pour le jour de l'événement. Chaque étape renvoie à la page qui la détaille. Créer, exporter et archiver le lien demandent **Gérer les liens de paiement** ; toute personne qui voit les liens de paiement suit les ventes ([rôles](https://docs.wajub.com/fr/dashboard#roles)). Le forfait **Pay as you go** permet 25 liens. Tout se fait en [Production](https://docs.wajub.com/fr/dashboard#sandbox-and-live), sans [code de sécurité](https://docs.wajub.com/fr/dashboard#the-security-code). ## Les étapes 1. **Créez le lien de billetterie** Créez un lien **Vendre des billets** avec vos types de places : [Vendre des billets](https://docs.wajub.com/dashboard/payment-links/sell-tickets#the-steps). 2. **Demandez le nom des participants** Pour contrôler les entrées par nom, demandez au moins le nom de chaque participant à la création du lien, à l'étape « Demandez les informations des participants » de [Vendre des billets](https://docs.wajub.com/dashboard/payment-links/sell-tickets#the-steps). 3. **Partagez le lien** Envoyez l'adresse par WhatsApp ou SMS, ou imprimez le code QR du lien sur vos affiches : [Partager un lien](https://docs.wajub.com/dashboard/payment-links/share#the-steps). 4. **Suivez les ventes** La page du lien compte les billets vendus et ceux qui restent : [Suivre un lien](https://docs.wajub.com/dashboard/payment-links/track#what-the-link-gathered). 5. **Exportez la liste des participants** La veille, exportez l'onglet **Participants** pour avoir la liste à l'entrée : [Le jour de l'événement](https://docs.wajub.com/dashboard/payment-links/sell-tickets#on-the-day). Wajub n'envoie pas de message groupé aux acheteurs ; pour leur écrire, servez-vous des e-mails de cet export. 6. **Contrôlez les entrées avec la liste** Wajub ne scanne pas les billets : à l'entrée, retrouvez chaque acheteur dans la liste. Un achat de plusieurs places reçoit un seul code QR, alors vérifiez dans la liste combien de places il couvre. Voir [Le jour de l'événement](https://docs.wajub.com/dashboard/payment-links/sell-tickets#on-the-day). 7. **Archivez le lien** Après l'événement, [archivez le lien](https://docs.wajub.com/dashboard/payment-links/edit-offline-delete#offline-or-archive) pour le retirer de la liste des liens. --- # Vendre sur les réseaux URL: https://docs.wajub.com/fr/dashboard/use-cases/social-selling > Vendre un article, un fichier ou un service dans une conversation WhatsApp ou une publication Facebook ou Instagram avec un lien de paiement, puis livrer et récupérer l'argent. Un lien de paiement donne à ce que vous vendez une page où payer : vous collez son adresse dans une conversation, une publication ou votre bio, et le client paie depuis son téléphone. Chaque étape renvoie à la page qui la détaille. Créer le lien et exporter ses clients demandent **Gérer les liens de paiement**, et le forfait **Pay as you go** permet 25 liens. Pour récupérer l'argent, un membre Finance envoie le transfert, mais seuls le propriétaire, un Administrateur ou un [rôle](https://docs.wajub.com/fr/dashboard#roles) personnalisé qui a **Voir les paramètres** et **Gérer les paramètres** ajoutent le compte de versement. Tout se fait en [Production](https://docs.wajub.com/fr/dashboard#sandbox-and-live), et le compte comme le transfert demandent le [code de sécurité](https://docs.wajub.com/fr/dashboard#the-security-code). ## Les étapes 1. **Créez le lien** Créez un lien **Vendre quelque chose**, en **Article physique**, **Contenu numérique** ou **Service** selon ce que vous vendez : [Vendre quelque chose](https://docs.wajub.com/dashboard/payment-links/sell-something). 2. **Partagez l'adresse** Envoyez l'adresse dans la conversation ou la publication depuis la fenêtre de partage : [Partager un lien](https://docs.wajub.com/dashboard/payment-links/share#the-steps). Instagram n'y figure pas : copiez l'adresse et collez-la dans votre bio, une story ou un message. 3. **Vérifiez le paiement avant de livrer** Livrez quand le paiement apparaît **Réussi** dans l'onglet **Paiements** du lien, jamais sur la foi d'une capture d'écran envoyée par le client : [Suivre un lien](https://docs.wajub.com/dashboard/payment-links/track#payments). 4. **Exportez les commandes** Pour un article livré, exportez l'onglet **Clients** du lien : le fichier donne l'adresse de livraison de chaque acheteur. Voir [Les clients et l'export](https://docs.wajub.com/dashboard/payment-links/track#people-and-export). 5. **Ajoutez un compte de versement** Liez le numéro Mobile Money ou le compte bancaire qui recevra l'argent : [Lier un compte de versement](https://docs.wajub.com/dashboard/transfers/payout-accounts). 6. **Envoyez-vous l'argent** Transférez votre solde vers ce compte : [Envoyer un transfert](https://docs.wajub.com/dashboard/transfers/send). Pour ne plus le faire à la main, [automatisez vos transferts](https://docs.wajub.com/dashboard/use-cases/automatic-payouts). --- # Travailler avec son équipe URL: https://docs.wajub.com/fr/dashboard/use-cases/team-and-accountant > Inviter vos collaborateurs et votre comptable avec le rôle qui correspond à leur travail, et savoir ce que chacun peut voir et exporter. Chaque personne qui travaille avec vous entre dans l'organisation par une invitation, avec un rôle qui fixe ce qu'elle voit et ce qu'elle peut faire. Chaque étape renvoie à la page qui la détaille. Le propriétaire, un Administrateur ou un [rôle](https://docs.wajub.com/fr/dashboard#roles) personnalisé qui a **Gérer les membres** et **Voir les paramètres** invite et gère les membres, en [Test comme en Production](https://docs.wajub.com/fr/dashboard#sandbox-and-live). Le forfait limite le nombre de membres : voir [Inviter et gérer les membres](https://docs.wajub.com/dashboard/settings/members). Inviter, changer un rôle et retirer un membre demandent le [code de sécurité](https://docs.wajub.com/fr/dashboard#the-security-code). ## Les étapes 1. **Choisissez le rôle de chacun** **Finance** convient à qui encaisse, facture et envoie les transferts, **Spécialiste support** à qui répond aux clients et rembourse, **Analyste** à qui lit les chiffres sans rien modifier : [Rôles](https://docs.wajub.com/fr/dashboard#roles). 2. **Créez un rôle sur mesure si besoin** Si aucun des sept rôles ne convient, réunissez les permissions voulues dans un rôle personnalisé : [Créer un rôle personnalisé](https://docs.wajub.com/dashboard/settings/roles). 3. **Invitez la personne** Envoyez l'invitation avec le rôle choisi : [Inviter et gérer les membres](https://docs.wajub.com/dashboard/settings/members#the-steps). 4. **Suivez l'invitation** Tant que la personne n'a pas accepté, l'invitation reste en attente : [Les invitations en attente](https://docs.wajub.com/dashboard/settings/members#pending-invitations). 5. **Changez un rôle quand le travail change** Changez le rôle d'un membre ou retirez-le de l'organisation : [Changer un rôle ou retirer un membre](https://docs.wajub.com/dashboard/settings/members#change-a-role-or-remove-a-member). ## Le rôle de votre comptable Un **Analyste** lit les paiements, les transferts, les factures et les revenus, et exporte le rapport des [Revenus](https://docs.wajub.com/dashboard/home/revenue#export-a-report). Il n'exporte ni les paiements, ni les remboursements, ni les transferts, ni les factures : ces exports demandent **Gérer les paiements**, **Gérer les transferts** et **Gérer les factures**. Un membre **Finance** a les trois, mais **Gérer les transferts** lui permet aussi d'envoyer de l'argent. Pour un comptable qui ne doit rien envoyer, faites les exports vous-même : [Préparer sa comptabilité](https://docs.wajub.com/dashboard/use-cases/monthly-accounting). Les factures Wajub, celles de votre forfait, ne se téléchargent qu'avec **Gérer le compte**, qui permet aussi de [changer de forfait](https://docs.wajub.com/dashboard/subscription/plans) : ni Finance ni Analyste ne l'a, alors téléchargez-les vous-même. --- # Encaisser sur son site URL: https://docs.wajub.com/fr/dashboard/use-cases/website-button > Mettre un bouton de paiement sur votre site sans développeur, en copiant son code depuis un lien de paiement, puis lui donner votre marque et votre domaine. Un lien de paiement fournit le code d'un bouton à coller dans votre site, sur Systeme.io, WordPress, Wix, Webflow ou Shopify : le client paie sans que personne écrive de code. Chaque étape renvoie à la page qui la détaille. Créer le lien demande **Gérer les liens de paiement**, mais toute personne qui voit les liens de paiement copie le code du bouton, en [Production](https://docs.wajub.com/fr/dashboard#sandbox-and-live). Déclarer le site, régler la marque, connecter le domaine et le choisir pour vos liens (en Production) demandent **Gérer les paramètres**, qu'ont le propriétaire et les Administrateurs ; un Développeur peut aussi déclarer le site et connecter le domaine ([rôles](https://docs.wajub.com/fr/dashboard#roles)). La marque demande le forfait **Growth** ou un forfait au-dessus, le domaine **Scale** ou **Enterprise**. Seul l'enregistrement des sites déclarés demande le [code de sécurité](https://docs.wajub.com/fr/dashboard#the-security-code). ## Les étapes 1. **Créez le lien** Créez le lien de ce que vous vendez : [Créer un lien de paiement](https://docs.wajub.com/dashboard/payment-links/create). 2. **Préparez le bouton** Sur la page du lien, ouvrez **Partager le lien**, puis l'onglet **Bouton pour votre site**, et choisissez **Par-dessus votre site** ou **Sur la page de paiement** : [Le bouton pour votre site](https://docs.wajub.com/dashboard/payment-links/share#button-for-your-site). 3. **Collez le code dans votre site** Choisissez **Copier**, puis collez le code dans un bloc HTML de votre site et publiez la page. Voir [Le bouton pour votre site](https://docs.wajub.com/dashboard/payment-links/share#button-for-your-site). 4. **Déclarez votre site** Ajoutez l'adresse de votre site dans [Les sites qui affichent la page](https://docs.wajub.com/dashboard/settings/checkout-page#embedding) : la fenêtre **Par-dessus votre site** s'ouvre alors sur vos sites, et sur aucun autre. 5. **Mettez votre marque** Donnez votre logo et vos couleurs à la page de paiement : [Personnaliser votre marque](https://docs.wajub.com/dashboard/settings/branding). 6. **Connectez votre domaine** Servez la page de paiement sur une adresse à vous, comme pay.example.com : [Connecter votre domaine](https://docs.wajub.com/dashboard/settings/custom-domains). 7. **Choisissez ce domaine pour vos liens** Une fois le domaine vérifié, choisissez-le pour vos liens de paiement : [Choisir le domaine des liens](https://docs.wajub.com/dashboard/payment-links/settings). --- # API directe URL: https://docs.wajub.com/fr/payments/direct-api > Débitez un paiement depuis votre serveur, sur le canal choisi, sans page Wajub. Avec l'API directe, c'est vous qui affichez chaque écran : votre serveur débite le paiement sur le canal choisi, et Wajub vous communique le résultat. Il faut deux appels, `POST /payments` pour enregistrer le paiement et `POST /payments/{id}` pour le débiter. > [!CAUTION] > **Cet appel a sa place sur votre serveur** > > Envoyez-le avec votre clé privée, depuis votre backend. N'utilisez jamais une clé `sk.…` depuis un > navigateur : Wajub la refuse avec un `403`. Si votre écran de paiement vit dans un > navigateur, utilisez plutôt les [Composants intégrés](https://docs.wajub.com/fr/libraries/components). ## 1. Créez le paiement Créez le paiement comme le montre le [guide de démarrage des paiements](https://docs.wajub.com/fr/payments/quickstart#1-create-the-payment). Conservez `transaction.id` dans la réponse. Vous n'utiliserez pas `authorization_url`, qui sert à la page hébergée. Conservez aussi `authorization_token` si vous débitez un canal dont le prestataire demande un code au payeur : c'est l'identifiant qui [confirme cette étape](#a-code-or-another-detail), et il n'est renvoyé qu'à la création. Le paiement est `pending`, et personne n'a encore été débité. ## 2. Débitez-le `POST /payments/{id}` - `channel` (string, required): Où débiter : un identifiant de canal renvoyé par `GET /channels`, comme `cm.mtn` ou `cm.orange`. Envoyez `mobile`, ou `cm.mobile` pour le Cameroun, pour laisser Wajub trouver l'opérateur à partir du numéro. Ce sont les deux seuls agrégats. - `data.phone` (string): Le numéro Mobile Money à débiter. Le format international est le plus sûr ; un numéro local est lu dans le pays du canal. - `data.operator` (string): Avec `cm.mobile` uniquement : l'opérateur choisi par le payeur, par exemple `orange`. Utilisé quand le numéro seul ne permet pas à Wajub de savoir à quel opérateur il appartient, un numéro porté par exemple. - `data.otp` (string): Le code que le payeur a généré dans le menu de son opérateur, pour un canal qui a répondu `payer_otp` : des chiffres uniquement. Voir [Un code que le payeur génère](#a-code-the-payer-generates). - `data.iban` (string): Pour un canal bancaire. `data.account_number` est accepté à la place. - `data.wallet_address` (string): Pour un canal crypto. - `data.save_payment_method` (boolean): Enregistre ce moyen de paiement sur le client, pour le lui proposer la prochaine fois. Uniquement avec l'accord du payeur. Vaut `false` par défaut. Chaque champ de `data` est aussi accepté à la racine du corps. Envoyez un en-tête `Idempotency-Key` propre à ce débit, pour qu'une nouvelle tentative après un délai dépassé ne débite jamais deux fois. **Débiter un paiement sur MTN Mobile Money** ```bash curl https://api.wajub.com/payments/trx_test_CSUGajfv9xh0XQ5wu2lx \ -H "Authorization: sk_test.xxxxxxxxxxxxxxxx…" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: charge-order-4172-1" \ -d '{ "channel": "cm.mtn", "data": { "phone": "+237670000000" } }' ``` ```javascript const payment = await wajub.payments.process( 'trx_test_CSUGajfv9xh0XQ5wu2lx', { channel: 'cm.mtn', data: { phone: '+237670000000' }, }, { idempotencyKey: 'charge-order-4172-1' }, ); console.log(payment.status); ``` ```python from wajub import RequestOptions payment = wajub.payments.process( "trx_test_CSUGajfv9xh0XQ5wu2lx", { "channel": "cm.mtn", "data": {"phone": "+237670000000"}, }, RequestOptions(idempotency_key="charge-order-4172-1"), ) print(payment.status) ``` ```php use Wajub\RequestOptions; $payment = $wajub->payments->process('trx_test_CSUGajfv9xh0XQ5wu2lx', [ 'channel' => 'cm.mtn', 'data' => [ 'phone' => '+237670000000', ], ], new RequestOptions(idempotencyKey: 'charge-order-4172-1')); echo $payment->status; ``` ```go payment, err := client.Payments.Process(context.Background(), "trx_test_CSUGajfv9xh0XQ5wu2lx", map[string]any{ "channel": "cm.mtn", "data": map[string]any{"phone": "+237670000000"}, }, &wajub.RequestOptions{IdempotencyKey: "charge-order-4172-1"}) if err != nil { log.Fatal(err) } log.Println(payment.Status) ``` ## La réponse Pour le Mobile Money, la réponse est presque toujours `202 Accepted`. La demande est sur le téléphone du payeur, le paiement est passé en `processing`, et `message` est la phrase à afficher pendant l'attente : ```json title="Réponse · 202 Accepted" { "code": 202, "status": "Accepted", "message": "Confirm the transaction on your phone.", "transaction": { "id": "trx_test_CSUGajfv9xh0XQ5wu2lx", "reference": "order-4172", "amount": 5000, "currency": "XAF", "status": "processing", "channel": "cm.mtn", "sandbox": true } } ``` Le résultat arrive plus tard, sous la forme d'un webhook `payment.succeeded` ou `payment.failed`. Avant de livrer la commande, [récupérez le paiement](https://docs.wajub.com/fr/payments/quickstart#3-verify-before-you-fulfil) et lisez son `status`, comme dans tous les autres modes. | Code | Ce qu'il signifie | Que faire | | ----- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `200` | Le canal a confirmé tout de suite. Le paiement est `succeeded` | Vérifiez, puis livrez | | `202` | En attente du payeur, ou d'une étape suivante indiquée dans `action` | Affichez `message`, terminez l'étape indiquée dans `action` s'il y en a une, attendez le webhook | | `400` | Le paiement ne peut plus être débité : il a déjà réussi, expiré ou été annulé, ou, en live, son `expires_at` est passé | Créez un nouveau paiement si besoin | | `402` | L'opérateur ou l'émetteur de la carte a refusé. Le paiement repasse en `pending`. Aussi `error_code: merchant_not_verified` tant que la vérification de votre compte est en cours, et `otp_attempts_exceeded` une fois que l'opérateur a refusé trois codes du payeur sur le canal | Laissez le payeur réessayer, voir plus bas. Pour `merchant_not_verified`, terminez votre vérification | | `403` | Refusé par une restriction sur votre compte, ou par [Shield](https://docs.wajub.com/fr/risk/shield). Un blocage Shield porte `error_code: shield_blocked` et sa référence `BLK-…` dans `block_reference` | Ne relancez pas la même tentative | | `404` | Aucun paiement avec cet id, dans cet environnement | Vérifiez l'id et la clé | | `409` | Un débit est déjà en cours sur ce paiement (`error_code: payment_in_progress`), un appel avec la même `Idempotency-Key` est encore en cours, ou le paiement a été préparé et sa commande n'est pas encore validée | Attendez l'issue de la tentative en cours, par webhook ou en relisant le paiement. Débitez de nouveau une fois qu'il est revenu à `pending`, ou `processing` sans plus aucun débit en cours | | `422` | Le canal n'est pas accepté, le numéro ne correspond pas à l'opérateur, le montant dépasse le plafond du canal, ou l'`Idempotency-Key` a déjà servi pour une autre requête | Corrigez la requête. Une clé réutilisée demande une nouvelle clé pour un nouveau débit | Un `402` porte `error_code`, un motif stable comme `insufficient_funds` que vous pouvez traduire pour le payeur, et `limit_exceeded` quand le paiement dépasserait l'un des plafonds de votre compte. ## Quand `action` est renseigné La plupart des débits Mobile Money n'attendent rien de plus de votre part : `action` est absent et vous attendez le webhook. Quand le prestataire derrière le canal veut d'abord que le payeur fasse quelque chose, la réponse reste un `202`, `action` nomme cette étape, et la réponse porte ce dont l'étape a besoin. | `action` | Ce que fait le payeur | Ce que porte la réponse | | --------------------------------------------------------------------- | -------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- | | `redirect` | Il approuve le paiement sur la page du prestataire ou dans son application | `action_url`, l'adresse où envoyer le payeur | | `confirm_otp` | Il saisit le code que le prestataire lui a envoyé | `otp_id`, et `otp_masked_contact`, où le code est parti, masqué, ou vide quand le prestataire ne le dit pas | | `payer_otp` | Il génère un code dans le menu de son opérateur, puis vous le donne | `payer_otp`, comment obtenir le code. Débitez de nouveau avec lui dans `data.otp` | | `confirm_pin`, `confirm_phone`, `confirm_birthday`, `confirm_address` | Il donne une information de plus au prestataire | `pin_id` et `pin_instruction`, ou la même paire au nom de `phone`, `birthday` ou `address` | | `client_session` | Il paie dans une fenêtre que le prestataire gère lui-même | `client_session`, avec son `id` et, quand le prestataire a sa propre page, `hosted_url` | | `confirm` | Il suit la consigne donnée dans `message` | Rien de plus en live. En sandbox, un canal crypto ajoute `crypto.deposit` | | `confirm_3ds` | Il s'authentifie auprès de l'émetteur de la carte | Rien à gérer de votre côté : cette étape se passe dans la page de paiement ou les composants, une raison de plus d'y traiter les cartes | L'étape peut changer d'un paiement à l'autre sur un même canal : lisez donc `action` à chaque `202`, au lieu d'en supposer une par canal. ### Une redirection Wave fonctionne ainsi : le payeur approuve dans l'application Wave, pas sur une demande reçue sur son téléphone. Les canaux crypto aussi en live, où la page du prestataire affiche l'adresse et le montant à envoyer. ```json title="Réponse · 202 Accepted, avec une redirection" { "code": 202, "status": "Accepted", "message": "Open Wave to confirm your payment.", "action": "redirect", "transaction": { "id": "trx_CSUGajfv9xh0XQ5wu2lx", "amount": 5000, "currency": "XOF", "status": "processing", "channel": "ci.wave" }, "action_url": "https://pay.wave.com/c/cos-0example00" } ``` Envoyez le payeur vers `action_url` : une redirection dans un navigateur, un lien ou un bouton dans une application. Quand il a terminé, le prestataire le ramène vers le `callback` du paiement, si vous en avez défini un. Le résultat arrive toujours par webhook, et vous vérifiez toujours le paiement avant de livrer. ### Un code, ou une autre information Avec `confirm_otp`, le prestataire a envoyé un code au payeur. Recueillez-le sur votre propre écran, puis envoyez-le depuis votre serveur à [`POST /payments/{id}/confirm`](https://docs.wajub.com/fr/api/payments/confirm), avec votre clé secrète, l'`otp_id` de la réponse et le code. ```bash title="Confirmer le code reçu par le payeur" curl https://api.wajub.com/payments/trx_CSUGajfv9xh0XQ5wu2lx/confirm \ -H "Authorization: sk.xxxxxxxxxxxxxxxx…" \ -H "Idempotency-Key: confirm-order-1042" \ -H "Content-Type: application/json" \ -d '{ "otp_id": "prc_2b4l4EObTOnOa501JXNi", "code": "482913" }' ``` La réponse est celle du débit. `200` quand le paiement est payé. `202` quand le prestataire demande une étape de plus : `action` la nomme, avec ce qu'il lui faut, comme sur le débit. `402` quand le prestataire a refusé ce qui a été envoyé : `error_code` dit pourquoi (`invalid_otp`, ou `max_attempts_exceeded` une fois les trois essais de l'étape épuisés) et `attempts_remaining` compte les essais restants. Quand il n'en reste aucun, débitez le paiement à nouveau. Envoyez une `Idempotency-Key` : un appel rejoué répond alors ce qu'a répondu le premier, sans envoyer le code deux fois au prestataire. Les quatre autres étapes passent par le même appel, avec leurs propres champs. Chaque champ `…_instruction` de la réponse du débit est la formulation du prestataire lui-même pour ce qu'il demande. | `action` | Corps de `POST /payments/{id}/confirm` | | ------------------ | ---------------------------------------------------- | | `confirm_otp` | `otp_id`, `code` | | `confirm_pin` | `pin_id`, `pin` | | `confirm_phone` | `phone_id`, `phone` | | `confirm_birthday` | `birthday_id`, `birthday` au format `YYYY-MM-DD` | | `confirm_address` | `address_id`, `address`, `city`, `state`, `zip_code` | Chaque étape permet trois essais, qu'elle soit confirmée depuis votre intégration ou depuis la page de paiement. ### Un code que le payeur génère Quelques opérateurs, comme Orange Money au Burkina Faso, n'acceptent un paiement qu'avec un code que le payeur génère d'abord dans le menu de son opérateur. Sans lui, ou avec un code que l'opérateur refuse, rien n'est débité : la réponse est un `202` avec `action: payer_otp`, le paiement reste `pending`, et `payer_otp` indique comment obtenir le code : `ussd_code` à composer, `amount` et `currency`, le montant exact à saisir, `otp_length`, les étapes dans `steps.fr` et `steps.en`, `reason` (`required`, `invalid` ou `refused`) et `attempts_remaining`. `ussd_code` et `otp_length` peuvent valoir `null`, et chaque étape est un objet dont le `text` est ce qu'il faut afficher. Avec `invalid` ou `refused`, la réponse porte aussi `error_code: invalid_otp`. Affichez les étapes et `payer_message`, recueillez le code, puis débitez de nouveau le paiement sur le même canal avec le code dans `data.otp` et une nouvelle `Idempotency-Key`. Une fois que l'opérateur a refusé trois codes sur ce canal, le débit répond `402` avec `error_code: otp_attempts_exceeded` : le payeur paie avec un autre canal. ### La fenêtre du prestataire Avec `client_session`, le prestataire encaisse le paiement lui-même. Quand `client_session.hosted_url` est présent, envoyez-y le payeur comme pour une redirection. À son retour, appelez `POST /payments/{id}/confirm` avec `client_session_id` égal à `client_session.id`. Il répond comme le débit, `202` tant que le résultat n'est pas définitif. Un prestataire qui ne propose qu'un widget dans la page, sans `hosted_url`, est fait pour les [Composants intégrés](https://docs.wajub.com/fr/libraries/components), qui l'ouvrent pour vous. ## Laisser Wajub trouver l'opérateur Avec `channel` à `mobile`, ou à `cm.mobile` pour le Cameroun, Wajub lit l'opérateur à partir du numéro et débite dessus : `+23767…` part sur `cm.mtn`. Ce sont les deux seuls agrégats : un autre pays se débite sur le canal de son opérateur, comme `ci.orange`. Quand le numéro ne peut pas être attribué, un numéro porté par exemple, Wajub utilise `data.operator` si vous l'avez envoyé avec `cm.mobile`, et répond `422` sinon. Avec un canal précis comme `cm.mtn`, le numéro doit appartenir à cet opérateur. Un numéro Orange envoyé sur `cm.mtn` est refusé avec un `422` qui indique le bon canal, au lieu d'être débité sur le mauvais réseau. Certains canaux portent le nom d'un portefeuille, pas celui d'un opérateur. Wave (`ci.wave`, `sn.wave`), Express Union (`cm.eu`), Djamo (`ci.djamo`, `sn.djamo`), Capitec Pay (`za.capitec`), OPay (`ng.opay`) et PalmPay (`ng.palmpay`) se détiennent quel que soit l'opérateur du payeur : tout numéro y est accepté. Les autres portefeuilles appartiennent à un opérateur et prennent un numéro de cet opérateur : `ke.mpesa` un numéro Safaricom, `tz.mpesa` et `mz.mpesa` un numéro Vodacom, `tg.tmoney` un numéro Togocel, `gh.vodafone` un numéro Telecel. Un agrégat envoie un tel numéro sur le portefeuille. [Formats de numéros de téléphone](https://docs.wajub.com/fr/payments/payment-methods/phone-numbers#how-the-operator-is-identified) liste chaque portefeuille et l'opérateur derrière lui. Sur un paiement créé avec [`accept`](https://docs.wajub.com/fr/payments/payment-methods#choosing-what-a-payment-accepts), un agrégat est jugé d'après l'opérateur que donne le numéro : `cm.mobile` avec un numéro MTN est accepté partout où `cm.mtn` l'est. ## Réessayer après un refus Un `402` laisse le paiement en `pending` : le même paiement peut donc être débité de nouveau, avec un autre numéro, un autre opérateur, ou le même une fois que le payeur a rechargé son compte. Utilisez une **nouvelle** `Idempotency-Key` pour cette nouvelle tentative. Renvoyer la première clé renvoie la première réponse, le `402`, sans rien retenter. La même clé reste la bonne après un délai dépassé ou une erreur réseau, quand vous ne savez pas si le premier appel est passé. ## Cartes Le mode live refuse les données de carte brutes : un numéro de carte ou un code de sécurité dans le corps reçoit un `422` avec `error_code: raw_card_data_not_accepted`, avant tout débit. Les cartes se saisissent dans le [Checkout hébergé](https://docs.wajub.com/fr/payments/hosted-checkout), les [Composants intégrés](https://docs.wajub.com/fr/libraries/components) ou un SDK mobile, qui les collectent de façon sécurisée. La sandbox accepte `channel: card` avec les cartes de test publiées uniquement, pour que vous puissiez dérouler tout le parcours. Tout autre numéro de carte y est refusé aussi. Un débit par carte en sandbox prend quatre champs dans `data`, chacun refusé par un `422` à son nom s'il manque ou est mal formé : | Champ | Ce qu'il contient | | ------------- | ------------------------------------------------------------------------------------------------ | | `card.number` | Une [carte de test](https://docs.wajub.com/fr/developer-tools/testing/test-scenarios#cards). Le numéro décide du résultat | | `card.holder` | Le nom sur la carte. `card_holder` est accepté aussi | | `exp` | L'expiration au format `MM/AA` ou `MM/AAAA`, une année de celle-ci à trente ans plus tard | | `cvc` | Trois ou quatre chiffres | Les deux clés `card.` sont des noms qui contiennent un point, pas un objet imbriqué : `"data": {"card.number": "4242424242424242", "card.holder": "Amina Diallo", "exp": "12/30", "cvc": "123"}`. ## En sandbox Les six derniers chiffres du numéro de téléphone décident du résultat, comme sur la page hébergée. `…000000` réussit ; `…000001` est refusé tout de suite comme le live refuse : un `402` avec `error_code: insufficient_funds`, et le paiement reste `pending`. Le tableau complet est dans [Scénarios de test](https://docs.wajub.com/fr/developer-tools/testing/test-scenarios). La sandbox ne répond jamais `redirect`, `confirm_otp` ni `client_session` : ces étapes n'arrivent qu'en live. Elle répond sans `action` pour le Mobile Money et les canaux bancaires, `confirm_3ds` pour une carte de test 3-D Secure, et `confirm` avec `crypto.deposit`, l'adresse et le montant à envoyer, pour un canal crypto. Orange Money au Burkina Faso (`bf.orange`) demande le code du payeur avec `payer_otp`, comme en live, et accepte `123456`. L'API directe est disponible sur tous les plans, en sandbox comme en live. Le découpage d'un paiement en plusieurs versements, avec [`POST /payments/{id}/splits`](https://docs.wajub.com/fr/api/payments/splits), fonctionne dans les deux, sur les canaux Mobile Money en live : [Paiements fractionnés](https://docs.wajub.com/fr/sync/split-payments) le décrit. - [Choisir son intégration](https://docs.wajub.com/fr/payments/integration-paths): Les quatre modes comparés, et quand l'API directe est le bon choix. - [Numéros de téléphone](https://docs.wajub.com/fr/payments/payment-methods/phone-numbers): Les formats qu'un numéro peut prendre, et comment l'opérateur est trouvé. - [Cycle de vie d'un paiement](https://docs.wajub.com/fr/payments/lifecycle): Chaque statut que traverse un paiement, et le webhook de chacun. - [Référence API](https://docs.wajub.com/fr/api/payments/process): Chaque champ de POST /payments/{id}. --- # Checkout hébergé URL: https://docs.wajub.com/fr/payments/hosted-checkout > La page que Wajub affiche à votre client, ce qu'elle prend en charge et ce que vous contrôlez. Le checkout hébergé est le chemin le plus court vers un paiement qui fonctionne. Vous créez le paiement, vous envoyez le client vers la page affichée par Wajub, et vous vérifiez le résultat à son retour. > [!TIP] > **Le code d'intégration** > > Le code d'une redirection, d'une iframe intégrée ou d'une fenêtre superposée se trouve dans [Wajub > Components → Checkout hébergé](https://docs.wajub.com/fr/libraries/components/hosted-checkout). ## Créer le paiement Tout ce dont la page a besoin vient de l'appel de création. Envoyez-le depuis votre serveur avec la clé secrète : la clé publique crée aussi des paiements, mais elle existe pour le cas où l'appel est fait depuis un navigateur. `POST /payments` - `amount` (number, required): Montant dans l'unité principale de la devise. Les décimales sont acceptées, donc `10.50` vaut dix dollars cinquante. En XAF et XOF, le paiement doit être compris entre 25 et 2 000 000. - `currency` (string, required): Code ISO 4217 : XAF, XOF, NGN, GHS, KES et le reste de la liste prise en charge. - `customer` (object): Identité du payeur : `email`, `phone`, `name`, ainsi que `address` et `metadata`. Au moins un des champs `customer`, `email`, `phone` ou `customer_id` est obligatoire, et l'objet est la forme qui évolue avec vous. - `description` (string): Un libellé unique affiché au client sur la page. Vaut « Payment » par défaut. - `items` (array): Lignes de commande affichées sur la page, chacune avec un `name`, une `description` et une `quantity`. Elles sont affichées, jamais additionnées : `amount` reste le montant que vous débitez. - `callback` (string (url)): Où le client est envoyé ensuite, quelle que soit l'issue : succès, échec, annulation ou expiration, distinguées par `status` dans les paramètres de l'URL. Doit être en HTTPS ; `http://localhost` et `http://127.0.0.1` sont acceptés en sandbox. Toute autre adresse reçoit un `422`. Si vous l'omettez, il reste sur une page de confirmation Wajub, et le webhook est alors votre seul signal. - `reference` (string): Votre propre numéro de commande. Il revient à chaque lecture et dans l'URL de retour. Il n'est soumis à aucune contrainte d'unicité, ce n'est donc pas lui qui empêche un double débit. - `expires.in` (integer): Durée pendant laquelle la page reste utilisable, en minutes, de 5 à 43 200. Vaut 1 440 par défaut, soit 24 heures. - `bearer` (string): Qui paie les frais Wajub : `merchant` par défaut, ou `customer`, qui ajoute les frais au montant et affiche le détail sur la page. - `accept` (object): Réduit les moyens de paiement proposés, par `countries`, `channels`, `types` et `currencies`. Si vous l'omettez, tous les moyens sur lesquels vous pouvez encaisser sont affichés. Voir [Choisir ce qu'un paiement accepte](https://docs.wajub.com/fr/payments/payment-methods#choosing-what-a-payment-accepts). - `metadata` (object): Paires clé-valeur libres, renvoyées lors des lectures et dans les webhooks. Un appel de création qui utilise les champs propres à la page hébergée ressemble à ceci : **Créer un paiement pour la page hébergée** ```bash curl https://api.wajub.com/payments \ -H "Authorization: sk_test.xxxxxxxxxxxxxxxx…" \ -H "Content-Type: application/json" \ -d '{ "amount": 25000, "currency": "XAF", "customer": { "email": "amina@example.com", "name": "Amina N." }, "description": "Order #4172", "reference": "order-4172", "items": [ { "name": "Wireless earbuds", "quantity": 1 }, { "name": "Delivery", "quantity": 1 } ], "expires": { "in": 60 }, "callback": "https://shop.example.com/order/complete" }' ``` ```javascript const payment = await wajub.payments.create({ amount: 25000, currency: 'XAF', customer: { email: 'amina@example.com', name: 'Amina N.' }, description: 'Order #4172', reference: 'order-4172', expires: { in: 60 }, callback: 'https://shop.example.com/order/complete', }); res.redirect(payment.authorization_url); ``` ```python payment = wajub.payments.create({ "amount": 25000, "currency": "XAF", "customer": {"email": "amina@example.com", "name": "Amina N."}, "description": "Order #4172", "reference": "order-4172", "expires": {"in": 60}, "callback": "https://shop.example.com/order/complete", }) return redirect(payment.authorization_url) ``` ```php $payment = $wajub->payments->create([ 'amount' => 25000, 'currency' => 'XAF', 'customer' => [ 'email' => 'amina@example.com', 'name' => 'Amina N.', ], 'description' => 'Order #4172', 'reference' => 'order-4172', 'expires' => ['in' => 60], 'callback' => 'https://shop.example.com/order/complete', ]); return redirect($payment->authorization_url); ``` ```go payment, err := client.Payments.Create(context.Background(), map[string]any{ "amount": 25000, "currency": "XAF", "customer": map[string]any{"email": "amina@example.com", "name": "Amina N."}, "description": "Order #4172", "reference": "order-4172", "expires": map[string]any{"in": 60}, "callback": "https://shop.example.com/order/complete", }, nil) if err != nil { log.Fatal(err) } http.Redirect(w, r, payment.AuthorizationURL, http.StatusSeeOther) ``` La réponse contient le paiement et la page vers laquelle envoyer le client. Enregistrez `transaction.id` avec votre commande avant de rediriger : ```json title="Réponse · 201 Created" { "code": 201, "status": "Created", "message": "Payment initiated", "authorization_url": "https://pay.wajub.com/xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx", "authorization_token": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx", "transaction": { "id": "trx_test_CSUGajfv9xh0XQ5wu2lx", "reference": "order-4172", "amount": 25000, "currency": "XAF", "status": "pending", "sandbox": true, "created_at": "2026-09-11T10:24:00+00:00" } } ``` `authorization_url` contient un jeton de session opaque, pas l'id de la transaction. Redirigez vers cette URL exactement telle qu'elle est renvoyée : ne l'analysez jamais et n'en construisez jamais une vous-même. L'hôte n'est d'ailleurs pas toujours `pay.wajub.com`, car un compte sur le plan Scale peut servir son checkout depuis son propre domaine vérifié. ## Ce que la page décide seule Le client ne voit que les moyens qui peuvent prendre ce paiement, pas une liste figée. Le Mobile Money plafonne un débit unique à **500 000 XAF**, et au même montant en XOF. Un paiement au-dessus est refusé et la page propose au payeur un montant plus faible ou un autre moyen de paiement. Si vous définissez `bearer` à `customer`, la page affiche les frais ajoutés à votre montant et le total réellement débité. La langue est l'anglais ou le français. Elle suit le réglage [**Paiement — Langue**](https://dashboard.wajub.com/settings/regional/language), qui accepte `auto`, `en` ou `fr`. Sur `auto`, la page utilise le `preferred_language` du client, et s'ouvre en français quand le client n'en a pas. ## Gérer le retour Une fois la tentative terminée, le client revient sur votre `callback`, avec le paiement identifié dans les paramètres de l'URL : ```bash title="Redirection de retour" https://shop.example.com/order/complete?reference=trx_test_CSUGajfv9xh0XQ5wu2lx&status=succeeded&trxref=order-4172 ``` `reference` est l'id du paiement Wajub et `trxref` est la `reference` que vous avez envoyée, présente seulement si vous en avez défini une. Les deux reviennent quelle que soit l'issue. `status` vaut `succeeded`, `failed`, `cancelled` ou `expired`. Après un succès, la page renvoie le client d'elle-même ; après un échec ou une expiration, quand il choisit de revenir. Un client qui ferme la page sans terminer ne revient jamais. > [!CAUTION] > **Le retour ne prouve rien** > > N'importe qui peut ouvrir cette URL à la main et modifier `status`. Un client qui ferme l'onglet ne > l'ouvre jamais. Confirmez avec `GET /payments/{id}` depuis votre serveur, ou agissez sur le webhook > `payment.succeeded`, avant de livrer quoi que ce soit. L'appel de vérification prend l'id que vous avez enregistré avant la redirection : **Vérifier avant de livrer** ```bash curl https://api.wajub.com/payments/trx_test_CSUGajfv9xh0XQ5wu2lx \ -H "Authorization: sk_test.xxxxxxxxxxxxxxxx…" ``` ```javascript const payment = await wajub.payments.retrieve(req.query.reference); if (payment.status === 'succeeded' && payment.amount === order.total) { await fulfill(order); } ``` ```python payment = wajub.payments.retrieve(request.args["reference"]) if payment.status == "succeeded" and payment.amount == order.total: fulfill(order) ``` ```php $payment = $wajub->payments->retrieve($request->query('reference')); // Comparez des unités mineures entières. Utilisez 1000 au lieu de 100 pour une devise à trois décimales. $paid = (int) round((float) $payment->amount * 100); $due = (int) round((float) $order->total * 100); if ($payment->status === 'succeeded' && $paid === $due) { $order->fulfill(); } ``` ```go payment, err := client.Payments.Retrieve(context.Background(), r.URL.Query().Get("reference")) if err != nil { log.Fatal(err) } if payment.Status == "succeeded" && payment.Amount == order.Total { fulfill(order) } ``` Vérifiez le montant et la devise en plus du statut, et laissez le webhook clôturer les commandes dont le client n'est jamais revenu. ## Personnaliser la page L'apparence de la page se règle une fois pour tout le compte, dans **Paramètres → Image de marque**, et s'applique à chaque page de paiement que vous créerez, en sandbox comme en production. | Ce que vous réglez | Où cela apparaît | | ------------------------------------------------- | ---------------------------------------------------------- | | Logo rectangulaire, logo carré, favicon | L'en-tête de la page et l'onglet du navigateur | | Couleurs principale, secondaire et d'arrière-plan | Les boutons, les liens et le fond de la page | | Couleurs du texte et du texte des boutons | Le contraste avec votre propre palette | | Couleurs de succès et d'erreur | Les états de confirmation et d'échec | | Police et arrondi des bordures | Toute la page | | Mode d'apparence | `system`, `light` ou `dark` | | Densité et style de couverture | La compacité de la mise en page et le cadrage de l'en-tête | > [!NOTE] > **L'image de marque demande un plan payant** > > **Paramètres → Image de marque** dépend de la fonctionnalité Personnalisation du design, disponible à partir de **Growth**. > Sur Pay as you go, la page de paiement garde l'apparence par défaut. Servir le checkout depuis > votre propre domaine est une fonctionnalité distincte, Domaine personnalisé, disponible à partir de > **Scale**. Vous pouvez aussi collecter des informations que le paiement lui-même ne contient pas, une note de livraison ou un numéro de table, en ajoutant des champs dans **Paramètres → Collecter**. Chaque champ a un type parmi `text`, `textarea`, `select`, `checkbox`, `number`, `email` et `tel`, un libellé, un placeholder facultatif et un indicateur obligatoire. Les champs apparaissent sur la page hébergée dans l'ordre où vous les disposez. - [Démarrage rapide Paiements](https://docs.wajub.com/fr/payments/quickstart): Le même parcours de bout en bout, de la création au webhook vérifié. - [Afficher le checkout](https://docs.wajub.com/fr/libraries/components/hosted-checkout): Redirection, iframe intégrée ou fenêtre superposée, avec le code de chacune. - [Image de marque](https://docs.wajub.com/fr/libraries/components/branding): Chaque réglage d'apparence et la façon dont il atteint la page. - [Moyens de paiement et canaux](https://docs.wajub.com/fr/payments/payment-methods): Les opérateurs proposés, pays par pays. - [Cycle de vie d'un paiement](https://docs.wajub.com/fr/payments/lifecycle): Chaque état du paiement pendant que le client est sur la page. - [Tester la page de paiement](https://docs.wajub.com/fr/developer-tools/testing/test-scenarios): Des numéros sandbox qui déclenchent chaque résultat à la demande. --- # Encaisser des paiements URL: https://docs.wajub.com/fr/payments > Les quatre façons d'encaisser un paiement, ce que chacune vous coûte en code, et la suite. Quatre façons d'encaisser un paiement, qui ne diffèrent que par qui affiche l'écran où le client confirme. Les opérateurs que vous atteignez, les webhooks que vous recevez et les remboursements que vous pouvez émettre sont les mêmes dans les quatre. ## Quatre points d'entrée Vous hésitez ? [Choisir une intégration](https://docs.wajub.com/fr/payments/integration-paths) compare les quatre sur le code, la personnalisation et les cas d'usage. Si vous préférez en voir un fonctionner avant de choisir, le [Démarrage rapide](https://docs.wajub.com/fr/payments/quickstart) mène un paiement sandbox de zéro jusqu'à un webhook vérifié. ## Moyens de paiement Le Mobile Money est la colonne vertébrale : MTN, Orange, Wave, Airtel, Moov et M-Pesa, dans une douzaine de pays. Les cartes et les virements bancaires domestiques sont disponibles là où l'opérateur les prend en charge. Les canaux sont nommés `country.operator` : `cm.mtn` est MTN Mobile Money au Cameroun et `sn.wave` est Wave au Sénégal. La matrice complète des pays et des opérateurs se trouve dans [Moyens de paiement et canaux](https://docs.wajub.com/fr/payments/payment-methods), et les formats de numéro acceptés par chaque opérateur dans [Formats de numéros de téléphone](https://docs.wajub.com/fr/payments/payment-methods/phone-numbers). Un mauvais format de numéro fait échouer le paiement avant même que le client voie une demande de confirmation : cette deuxième page mérite d'être lue une fois. ## Les deux appels Créer un paiement ne débite jamais personne. `POST /payments` enregistre l'intention, la garde en `pending`, et vous renvoie l'URL d'une page hébergée et un jeton de session utilisable dans le navigateur. Rien n'a encore atteint un opérateur. C'est le second appel qui débite. Le Checkout hébergé, les Composants intégrés et les liens de paiement le font pour vous. Seule l'[API directe](https://docs.wajub.com/fr/payments/direct-api) vous le laisse : vous collectez vous-même le numéro de téléphone, puis vous envoyez `POST /payments/{id}` avec un `channel` et les détails du paiement. > [!CAUTION] > **Une clé privée dans un navigateur est refusée** > > N'utilisez jamais `sk.…` depuis un navigateur. Lorsque Wajub le détecte, la requête est rejetée > avec un `403` et le propriétaire de la clé reçoit un e-mail. L'API directe a donc sa place sur > votre serveur. Le code front-end utilise la clé publique, ou le jeton de session que renvoie la réponse > de création. ## Ressources de l'API Les paiements partagent une seule API avec tous les autres produits. Voici les ressources qu'ils appellent ; les paramètres et les réponses complets se trouvent dans la [Référence API](https://docs.wajub.com/fr/api). | Endpoint | Méthodes | Utilisé pour | | --------------------------------------------------- | --------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [`/payments`](https://docs.wajub.com/fr/api/payments) | `GET` `POST` `DELETE` | Créer, lister, récupérer et annuler un paiement | | [`/payments/{id}`](https://docs.wajub.com/fr/api/payments/process) | `POST` | Le débiter sur un canal, et ses `/splits` pour les échéances, sur le Mobile Money en live | | [`/payments/{id}/activate`](https://docs.wajub.com/fr/api/payments/activate) | `POST` | Créer un paiement préparé avec `deferred: true` une fois la commande passée, pour des [champs de paiement affichés avant que la commande existe](https://docs.wajub.com/fr/libraries/components/payment-fields#before-the-order-exists). Avant cela, [`PATCH /payments/{id}`](https://docs.wajub.com/fr/api/payments/update) change son montant | | [`/refunds`](https://docs.wajub.com/fr/api/refunds) | `GET` `POST` | Émettre un remboursement et le suivre | | [`/customers`](https://docs.wajub.com/fr/api/customers) | `GET` `POST` `PUT` `DELETE` | Clients récurrents, plus blocage et désactivation | | [`/disputes`](https://docs.wajub.com/fr/api/disputes) | `GET` `POST` | Preuves, acceptation, clôture et messages | | [`/links`](https://docs.wajub.com/fr/api/payment-links) | `GET` `POST` `PUT` `DELETE` | Liens de paiement. Production uniquement | Les appels de paiement standard n'ont besoin d'aucun en-tête propre au produit. Une marketplace qui attribue le paiement à l'un de ses sous-comptes ajoute `X-Sync: acc_…` au même appel, comme décrit dans [Sync → Ressources de l'API](https://docs.wajub.com/fr/sync#the-resources). ## Après le paiement | Besoin | Où | | -------------------------------------------- | -------------------------------------------------------- | | Connaître le résultat au moment où il arrive | [Webhooks](https://docs.wajub.com/fr/developer-tools/webhooks) | | Comprendre chaque état et ses transitions | [Cycle de vie d'un paiement](https://docs.wajub.com/fr/payments/lifecycle) | | Rembourser un paiement | [Remboursements](https://docs.wajub.com/fr/payments/refunds) | | Traiter un litige ou une rétrofacturation | [Litiges](https://docs.wajub.com/fr/payments/disputes) | | Reconnaître un client récurrent | [Clients](https://docs.wajub.com/fr/payments/customers) | | Choisir entre webhooks et polling | [Webhooks ou polling](https://docs.wajub.com/fr/developer-tools/webhooks/polling) | - [Démarrage rapide Paiements](https://docs.wajub.com/fr/payments/quickstart): Un paiement sandbox, de zéro jusqu'à un webhook vérifié. - [Choisir une intégration](https://docs.wajub.com/fr/payments/integration-paths): Les quatre modes comparés sur le code, le contrôle et les cas d'usage. - [Moyens de paiement et canaux](https://docs.wajub.com/fr/payments/payment-methods): La couverture par pays et par opérateur, canal par canal. - [Accepter un paiement](https://docs.wajub.com/fr/guides/accept-a-payment): Le parcours de bout en bout : créer, rediriger, vérifier, livrer. --- # Choisir une intégration URL: https://docs.wajub.com/fr/payments/integration-paths > Les quatre façons d'encaisser un paiement, comparées sur le contrôle, le code et les contraintes. Les quatre modes d'intégration comparés : qui affiche l'écran où le client confirme, et ce que vous écrivez. Les opérateurs, les webhooks et les remboursements sont les mêmes dans les quatre. ## La décision en un tableau | Mode | Qui affiche l'écran de paiement | Ce que vous écrivez | Idéal pour | | ----------------------- | ------------------------------- | ---------------------------------------- | ---------------------------------------------------- | | **Checkout hébergé** | Wajub, sur sa propre page | Une redirection et un handler de retour | Aller vite en production, sur n'importe quelle stack | | **Composants intégrés** | Wajub, dans votre page | Une route serveur plus le SDK navigateur | Rester sur votre domaine, avec votre marque | | **Liens de paiement** | Wajub, sur sa propre page | Rien | Vendre sans site ni serveur | | **API directe** | Vous | Toute l'interface de paiement | Applications natives et parcours sur mesure | ## Ce que vous renvoie la réponse de création Créer un paiement ne débite personne. L'appel enregistre l'intention, la garde en `pending` et répond avec deux champs. Celui que vous utilisez dépend de votre mode d'intégration. - `authorization_url` (string): **Checkout hébergé.** L'URL complète de la page de paiement hébergée par Wajub. Redirigez-y votre client. C'est une URL de session opaque : ne l'analysez jamais et n'en construisez jamais une vous-même. - `authorization_token` (string): **Composants intégrés.** Un jeton de session utilisable dans le navigateur et limité à ce paiement. Passez-le en `sessionId` à `wajub.mount()`. Il n'est renvoyé qu'à la création, jamais lors d'une récupération ultérieure. Dans le code, toute la différence entre les deux modes tient en une ligne : ```js title="Le champ utilisé par chaque mode" // Hosted Checkout: send the customer to the page Wajub renders. res.redirect(payment.authorization_url); // Embedded Components: hand the token to the browser and mount in place. wajub.mount('#checkout', { sessionId: payment.authorization_token }); ``` L'API directe n'utilise ni l'un ni l'autre pour encaisser. Elle fait un second appel à la place, détaillé plus bas, et n'a besoin du jeton que lorsqu'un prestataire demande un code au payeur. ## Checkout hébergé Votre serveur crée le paiement et redirige vers `authorization_url`. Le client choisit un opérateur, saisit son numéro et confirme sur son téléphone, puis revient sur votre `callback`. Wajub envoie le webhook en parallèle : le résultat vous parvient même si le client ferme l'onglet en revenant. Vous écrivez deux choses : la route qui crée le paiement, et le handler qui le vérifie avant de livrer la commande. La page affiche votre logo et vos couleurs, réglés une fois dans le Dashboard sous Paramètres › Image de marque, à partir du plan Growth. C'est le mode que nous recommandons, et celui que parcourt le [Démarrage rapide Paiements](https://docs.wajub.com/fr/payments/quickstart). ## Composants intégrés Le même checkout, monté dans votre propre mise en page. Votre serveur crée le paiement et transmet `authorization_token` au navigateur, qui appelle `wajub.mount()` avec ce jeton en `sessionId`. Le client ne quitte jamais votre domaine. Vous écrivez une route serveur et quelques lignes de code front-end. Ce que vous n'écrivez pas, c'est l'interface de paiement elle-même : Mobile Money, cartes, OTP et 3DS viennent tous du composant monté, et vous fournissez l'habillage autour. Quand les composants s'affichent sur votre page de commande avant que la commande existe, alors que le panier peut encore changer, créez le paiement avec `deferred: true`. Il est seulement préparé : il reste hors de vos paiements et n'envoie aucun webhook `payment.*`. Votre serveur change son montant avec `PATCH /payments/{id}` quand le total bouge, puis l'active avec `POST /payments/{id}/activate` une fois la commande passée, depuis le `onBeforeSubmit` du composant. [Avant que la commande existe](https://docs.wajub.com/fr/libraries/components/payment-fields#before-the-order-exists) en détaille les étapes. Il existe un package JavaScript vanilla et des wrappers React, Vue, Svelte et Angular. La [vue d'ensemble des composants](https://docs.wajub.com/fr/libraries/components#four-ways-to-take-a-payment) compare ses quatre modes ; commencez par le [démarrage rapide des composants](https://docs.wajub.com/fr/libraries/components/quickstart), puis la page du framework qui correspond à votre stack. ## Liens de paiement Un lien à partager, sous forme d'URL ou de QR code. Vous le créez depuis le Dashboard ou avec un seul appel API, vous l'envoyez par WhatsApp, SMS ou e-mail, et le client paie sur une page Wajub. Il n'y a de code serveur à aucun moment. Deux limites sont à connaître avant de construire autour. Les liens de paiement fonctionnent **en production uniquement**, la sandbox n'a pas d'équivalent, et le plan Pay as you go autorise **25 liens**. Consultez [Liens de paiement](https://docs.wajub.com/fr/payments/link) pour savoir ce qu'un lien peut porter et comment suivre ce qu'il encaisse. ## API directe Vous collectez vous-même le numéro de téléphone, puis vous débitez avec un second appel, `POST /payments/{id}`, en passant un `channel` comme `cm.mtn` et les détails du paiement. La demande de confirmation de l'opérateur part vers le téléphone du client, et vous affichez chaque écran autour, y compris l'attente et le résultat. La page [API directe](https://docs.wajub.com/fr/payments/direct-api) détaille l'appel et chaque réponse possible. Les cartes font exception. Le mode live refuse les données de carte brutes sur cet appel : une carte se saisit dans le Checkout hébergé, les composants ou un SDK mobile, qui la collectent de façon sécurisée. C'est le seul mode où l'interface de paiement vous appartient entièrement, c'est pourquoi il existe pour les applications mobiles natives et pour les parcours qu'aucune page hébergée ne peut exprimer. C'est aussi le seul mode où c'est à vous de repérer les erreurs. > [!CAUTION] > **L'API directe a sa place sur votre serveur, jamais dans un navigateur** > > N'utilisez jamais une clé `sk.…` depuis un navigateur. Lorsque Wajub en détecte une, la requête est > rejetée avec un `403` et le propriétaire de la clé reçoit un e-mail. Le code front-end utilise la clé publique ou le jeton > de session de la réponse de création. Si votre interface de paiement vit dans un navigateur, ce sont > les Composants intégrés qu'il vous faut, pas ce mode. ## Toujours indécis Commencez par le Checkout hébergé. C'est le chemin le plus court vers un paiement qui fonctionne, et passer plus tard aux Composants intégrés ne change que votre front-end : l'appel de création, le traitement des webhooks et la vérification restent exactement tels quels. Optez plutôt pour les liens de paiement si vous n'avez pas de site où intégrer, et pour l'API directe seulement après avoir étudié les Composants intégrés et trouvé quelque chose qu'ils ne peuvent vraiment pas afficher. - [Démarrage rapide Paiements](https://docs.wajub.com/fr/payments/quickstart): Un paiement sandbox, de la création au webhook vérifié. - [Checkout hébergé](https://docs.wajub.com/fr/payments/hosted-checkout): Le parcours de redirection complet, personnalisation visuelle et gestion du retour compris. - [Wajub Components](https://docs.wajub.com/fr/libraries/components): Monter le checkout dans votre propre page, framework par framework. - [Liens de paiement](https://docs.wajub.com/fr/payments/link): Créer, partager et suivre un lien. - [Référence API des paiements](https://docs.wajub.com/fr/api/payments): Chaque paramètre des appels de création et de débit. - [Accepter un paiement, guide complet](https://docs.wajub.com/fr/guides/accept-a-payment): Le parcours de bout en bout, avec la logique de livraison autour. --- # Cycle de vie d'un paiement URL: https://docs.wajub.com/fr/payments/lifecycle > Chaque état d'un paiement, le webhook qui l'annonce, et ce qu'il faut faire dans chacun. Chaque état qu'un paiement peut prendre, le webhook qui l'annonce, et ce que fait votre intégration dans chacun. Deux d'entre eux signifient « attendez » : `pending`, avant tout contact avec un opérateur, et `processing`, pendant que le client reçoit la demande de confirmation, où une nouvelle tentative crée un deuxième débit. ## Les états > [!NOTE] > **Aiguillez sur `status`, jamais sur le message** > > Le champ `message` est rédigé pour des humains et peut changer sans préavis. La valeur `status` fait > partie du contrat de l'API, et c'est sur elle que votre code doit se baser. Aiguillez sur elle > plutôt que sur l'événement reçu, car plusieurs événements peuvent annoncer le même état. | `status` | Signification | Webhook | Que faire | | ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------- | ------------------------------------------------------------------------------------- | | `pending` | Le paiement existe. Aucun opérateur n'a encore été contacté. | `payment.created` | Redirigez le client, ou faites l'appel de débit. Rien à livrer. | | `processing` | Envoyé à l'opérateur. Le client reçoit la demande de confirmation sur son téléphone. | `payment.processing` | **Attendez.** Ne faites pas de nouvelle tentative et ne créez pas de second paiement. | | `partial` | Certaines échéances d'un paiement fractionné sont réglées, d'autres non. | `payment.split.*` | Attendez. `amount_paid` sur le paiement indique ce qui est réglé jusqu'ici. | | `succeeded` | Fonds capturés. | `payment.succeeded` | Livrez la commande. | | `failed` | La tentative n'a pas abouti. | `payment.failed` | Lisez `failure_reason`, puis décidez si une nouvelle tentative a du sens. | | `cancelled` | Annulé par vous avec `DELETE /payments/{id}`, ou par le client avec le bouton Annuler de la page hébergée. Un refus sur le téléphone n'est pas une annulation. | `payment.cancelled` | Proposez de lancer un nouveau paiement. | | `expired` | Le délai de paiement s'est écoulé avant que le client agisse. | `payment.expired` | Créez un nouveau paiement. L'ancien ne pourra jamais aboutir. | **Paiement** `pending` (aucun opérateur contacté pour le moment) → [`payment.processing`] `processing` (demande envoyée au téléphone) → [`payment.succeeded`] `succeeded` (fonds capturés, livraison sans risque) Sorties anticipées, depuis pending ou processing: - `failed` (lire failure_reason) - `cancelled` (DELETE, ou Annuler sur la page hébergée) - `expired` (fenêtre fermée) Quatre de ces états mettent fin à la tentative : `succeeded`, `failed`, `cancelled` et `expired`. `succeeded` ne bouge plus jamais, sauf par les remboursements : un paiement remboursé se lit `refunded` ou `partially_refunded`. ## Un paiement préparé, avant son activation Un paiement créé avec `deferred: true`, pour des [champs de paiement affichés avant que la commande existe](https://docs.wajub.com/fr/libraries/components/payment-fields#before-the-order-exists), est seulement préparé jusqu'à ce que votre serveur l'active avec `POST /payments/{id}/activate`. D'ici là, il n'envoie aucun webhook `payment.*` et n'apparaît ni dans `GET /payments` ni dans le Dashboard. Lu par son `id`, il est `pending`, puis `expired` ou `cancelled`, et il ne peut pas être débité. L'activation envoie `payment.created`, puis le paiement suit les états ci-dessus, avec le même `id` et la même expiration. [Paiements préparés](https://docs.wajub.com/fr/api/payments#prepared-payments) résume les différences. ## Les transitions possibles Wajub ne fait évoluer un paiement que selon les chemins ci-dessous. | Depuis | Peut devenir | | ---------------------------------- | --------------------------------------------------------------------------- | | `pending` | `processing` · `partial` · `succeeded` · `failed` · `cancelled` · `expired` | | `processing` | `pending` · `partial` · `succeeded` · `failed` · `cancelled` · `expired` | | `partial` | `processing` · `succeeded` · `failed` | | `failed` · `cancelled` · `expired` | `succeeded` uniquement | Deux de ces chemins surprennent. `processing` revient à `pending` quand l'opérateur refuse un débit immédiatement, avec un `402`, pour que le même paiement puisse être débité de nouveau ; `payment.attempt_failed` en informe votre serveur. Et un paiement `failed`, `cancelled` ou `expired` peut encore devenir `succeeded` quand l'opérateur confirme l'argent en retard : livrez sur `payment.succeeded`, quel que soit le moment où il arrive. Quand une confirmation tardive ne peut pas être créditée, par exemple parce qu'une autre tentative avait déjà encaissé le paiement, le payeur est remboursé et le paiement reste tel quel. Rien d'autre ne fait sortir de ces trois états, donc une nouvelle tentative après eux passe par un nouveau paiement. ## Trois points qui surprennent ### `processing` signifie que le téléphone du client sonne C'est l'état dans lequel votre intégration passera le plus de temps, et celui qui a le plus de chances d'être mal géré. En Mobile Money, `processing` signifie que l'opérateur a envoyé une demande de confirmation sur le téléphone du client et attend qu'il saisisse son code PIN. Cela peut prendre quelques secondes, ou le temps qu'il faut à quelqu'un pour retrouver son téléphone. > [!WARNING] > **Ne retentez jamais un paiement en cours de traitement** > > Créer un second paiement parce que le premier « prend trop de temps » est la façon la plus courante > de débiter un client deux fois. Un paiement en `processing` est toujours actif. Attendez > `payment.succeeded`, `payment.failed` ou `payment.expired`. ### Un remboursement ne modifie le `status` du paiement qu'à travers ses remboursements Un paiement se lit `partially_refunded` dès que des remboursements réussis en couvrent une partie, et `refunded` quand ils le couvrent en entier. C'est une lecture des remboursements : le paiement lui-même ne change pas, et il n'existe pas d'événement `payment.refunded`. [Ce que dit le statut du paiement](https://docs.wajub.com/fr/payments/refunds#the-payments-status-never-changes) Les remboursements ont à la place leur propre famille d'événements : `refund.created`, `refund.processing` (en live uniquement), `refund.succeeded` et `refund.failed`, qui arrive aussi, avec `cancelled_by_wajub`, pour un remboursement que Wajub a arrêté avant de l'envoyer. Pour savoir quelle part d'un paiement a été restituée, listez ses remboursements avec [`GET /payments/{id}/refunds`](https://docs.wajub.com/fr/api/payments/refunds) et additionnez ceux qui ont réussi. ### `partial` ne concerne que les paiements fractionnés Un paiement peut être réglé en deux à quatre échéances, en sandbox et, sur le Mobile Money, en live ([Paiements fractionnés](https://docs.wajub.com/fr/sync/split-payments)). Tant que certaines sont payées et d'autres non, son statut est `partial`, `processing` pendant qu'une échéance attend le payeur, et chaque échéance rend compte d'elle-même via `payment.split.processing`, `payment.split.succeeded` et `payment.split.failed`. Il n'existe pas d'événement `payment.partial`, et un abonnement ne reconnaît que des noms exacts : `payment.*` ne correspond à rien. Listez les trois événements `payment.split` par leur nom, ou abonnez-vous à `*`. Le paiement ne porte pas la liste de ses échéances : `amount_paid` est la référence de ce qui a été réglé, et chaque événement `payment.split.*` indique quelle échéance a bougé. Un paiement `partial` reste ouvert jusqu'au paiement de sa dernière échéance : rien ne l'expire ni ne l'annule. Pour l'arrêter avant, clôturez-le avec [`POST /payments/{id}/close`](https://docs.wajub.com/fr/api/payments/close) : il devient `succeeded` pour ce qui a été encaissé, que vous gardez ou remboursez (`outcome`). `DELETE /payments/{id}` refuse un paiement dont des échéances sont déjà payées. ## Expiration Chaque paiement porte une date limite, fixée avec `expires.in` à la création, en **minutes**, et relue dans son `expires_at` : | | | | ---------- | ------------------------- | | Minimum | 5 minutes | | Par défaut | 1 440 minutes (24 heures) | | Maximum | 43 200 minutes (30 jours) | Le plancher est de cinq minutes, car une demande de confirmation Mobile Money a besoin de temps pour atteindre le téléphone et être confirmée. Des fenêtres plus courtes expirent avant que le client puisse payer. `payment.expired` peut arriver un peu après `expires_at`, et le paiement peut encore afficher `pending` entre les deux. Ne calculez pas l'expiration vous-même pour décider qu'une commande est morte : un opérateur peut encore confirmer un paiement dans les dernières secondes de sa fenêtre. Un paiement dont le débit est encore en cours quand `expires_at` passe, le payeur le validant sur son téléphone par exemple, n'expire pas à ce moment : il attend ce débit. Payé, il est `succeeded` ; refusé sur-le-champ, il revient à `pending` et peut expirer ; refusé plus tard, il est `failed`, sauf le code du payeur refusé plus tard par l'opérateur, qui le ramène à `pending`, où il peut aussi expirer. Un paiement dont une échéance est déjà payée n'expire jamais : il reste ouvert jusqu'à être soldé ou [clôturé](https://docs.wajub.com/fr/api/payments/close). ## Ce que vous recevez quand un paiement échoue Un paiement échoué porte un `failure_reason`, et `failure_message` le dit en une phrase. Voir [Motifs d'échec](https://docs.wajub.com/fr/api/failure-reasons#failed-payments). Aiguillez sur `status` pour le déroulement du code. Utilisez `failure_reason` pour expliquer à un humain ce qui s'est passé, et pour décider manuellement si une catégorie d'échec mérite une nouvelle tentative. ## Annuler un paiement Un paiement que personne n'est en train de payer peut être annulé depuis votre serveur, quand le client abandonne la commande de votre côté. `DELETE /payments/{id}` Le paiement passe en `cancelled`, `payment.cancelled` est envoyé, et sa page n'accepte plus de paiement. Un paiement qui ne peut pas être annulé maintenant répond `409`, avec sa raison dans `error_code` : | `error_code` | Quand | Que faire | | --------------------- | ------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- | | `payment_in_progress` | Un débit est en cours : le payeur le valide sur son téléphone, ou paie sur la page du prestataire | Attendez son issue, par webhook ou `GET /payments/{id}`. Un paiement revenu à `pending` peut être annulé | | `payment_partly_paid` | Des échéances en ont été payées | Clôturez-le avec [`POST /payments/{id}/close`](https://docs.wajub.com/fr/api/payments/close), en gardant ou en remboursant ce qui a été encaissé | Tout autre paiement, déjà payé, échoué, annulé ou expiré, répond `400 This payment cannot be cancelled (already completed or expired).` Une confirmation que l'opérateur envoie après l'annulation fait quand même passer le paiement en `succeeded`, comme décrit plus haut. ## Lister les paiements par état `GET /payments` | Paramètre de requête | Valeurs acceptées | | -------------------------- | ----------------------------------------------------------------------------------------------------------------- | | `status` | `pending`, `processing`, `partial`, `succeeded`, `failed`, `cancelled`, `expired` | | `reference` | Exactement la `reference` envoyée à la création. Elle n'est pas unique : chaque paiement qui la porte est renvoyé | | `search` | Texte libre sur l'id du paiement, votre `reference` et la description | | `date_from`, `date_to` | Dates, comparées à la date de création | | `amount_min`, `amount_max` | Montants dans l'unité principale de la devise | | `per_page` | De 1 à 100, 25 par défaut | | `cursor` | Passe à la pagination par curseur | `status` accepte aussi `refunded` et `partially_refunded` : ils listent les paiements remboursés en totalité ou en partie, que `succeeded` laisse alors de côté. [Ce que dit le statut du paiement](https://docs.wajub.com/fr/payments/refunds#the-payments-status-never-changes) Pour voir les paiements qui attendent encore un client, filtrez sur `pending` : **Lister les paiements en attente** ```bash curl -G https://api.wajub.com/payments \ -H "Authorization: $WAJUB_API_KEY" \ -d status=pending \ -d per_page=50 ``` ```javascript const page = await wajub.payments.list({ status: 'pending', per_page: 50 }); for (const payment of page.data) { console.log(payment.id, payment.created_at); } ``` ```python page = wajub.payments.list({"status": "pending", "per_page": 50}) for payment in page.data: print(payment["id"], payment["created_at"]) ``` ```php $page = $wajub->payments->list([ 'status' => 'pending', 'per_page' => 50, ]); foreach ($page->data as $payment) { echo $payment['id'], PHP_EOL; } ``` ```go page, err := client.Payments.List(context.Background(), map[string]any{ "status": "pending", "per_page": 50, }) if err != nil { log.Fatal(err) } for _, payment := range page.Data { log.Println(payment["id"], payment["created_at"]) } ``` ## Le reçu d'un paiement réussi Une fois le paiement réussi, il porte `receipt_url` : le reçu du payeur, une page hébergée sur votre domaine de factures, dans la langue du payeur. Le lien est signé : transmettez l'URL telle quelle. Le même document existe sous deux autres formes. Ajoutez `/pdf` au chemin pour un PDF, ou `/data` pour le reçu en JSON, en gardant la chaîne de requête. - [Webhooks](https://docs.wajub.com/fr/developer-tools/webhooks): Recevoir ces événements de façon fiable : signatures, nouvelles tentatives, doublons. - [Mode test](https://docs.wajub.com/fr/developer-tools/testing/sandbox-mode): Amenez un paiement dans chaque état à la demande avec des numéros de test. - [Remboursements](https://docs.wajub.com/fr/payments/refunds): Le cycle de vie d'un remboursement et les événements qu'il émet. - [Récupérer un paiement](https://docs.wajub.com/fr/api/payments/retrieve): Faites le rapprochement côté serveur quand vous avez besoin de certitude. --- # Démarrage rapide URL: https://docs.wajub.com/fr/payments/quickstart > Un paiement sandbox, de la création au webhook vérifié, pour un compte qui a déjà ses clés. Un paiement sandbox en quatre étapes : le créer, envoyer le client vers une page, vérifier le résultat depuis votre serveur, et laisser les webhooks vous informer de ce qui arrive après le départ du client. > [!NOTE] > **Cette page commence après la configuration** > > Elle suppose un compte, des clés sandbox et un SDK installé. Si vous n'avez encore rien de tout > cela, le [démarrage rapide de la plateforme](https://docs.wajub.com/fr/getting-started/quickstart) couvre la création du > compte, les clés et l'installation, puis parcourt les mêmes quatre étapes depuis zéro. ## 1. Créez le paiement Une seule requête porte toute l'intention : combien, dans quelle devise, qui paie, et où cette personne revient. Wajub l'enregistre, la garde en `pending`, et répond avec une page vers laquelle envoyer le client. Rien n'a encore atteint un opérateur, et personne n'a été débité. Envoyez-la depuis votre serveur avec la clé secrète. La clé publique crée aussi des paiements, mais elle existe pour le seul cas où l'appel se fait dans un navigateur. Décrivez le payeur dans l'objet `customer`. Un `email` au premier niveau fonctionne aussi et aboutit sur la même fiche client, mais c'est l'objet qui grandit avec vous : il porte aussi `name`, `phone`, `address` et `metadata`. `POST /payments` **Créer un paiement** ```bash curl https://api.wajub.com/payments \ -H "Authorization: sk_test.xxxxxxxxxxxxxxxx…" \ -H "Content-Type: application/json" \ -d '{ "amount": 5000, "currency": "XAF", "customer": { "email": "amina@example.com" }, "reference": "order-4172", "callback": "https://shop.example.com/order/complete" }' ``` ```javascript import { Wajub } from '@wajub/node'; const wajub = new Wajub({ apiKey: process.env.WAJUB_API_KEY }); const payment = await wajub.payments.create({ amount: 5000, currency: 'XAF', customer: { email: 'amina@example.com' }, reference: 'order-4172', callback: 'https://shop.example.com/order/complete', }); console.log(payment.id, payment.authorization_url); ``` ```python import os from wajub import Wajub wajub = Wajub(api_key=os.environ["WAJUB_API_KEY"]) payment = wajub.payments.create({ "amount": 5000, "currency": "XAF", "customer": {"email": "amina@example.com"}, "reference": "order-4172", "callback": "https://shop.example.com/order/complete", }) print(payment.id, payment.authorization_url) ``` ```php getenv('WAJUB_API_KEY')]); $payment = $wajub->payments->create([ 'amount' => 5000, 'currency' => 'XAF', 'customer' => [ 'email' => 'amina@example.com', ], 'reference' => 'order-4172', 'callback' => 'https://shop.example.com/order/complete', ]); echo $payment->authorization_url; ``` ```go client, err := wajub.New(wajub.Config{APIKey: os.Getenv("WAJUB_API_KEY")}) if err != nil { log.Fatal(err) } payment, err := client.Payments.Create(context.Background(), map[string]any{ "amount": 5000, "currency": "XAF", "customer": map[string]any{"email": "amina@example.com"}, "reference": "order-4172", "callback": "https://shop.example.com/order/complete", }, nil) if err != nil { log.Fatal(err) } log.Println(payment.ID, payment.AuthorizationURL) ``` Wajub répond `201 Created`. Deux champs comptent ici : `transaction.id`, que vous stockez avec votre commande, et `authorization_url`, où le client va ensuite. ```json title="Réponse · 201 Created" { "code": 201, "status": "Created", "message": "Payment initiated", "authorization_url": "https://pay.wajub.com/xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx", "authorization_token": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx", "transaction": { "id": "trx_test_CSUGajfv9xh0XQ5wu2lx", "reference": "order-4172", "amount": 5000, "amount_paid": 0, "currency": "XAF", "status": "pending", "customer": { "id": "cus_test_sAaim5apjocIgtlhzJY3wQ8s", "email": "amina@example.com" }, "callback": "https://shop.example.com/order/complete", "sandbox": true, "created_at": "2026-09-11T10:24:00+00:00" } } ``` > [!NOTE] > **Les montants sont en unité principale, jamais en centimes** > > `"amount": 5000` vaut 5 000 XAF, pas 50. Wajub n'utilise pas de sous-unités. Un paiement en XAF ou > en XOF doit être compris entre 25 et 2 000 000 ; hors de cette plage, l'API répond `422` avec la > limite dans `errors.amount`. `reference` vous appartient : c'est votre numéro de commande, renvoyé à chaque lecture et consultable dans le Dashboard. Il n'a aucune contrainte d'unicité : l'envoyer deux fois crée deux paiements, et `GET /payments?reference=order-4172` liste chaque paiement qui le porte. Un paiement se lit par son `id`. Ce qui vous protège vraiment d'un double débit, c'est l'en-tête `Idempotency-Key`. Générez-le vous-même, stockez-le à côté de la commande, et renvoyez la même valeur à chaque nouvelle tentative : l'API renvoie alors le paiement d'origine au lieu d'en ouvrir un second. Passez vous-même cette clé à chaque appel. [Idempotence](https://docs.wajub.com/fr/best-practices/idempotency) présente les stratégies qui fonctionnent. ## 2. Envoyez le client vers la page Redirigez vers `authorization_url`. Le client choisit un opérateur, saisit son numéro, confirme sur son téléphone et revient sur votre `callback`. C'est le Checkout hébergé, et c'est le mode que nous recommandons : Wajub affiche l'écran, vous n'avez donc aucune interface de paiement à maintenir. La session reste valide 24 heures. Passez `expires.in` en minutes, de 5 à 43 200, pour fermer la fenêtre plus tôt. En sandbox, les six derniers chiffres du numéro décident du résultat, et `…000000` réussit. Le tableau complet des suffixes et un numéro par opérateur se trouvent dans le [démarrage rapide de la plateforme](https://docs.wajub.com/fr/getting-started/quickstart#4-pay-it-with-a-sandbox-number). La sandbox ne demande jamais de code PIN. ## 3. Vérifiez avant de livrer Le retour du client sur votre `callback` ne prouve rien. N'importe qui peut ouvrir cette URL à la main, et un client qui ferme l'onglet ne l'ouvre jamais. Demandez à l'API ce qui s'est passé, depuis votre serveur, avec l'id stocké à l'étape 1. `GET /payments/{id}` **Récupérer un paiement** ```bash curl https://api.wajub.com/payments/trx_test_CSUGajfv9xh0XQ5wu2lx \ -H "Authorization: sk_test.xxxxxxxxxxxxxxxx…" ``` ```javascript const payment = await wajub.payments.retrieve('trx_test_CSUGajfv9xh0XQ5wu2lx'); console.log(payment.status, payment.amount, payment.currency); ``` ```python payment = wajub.payments.retrieve("trx_test_CSUGajfv9xh0XQ5wu2lx") print(payment.status, payment.amount, payment.currency) ``` ```php $payment = $wajub->payments->retrieve('trx_test_CSUGajfv9xh0XQ5wu2lx'); echo $payment->status; ``` ```go payment, err := client.Payments.Retrieve(context.Background(), "trx_test_CSUGajfv9xh0XQ5wu2lx") if err != nil { log.Fatal(err) } log.Println(payment.Status, payment.Amount, payment.Currency) ``` La réponse est le paiement tel que Wajub le connaît, quoi qu'on ait dit au navigateur. `channel` indique l'opérateur réellement utilisé, et `amount_paid` ce qui a vraiment été encaissé : ```json title="Réponse · 200 OK" { "code": 200, "status": "OK", "message": "Payment retrieved", "transaction": { "id": "trx_test_CSUGajfv9xh0XQ5wu2lx", "reference": "order-4172", "amount": 5000, "amount_paid": 5000, "currency": "XAF", "status": "succeeded", "channel": "cm.mtn", "customer": { "id": "cus_test_sAaim5apjocIgtlhzJY3wQ8s", "email": "amina@example.com" }, "sandbox": true, "created_at": "2026-09-11T10:24:00+00:00" } } ``` Livrez la commande uniquement quand `status` vaut `succeeded`, et seulement si `amount` et `currency` correspondent à ce que vous avez facturé. Un paiement encore `pending` n'est pas un échec, c'est un client qui n'a pas encore terminé : laissez la commande ouverte et laissez l'étape suivante la clore. ## 4. Laissez le webhook boucler la boucle Vérifier au retour couvre les clients qui reviennent. Les webhooks couvrent tous les autres, ainsi que chaque événement sans aucun navigateur derrière : une confirmation que l'opérateur envoie avec dix minutes de retard, un remboursement émis depuis le Dashboard, une session qui expire sans avoir été ouverte. Abonnez-vous par leur nom aux sept événements qu'un paiement peut produire. Un abonnement ne reconnaît que des noms exacts : `payment.*` ne recevrait rien. | Événement | Se déclenche quand | | ------------------------ | ------------------------------------------------------------------------------------------------- | | `payment.created` | Le paiement a été enregistré et est `pending` | | `payment.processing` | La requête a atteint l'opérateur, le client reçoit la demande de confirmation | | `payment.succeeded` | Fonds capturés. C'est sur celui-ci que vous livrez la commande | | `payment.failed` | L'opérateur a signalé l'échec de la tentative après l'envoi de la demande | | `payment.attempt_failed` | Un refus renvoyé immédiatement : le paiement est de nouveau `pending` et le client peut réessayer | | `payment.expired` | La session a expiré avant que le client confirme | | `payment.cancelled` | Annulé avec `DELETE /payments/{id}`, ou avec le bouton Annuler de la page hébergée | > [!NOTE] > **Les webhooks sont documentés une seule fois, ailleurs** > > L'enregistrement de l'endpoint, la vérification de signature, les nouvelles tentatives et le > catalogue complet se trouvent dans [Webhooks](https://docs.wajub.com/fr/developer-tools/webhooks). Une règle a pourtant sa > place ici : dédoublonnez sur l'`id` de l'événement. Une livraison échouée est > [retentée](https://docs.wajub.com/fr/developer-tools/webhooks/retries), et chaque tentative porte ce même `id`, c'est ce qui > empêche une nouvelle tentative de livrer la commande deux fois. ## Choisissez ensuite le mode à mettre en production Ce que vous venez de construire, c'est le Checkout hébergé. Les trois autres modes changent une seule chose : qui affiche l'écran de l'étape 2. La création, la vérification et le traitement des webhooks restent mot pour mot ce qu'ils sont ci-dessus. **Modes d'intégration** - [Checkout hébergé](https://docs.wajub.com/fr/payments/hosted-checkout): Ce que vous venez de construire. Wajub affiche le choix de l'opérateur, la demande de confirmation et le résultat. - [Composants intégrés](https://docs.wajub.com/fr/libraries/components): Le même écran, monté dans votre page avec le jeton de session. - [Liens de paiement](https://docs.wajub.com/fr/payments/link/quickstart): Aucune intégration. Production uniquement, 25 liens sur l'offre gratuite. - [API directe](https://docs.wajub.com/fr/payments/direct-api): Vous collectez le numéro et le débitez vous-même avec un second appel. ## Et ensuite ? - [Cycle de vie d'un paiement](https://docs.wajub.com/fr/payments/lifecycle): Chaque statut qu'un paiement peut prendre, et les passages de l'un à l'autre. - [Moyens de paiement et canaux](https://docs.wajub.com/fr/payments/payment-methods): La couverture par pays et par opérateur, canal par canal. - [Formats de numéros de téléphone](https://docs.wajub.com/fr/payments/payment-methods/phone-numbers): Ce que chaque opérateur accepte, avant même qu'un paiement puisse démarrer. - [Remboursements](https://docs.wajub.com/fr/payments/refunds): Remboursements totaux ou partiels d'un paiement réussi. - [Accepter un paiement, guide complet](https://docs.wajub.com/fr/guides/accept-a-payment): Le même parcours de bout en bout, avec la logique de livraison autour. - [Passer en live](https://docs.wajub.com/fr/getting-started/going-live): La checklist avant de passer aux clés de production. --- # Suppression et effacement URL: https://docs.wajub.com/fr/payments/customers/delete > Supprimer un client efface aussitôt ses données personnelles. Ce que cela retire, ce qui reste, et ce qui ne peut pas être annulé. La suppression n'est pas l'archivage réversible qu'elle est sur la plupart des ressources. `DELETE /customers/{id}` La fiche est retirée de vos listes et ses données personnelles sont anonymisées immédiatement, dans la même requête, pour répondre à une demande de droit à l'effacement sans deuxième étape. La fiche anonymisée reste parmi les clients supprimés du Dashboard jusqu'à ce qu'un membre de votre équipe la supprime définitivement. Les paiements passés restent, car ce sont des écritures financières : leurs coordonnées client sont pseudonymisées, et ils conservent le numéro de portefeuille ou de compte avec lequel ils ont été réglés. L'événement `customer.deleted` porte la fiche anonymisée, et les coordonnées du client sont retirées des événements et des livraisons de webhook déjà enregistrés. Un appel répété répond le même `200`. Avec `X-Sync`, l'appel répond `403` : une plateforme n'efface pas les clients d'un marchand. [Supprimer un payeur](https://docs.wajub.com/fr/resources/compliance#deleting-a-payer) liste tout ce qu'il retire. > [!CAUTION] > **Aucune annulation possible via l'API** > > L'API n'a pas d'endpoint de restauration. Le Dashboard peut restaurer la fiche, mais les données > personnelles ne reviennent pas avec elle : elles ont été anonymisées dans la requête de > suppression. Désactivez plutôt que de supprimer quand vous voulez simplement écarter un client. - [Supprimer un payeur](https://docs.wajub.com/fr/resources/compliance#deleting-a-payer): Tout ce qu'un effacement retire, sur toute la plateforme. - [Pocket](https://docs.wajub.com/fr/payments/customers/pocket): Où un payeur peut supprimer lui-même ses données. --- # Clients URL: https://docs.wajub.com/fr/payments/customers > La fiche payeur que Wajub réutilise d'un paiement à l'autre, et ce qu'elle change sur la page de checkout. Chaque paiement est rattaché à un client, la fiche payeur que Wajub retrouve ou crée pour vous et réutilise d'un paiement à l'autre. Cinq pages vont plus loin : - [Payer en client connu](https://docs.wajub.com/fr/payments/customers/known-customer), par son id, et ce qu'un client connu change sur la page de checkout. - [Gérer les clients](https://docs.wajub.com/fr/payments/customers/manage) : en créer un en amont, le modifier, les lister, les bloquer, leurs numéros fiscaux et leurs webhooks. - [Suppression et effacement](https://docs.wajub.com/fr/payments/customers/delete), ce que supprimer un client efface et ce qui reste. - [Pocket](https://docs.wajub.com/fr/payments/customers/pocket), où vos payeurs retrouvent leurs paiements, tous marchands confondus. - Dans le guide du tableau de bord, [la fiche client](https://docs.wajub.com/dashboard/customers/profile), [la fusion de deux clients](https://docs.wajub.com/dashboard/customers/merge) et [l'export](https://docs.wajub.com/dashboard/customers/bulk-actions#export-customers). ## Chaque paiement en crée un ou en retrouve un Un paiement doit porter au moins un champ parmi `email`, `phone` et `customer_id`. Sans aucun des trois, l'API répond `422` et rien n'est enregistré. Dès qu'il en reçoit un, Wajub cherche un client correspondant sur votre compte, dans l'environnement que vous appelez. S'il en trouve un, le paiement lui est rattaché. Sinon, il crée le client et y rattache le paiement. Dans les deux cas, le paiement vous renvoie un objet `customer`, avec l'`id` que vous pourrez réutiliser ensuite. La sandbox et le live sont deux populations séparées. Un client créé par un paiement en sandbox est invisible pour un paiement live, et les ids diffèrent : `cus_test_…` en sandbox, `cus_…` en production. ## Comment Wajub décide que deux paiements viennent de la même personne La recherche suit un ordre fixe et s'arrête à la première correspondance. | Ordre | Champ | Méthode de comparaison | | ----- | ------------- | -------------------------------------------------------------------------------------------------------------------------------------- | | 1 | `customer_id` | Correspondance exacte sur l'`id` du client | | 2 | `email` | Espaces de début et de fin retirés, en minuscules : `Amina@Example.com` correspond à `amina@example.com` | | 3 | `phone` | Lu d'abord en E.164 : `+237 6 70 00 00 00`, `237670000000` et, pour un compte au Cameroun, `670000000` correspondent à `+237670000000` | Un compte a un seul client par email, quelle que soit sa casse, et par téléphone une fois en E.164. > [!NOTE] > **Les téléphones sont enregistrés en E.164** > > Tout téléphone de client est enregistré en E.164, quel que soit celui qui l'écrit : l'API, un > paiement, le payeur d'un lien de paiement ou d'une facture, le Dashboard. Un numéro écrit avec `+` > (ou `00`) est lu dans son propre pays ; un numéro écrit sans est lu dans `phone_country` quand > vous l'envoyez, sinon dans le pays de votre compte. Une valeur qui ne se lit pas comme un numéro > est gardée telle qu'envoyée, et ne correspond qu'à elle-même. Les formats sont dans > [Formats de numéros de téléphone](https://docs.wajub.com/fr/payments/payment-methods/phone-numbers). Quand un paiement porte à la fois un email et un téléphone, c'est l'email qui décide. Le téléphone n'est consulté que si aucun client ne correspond à l'email : un client existant peut donc être retrouvé par son email, puis recevoir discrètement un numéro de téléphone qu'il n'avait jamais eu. ## Un paiement n'écrase jamais un client Quand un paiement correspond à un client existant, les données que vous avez envoyées sont fusionnées, mais seulement dans les champs vides. Un champ qui a déjà une valeur n'est pas touché. | Envoyé sur le paiement | Le client a déjà une valeur | Le client n'en a pas | | ------------------------ | ------------------------------------------ | --------------------------------------------------------------------------------- | | `name`, `email`, `phone` | Ignoré | Renseigné, sauf si un autre client du compte porte déjà cet email ou ce téléphone | | `metadata` | Fusionné clé par clé, vos clés l'emportent | Renseigné | | `address` | Ignoré | Rattaché comme adresse de livraison principale | | `shipping` | Ignoré | Rattaché comme adresse de **facturation** principale | Envoyez l'adresse de livraison dans `customer.address`. Conséquence pratique : vous ne pouvez pas corriger un client via un paiement. Envoyez un paiement avec `"name": "Amina Diallo"` pour un client déjà nommé `Amina N.` et l'ancien nom est conservé. Utilisez [`PUT /customers/{id}`](https://docs.wajub.com/fr/payments/customers/manage#update-a-customer) pour les corrections. Un paiement envoyé avec `X-Sync` ne touche jamais aux `metadata` du marchand : ses `metadata` vont à celles de la plateforme, décrites dans [Pour le compte d'un sous-compte](https://docs.wajub.com/fr/payments/customers/manage#on-behalf-of-a-subaccount). > [!NOTE] > **Le premier paiement perd l'adresse** > > Les adresses ne sont rattachées que quand le client existait déjà. Un tout > nouveau client créé par un paiement est enregistré avec son email, son nom, son téléphone et ses > métadonnées seulement : une `address` envoyée sur ce premier paiement n'est donc pas conservée sur > la fiche client. [Créez le client en > amont](https://docs.wajub.com/fr/payments/customers/manage#create-a-customer-up-front) si l'adresse compte pour vous. - [Référence API des clients](https://docs.wajub.com/fr/api/customers): Tous les champs de la ressource, et ses endpoints. - [Formats de numéros de téléphone](https://docs.wajub.com/fr/payments/payment-methods/phone-numbers): Le format international dans lequel tout téléphone de client est enregistré. --- # Payer en client connu URL: https://docs.wajub.com/fr/payments/customers/known-customer > Débiter un client par son id, et ce qu'un client connu change sur la page de checkout. Une fois que vous détenez un `id`, issu de l'objet `customer` d'un paiement précédent ou de [`POST /customers`](https://docs.wajub.com/fr/payments/customers/manage#create-a-customer-up-front), passez-le et laissez complètement de côté les champs de contact. Le champ `customer` accepte l'id sous forme de simple chaîne, et `customer_id` accepte la même valeur ; ce sont deux écritures de la même chose. **Débiter un client existant** ```bash curl https://api.wajub.com/payments \ -H "Authorization: sk_test.xxxxxxxxxxxxxxxx…" \ -H "Content-Type: application/json" \ -d '{ "amount": 5000, "currency": "XAF", "customer": "cus_test_sAaim5apjocIgtlhzJY3wQ8s", "reference": "order-4173" }' ``` ```javascript const payment = await wajub.payments.create({ amount: 5000, currency: 'XAF', customer: 'cus_test_sAaim5apjocIgtlhzJY3wQ8s', reference: 'order-4173', }); ``` ```python payment = wajub.payments.create({ "amount": 5000, "currency": "XAF", "customer": "cus_test_sAaim5apjocIgtlhzJY3wQ8s", "reference": "order-4173", }) ``` ```php $payment = $wajub->payments->create([ 'amount' => 5000, 'currency' => 'XAF', 'customer' => 'cus_test_sAaim5apjocIgtlhzJY3wQ8s', 'reference' => 'order-4173', ]); ``` ```go payment, err := client.Payments.Create(context.Background(), map[string]any{ "amount": 5000, "currency": "XAF", "customer": "cus_test_sAaim5apjocIgtlhzJY3wQ8s", "reference": "order-4173", }, nil) ``` L'identifiant n'est pas forcément un id. Si la valeur que vous passez ne correspond à aucun `id` de client, Wajub l'essaie comme numéro de téléphone, puis comme adresse email. `"customer": "amina@example.com"` et `"customer": "+237670000000"` sont donc tous deux résolus, ce qui est pratique quand votre propre base stocke l'email et non l'id Wajub. > [!CAUTION] > **Un identifiant qui ne correspond à rien donne un 422, pas un nouveau client** > > C'est le seul endroit où l'API refuse de créer. Passez `customer` ou `customer_id` et Wajub > trouvera ce client ou fera échouer l'appel avec un `422` sur le champ utilisé, `Customer not > found.` ; il ne se rabat jamais sur une création. Un id périmé, un client supprimé la semaine dernière ou un id live envoyé en > sandbox font tous échouer le paiement d'emblée. En cas de doute sur l'existence de la fiche, > envoyez plutôt `email` ou `phone`. ## Ce qu'un client change sur la page de checkout C'est ce qui rentabilise l'appel supplémentaire. Un paiement rattaché à un client connu affiche une page différente. | Ce que porte le client | Ce que le checkout en fait | | -------------------------------------------- | ------------------------------------------------------------------------------------------------------------- | | Cartes et numéros Mobile Money déjà utilisés | Les propose comme moyens enregistrés, utilisables en un geste, le moyen par défaut en premier, dix au maximum | | `preferred_language` | Définit la langue de la page, sauf si le réglage d'équipe ou de branding l'emporte | | `currency` | Devient la devise présélectionnée quand la conversion automatique est activée | Les moyens enregistrés sont le vrai gain pour les payeurs qui reviennent : le numéro est déjà là, masqué, et ils confirment sur leur téléphone sans le ressaisir. > [!NOTE] > **Enregistrer un moyen de paiement est la décision du payeur** > > Une carte ou un numéro Mobile Money n'est conservé que si le payeur coche la case sur la page de > checkout. Ce n'est jamais déduit ni coché par défaut : une fiche client sans moyen enregistré est > donc l'état normal tant que personne n'a donné son accord. Seuls les cartes et le Mobile Money sont > réutilisables ; les portefeuilles et les virements bancaires ne sont pas conservés. - [Gérer les clients](https://docs.wajub.com/fr/payments/customers/manage): En créer un en amont, pour que le premier paiement ait déjà un id à utiliser. - [Factures récurrentes](https://docs.wajub.com/fr/billing/invoice/recurring): Facturez un client connu selon un calendrier. --- # Gérer les clients URL: https://docs.wajub.com/fr/payments/customers/manage > Créer un client en amont, le modifier, le lister et le bloquer, conserver ses numéros fiscaux, et suivre ses webhooks. ## Créer un client en amont La création explicite en vaut la peine quand vous connaissez le payeur avant qu'il ne paie : une inscription, une base clients importée, un compte B2B avec un numéro fiscal et une adresse de facturation. `POST /customers` Au moins un champ parmi `email` et `phone` est obligatoire. Tout le reste est facultatif ; les champs ci-dessous sont ceux qu'il faut connaître, et la liste complète se trouve dans la [référence API](https://docs.wajub.com/fr/api/customers/create). - `email` (string): Obligatoire sauf si `phone` est fourni. Stocké tel qu'envoyé, et retrouvé quelle que soit la casse : un second `POST /customers` avec `Amina@Example.com` renvoie le client enregistré avec `amina@example.com`. - `phone` (string): Obligatoire sauf si `email` est fourni. Enregistré en E.164 : un numéro sans son préfixe international est lu dans `phone_country`, sinon dans le pays de votre compte. - `name` (string): Nom affiché, le seul champ de nom que vous pouvez définir. - `type` (enum, default `individual`): `individual` ou `business`. Envoyer `business_name` seul implique `business`. - `business_name` (string): Obligatoire quand `type` vaut `business`. Devient le `name` du client. - `currency` (string): Devise préférée, utilisée par défaut sur le checkout quand la conversion automatique est activée. - `preferred_language` (string): Langue du checkout hébergé, qui passe après les réglages d'équipe et de branding. - `address` (object): Adresse de livraison : `country`, `city`, `state`, `postal_code`, `address_line1`, `address_line2`. - `billing` (object): Adresse de facturation, même structure que `address`. - `customer_group` (string): Segment libre sur lequel vous pouvez filtrer la liste. - `tags` (array): Chaînes de 50 caractères maximum chacune. - `metadata` (object): Vos propres données clé-valeur, au format libre. Envoyez l'appel depuis votre serveur, avec la clé secrète. **Créer un client** ```bash curl https://api.wajub.com/customers \ -H "Authorization: sk_test.xxxxxxxxxxxxxxxx…" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: cus-signup-9182" \ -d '{ "email": "amina@example.com", "phone": "+237670000000", "name": "Amina Diallo", "metadata": { "user_id": "u_9182" } }' ``` ```javascript const customer = await wajub.customers.create({ email: 'amina@example.com', phone: '+237670000000', name: 'Amina Diallo', metadata: { user_id: 'u_9182' }, }); console.log(customer.id); ``` ```python customer = wajub.customers.create({ "email": "amina@example.com", "phone": "+237670000000", "name": "Amina Diallo", "metadata": {"user_id": "u_9182"}, }) print(customer.id) ``` ```php $customer = $wajub->customers->create([ 'email' => 'amina@example.com', 'phone' => '+237670000000', 'name' => 'Amina Diallo', 'metadata' => [ 'user_id' => 'u_9182', ], ]); echo $customer->id; ``` ```go customer, err := client.Customers.Create(context.Background(), map[string]any{ "email": "amina@example.com", "phone": "+237670000000", "name": "Amina Diallo", "metadata": map[string]any{"user_id": "u_9182"}, }, nil) ``` Un nouveau client est renvoyé en `201 Created`, avec l'`id` que vous passerez désormais sur vos paiements. ```json title="Réponse · 201 Created" { "code": 201, "status": "Created", "message": "Customer created", "customer": { "id": "cus_test_sAaim5apjocIgtlhzJY3wQ8s", "type": "individual", "name": "Amina Diallo", "email": "amina@example.com", "phone": "+237670000000", "status": "active", "blocked": false, "tags": [], "metadata": { "user_id": "u_9182" }, "sandbox": true, "created_at": "2026-09-11T10:24:00+00:00" } } ``` > [!WARNING] > **Un doublon répond 200, pas 201** > > Si vous créez un client dont l'email (quelle que soit sa casse) ou le téléphone existe déjà, l'API > renvoie la fiche existante avec `200 OK` et le message > `Customer already exists for this merchant`. Avec une clé publique, cette fiche ne contient que > son `id` et les champs envoyés par la requête. Rien n'est dupliqué, et rien n'est mis à jour non > plus. Testez `code === 201` pour distinguer une vraie création d'une > correspondance, et ne traitez jamais le `200` comme une erreur. `Idempotency-Key` fonctionne ici comme sur les paiements : la même clé rejoue la réponse d'origine pendant 24 heures au lieu d'ouvrir une deuxième fiche. C'est la façon sûre de retenter un hook d'inscription. ## Modifier un client Un paiement ne corrige jamais un client, il ne remplit que les champs encore vides : voir [Un paiement n'écrase jamais un client](https://docs.wajub.com/fr/payments/customers#a-payment-never-overwrites-a-customer). Les corrections passent par `PUT /customers/{id}`. `PUT /customers/{id}` `PUT /customers/{id}` ne change que les champs que vous envoyez. Le `name` ne change que si vous l'envoyez : `first_name` et `last_name` sont refusés, et envoyer `business_name` sur un particulier laisse son nom intact (sur une entreprise, un nouveau `business_name` devient son nom, sauf si vous envoyez aussi `name`). Un `email` (quelle que soit sa casse) ou un `phone` déjà porté par un autre client du compte répond `422` sur ce champ, `A customer with this email already exists.` ou `A customer with this phone already exists.` ## Récupérer et lister La récupération prend l'`id` du client et renvoie le même objet que l'appel de création. `GET /customers/{id}` La liste renvoie vos clients du plus récent au plus ancien, et accepte des filtres qui correspondent à votre façon de les segmenter. `GET /customers` | Paramètre de requête | Accepte | | -------------------- | ------------------------------------------------------------------------------ | | `per_page` | De 1 à 100, 25 par défaut | | `search` | Texte libre sur le nom, l'email, le téléphone et l'id | | `status` | `active`, `inactive`, `blocked` | | `type` | `individual`, `business` | | `country` | Code pays à deux lettres de l'adresse de livraison ou de facturation du client | | `customer_group` | La chaîne de groupe définie sur le client | | `cursor` | Un curseur opaque issu d'une réponse précédente | La pagination a deux modes, et le mode par numéro de page est celui par défaut. Sans `cursor`, `meta` contient `current_page`, `last_page`, `per_page` et `total`, ainsi que le `next_cursor` et le `has_more` qui permettent de continuer avec un curseur. Envoyez ce `next_cursor` comme `cursor` et l'endpoint passe en mode curseur, où `meta` contient à la place `per_page`, `next_cursor`, `prev_cursor` et `has_more`. Le mode curseur est celui qu'il vous faut pour un export complet, car il reste juste pendant que de nouveaux clients sont créés. [Pagination](https://docs.wajub.com/fr/api/pagination) détaille les deux. ## Pour le compte d'un sous-compte Une marketplace qui crée un client pour le compte d'un de ses sous-comptes ajoute l'en-tête `X-Sync` à `POST /customers`, et la règle des doublons ci-dessus s'applique : quand le marchand a déjà un client avec cet email ou ce téléphone, ce client est renvoyé avec `200`, et rien n'est dupliqué. L'appel de la plateforme ne remplit que les champs que le marchand a laissés vides ; il ne change jamais un champ qu'il a renseigné. Le client renvoyé, trouvé ou créé, est dès lors ouvert à la connexion : la plateforme peut le lire, le retrouver dans la liste et l'utiliser sur ses paiements et ses factures. Elle gère un client qu'elle a créé ; sur un client que le marchand avait déjà, ses modifications ne remplissent que les champs que le marchand a laissés vides, et elle ne peut pas le bloquer. Un paiement créé avec `X-Sync` et l'email ou le téléphone d'un client existant est rattaché à ce client de la même façon. Si le marchand a bloqué ce client, le paiement est refusé à partir de la version `2026-11-02`, comme pour tout [client bloqué](#status-and-blocking), même si la connexion n'a pas accès à ce client. Avec `X-Sync`, un client ne montre jamais les `notes`, le `block_reason` ni les `metadata` du marchand, et `notes` envoyé avec `X-Sync` est ignoré. Les `metadata` sont celles de la plateforme : elle les lit et les écrit comme sur tout client, chaque connexion a les siennes, et celles du marchand restent les siennes. Sur un client que le marchand avait déjà, `POST /customers` et les paiements ajoutent les clés que la plateforme n'a pas encore définies, et `PUT /customers/{id}` remplace les `metadata` de la plateforme. [Types de compte](https://docs.wajub.com/fr/sync/account-types#customers-are-shared-with-the-merchant) donne le détail. ## Statut et blocage Un client est `active`, `inactive` ou `blocked`, et quatre endpoints le font passer d'un état à l'autre. | Appel | Effet | | --------------------------------- | -------------------------------------------------------------------------- | | `POST /customers/{id}/block` | Passe à `blocked`, enregistre votre `reason` et un horodatage `blocked_at` | | `POST /customers/{id}/unblock` | Remet le client à `active` | | `POST /customers/{id}/deactivate` | Passe à `inactive` | | `POST /customers/{id}/activate` | Passe à `active` | Bloquer un client déjà bloqué répond `400`, tout comme débloquer un client qui ne l'est pas. `inactive` est une étiquette sur la fiche client, quelle que soit la version d'API. Ce que fait `blocked` dépend de la version : - **À partir de `2026-11-02`**, un client bloqué ne peut plus payer, en sandbox comme en live. Un nouveau paiement pour lui, désigné par `customer_id` ou retrouvé par son email ou son téléphone, répond `403` avec `error_code: customer_blocked`, et rien n'est créé. Un paiement créé sur cette version ne peut plus être débité ni confirmé une fois son client bloqué. Vos liens de paiement et vos factures créent leurs paiements sur la version à laquelle votre compte est fixé. [Clients bloqués](https://docs.wajub.com/fr/api/errors#blocked-customers) - **Avant `2026-11-02`**, `blocked` ne fait que signaler le client, à votre équipe et à vos [règles de routage](https://docs.wajub.com/fr/orchestration/routing-rules) : il peut toujours payer. Le débloquer lui permet de payer à nouveau. [Gestion des versions](https://docs.wajub.com/fr/api/versioning) explique comment votre version est choisie. > [!NOTE] > **Pour refuser un payeur quelle que soit la version** > > Ajoutez son email ou son téléphone à la [liste de blocage](https://docs.wajub.com/fr/risk/shield/rules) de Shield, vérifiée > sur chaque transaction live, qui la rejette d'emblée. ## Numéros fiscaux Les numéros d'identification fiscale d'un client entreprise sont conservés dans leur propre liste, une entrée par numéro : un NIU camerounais, un NINEA sénégalais, un numéro de TVA européen. La liste est disponible en live uniquement. `POST /customers/{id}/tax_ids` - `type` (string, required): Le type de numéro : `cm.niu`, `sn.ninea`, `ci.ifu`, `ke.pin`, `ng.tin`, `gh.tin`, `gh.vat`, `eu.vat`, `gb.vat` ou `us.ein`. Un autre type est accepté aussi, et seule sa longueur est vérifiée. - `value` (string, required): Le numéro lui-même, avec ou sans les espaces et tirets que son format comporte. - `country_code` (string, required): ISO 3166-1 alpha-2, par exemple `CM`. Ajoutez le numéro depuis votre serveur, avec une clé privée live : **Ajouter un numéro fiscal** ```bash curl https://api.wajub.com/customers/cus_sAaim5apjocIgtlhzJY3wQ8s/tax_ids \ -H "Authorization: $WAJUB_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "type": "cm.niu", "value": "M123456789000L", "country_code": "CM" }' ``` ```javascript const taxId = await wajub.customers.createTaxId('cus_sAaim5apjocIgtlhzJY3wQ8s', { type: 'cm.niu', value: 'M123456789000L', country_code: 'CM', }); console.log(taxId.verification_status); ``` ```python tax_id = wajub.customers.create_tax_id("cus_sAaim5apjocIgtlhzJY3wQ8s", { "type": "cm.niu", "value": "M123456789000L", "country_code": "CM", }) print(tax_id["verification_status"]) ``` ```php $taxId = $wajub->customers->createTaxId('cus_sAaim5apjocIgtlhzJY3wQ8s', [ 'type' => 'cm.niu', 'value' => 'M123456789000L', 'country_code' => 'CM', ]); echo $taxId['verification_status']; ``` ```go taxID, err := client.Customers.CreateTaxID(context.Background(), "cus_sAaim5apjocIgtlhzJY3wQ8s", map[string]any{ "type": "cm.niu", "value": "M123456789000L", "country_code": "CM", }, nil) if err != nil { log.Fatal(err) } log.Println(taxID["verification_status"]) ``` Le numéro revient `pending` pendant que Wajub le vérifie. `verification_status` passe ensuite à `verified` quand la valeur respecte le format de son type, à `failed` quand elle ne le respecte pas, et à `unavailable` quand la vérification n'a pas pu se faire. Les formats sont ceux qui servent à vérifier votre propre numéro d'immatriculation ([configuration de Tax](https://docs.wajub.com/fr/tax/configuration#customer-tax-ids) les liste) : un NIU camerounais compte une lettre, douze chiffres et une lettre. Pour un numéro `eu.vat`, la vérification confirme aussi que le numéro est enregistré. Ajouter de nouveau le même type et le même numéro ne crée pas de copie : l'appel répond `200` avec l'entrée existante, repassée à `pending` le temps d'une nouvelle vérification. C'est ainsi que l'on relance une vérification `unavailable`. `GET /customers/{id}/tax_ids` liste les numéros avec leur statut, et `DELETE /customers/{id}/tax_ids/{tax_id}` en retire un. ## Webhooks Trois événements suivent un client, et ils portent l'objet client complet comme payload. | Événement | Déclenché quand | | ------------------ | ----------------------------------------------------------------------------------- | | `customer.created` | Un client est créé, y compris implicitement par un paiement | | `customer.updated` | Un champ change, y compris un changement de statut ou une fusion depuis un paiement | | `customer.deleted` | Le client est supprimé et anonymisé | `customer.created` est plus bavard qu'il n'y paraît : il se déclenche pour chaque nouveau payeur que voit votre checkout, pas seulement pour ceux que vous créez vous-même. L'enregistrement, la vérification et les nouvelles tentatives sont traités dans [Webhooks](https://docs.wajub.com/fr/developer-tools/webhooks). - [Référence API des clients](https://docs.wajub.com/fr/api/customers): Tous les champs de la ressource, et ses endpoints. - [Règles Shield](https://docs.wajub.com/fr/risk/shield/rules): La liste de blocage qui refuse vraiment un payeur, par email, téléphone, IP ou BIN. - [Webhooks](https://docs.wajub.com/fr/developer-tools/webhooks): Enregistrez un endpoint et vérifiez la signature des événements client. - [Pagination](https://docs.wajub.com/fr/api/pagination): Des numéros de page pour un écran, des curseurs pour un export. --- # Pocket URL: https://docs.wajub.com/fr/payments/customers/pocket > Le côté du payeur. Où vos clients retrouvent leurs paiements, demandent un remboursement, le font passer en litige ou suppriment leurs données. Vos clients ont leur propre espace, Pocket, sur `pocket.wajub.com`. Un payeur s'y connecte avec son adresse e-mail ou son numéro de téléphone et un code à usage unique, et y retrouve chaque paiement live fait avec cette adresse ou ce numéro, chez tous les marchands de Wajub. Depuis Pocket, il peut : - vous demander un remboursement, avec un montant et un motif. La demande arrive dans la liste **Litiges** de votre Dashboard, où vous l'acceptez ou la refusez ; - faire passer cette demande en [litige](https://docs.wajub.com/fr/payments/disputes) une fois que vous l'avez refusée, pendant 30 jours après votre réponse, ou quand elle attend depuis 7 jours sans réponse ; - suivre ses litiges, y compris les rétrofacturations ouvertes par sa banque, et vous y écrire ; - retirer un moyen de paiement enregistré, ou choisir celui par défaut ; - consulter et télécharger les factures qui lui ont été envoyées ; - supprimer ses données. Tant que la banque du payeur traite une rétrofacturation sur un paiement, le payeur ne peut ni envoyer de demande de remboursement sur ce paiement ni en faire passer une en litige, et ces délais attendent : ils reprennent là où ils en étaient une fois que la banque a tranché. Les détails sont dans [Demandes de remboursement](https://docs.wajub.com/fr/payments/refunds#refund-requests). Il n'y a rien à intégrer : Pocket lit les mêmes clients et paiements que votre intégration crée, une raison de plus d'envoyer la vraie adresse e-mail et le vrai numéro du payeur. - [Litiges](https://docs.wajub.com/fr/payments/disputes): Ce qui se passe une fois qu'un payeur fait passer une demande en litige depuis Pocket. - [Suppression et effacement](https://docs.wajub.com/fr/payments/customers/delete): Ce que supprimer un client efface, et ce qui reste. --- # Litiges URL: https://docs.wajub.com/fr/payments/disputes > Quand un payeur conteste un paiement, comment vous répondez, et ce qu'une perte vous coûte. Un litige, c'est un payeur, ou son réseau de carte, qui conteste l'un de vos paiements : vous y répondez, et il se termine soit avec l'argent conservé, soit avec votre solde débité. Vous ne pouvez pas en créer un par l'API. > [!CAUTION] > **Les endpoints de litige exigent la clé secrète** > > Chaque appel de cette section exige une clé secrète et répond `406 Not Acceptable` > avec `Private Key Required` à une clé publique. Ces appels ont leur place sur votre serveur. Deux pages vont plus loin : - [Répondre à un litige](https://docs.wajub.com/fr/payments/disputes/respond), avec des justificatifs, en concédant, ou en échangeant avec le payeur. - [Suivre les litiges](https://docs.wajub.com/fr/payments/disputes/track), les consulter et les webhooks qu'ils envoient. ## D'où vient un litige Un litige vous parvient de l'un de deux endroits. **Le payeur fait passer une demande de remboursement en litige depuis Pocket**, le portefeuille Wajub où il retrouve les paiements qu'il a effectués. Un problème y commence par une [demande de remboursement](https://docs.wajub.com/fr/payments/refunds#refund-requests) qui vous est adressée. Le payeur peut la transformer en litige une fois que vous l'avez refusée, pendant 30 jours après votre réponse, ou quand elle attend depuis 7 jours sans réponse. Il choisit un motif, et le texte de sa demande devient le premier message du fil de discussion du litige. | Motif choisi par le payeur | Ce qu'il affirme | | -------------------------- | -------------------------------------------------------- | | `product_not_received` | Il a payé et rien n'est arrivé | | `product_not_as_described` | Ce qui est arrivé ne correspond pas à ce qui était vendu | | `duplicate_charge` | Il a été débité deux fois pour la même chose | | `fraudulent` | Il n'a pas effectué ce paiement | | `other` | Tout autre cas, expliqué dans la description | Un litige ouvert depuis Pocket porte sur le montant demandé par le payeur, plafonné à ce qui reste sur le paiement une fois retirés ses remboursements et les rétrofacturations que vous avez perdues, et porte un `due_date` avant lequel répondre, sept jours après son ouverture. **Le prestataire signale une rétrofacturation.** Quand un réseau de carte ou un prestataire notifie une rétrofacturation sur l'un de vos paiements, Wajub ouvre un litige pour elle. Il porte la référence du prestataire dans `provider_reference`, son code de motif dans `reason`, et le montant que le prestataire conteste, qui peut être inférieur au paiement. Il porte aussi un `due_date` : l'échéance du prestataire quand il en envoie une, sept jours après l'ouverture sinon. Un avis ultérieur pour la même rétrofacturation, avec le même `provider_reference`, met à jour son litige au lieu d'en ouvrir un second, même une fois qu'il est tranché. Une rétrofacturation qui arrive pendant qu'un litige du payeur ouvert depuis Pocket est en cours sur le paiement ouvre son propre litige. Le payeur ne peut pas faire passer une demande en litige pendant qu'une rétrofacturation est en cours sur le paiement, ni ouvrir un second litige depuis Pocket sur ce paiement. > [!WARNING] > **Les litiges n'existent pas en sandbox** > > Les litiges viennent de vrais payeurs et de vrais prestataires : un paiement de test n'en produit > donc jamais. Ce parcours ne peut pas être répété de bout en bout avant de passer en live. > Construisez votre handler à partir des payloads de cette page, puis vérifiez-le sur le premier > vrai litige que vous recevez. > [!NOTE] > **Le montant est bloqué tant que le litige est ouvert** > > Un litige ouvert depuis Pocket, sur un paiement que Wajub a encaissé pour vous, fait > passer le montant contesté de votre solde disponible à votre solde en litige, dans la limite de > votre solde disponible. Gagner le rend disponible. Perdre le débite, comme décrit plus bas. ## Les états d'un litige **Litige** `open` (en attente de vos justificatifs) → `under_review` (justificatifs reçus, en cours d'examen) → [`dispute.won`] `won` (vous gardez l'argent) L'autre issue, depuis open ou under_review: - `lost` (montant débité de votre solde) Un litige arrive en `open`. L'envoi de justificatifs le fait passer de lui-même en `under_review`, vous ne réglez pas ce statut vous-même. Depuis l'un ou l'autre de ces deux états, il peut se terminer en `won` ou en `lost`. Sur un litige ouvert depuis Pocket, les deux sont définitifs. C'est Wajub qui tranche un litige ouvert depuis Pocket, et la banque du payeur une rétrofacturation. Aucun endpoint ne vous permet de vous déclarer gagnant ; ce que vous pouvez faire, c'est présenter les justificatifs à ceux qui décident, ou concéder. ### Comment une rétrofacturation est tranchée La banque du payeur tranche une rétrofacturation, par l'intermédiaire du prestataire, et le litige suit la décision que le prestataire signale. Une décision fixe `status` et `resolved_at`, avec `metadata.decided_by` à `provider` et `metadata.provider_stage`, le nom de l'étape du prestataire qui a tranché. | Ce que signale le prestataire | Ce que devient le litige | | --------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Un gain | `open` ou `under_review` passe en `won` | | Une perte | `open`, `under_review` ou `won` passe en `lost` : une rétrofacturation gagnée peut encore être perdue à une étape ultérieure | | Une nouvelle étape de rétrofacturation qui reprend les fonds, après un gain | `won` repasse en `open` : `resolved_at` est effacé, `due_date` est fixé de nouveau, à l'échéance du prestataire ou sept jours plus tard, et `metadata.reopened_at` en garde la date | `lost` est définitif : un gain signalé après une perte ne change rien. Chaque changement envoie `dispute.updated`, avec `dispute.won` pour un gain, ou `dispute.lost` et `dispute.closed` pour une perte. Un litige rouvert n'envoie que `dispute.updated`, et son rappel d'échéance est envoyé de nouveau. ## Ce que coûte une perte Sur un paiement que Wajub a encaissé pour vous, un litige perdu retire le montant contesté de votre solde, plafonné à ce qui n'est pas déjà sorti par un remboursement sur le même paiement, pour que l'argent ne puisse pas être pris deux fois. Sur un paiement encaissé par votre propre compte chez un prestataire, Wajub ne détient pas l'argent, et le prestataire règle la rétrofacturation directement avec vous. Des **frais de litige forfaitaires** s'ajoutent, 15 000 XAF par défaut dans la devise du litige, quand la perte vient de l'API, avec `accept` ou `close`, ou d'une rétrofacturation du prestataire. Accepter depuis le Dashboard ne les facture pas. Perdre un litige de 25 000 XAF par l'API coûte donc 40 000 XAF, et non 25 000. Les débits ont lieu au changement de statut lui-même, pas lors d'un appel que vous feriez ensuite, et une seule fois par litige : une rétrofacturation perdue après un gain ou une réouverture n'est débitée qu'une fois. Un litige ne change pas le statut du paiement d'origine. Quand vous acceptez, le remboursement que Wajub crée pour le payeur est un remboursement ordinaire, avec ses propres événements `refund.*`, et il apparaît sur le paiement comme n'importe quel autre. Il ne retire pas le montant contesté une seconde fois. Si le payeur a payé les frais Wajub en plus du prix (`bearer: customer`), ces frais vous sont débités aussi, puisque le payeur récupère tout ce qu'il a payé. Le mouvement d'argent apparaît sur votre solde, et c'est là que vous le rapprochez. ## Les remboursements attendent la fin d'une rétrofacturation Tant qu'une rétrofacturation est `open` ou `under_review` sur un paiement, aucun remboursement de ce paiement n'est effectué : la banque du payeur peut rendre l'argent elle-même. `POST /refunds` répond `422` avec ce message : `Transaction cannot be refunded while a chargeback is open: the payer's bank may return the funds itself. It can be refunded again once the dispute is decided.` Accepter un litige du payeur sur le même paiement échoue avec la même réponse, et le litige reste tel quel, puisque l'accepter rembourse le payeur. Clôturer un paiement en plusieurs fois avec `outcome: refund` répond `409` avec le code `chargeback_open`. Un litige ouvert depuis Pocket ne bloque aucun remboursement. Les détails sont dans [Remboursements](https://docs.wajub.com/fr/payments/refunds#what-can-be-refunded). ## Dans le Dashboard **Litiges** les liste avec leur statut et le paiement concerné. Ouvrir un litige vous donne la description du payeur, le fil de messages, et les trois mêmes actions que l'API, plus une qu'elle n'expose pas : vous pouvez marquer ici un litige ouvert depuis Pocket comme gagné quand Wajub a tranché en votre faveur. Une rétrofacturation ne peut pas être marquée gagnée : son prestataire la tranche. La même liste porte les [demandes de remboursement](https://docs.wajub.com/fr/payments/refunds#refund-requests) que les payeurs envoient depuis Pocket, comme une étape à part. La section exige la permission `manage_disputes`, distincte de `manage_payments`, pour qu'un coéquipier puisse gérer les commandes sans pouvoir concéder un litige à votre place. ## Moins de litiges coûte moins cher que d'en gagner Un litige vous coûte du temps quelle qu'en soit l'issue, et le travail le plus rentable se fait donc avant qu'il n'existe. Remboursez de bon gré quand un client se plaint et que vous n'avez pas d'argument : un [remboursement](https://docs.wajub.com/fr/payments/refunds) que vous choisissez vous coûte le montant, un litige perdu vous coûte le montant plus les frais de litige forfaitaires. Gardez vos preuves de livraison là où vous pouvez les joindre en un clic. Et laissez [Shield](https://docs.wajub.com/fr/risk/shield) refuser les paiements les plus susceptibles de se retourner contre vous, puisqu'un paiement refusé d'emblée ne peut pas du tout être contesté. - [Shield, détection de fraude](https://docs.wajub.com/fr/risk/shield): Refusez les paiements risqués avant qu'ils puissent être contestés. - [Remboursements](https://docs.wajub.com/fr/payments/refunds): Rendez l'argent selon vos conditions, pas selon les siennes. - [Solde et règlements](https://docs.wajub.com/fr/payouts/balance): Où atterrit le débit d'un litige perdu. - [Webhooks](https://docs.wajub.com/fr/developer-tools/webhooks): Enregistrez un endpoint et vérifiez la signature des événements de litige. - [Bonnes pratiques de sécurité](https://docs.wajub.com/fr/best-practices/security): Limitez la fraude côté intégration. - [Référence API des litiges](https://docs.wajub.com/fr/api/disputes): Chaque champ de la ressource, et les six endpoints. --- # Répondre à un litige URL: https://docs.wajub.com/fr/payments/disputes/respond > Envoyer des justificatifs, concéder ou échanger avec le payeur. ## Répondre avec des justificatifs C'est cette étape qui décide de l'issue, et elle mérite d'être soignée. Chaque justificatif est classé sous un type, et vous pouvez faire plusieurs appels pour constituer votre dossier. `POST /disputes/{id}/submit-evidence` - `evidence_type` (enum, required): L'un de `customer_communication`, `proof_of_delivery`, `service_documentation`, `receipt`, `product_description`, `cancellation_policy`, `refund_policy`, `duplicate_charge_documentation`, `other`. - `evidence_text` (string): Votre argumentaire écrit pour ce justificatif, 2 000 caractères maximum. - `evidence_file` (file): Un seul fichier : PDF, JPG, JPEG, PNG, DOC, DOCX ou TXT, 10 Mo maximum. Envoyez l'appel en `multipart/form-data`. Le type est un emplacement, pas une étiquette. Envoyez deux appels avec `proof_of_delivery` et le second remplace le premier, il ne s'y ajoute pas. Utilisez un type différent pour chaque justificatif distinct, et mettez tout ce que vous voulez dire sur un justificatif dans cet unique appel. Envoyez un texte, un fichier, ou les deux : un appel sans l'un ni l'autre répond `422`, et le litige reste où il était. Sans fichier, le justificatif est enregistré sous la forme de votre seul texte : `evidence.proof_of_delivery` est alors une chaîne et non un objet. Le nom que vous aviez donné à un fichier revient dans `file_name`. Les fichiers sont privés : aucune adresse ne les ouvre d'elle-même. Chaque réponse de l'API qui renvoie le litige donne à chaque fichier, justificatifs comme pièces jointes des messages, une `url`, un lien signé valable 30 minutes. Passé ce délai, relisez le litige pour en obtenir un nouveau. Un webhook porte `file_path` sans lien. Comme un fichier est en jeu, il s'agit d'un envoi de formulaire et non d'un corps JSON. **Envoyer une preuve de livraison** ```bash curl https://api.wajub.com/disputes/dsp_hrgUOE225KMKULRQqYvlh/submit-evidence \ -H "Authorization: sk.xxxxxxxxxxxxxxxx…" \ -F "evidence_type=proof_of_delivery" \ -F "evidence_text=Delivered 12 Sept, signed for by the customer." \ -F "evidence_file=@/path/to/delivery-note.pdf" ``` ```javascript import { readFile } from 'node:fs/promises'; // Text alone goes through the SDK, as JSON. const dispute = await wajub.disputes.submitEvidence('dsp_hrgUOE225KMKULRQqYvlh', { evidence_type: 'proof_of_delivery', evidence_text: 'Delivered 12 Sept, signed for by the customer.', }); console.log(dispute.status); // A file needs multipart/form-data, which the SDK does not send. // Post the form yourself instead of the call above. const form = new FormData(); form.set('evidence_type', 'proof_of_delivery'); form.set('evidence_text', 'Delivered 12 Sept, signed for by the customer.'); form.set( 'evidence_file', new Blob([await readFile('./delivery-note.pdf')], { type: 'application/pdf' }), 'delivery-note.pdf', ); const response = await fetch('https://api.wajub.com/disputes/dsp_hrgUOE225KMKULRQqYvlh/submit-evidence', { method: 'POST', headers: { Authorization: process.env.WAJUB_API_KEY, Accept: 'application/json' }, body: form, }); if (!response.ok) { throw new Error('Evidence refused: ' + response.status); } const body = await response.json(); console.log(body.dispute.status); ``` ```python import os import httpx # Text alone goes through the SDK, as JSON. dispute = wajub.disputes.submit_evidence( "dsp_hrgUOE225KMKULRQqYvlh", { "evidence_type": "proof_of_delivery", "evidence_text": "Delivered 12 Sept, signed for by the customer.", }, ) print(dispute["status"]) # A file needs multipart/form-data, which the SDK does not send. # Post the form yourself instead of the call above. with open("delivery-note.pdf", "rb") as f: response = httpx.post( "https://api.wajub.com/disputes/dsp_hrgUOE225KMKULRQqYvlh/submit-evidence", headers={"Authorization": os.environ["WAJUB_API_KEY"], "Accept": "application/json"}, data={ "evidence_type": "proof_of_delivery", "evidence_text": "Delivered 12 Sept, signed for by the customer.", }, files={"evidence_file": ("delivery-note.pdf", f, "application/pdf")}, ) response.raise_for_status() print(response.json()["dispute"]["status"]) ``` ```php use GuzzleHttp\Client; // Text alone goes through the SDK, as JSON. $dispute = $wajub->disputes->submitEvidence('dsp_hrgUOE225KMKULRQqYvlh', [ 'evidence_type' => 'proof_of_delivery', 'evidence_text' => 'Delivered 12 Sept, signed for by the customer.', ]); echo $dispute['status']; // A file needs multipart/form-data, which the SDK does not send. // Post the form yourself instead of the call above, with the Guzzle // client the SDK already installed. $response = (new Client())->post( 'https://api.wajub.com/disputes/dsp_hrgUOE225KMKULRQqYvlh/submit-evidence', [ 'headers' => [ 'Authorization' => getenv('WAJUB_API_KEY'), 'Accept' => 'application/json', ], 'multipart' => [ ['name' => 'evidence_type', 'contents' => 'proof_of_delivery'], ['name' => 'evidence_text', 'contents' => 'Delivered 12 Sept, signed for by the customer.'], [ 'name' => 'evidence_file', 'contents' => fopen('delivery-note.pdf', 'r'), 'filename' => 'delivery-note.pdf', ], ], ], ); $body = json_decode((string) $response->getBody(), true); echo $body['dispute']['status']; ``` ```go // Text alone goes through the SDK, as JSON. dispute, err := client.Disputes.SubmitEvidence(context.Background(), "dsp_hrgUOE225KMKULRQqYvlh", map[string]any{ "evidence_type": "proof_of_delivery", "evidence_text": "Delivered 12 Sept, signed for by the customer.", }, nil) if err != nil { log.Fatal(err) } log.Println(dispute["status"]) // A file needs multipart/form-data, which the SDK does not send. // Post the form yourself instead of the call above. file, err := os.Open("delivery-note.pdf") if err != nil { log.Fatal(err) } defer file.Close() var form bytes.Buffer writer := multipart.NewWriter(&form) writer.WriteField("evidence_type", "proof_of_delivery") writer.WriteField("evidence_text", "Delivered 12 Sept, signed for by the customer.") part, err := writer.CreateFormFile("evidence_file", "delivery-note.pdf") if err != nil { log.Fatal(err) } if _, err := io.Copy(part, file); err != nil { log.Fatal(err) } writer.Close() req, err := http.NewRequest( http.MethodPost, "https://api.wajub.com/disputes/dsp_hrgUOE225KMKULRQqYvlh/submit-evidence", &form, ) if err != nil { log.Fatal(err) } req.Header.Set("Authorization", os.Getenv("WAJUB_API_KEY")) req.Header.Set("Accept", "application/json") req.Header.Set("Content-Type", writer.FormDataContentType()) res, err := http.DefaultClient.Do(req) if err != nil { log.Fatal(err) } defer res.Body.Close() log.Println(res.Status) ``` L'appel répond `200 OK` avec le litige dans son état actuel, déjà passé en `under_review`, et vos justificatifs regroupés sous `evidence`. ```json title="Réponse · 200 OK" { "code": 200, "status": "OK", "message": "Evidence submitted successfully", "dispute": { "id": "dsp_hrgUOE225KMKULRQqYvlh", "transaction": "trx_CSUGajfv9xh0XQ5wu2lx", "customer": "cus_sAaim5apjocIgtlhzJY3wQ8s", "amount": 25000, "currency": "XAF", "status": "under_review", "reason": "product_not_received", "evidence": { "proof_of_delivery": { "text": "Delivered 12 Sept, signed for by the customer.", "file_path": "…", "file_name": "delivery-note.pdf", "uploaded_at": "2026-09-11T12:04:00+00:00", "url": "https://…?signature=…" } }, "sandbox": false, "created_at": "2026-09-11T12:00:00+00:00" } } ``` Les justificatifs ne peuvent être déposés que tant que le litige est `open` ou `under_review`. Une fois en `won` ou `lost`, l'appel répond `422` et le dossier est clos. > [!WARNING] > **Les justificatifs restent chez Wajub** > > Quand le champ `evidence_reaches_provider` d'un litige vaut `false`, ce que > vous déposez est enregistré chez Wajub et lu par ceux qui tranchent un litige ouvert depuis Pocket. > Rien n'est transmis au prestataire ni au réseau de carte : pour une rétrofacturation, votre défense > doit passer par votre propre compte chez le prestataire. ## Concéder, et un appel qui ne fait pas ce que son nom laisse croire Si le payeur a raison, concédez tôt plutôt que de laisser traîner. `POST /disputes/{id}/accept` L'acceptation prend un `merchant_response` facultatif, 2 000 caractères maximum, enregistré sur le litige. Elle passe le litige en `lost` immédiatement, sans retour possible, et rend l'argent au payeur : Wajub crée un remboursement du montant contesté, plafonné à ce qui reste remboursable sur le paiement. Ce remboursement porte le motif `customer_complaint` et le motif du litige dans `metadata.dispute_reason`, et il rend au payeur tout ce qu'il a payé pour ce montant, y compris des frais qu'il aurait payés en plus. Si le remboursement ne peut pas être créé, l'appel échoue et le litige reste dans son état. Trois cas ne créent aucun remboursement, et le litige finit quand même `lost` : - **Une rétrofacturation.** La banque du payeur lui a déjà rendu l'argent : un remboursement paierait le payeur deux fois. - **Plus rien à rembourser.** Des remboursements antérieurs ont déjà rendu tout le paiement. - **Un litige dans une autre devise que son paiement.** Il n'y a pas de montant à rembourser dans la devise du paiement. > [!CAUTION] > **close, c'est accept sous un autre nom** > > `POST /disputes/{id}/close` n'est pas une façon neutre de ranger un litige. Il a exactement > le même effet que `accept` : le litige passe en `lost`, le payeur est remboursé sauf s'il s'agit > d'une rétrofacturation, et l'issue est définitive. Si vous cherchiez un appel qui classe un > litige en votre faveur, il n'en existe pas. Envoyez plutôt des justificatifs. ## Échanger avec le payeur Un litige porte un fil de messages, ouvert par la description du payeur lui-même. Vous pouvez y répondre. `POST /disputes/{id}/messages` Les messages prennent `content`, obligatoire et limité à 5 000 caractères, et un tableau `attachments` facultatif de fichiers soumis aux mêmes contraintes que les justificatifs. Chaque pièce jointe revient avec `file_name`, `file_path` et la même `url` valable 30 minutes. `POST /disputes/{id}/send-message` est un alias du même appel. Vos messages sont enregistrés avec un `sender_type` à `merchant`, ceux du payeur avec `customer`, et le fil complet est renvoyé lorsque vous récupérez le litige. Le fil reste ouvert après l'issue : un message sur un litige déjà `won` ou `lost` est accepté et enregistré, mais ne change rien au résultat. - [Suivre les litiges](https://docs.wajub.com/fr/payments/disputes/track): Les consulter, et leurs webhooks. - [Référence API des litiges](https://docs.wajub.com/fr/api/disputes): Tous les endpoints des litiges. --- # Suivre les litiges URL: https://docs.wajub.com/fr/payments/disputes/track > Consulter vos litiges et les suivre par leurs webhooks. ## Consulter les litiges Récupérer un litige le renvoie avec sa transaction, son client et son fil de messages complet. `GET /disputes/{id}` `GET /disputes` | Paramètre de requête | Valeurs acceptées | | ---------------------- | ---------------------------------------------------------- | | `per_page` | De 1 à 100, 25 par défaut | | `status` | `open`, `under_review`, `won`, `lost` | | `search` | Texte libre sur l'id, le motif et la description du litige | | `date_from`, `date_to` | Dates, `date_to` pas antérieure à `date_from` | | `cursor` | Passe à la pagination par curseur | Au-delà des champs évidents, un litige porte la `description` du payeur, votre `merchant_response`, les justificatifs que vous avez déposés dans `evidence`, `resolved_at` une fois tranché, et `metadata`. Sur une rétrofacturation, `metadata.source` vaut `provider_webhook`. Une fois qu'elle est tranchée par le prestataire, `metadata.decided_by` vaut `provider` et `metadata.provider_stage` donne le nom de l'étape du prestataire qui a tranché. Une rétrofacturation gagnée que le prestataire rouvre repasse en `open`, avec `resolved_at` effacé et `metadata.reopened_at` renseigné. Les règles sont dans [Litiges](https://docs.wajub.com/fr/payments/disputes#how-a-chargeback-is-decided). > [!NOTE] > **Comment due_date est fixé** > > Chaque litige porte `due_date`, l'échéance avant laquelle répondre. Sur un litige ouvert depuis > Pocket, c'est sept jours après l'ouverture. Sur une rétrofacturation, c'est l'échéance du > prestataire quand il en envoie une, sept jours après l'ouverture sinon. Passé son échéance, un > litige Pocket reste ouvert jusqu'à ce que Wajub tranche. ## Webhooks Sept événements, et ceux qui méritent une action sont les issues, plus le rappel. | Événement | Déclenché quand | | ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `dispute.created` | Un litige a été ouvert, par un payeur ou à partir d'une rétrofacturation. Lisez-le et décidez comment répondre | | `dispute.updated` | Un champ a changé, y compris à chaque changement de statut, et quand une rétrofacturation gagnée est rouverte (`status: open`) | | `dispute.won` | Résolu en votre faveur, rien ne quitte votre solde. Sur une rétrofacturation, le prestataire peut encore décider autrement plus tard | | `dispute.lost` | Résolu contre vous, le montant est débité. Sur une rétrofacturation, il peut suivre un `dispute.won` | | `dispute.closed` | Envoyé avec `dispute.lost`. Un litige gagné ne l'envoie pas | | `dispute.deadline_approaching` | L'échéance est dans deux jours et le litige est encore `open` ou `under_review`. Envoyé une seule fois, avec `metadata.reminded_at` renseigné, et de nouveau après la réouverture d'une rétrofacturation ; répondez maintenant | | `dispute.deleted` | L'enregistrement du litige a été supprimé | `dispute.deadline_approaching` est envoyé pour chaque litige qui a une `due_date` : litiges Pocket et rétrofacturations à l'identique. L'écriture de `metadata.reminded_at` sur le litige envoie aussi un `dispute.updated` à côté. > [!WARNING] > **Une perte vous envoie trois webhooks** > > Le passage en `lost` émet `dispute.updated`, `dispute.lost` et `dispute.closed`, dans cet ordre, > pour le même événement. Choisissez-en un pour agir, `dispute.lost`, et laissez passer les deux > autres. Agir aussi sur `dispute.closed` débitera deux fois votre propre comptabilité. > [!NOTE] > **Une rétrofacturation gagnée peut revenir** > > La banque du payeur peut trancher contre vous à une étape ultérieure d'une rétrofacturation que > vous aviez gagnée, ou reprendre les fonds : le litige passe alors en `lost`, ou repasse en `open`, > et envoie ses webhooks comme pour tout autre changement. Wajub ne débite une perte qu'une fois par > litige : continuez d'agir sur `dispute.lost` seul, même quand un `dispute.won` l'a précédé. **`dispute.created`**: Un payeur a ouvert un litige sur l'un de vos paiements. ```json title="dispute.created" { "id": "evt_Qp7Tz3Wk5Yb1NdLm2Xc94Rf8", "event": "dispute.created", "created": "2026-09-11T12:00:00+00:00", "livemode": true, "data": { "id": "dsp_hrgUOE225KMKULRQqYvlh", "transaction": "trx_CSUGajfv9xh0XQ5wu2lx", "customer": "cus_sAaim5apjocIgtlhzJY3wQ8s", "amount": 25000, "currency": "XAF", "status": "open", "reason": "product_not_received", "description": "Ordered on 2 Sept, nothing delivered." } } ``` Dédupliquez sur l'`id` de l'événement, comme partout ailleurs. L'enregistrement et la vérification de signature sont décrits dans [Webhooks](https://docs.wajub.com/fr/developer-tools/webhooks). - [Répondre à un litige](https://docs.wajub.com/fr/payments/disputes/respond): Justificatifs, concession, échange avec le payeur. - [Webhooks](https://docs.wajub.com/fr/developer-tools/webhooks): Recevoir et vérifier les événements. --- # Personnalisation URL: https://docs.wajub.com/fr/payments/link/customization > Ce que chaque lien hérite de votre compte, et ce que chacun contrôle de son côté. Votre **marque**, réglée une fois pour le compte, donne à chaque lien son logo, ses couleurs, sa police et son arrondi. Chaque **lien** contrôle son propre contenu : images, texte, bouton, questions, langues et personnes autorisées à l'ouvrir. ## Ce qui vient du compte, une fois pour toutes Le logo, la palette, la police, l'arrondi des angles et le mode d'apparence se trouvent dans **Paramètres → Image de marque**. Modifiez-les là et tous vos liens sont mis à jour d'un coup, en même temps que votre checkout hébergé et vos factures. Le tableau complet est sur [Checkout hébergé](https://docs.wajub.com/fr/payments/hosted-checkout#make-the-page-yours), puisque c'est le même réglage qui sert les trois. > [!NOTE] > **L'image de marque nécessite un plan payant** > > **Paramètres → Image de marque** dépend de la fonctionnalité Personnalisation du design, incluse à partir de **Growth**. Avec > Pay as you go, chaque lien garde l'apparence par défaut. Servir vos liens depuis votre propre > domaine plutôt que `wajub.link` est une fonctionnalité distincte, Domaine personnalisé, incluse à partir > de **Scale**. ## Ce qui appartient au lien Tout ce qui suit se règle lien par lien, et deux liens d'un même compte peuvent différer sur chacun de ces points. ### Images Le `poster` est la bannière en haut de la page, et `gallery` en contient jusqu'à dix autres, affichées en dessous. Pour un produit, c'est la différence entre une page qui vend et une page qui annonce un prix. Les deux voies n'acceptent pas la même chose. Le Dashboard téléverse des fichiers, JPEG, PNG, GIF ou WebP jusqu'à 10 Mo chacun, et les héberge pour vous. L'API prend des **URLs que vous hébergez déjà**, jusqu'à 2 048 caractères chacune, et ne téléverse jamais rien. Faites-les pointer vers des images que vous servez vous-même. ### Le bouton, et ce qui suit le paiement `cta_type` fixe le texte du bouton parmi `buy_now`, `pay`, `donate`, `register`, ou `custom` associé à votre propre `custom_cta_text` de 50 caractères maximum. `thank_you_message` remplace la confirmation par défaut une fois le paiement réussi. C'est la dernière chose que lit le payeur, c'est donc le bon endroit pour un délai de livraison ou une prochaine étape. ### Questions au payeur `extra_fields` ajoute des champs à la page : un numéro de table, une taille, une note pour la cuisine. Un champ a un `name`, en lettres minuscules, chiffres et tirets bas, un `label`, un `type` parmi `text`, `email`, `tel`, `textarea`, `select` et `checkbox`, un indicateur `required`, un `placeholder` facultatif, et pour un `select` ses `options`. Un lien accepte jusqu'à dix champs. La page demande en plus l'e-mail du payeur, toujours : un paiement sur un lien ne peut pas se faire sans. ```json title="Deux questions sur la page" { "extra_fields": [ { "name": "size", "label": "Size", "type": "select", "required": true, "options": ["S", "M", "L"] }, { "name": "note", "label": "Note to the seller", "type": "textarea", "required": false } ] } ``` Donnez à chaque champ un `name` et un `type`. Les réponses accompagnent le paiement, imbriquées et non aplaties : lisez `metadata.extra_fields.size` dans votre handler de webhook, pas `metadata.size`. ### Codes promo Un lien porte jusqu'à vingt codes promo, réglés dans le Dashboard. Chacun a un `code`, de 3 à 32 lettres majuscules, chiffres, tirets ou tirets bas, unique parmi vos liens, une remise en pourcentage ou en montant fixe, et en option un nombre maximal d'utilisations et une date d'expiration. Le payeur saisit le code sur la page et voit la remise avant de payer. ### Produits numériques Un produit `digital` est livré par e-mail une fois le paiement réussi : le payeur doit donc donner une adresse e-mail. Dans le Dashboard, vous téléversez le fichier, à partir du plan Growth, ou vous donnez une URL `https` vers lui, sur tous les plans ; `file_url` sur `POST /links` prend une adresse à vous, pas un fichier téléversé dans le Dashboard. Le bouton **Télécharger maintenant** de l'e-mail est un lien propre à ce paiement, jamais l'adresse du fichier lui-même, et la page ne montre le fichier qu'après le paiement. Le téléchargement fonctionne pendant la durée d'accès que vous fixez dans le Dashboard, ou sans limite si vous n'en fixez pas, même une fois le lien fermé ou archivé, et s'arrête quand le paiement est remboursé en totalité ou perdu dans un litige. Avec `single_use_access: true`, l'acheteur télécharge le fichier une seule fois : la page de téléchargement lui demande de le conserver, et une visite suivante indique que le téléchargement a déjà servi. C'est l'accès de l'acheteur, pas celui du lien : l'acheteur suivant peut toujours acheter, sauf si le lien est un [lien à usage unique](https://docs.wajub.com/fr/payments/link/tracking#how-a-link-closes). Quand `file_url` est votre propre adresse, l'acheteur y est envoyé : protégez-la comme tout téléchargement. ### Langues Un lien peut être bilingue. `supported_locales` liste les langues que la page propose parmi `fr` et `en`, `default_locale` indique celle qui s'affiche en premier, et `translations` contient l'autre version, indexée par langue. ```json title="Le même lien, en deux langues" { "default_locale": "fr", "supported_locales": ["fr", "en"], "translations": { "en": { "title": "Amina Coffee, 250 g", "description": "Roasted in Douala, ground to order.", "custom_cta_text": "Order now", "thank_you_message": "Thank you, we ship within 48 hours." } } } ``` Seuls quatre champs se traduisent : `title`, `description`, `custom_cta_text` et `thank_you_message`. Les champs de base du lien sont ceux qu'affiche la langue par défaut, vous n'écrivez donc jamais que la seconde langue dans `translations`. ### Devises `supported_currencies` permet au payeur de changer de devise sur la page. La `currency` propre au lien est toujours proposée, et les devises que vous ajoutez viennent s'y joindre. ### Qui peut entrer Cinq verrous indépendants, et la page se ferme dès que l'un d'eux se déclenche. | Réglage | Réponse de la page | | ---------------------------------------- | ------------------------------------------------ | | `is_public` mis à `false` | `404`, le lien n'est pas publié | | `access_password` | Une demande de mot de passe avant tout affichage | | `max_views` atteint | `410`, le plafond de vues est épuisé | | `expiry_date` dépassée, ou `is_archived` | `410`, le lien est terminé | | `single_use_link`, une fois payé | Que le lien a déjà servi à payer | Une tentative bloquée n'est pas comptée comme une vue : le verrou du mot de passe n'entame donc pas `max_views`. ### Ce que chaque type ajoute Le type apporte ses propres réglages, qui n'existent que sur ce type. | Type | Ce que vous pouvez régler | | ------------- | ----------------------------------------------------------------------------------------------------------------------------------------- | | `product` | `product_variants`, stock, livraison, poids, et pour un service la durée, le lieu et l'URL de réunion | | `event` | Types de billets avec leur propre nom, prix et quantité, `event_capacity`, `generate_qr_tickets`, `attendee_info_fields`, `refund_policy` | | `fundraising` | `show_progress`, `show_contributors`, `allow_overflow`, `impact_tiers`, `campaign_deadline`, `fundraising_milestones` | | `donation` | `suggested_amounts`, `allow_custom_amount`, `min_amount`, `max_amount`, `allow_anonymous`, `show_donor_wall` | L'URL de réunion d'un service n'est jamais sur la page avant le paiement : le payeur la reçoit dans l'e-mail de confirmation de son paiement, avec ce qu'il faut préparer, et la page propose de la rejoindre une fois le paiement fait. ## Ce que l'API peut régler, et ce qu'elle ne peut pas C'est ce qu'il faut savoir avant d'automatiser quoi que ce soit. L'API et le Dashboard n'atteignent pas les mêmes champs, et `POST /links` en atteint davantage que `PUT /links/{id}`. | Champ | Création via l'API | Mise à jour via l'API | Dashboard | | -------------------------------------------------------------------- | ------------------ | --------------------- | ---------------------------- | | `title`, `description`, `price` | Oui | Oui | Oui | | `currency` | Oui | Non | Oui | | `target_amount`, `min_amount`, `max_amount` | Oui | Oui | Oui | | `callback_url` | Oui | Oui | Non | | `cta_type`, `custom_cta_text` | Oui | Oui | Oui | | `custom_url`, `tags` | Oui | Oui | Oui | | `category_id` | Non | Non | Oui | | `is_public`, `is_archived`, `expiry_date`, `sales_limit` | Oui | Oui | Oui | | `accept` (moyens de paiement proposés) | Oui | Oui | Oui | | `extra_fields`, `thank_you_message` | Oui | Non | Oui | | `poster`, `gallery` | Oui, en URLs | Non | Oui, en fichiers téléversés | | `allow_overflow`, sur une collecte | Oui | Oui | Oui | | Autres champs propres au type, événement et collecte de fonds | Oui | Non | Oui | | `supported_locales`, `default_locale`, `translations` | Non | Non | Oui | | `supported_currencies` | Non | Non | Oui | | `access_password`, `max_views` | Non | Non | Oui | | `single_use_link`, `single_use_access` | Oui | Non | Oui | | `file_url`, le fichier d'un produit numérique à votre propre adresse | Oui | Non | Oui, ou un fichier téléversé | | Codes promo | Non | Non | Oui | | Domaine personnalisé, types de billets | Non | Non | Oui | > [!WARNING] > **La mise à jour via l'API est plus restreinte que la création** > > `PUT /links/{id}` ignore les champs marqués Non dans la colonne Mise à jour via l'API, et répond > tout de même `200`. Modifiez-les dans le Dashboard. ## Dans le Dashboard Les langues, les devises, le mot de passe d'accès, le plafond de vues, le domaine personnalisé et les types de billets d'un événement ne se règlent que dans le Dashboard, dans le formulaire du lien. Le guide du tableau de bord montre [comment créer un lien](https://docs.wajub.com/dashboard/payment-links/create) et [comment le modifier](https://docs.wajub.com/dashboard/payment-links/edit-offline-delete#edit). Chaque lien a aussi ses propres endpoints de webhook, distincts de ceux de votre compte, avec leur propre secret, un envoi de test et une nouvelle tentative. Utilisez-les quand une campagne doit prévenir un système que le reste de votre compte ne prévient pas. Une livraison ne compte que si l'endpoint répond par un `2xx` : toute autre réponse, une redirection comprise, est enregistrée comme échouée et retentée, et une redirection n'est jamais suivie. L'envoi de test indique seulement si l'endpoint l'a accepté. Le guide du tableau de bord montre [où en ajouter un](https://docs.wajub.com/dashboard/payment-links/notify-server). - [Liens de paiement](https://docs.wajub.com/fr/payments/link): Ce qu'est le produit, et quand un lien vaut mieux qu'une intégration. - [Démarrage rapide](https://docs.wajub.com/fr/payments/link/quickstart): Créez un lien, publiez-le, partagez-le. - [Suivi et conversions](https://docs.wajub.com/fr/payments/link/tracking): Vues, taux de conversion et cycle de vie d'un lien. - [Image de marque du Checkout hébergé](https://docs.wajub.com/fr/payments/hosted-checkout): Les réglages du compte dont hérite chaque page de paiement. - [Référence API des liens de paiement](https://docs.wajub.com/fr/api/payment-links): Chaque champ accepté par l'API, endpoint par endpoint. --- # Liens de paiement URL: https://docs.wajub.com/fr/payments/link > Encaissez depuis une URL que vous partagez, sans intégration et sans page à vous. Un lien de paiement est une URL qui encaisse de l'argent : vous décrivez ce que vous vendez, Wajub héberge la page, et vous partagez l'adresse là où se trouvent vos clients. Ni code ni serveur à vous. ## Quand un lien vaut mieux qu'une intégration Optez pour un lien quand ce que vous vendez ne justifie pas un checkout, ou quand il n'existe aucun site où placer un checkout. Une boutique qui vend sur WhatsApp sans vitrine en ligne. Une facture ponctuelle pour un seul client. Des billets pour un événement le mois prochain. Une collecte de fonds qui a besoin d'une barre de progression et d'un mur des donateurs. Un consultant qui prend un acompte avant une réservation. Optez plutôt pour le [Checkout hébergé](https://docs.wajub.com/fr/payments/hosted-checkout) dès que le paiement conclut un parcours piloté par votre logiciel : un panier, une commande, un abonnement. Un lien ne sait rien de votre commande, et ne peut pas être créé au moment où un client en a besoin, sauf si vous appelez l'API. ## Quatre types de lien Le type n'est pas une étiquette, il change la page. Choisissez celui qui correspond à ce que vous encaissez. | Type | La page affiche | Choisissez-le quand | | ------------- | ---------------------------------------------------------------- | ---------------------------------------------- | | `product` | Un prix fixe et un bouton d'achat | Vous vendez une seule chose à un seul prix | | `event` | Une date, un lieu, un nombre de billets | Vous vendez l'accès à quelque chose qui a lieu | | `fundraising` | Un objectif, sa progression, et éventuellement les contributeurs | Vous collectez en vue d'un total | | `donation` | Un montant libre, dans des bornes que vous pouvez fixer | Le payeur décide de ce qu'il donne | Un lien `product` porte aussi un `product_type`, parmi `physical`, `digital` ou `service`, qui fait apparaître sur la page les champs de stock, de livraison ou de réservation. ## Deux façons d'en créer un **Le Dashboard** est la voie normale. **Liens → Créer un lien** parcourt les champs avec un aperçu en direct, génère le QR code, et publie quand vous êtes prêt. Rien sur cette page ne nécessite un développeur. **L'API** sert quand les liens sont produits par votre propre logiciel : un par client, un par campagne, un par commande. Même objet, même page. `POST /links` La liste complète des champs, ceux qui sont obligatoires selon le type, et les pièges à connaître sont dans le [Démarrage rapide](https://docs.wajub.com/fr/payments/link/quickstart). > [!CAUTION] > **Deux points qui vont vous piéger** > > Les liens sont **uniquement en production**. Il n'existe pas d'équivalent en sandbox, le premier > lien que vous créez encaisse donc de l'argent réel : une clé de test reçoit `403` sur tout appel > à `/links`, avec `This feature is only available in live mode.` Et un lien **est en ligne dès sa > création** : `is_public` vaut `true` par défaut, l'URL renvoyée est donc immédiatement ouverte aux > payeurs. Envoyez `is_public: false` pour préparer un lien et le publier quand vous êtes prêt. ## Ce que cela implique pour votre plan Les liens de paiement nécessitent la fonctionnalité Liens de paiement. **Pay as you go** les inclut, avec un plafond de 25 liens actifs ; Growth et les plans supérieurs suppriment ce plafond. Créer un lien au-delà de votre plafond répond `403` avec un message de mise à niveau, plutôt que d'échouer en silence. Les liens archivés comptent dans ce plafond : supprimez un lien, plutôt que de l'archiver, pour libérer sa place. Par défaut, un lien est servi depuis `wajub.link`. Sur Scale, un domaine personnalisé vérifié le sert à la place, et l'adresse que voit le payeur est la vôtre. ## Ce que vous obtenez en retour Un lien produit des paiements ordinaires, sur les mêmes canaux que tout le reste : MTN, Orange, Wave, Airtel, Moov, M-Pesa, et les cartes là où le pays les prend en charge. La matrice complète est dans [Moyens de paiement](https://docs.wajub.com/fr/payments/payment-methods). Il n'y a donc pas de rapprochement séparé. Le paiement arrive dans votre liste Payments, déclenche `payment.succeeded`, est réglé sur votre solde et peut être remboursé comme n'importe quel autre. Ce que le lien ajoute par-dessus, c'est la page, le partage, et des statistiques par lien. | Besoin | Où | | ------------------------------------------------ | ------------------------------------------------ | | Créer votre premier lien | [Démarrage rapide](https://docs.wajub.com/fr/payments/link/quickstart) | | Modifier l'apparence de la page | [Personnalisation](https://docs.wajub.com/fr/payments/link/customization) | | Voir les vues, les conversions et la vie du lien | [Suivi](https://docs.wajub.com/fr/payments/link/tracking) | | Chaque champ de la ressource | [Référence API](https://docs.wajub.com/fr/api/payment-links) | - [Démarrage rapide Liens de paiement](https://docs.wajub.com/fr/payments/link/quickstart): Créez un lien, publiez-le, partagez-le, soyez prévenu quand quelqu'un paie. - [Personnalisation](https://docs.wajub.com/fr/payments/link/customization): Couleurs de marque, logo, et champs de la page. - [Suivi et conversions](https://docs.wajub.com/fr/payments/link/tracking): Vues, taux de conversion, et vie d'un lien. - [Choisir une intégration](https://docs.wajub.com/fr/payments/integration-paths): Les quatre modes comparés, et quand un lien n'est pas le bon choix. - [Moyens de paiement](https://docs.wajub.com/fr/payments/payment-methods): Les opérateurs que voient vos payeurs, pays par pays. - [Webhooks](https://docs.wajub.com/fr/developer-tools/webhooks): Écoutez payment.succeeded et livrez la commande automatiquement. --- # Démarrage rapide URL: https://docs.wajub.com/fr/payments/link/quickstart > Créez un lien de paiement, partagez-le, et encaissez sans écrire d'intégration. Créez un lien, partagez son adresse, et soyez prévenu par webhook quand quelqu'un paie, sans écrire d'intégration. > [!WARNING] > **Production uniquement, et soumis au plan** > > Les liens de paiement n'existent pas dans la sandbox. Chaque lien est actif et encaisse de > l'argent réel dès le premier partage : pour tester, vous payez un petit montant réel que vous > remboursez ensuite. La fonctionnalité Liens de paiement doit aussi figurer dans votre plan : **25 > liens avec Pay as you go**, illimités à partir de Growth. Au-delà du plafond, la création répond > `403` avec un message de mise à niveau. Une clé de test (`sk_test.`) reçoit `403` sur tout appel à > `/links`, avec `This feature is only available in live mode.` ## 1. Choisissez l'usage du lien Le `type` détermine la forme de la page et les champs qui deviennent obligatoires. Il en existe quatre, et le choix n'est pas cosmétique : un lien de collecte de fonds affiche une barre de progression, un lien d'événement affiche une date et un lieu. | Type | Ce que voit le payeur | Ce qu'il exige | | ------------- | ----------------------------------------------- | ------------------------------------------------------ | | `product` | Un prix fixe que vous définissez | `price` | | `event` | Une date, un lieu, un nombre de billets | `event_start_date`, `event_location`, `event_timezone` | | `fundraising` | Une campagne avec un objectif et sa progression | `target_amount` | | `donation` | Un montant libre, ou borné par vous | Rien de plus que l'essentiel | Au-delà du type, chaque lien a besoin d'un `title` d'au moins trois caractères, d'une `currency`, et d'un `cta_type` qui fixe le libellé du bouton : `buy_now`, `pay`, `donate`, `register`, ou `custom` avec votre propre `custom_cta_text`. Un lien `product` exige aussi un `product_type`, parmi `physical`, `digital` ou `service`, qui fait apparaître plus bas les champs de stock, de livraison ou de réservation. ## 2. Créez-le Le Dashboard est la voie la plus rapide : **Liens → Créer un lien** parcourt les mêmes champs avec un aperçu à côté. Ce qui suit est l'équivalent par l'API, pour le cas où les liens sont générés par votre propre logiciel. `POST /links` - `type` (enum, required): `product`, `event`, `fundraising` ou `donation`. - `product_type` (enum): Obligatoire pour un `product` : `physical`, `digital` ou `service`. - `title` (string, required): Affiché comme titre de la page. Trois caractères minimum. - `currency` (string, required): Code ISO 4217, la devise dans laquelle chaque paiement de ce lien est encaissé. - `cta_type` (enum, required): Libellé du bouton : `buy_now`, `pay`, `donate`, `register` ou `custom`. - `price` (number): Obligatoire pour un `product`. Le montant fixe débité au payeur. - `target_amount` (number): Obligatoire pour `fundraising`. L'objectif que remplit la barre de progression. - `min_amount` (number): Plancher du montant libre, sur une `donation`. - `max_amount` (number): Plafond du montant libre, sur une `donation`. - `custom_url` (string): Votre propre slug à la place de celui généré : lettres, chiffres, traits d'union et underscores. Unique sur tout Wajub, liens supprimés compris : un slug déjà pris par un autre marchand, ou par un lien que vous avez supprimé, répond `422` sur `custom_url`. - `external_reference` (string): Votre propre référence pour le lien, jusqu'à 255 caractères. Renvoyée telle quelle, jamais montrée aux payeurs. - `description` (string): Texte principal de la page, 5 000 caractères maximum. - `callback_url` (string (url)): Où le payeur est envoyé une fois le paiement terminé : après une réussite, et aussi quand il annule sur la page. Lisez `status` dans la chaîne de requête. - `expiry_date` (string (date)): Date à laquelle le lien cesse d'accepter des paiements. Doit être dans le futur. - `sales_limit` (integer): Le nombre d'unités que le lien peut vendre. Chaque paiement compte sa quantité, et un paiement encore en cours réserve ses unités jusqu'à ce qu'il réussisse ou expire. - `extra_fields` (array): Questions posées sur la page. Détaillé à l'étape suivante. - `is_public` (boolean, default `true`): Indique si la page s'ouvre à son URL. Envoyez `false` pour créer le lien hors ligne : il répond alors `404` aux payeurs jusqu'à sa publication. Envoyez-le avec la clé secrète. Les liens n'existent qu'en live, la clé est donc `sk.` et non `sk_test.`. **Créer un lien de type product** ```bash curl https://api.wajub.com/links \ -H "Authorization: sk.xxxxxxxxxxxxxxxx…" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: link-cafe-amina" \ -d '{ "type": "product", "product_type": "physical", "title": "Café Amina, 250 g", "currency": "XAF", "price": 3500, "cta_type": "buy_now", "custom_url": "cafe-amina", "is_public": true }' ``` ```javascript const link = await wajub.links.create({ type: 'product', product_type: 'physical', title: 'Café Amina, 250 g', currency: 'XAF', price: 3500, cta_type: 'buy_now', custom_url: 'cafe-amina', is_public: true, }); console.log(link.url); ``` ```python link = wajub.links.create({ "type": "product", "product_type": "physical", "title": "Café Amina, 250 g", "currency": "XAF", "price": 3500, "cta_type": "buy_now", "custom_url": "cafe-amina", "is_public": True, }) print(link.url) ``` ```php $link = $wajub->links->create([ 'type' => 'product', 'product_type' => 'physical', 'title' => 'Café Amina, 250 g', 'currency' => 'XAF', 'price' => 3500, 'cta_type' => 'buy_now', 'custom_url' => 'cafe-amina', 'is_public' => true, ]); echo $link->url; ``` ```go link, err := client.Links.Create(context.Background(), map[string]any{ "type": "product", "product_type": "physical", "title": "Café Amina, 250 g", "currency": "XAF", "price": 3500, "cta_type": "buy_now", "custom_url": "cafe-amina", "is_public": true, }, nil) ``` La réponse est `201 Created`, et `url` est ce que vous cherchiez : l'adresse que vous partagez, construite à partir de votre `custom_url` si vous en avez défini un, et de l'id généré sinon. ```json title="Réponse · 201 Created" { "code": 201, "status": "Created", "message": "Payment link created", "link": { "id": "8kD2xQpLm", "type": "product", "product_type": "physical", "title": "Café Amina, 250 g", "currency": "XAF", "price": 3500, "cta_type": "buy_now", "custom_url": "cafe-amina", "url": "https://wajub.link/cafe-amina", "qr_url": null, "is_public": true, "is_archived": false, "tags": [], "created_at": "2026-09-11T14:00:00+00:00" } } ``` > [!CAUTION] > **Un lien est en ligne dès sa création** > > `is_public` vaut `true` par défaut : l'URL renvoyée encaisse de l'argent réel dès que vous > l'avez. Envoyez `is_public: false` pour créer le lien hors ligne : il répond alors `404 This > payment link is not available` à tous ceux qui l'ouvrent, jusqu'à ce que vous le publiiez avec > `PUT /links/{id}` ou depuis la page du lien dans le Dashboard. Le Dashboard crée lui aussi les > liens en ligne, et expose le même indicateur sous le nom Status du lien. > [!WARNING] > **Le QR code vient du Dashboard** > > `qr_url` peut valoir `null` sur un lien créé par l'API. Téléchargez le QR code depuis la page du > lien dans le Dashboard, ou générez-le vous-même à partir de `url`. > [!NOTE] > **Un id de lien n'a pas de préfixe comme le reste de l'API** > > Les paiements sont `trx_…`, les clients `cus_…`, mais un id de lien est une chaîne nue de neuf > caractères comme `8kD2xQpLm`, parce qu'il sert aussi de slug dans l'URL. Définissez `custom_url` > et c'est votre slug qui apparaît dans l'adresse à la place ; l'id reste ce que vous passez à > `GET /links/{id}`. ## 3. Posez une question au payeur, si besoin Un numéro de table, une taille de T-shirt, une note de livraison : `extra_fields` ajoute des champs à la page et transmet les réponses jusqu'au paiement. ```json title="Deux questions sur la page" { "extra_fields": [ { "name": "table", "label": "Table number", "type": "text", "required": true }, { "name": "note", "label": "Note to the kitchen", "type": "textarea", "required": false } ] } ``` Un champ a besoin d'un `name` et d'un `type` : le `name` est la clé sous laquelle sa réponse revient, et le `type` est le champ de saisie que la page affiche. [Personnalisation](https://docs.wajub.com/fr/payments/link/customization#questions-for-the-payer) liste les types et les autres options. Ce que le payeur saisit revient sur le paiement, imbriqué sous ses métadonnées plutôt qu'étalé dessus : c'est donc dans `metadata.extra_fields.table` que se trouve le numéro de table. Lisez-le là dans votre handler de webhook, et vous avez la réponse à côté de l'argent. ## 4. Partagez-le L'`url` fonctionne partout où une URL fonctionne : un message WhatsApp, une bio, un SMS, une affiche imprimée. Rien à intégrer, et aucune page à vous n'intervient. Pour une affiche, le Dashboard vous donne le QR code sur la page du lien, prêt à télécharger. Par défaut, un lien est hébergé sur `wajub.link`. Avec le plan Scale, un domaine personnalisé vérifié le sert à la place, et l'adresse que voit le payeur est la vôtre. Sur la page, le payeur voit les opérateurs disponibles dans son pays, la même liste que propose le checkout hébergé : MTN, Orange, Wave, Airtel, Moov, M-Pesa et les cartes là où le pays les prend en charge. La matrice complète est dans [Moyens de paiement](https://docs.wajub.com/fr/payments/payment-methods). ## 5. Soyez prévenu quand quelqu'un paie Un lien produit des paiements ordinaires. Il n'existe pas d'événement `link.paid` : ce que vous écoutez, c'est `payment.succeeded`, exactement comme pour les autres modes. | Événement | Déclenché quand | | ------------------- | ------------------------------------------------------------- | | `payment.succeeded` | Quelqu'un a payé via le lien. Livrez la commande sur celui-ci | | `link.created` | Un lien a été créé | | `link.updated` | Un lien a été modifié, archivé ou désarchivé | | `link.deleted` | Un lien a été supprimé | | `link.expired` | L'`expiry_date` d'un lien est passée | Définir un `callback_url` renvoie ensuite le payeur vers votre page, mais c'est une attention pour lui, pas un signal pour vous. Considérez le webhook comme la source de vérité, comme toujours. [Webhooks](https://docs.wajub.com/fr/developer-tools/webhooks) couvre l'enregistrement et la vérification de signature. ## Fermer un lien Trois façons différentes, selon ce que vous entendez par fermer. | Vous voulez | Définissez | | ------------------------------------------------------------- | ----------------------- | | Qu'il s'arrête à une date | `expiry_date` | | Qu'il s'arrête après N ventes | `sales_limit` | | Qu'il s'arrête après une vente, avec un seul payeur à la fois | `single_use_link: true` | Un lien peut aussi être archivé avec `is_archived` via `PUT /links/{id}`, ce qui le retire de vos listes sans détruire ce qu'il a déjà encaissé. `DELETE /links/{id}` le supprime purement et simplement. ## Dans le Dashboard **Liens**, c'est tout le produit sans l'API, et il montre ce que l'API n'expose pas : les vues et la conversion de chaque lien, les paiements qu'il a produits et les personnes qui ont payé, exportables. Le guide du tableau de bord le couvre, de [la création d'un lien](https://docs.wajub.com/dashboard/payment-links/create) à [son suivi](https://docs.wajub.com/dashboard/payment-links/track). La section exige la fonctionnalité Liens de paiement dans le plan et la permission `view_links` ou `manage_links`, et elle est entièrement masquée tant que vous êtes en sandbox. - [Vue d'ensemble des liens de paiement](https://docs.wajub.com/fr/payments/link): Ce qu'est le produit, et quand un lien vaut mieux qu'une intégration. - [Personnalisation](https://docs.wajub.com/fr/payments/link/customization): Couleurs de marque, logo, et champs de la page. - [Suivi et conversions](https://docs.wajub.com/fr/payments/link/tracking): Vues, taux de conversion, et vie d'un lien. - [Moyens de paiement](https://docs.wajub.com/fr/payments/payment-methods): Les opérateurs que voient vos payeurs, pays par pays. - [Webhooks](https://docs.wajub.com/fr/developer-tools/webhooks): Enregistrez un endpoint et vérifiez la signature. - [Référence API des liens de paiement](https://docs.wajub.com/fr/api/payment-links): Chaque champ de la ressource, et les cinq endpoints. --- # Suivi et conversions URL: https://docs.wajub.com/fr/payments/link/tracking > Ce qu'un lien mesure vraiment, où trouver ces chiffres, et comment il se ferme. L'API vous dit si un lien est toujours ouvert ; seul le Dashboard montre ses performances. ## L'API n'a pas de compteurs `GET /links/{id}` renvoie ce que le lien *est*, jamais ses *performances* : ni vues, ni conversions, ni revenus. `GET /links/{id}` **Récupérer un lien** ```bash curl https://api.wajub.com/links/8kD2xQpLm \ -H "Authorization: sk.xxxxxxxxxxxxxxxx…" ``` ```javascript const link = await wajub.links.retrieve('8kD2xQpLm'); console.log(link.is_public, link.is_archived, link.expiry_date); ``` ```python link = wajub.links.retrieve("8kD2xQpLm") print(link.is_public, link.is_archived, link.expiry_date) ``` ```php $link = $wajub->links->retrieve('8kD2xQpLm'); echo $link->url; ``` ```go link, err := client.Links.Retrieve(context.Background(), "8kD2xQpLm") if err != nil { log.Fatal(err) } log.Println(link["url"], link["is_public"]) ``` La réponse est l'état du lien, et c'est ce que vous interrogez pour savoir s'il encaisse toujours. ```json title="Réponse · 200 OK" { "code": 200, "status": "OK", "message": "Payment link retrieved", "link": { "id": "8kD2xQpLm", "type": "product", "title": "Café Amina, 250 g", "url": "https://wajub.link/cafe-amina", "currency": "XAF", "price": 3500, "is_public": true, "is_archived": false, "expiry_date": null, "sales_limit": null, "created_at": "2026-09-11T14:00:00+00:00" } } ``` La liste fonctionne de la même façon. Elle accepte `per_page`, `search`, `archived` pour voir les liens archivés plutôt que les liens actifs, `only_public`, `type` (`product`, `event`, `fundraising` ou `donation`), et `sort_by` (`created_at`, `updated_at`, `title` ou `type`) avec `sort_dir` (`desc` ou `asc`). La liste suit le tri en premier, puis du plus récent au plus ancien entre liens à égalité. Pour les exports, un `cursor` parcourt la liste dans son ordre par défaut, du plus récent au plus ancien : avec un autre tri, la liste est paginée par numéro et ne porte pas de curseur. Un `type`, un `sort_by` ou un `sort_dir` hors de ces valeurs renvoie une `422` sur ce champ, comme un `per_page` hors limites. `GET /links` ## Ce qui est réellement mesuré Chaque visite qui passe les verrous d'accès est comptée, avec sa provenance (le referrer HTTP), le pays du visiteur et son type d'appareil. Les visiteurs uniques sont comptés **par jour** : la même personne qui visite deux jours différents compte donc pour deux visiteurs uniques. Lisez ce nombre comme « uniques par jour », pas comme un nombre de personnes. > [!NOTE] > **Une visite bloquée n'est pas une vue** > > Quand un lien est protégé par mot de passe, une tentative dont le mot de passe échoue n'est pas > comptée. Une visite sur un lien non publié, expiré ou dont le plafond de vues est atteint ne l'est > pas non plus. Le compteur n'avance que pour les visites qui ont réellement atteint la page, et c'est > ce qui fait de `max_views` un plafond fiable. ## Les chiffres, et où les lire **Liens → un lien → Vue d'ensemble** est le seul endroit où ils apparaissent. **Total des vues**, **Total des ventes** et **Revenu total** couvrent toute la vie du lien, et **Taux de conversion** rapporte ces ventes à ses visiteurs. La période choisie, les 7, 14, 30 ou 90 derniers jours, ne change que les graphiques : les barres sous chaque total et **Tendances des visites et des ventes**. La transaction moyenne, les vues par transaction, les principaux pays et les appareils couvrent toujours les 30 derniers jours. > [!WARNING] > **Le taux de conversion se calcule par visiteur, pas par vue** > > Le chiffre vaut `transactions ÷ unique visitors`, et non `transactions ÷ views`. Une page ouverte > quatre fois avant le paiement compte pour un visiteur et une conversion : le taux paraît donc plus > élevé qu'avec un calcul par vue. Comparez-le à lui-même dans le temps plutôt qu'à un chiffre venant > d'un autre outil. ## Attribuer un canal Aucun paramètre d'URL ne marque une visite. Un `?src=whatsapp` sur l'URL partagée n'est transmis nulle part : il n'atteint pas le paiement, il n'est pas enregistré sur la vue, et il n'apparaîtra dans aucun rapport. Vous disposez à la place de deux choses qui fonctionnent. Le **referrer** est capturé automatiquement : le trafic qui en porte un, depuis un lien dans une publication ou une page, affiche déjà son origine dans les statistiques. Le trafic venant de WhatsApp, d'un SMS ou d'un QR code n'a pas de referrer, et c'est en pratique l'essentiel du trafic. Donc, pour tout ce que vous devez vraiment attribuer, **créez un lien par canal**. Même produit, même prix, `custom_url` différente : `wajub.link/cafe-whatsapp`, `wajub.link/cafe-instagram`. Chacun garde ses propres vues, son propre taux de conversion et son propre chiffre d'affaires, et la comparaison est exacte plutôt que déduite. Un paiement fait sur un lien le désigne : son champ `link` est l'`id` du lien, dans l'API et dans les webhooks `payment.*`, si bien que votre handler sait de quel lien, donc de quel canal, vient l'argent. `GET /payments` n'a pas de filtre par lien : pour lister les paiements d'un lien, lisez **Liens → un lien → Transactions** dans le Dashboard, ou gardez le `link` de chaque paiement à son arrivée. ## Comment un lien se ferme Cinq réglages mettent fin à la vie d'un lien, et ils ne le ferment pas de la même façon. | Réglage | Ferme | Le payeur obtient | | ----------------------- | ------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------- | | `expiry_date` | La page, au moment que vous choisissez | `410`, avant tout affichage | | `is_archived` | La page, immédiatement | `410`, avant tout affichage | | `sales_limit` | Le paiement, pas la page | `422` au moment de payer, `This payment link has reached its sales limit.` | | `single_use_link` | La page, après son premier paiement réussi | Une page qui indique que le lien a déjà servi à payer | | `allow_overflow: false` | Les dons d'une collecte, une fois son objectif atteint | Une page qui indique que la collecte a atteint son objectif ; `410` avec `error_code: goal_reached` au moment de payer | La différence compte. Un lien expiré ou archivé ne s'ouvre jamais : le payeur voit une page fermée et tout s'arrête là. Un lien qui a atteint son plafond de ventes **s'ouvre toujours normalement**, affiche le produit et le bouton, et ne refuse qu'au moment du paiement. Si vous vendez une quantité fixe, attendez-vous à ce que des payeurs tombent sur ce message plutôt que sur une page fermée. Un lien à usage unique accepte un seul payeur à la fois. Pendant que quelqu'un paie par ce lien, un autre payeur apprend qu'un paiement par ce lien est en cours, et que le lien rouvre si ce paiement n'aboutit pas. Une fois un paiement réussi, le lien reste fermé, même si vous le remboursez. Aucun champ du lien n'indique qu'il est fermé : `payment.succeeded`, dont le `link` est l'`id` du lien, est votre signal. Si un second paiement aboutit malgré tout par ce lien, comme une tentative antérieure que l'opérateur confirme en retard, le propriétaire, les administrateurs et les membres finance de votre équipe reçoivent un e-mail qui nomme le paiement à rembourser : Wajub ne le rembourse pas de lui-même. Une collecte dont `allow_overflow` est désactivé n'accepte plus de dons une fois que ce qu'elle a gardé atteint `target_amount`. Le don qui franchit l'objectif passe ; le checkout suivant répond `410` avec `error_code: goal_reached`, et la page, qui s'ouvre toujours, indique que la collecte a atteint son objectif. Un remboursement qui ramène le total sous l'objectif la rouvre. Avec `allow_overflow` activé, la collecte continue au-delà de son objectif. `POST /links` crée une collecte avec `allow_overflow` désactivé, sauf si vous l'envoyez, et `PUT /links/{id}` le modifie. `link.expired` est envoyé une fois, dans la journée qui suit le passage de l'`expiry_date` d'un lien, sauf si le lien est archivé entre-temps, avec le lien dans `data`. L'archivage envoie `link.updated`, tout comme une vente ou un remboursement qui change le stock d'un produit. Atteindre le plafond de ventes, fermer un lien à usage unique et atteindre l'objectif d'une collecte n'envoient aucun événement propre. L'archivage est l'option réversible : remettez `is_archived` à `false` via `PUT /links/{id}` et le lien encaisse de nouveau, en conservant tout ce qu'il a déjà collecté. `expiry_date` est une condition plutôt qu'un état : la repousser rouvre un lien qui s'était fermé à cause d'elle. La dépublication avec `is_public: false` ferme aussi un lien, mais répond `404` au lieu de `410`, car un lien non publié doit donner l'impression de n'avoir jamais existé. Les verrous d'accès sont décrits dans [Personnalisation](https://docs.wajub.com/fr/payments/link/customization#who-is-allowed-in). ## Ce que rend un remboursement Un lien compte ce qu'il a gardé, pas ce qu'il a encaissé un jour. Un remboursement réussi, ou un litige que vous perdez, rend ce que le paiement avait pris : - Un billet ou une unité dont le prix entier est remboursé ne compte plus dans `event_capacity`, `sales_limit` ni dans la quantité de son type de billet, et revient dans le stock d'un produit physique. Le remboursement d'une partie du prix d'un billet garde le billet : trois billets à 3 000 XAF remboursés de 3 000 XAF laissent deux billets vendus. - Sur une collecte ou une page de dons, le total collecté, la progression vers l'objectif et le nombre de contributeurs baissent de ce qui a été remboursé. Un don remboursé en entier quitte le mur des donateurs, et une collecte fermée à son objectif se rouvre si le total repasse dessous. - Un paiement perdu dans un litige ne compte plus, comme un remboursement complet. Un litige encore ouvert, ou que vous avez gagné, ne change rien. Un remboursement qui échoue, ou qui est encore en cours, ne change rien non plus. ## Les webhooks d'un lien L'onglet **Webhooks** d'un lien, dans le Dashboard, envoie les événements propres à ce lien à une adresse à vous, avec un secret de signature qui lui est propre. Ils s'ajoutent aux webhooks de votre compte, qui couvrent tous les paiements. | Événement | Envoyé quand | | ------------------- | -------------------------------------------------------------------------------------------------------------------- | | `payment.success` | Un paiement par le lien a réussi, quel que soit son type | | `ticket_purchased` | Des billets ont été achetés sur un lien d'événement | | `donation.received` | Un don a été reçu sur un lien de don ou de collecte | | `order.placed` | Une commande a été payée sur un lien de produit | | `payment.refunded` | Un remboursement d'un de ses paiements a réussi, une fois par remboursement, ou un litige sur l'un d'eux a été perdu | | `link_expired` | L'`expiry_date` du lien est passée | Un paiement qui échoue n'envoie rien. Les paiements sandbox ne partent que vers les endpoints d'un lien sandbox, avec `sandbox: true`. En sandbox, un remboursement fait depuis le tableau de bord n'envoie pas de `payment.refunded`. Chaque envoi est un `POST` avec un corps JSON, signé dans `X-Webhook-Signature` et nommé dans `X-Webhook-Event`. Chaque événement porte en plus un `id` dans le corps, et la même valeur dans `X-Webhook-Id` : | En-tête | Ce que c'est | | --------------------- | ----------------------------------------------------------------------------------- | | `X-Webhook-Signature` | HMAC-SHA256 en hexadécimal du corps brut, avec le secret de signature de l'endpoint | | `X-Webhook-Event` | L'événement, comme dans le corps | | `X-Webhook-Id` | L'`id` de l'événement, comme dans le corps | **Vérifier un envoi d'un lien** ```javascript import crypto from 'node:crypto'; app.post('/webhooks/link', express.raw({ type: 'application/json' }), (req, res) => { const expected = crypto.createHmac('sha256', process.env.LINK_WEBHOOK_SECRET).update(req.body).digest('hex'); const received = String(req.headers['x-webhook-signature'] ?? ''); if (received.length !== expected.length || !crypto.timingSafeEqual(Buffer.from(received), Buffer.from(expected))) { return res.sendStatus(400); } const event = JSON.parse(req.body); // Ignorez un event.id déjà traité, puis livrez. res.sendStatus(200); }); ``` ```php $raw = file_get_contents('php://input'); $expected = hash_hmac('sha256', $raw, getenv('LINK_WEBHOOK_SECRET')); if (! hash_equals($expected, $_SERVER['HTTP_X_WEBHOOK_SIGNATURE'] ?? '')) { http_response_code(400); exit; } $event = json_decode($raw, true); // Ignorez un $event['id'] déjà traité, puis livrez. ``` Répondez par un `2xx` une fois l'événement enregistré. Un envoi qui échoue est retenté, pendant 72 heures au plus, si bien qu'un même événement peut arriver plusieurs fois. Un événement garde son `id` à chaque fois : gardez ceux que vous avez traités et ignorez-les. Un envoi renvoyé depuis l'onglet a le même corps et le même `X-Webhook-Id`. `timestamp` est le moment où l'événement s'est produit, pas celui de l'envoi : une nouvelle tentative, ou un envoi renvoyé depuis l'onglet, le garde. Chaque événement de paiement porte le lien et le paiement. Le payeur n'est désigné que par `name` et `email` : un envoi ne contient jamais son numéro de téléphone ni sa carte. Ce qui a été saisi au paiement arrive avec toute suite de sept chiffres ou plus masquée, sous la forme `23••••89`, y compris au milieu d'une phrase ; `answers` ne contient que les questions du lien, chacune coupée à 500 caractères. ```json title="ticket_purchased" { "id": "lwe_5b3c2f1e-8d0a-5c4b-9e7f-2a1d6c0b9e84", "event": "ticket_purchased", "link_id": "9f3a1c52-6b1e-4f7d-a1c2-7e0d4b8f2a61", "link_uid": "8kD2xQpLm", "link": { "id": "9f3a1c52-6b1e-4f7d-a1c2-7e0d4b8f2a61", "uid": "8kD2xQpLm", "title": "Soirée Afrobeats", "type": "event" }, "sandbox": false, "timestamp": "2026-10-23T18:04:11+00:00", "payment": { "id": "trx_CSUGajfv9xh0XQ5wu2lx", "reference": "order-4172", "amount": 10000, "currency": "XAF", "status": "succeeded", "amount_refunded": 0, "dispute_lost": false, "quantity": 2, "quantity_kept": 2, "channel": "cm.mtn", "customer": { "id": "cus_Qe7Tb2Wn5Lr9Xc4Mv8Hk1Zs3", "name": "Ada Obi", "email": "ada@example.com" }, "answers": { "company": "Acme" }, "paid_at": "2026-10-23T18:04:09+00:00", "created_at": "2026-10-23T18:02:47+00:00" }, "ticket": { "ticket_type": { "id": "3e1b7a90-2c4d-4f6e-8a1b-5d9c0e2f7b13", "name": "VIP" }, "quantity": 2, "attendees": [{ "Nom complet": "Ada Obi", "Téléphone": "23••••33" }, { "Nom complet": "Ben Eko" }], "event_start_date": "2026-11-07T20:00:00+00:00" } } ``` `link_uid` est l'`id` du lien dans l'API, et `payment.id` celui du paiement. `quantity_kept` est ce que le paiement détient encore une fois ses remboursements et ses litiges comptés, comme plus haut. Chaque événement ajoute un objet à côté de `payment` : | Événement | Ajoute | | ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `payment.success` | Rien de plus | | `ticket_purchased` | `ticket` : `ticket_type` (`id`, `name`), `quantity`, `attendees`, `event_start_date` | | `donation.received` | `donation` : `amount`, `currency`, `anonymous`, `recurring_interval` | | `order.placed` | `order` : `product_type`, `quantity`, `variant`, `shipping_address` avec son `phone` masqué | | `payment.refunded` | `refund` : `id`, `amount`, `currency`, `reason`, `created_at`. `payment.status` vaut alors `partially_refunded` ou `refunded`. Pour un litige perdu, `dispute` à la place de `refund` : `id`, `amount`, `currency`, `reason`, `status`, `created_at`, avec `payment.dispute_lost` à true | `anonymous` signifie que le donateur a demandé à ne pas figurer sur le mur public des donateurs : vous recevez tout de même son nom. Un litige perdu envoie `payment.refunded` une fois ; si un remboursement le règle ensuite, ce remboursement envoie le sien, avec un autre `id`. `link_expired` porte `id`, `event`, `link_id`, `link_uid`, le lien avec son `expiry_date`, et `timestamp`. ## Le rapprochement des fonds Les paiements d'un lien sont des paiements ordinaires. Ils arrivent dans votre liste Payments, déclenchent `payment.succeeded`, sont réglés sur votre solde et se remboursent comme les autres : il n'y a donc rien de propre aux liens à rapprocher. Le webhook transporte ce que le payeur a saisi dans vos `extra_fields`, imbriqué sous `metadata.extra_fields`, ainsi que le `link` dont vient le paiement. - [Liens de paiement](https://docs.wajub.com/fr/payments/link): Ce qu'est le produit, et quand un lien vaut mieux qu'une intégration. - [Démarrage rapide](https://docs.wajub.com/fr/payments/link/quickstart): Créez un lien, publiez-le, partagez-le. - [Personnalisation](https://docs.wajub.com/fr/payments/link/customization): Images, langues, devises, et qui peut entrer. - [Webhooks](https://docs.wajub.com/fr/developer-tools/webhooks): Écoutez payment.succeeded et livrez la commande automatiquement. - [Référence API des liens de paiement](https://docs.wajub.com/fr/api/payment-links): Chaque champ de la ressource, et les cinq endpoints. --- # Virements bancaires URL: https://docs.wajub.com/fr/payments/payment-methods/bank-transfers > Les virements nationaux sur le canal `bank`, réglés au rythme de la banque. Pour les gros montants, surtout entre entreprises. Le client reçoit des coordonnées bancaires, et le paiement passe à `succeeded` une fois les fonds arrivés. | Type | Canal | Pays | | --- | --- | --- | | Virement national | `bank` | CM, CI, SN, NG, GH | Un virement se règle au rythme de la banque, pas à celui du client. Attendez-vous à un délai entre le moment où il confirme et celui où le webhook est déclenché, et ne gardez jamais une commande ouverte dans le navigateur en l'attendant. - [Cycle de vie d'un paiement](https://docs.wajub.com/fr/payments/lifecycle): Ce que traverse le paiement jusqu'à l'arrivée des fonds. - [Webhooks](https://docs.wajub.com/fr/developer-tools/webhooks): Être prévenu quand le virement est réglé. --- # Cartes bancaires URL: https://docs.wajub.com/fr/payments/payment-methods/cards > Visa et Mastercard sur le canal `card`, et quand Wajub demande le 3-D Secure. Visa et Mastercard, proposées sur la page hébergée partout où la devise de règlement le permet. | Réseau | Détecté comme | Remarques | | --- | --- | --- | | Visa | `visa` | 3-D Secure 2 sur demande | | Mastercard | `mastercard` | 3-D Secure 2 sur demande | Le canal est `card` pour les deux réseaux : vous ne nommez jamais la marque. American Express, Discover, Diners, JCB et Maestro sont acceptées là où votre prestataire les prend en charge. Wajub demande le 3-D Secure quand [Shield](https://docs.wajub.com/fr/risk/shield) l'exige : l'Auto 3DS de Shield Advanced à partir de votre seuil de revue, ou une règle `challenge_3ds`. Sinon, le prestataire et l'émetteur de la carte appliquent leur propre politique. - [Shield](https://docs.wajub.com/fr/risk/shield): Les règles qui demandent le 3-D Secure. - [Checkout hébergé](https://docs.wajub.com/fr/payments/hosted-checkout): La page où le payeur saisit sa carte. --- # Moyens de paiement et canaux URL: https://docs.wajub.com/fr/payments/payment-methods > Chaque moyen de paiement avec lequel Wajub encaisse, son identifiant de canal et où il fonctionne. Chaque moyen de paiement est désigné par un **canal** : une famille à part entière, `mobile`, `card`, `bank` ou `crypto`, ou un opérateur précis au format `country.operator`. La page hébergée propose tous les canaux sur lesquels votre compte peut encaisser ; réduisez cette liste paiement par paiement avec [`accept`](#choosing-what-a-payment-accepts), et ne nommez un canal que dans un débit par l'API directe. > [!NOTE] > **Comment lire un canal** > > `cm.mtn` correspond à MTN Mobile Money au Cameroun, `sn.wave` à Wave au Sénégal. Le préfixe est le > code pays ISO 3166-1 alpha-2 et le suffixe l'opérateur. Un nom de famille seul, comme `mobile`, > laisse Wajub déduire l'opérateur à partir du numéro de téléphone. Chaque famille a sa page : - [Mobile Money](https://docs.wajub.com/fr/payments/payment-methods/mobile-money), les opérateurs et leurs canaux, et les [formats de numéros](https://docs.wajub.com/fr/payments/payment-methods/phone-numbers) que chacun accepte. - [Cartes bancaires](https://docs.wajub.com/fr/payments/payment-methods/cards), Visa et Mastercard sur le canal `card`. - [Virements bancaires](https://docs.wajub.com/fr/payments/payment-methods/bank-transfers), sur le canal `bank`. - [Portefeuilles et cryptomonnaies](https://docs.wajub.com/fr/payments/payment-methods/wallets-and-crypto), Apple Pay, Google Pay et les canaux `crypto.{asset}`. ## Où en est chaque pays La devise décide des canaux qui existent, et les prestataires du compte décident lesquels sont activés. | Pays | Devise | Mobile Money | Cartes | | --- | --- | --- | --- | | Cameroun | XAF | MTN, Orange, Express Union | Oui | | Côte d'Ivoire | XOF | MTN, Orange, Wave, Moov | Oui | | Sénégal | XOF | Orange, Wave, Free | Oui | | Bénin | XOF | MTN, Moov | Oui | | Burkina Faso | XOF | Orange, Moov | Oui | | Togo | XOF | T-Money, Moov | Oui | | Mali | XOF | Orange, Moov | Oui | | Ghana | GHS | MTN, Vodafone, AirtelTigo | Oui | | Nigeria | NGN | OPay, par une connexion Flutterwave v4. Aussi virement bancaire et USSD ; PalmPay bientôt disponible | Oui | | Kenya | KES | M-Pesa, Airtel | Oui | | Ouganda | UGX | MTN, Airtel | Oui | | Rwanda | RWF | MTN, Airtel | Oui | | Tanzanie | TZS | M-Pesa, Airtel, Tigo, Halopesa | Oui | | Gabon | XAF | Airtel, Moov | Oui | | Congo | XAF | MTN, Airtel | Oui | | RD Congo | CDF | Orange, Airtel, Vodacom, Africell | Oui | | Guinée | GNF | MTN, Orange | Oui | | Liberia | LRD | MTN | Oui | | Sierra Leone | SLE | Orange | Oui | | Zambie | ZMW | MTN, Airtel, Zamtel | Oui | | Malawi | MWK | Airtel, TNM | Oui | | Mozambique | MZN | M-Pesa | Oui | ## Choisir ce qu'un paiement accepte Rien n'est masqué par défaut : le payeur voit tous les moyens sur lesquels votre compte peut encaisser, et un paiement dans une devise que le portefeuille n'utilise pas est converti, comme décrit dans [Limites](https://docs.wajub.com/fr/resources/limits). Pour réduire la liste, envoyez `accept` à la création du paiement, du lien ou de la facture. Chaque clé est facultative, et une clé omise ne restreint rien. - `accept.countries` (string[]): Uniquement les canaux de ces pays, en codes ISO 3166-1 alpha-2. Les cartes et la crypto n'appartiennent à aucun pays : cette clé ne les retire jamais. - `accept.channels` (string[]): Uniquement ces canaux, comme `cm.mtn`. Un agrégat comme `cm.mobile` désigne tous les opérateurs mobiles du pays, et `mobile` tous les opérateurs mobiles. - `accept.types` (string[]): Uniquement ces types de canal, comme `mobile_money` ou `card`. - `accept.currencies` (string): `any` (par défaut) propose tous les canaux et convertit le montant quand les devises diffèrent. `payment` ne garde que les canaux qui règlent dans la devise du paiement : un paiement en XAF n'affiche plus le Mobile Money kényan. ```json title="Un paiement en USD, Mobile Money camerounais uniquement" { "amount": 99.5, "currency": "USD", "email": "buyer@example.com", "accept": { "countries": ["CM"], "types": ["mobile_money"] } } ``` La restriction est conservée sur le paiement et s'applique deux fois : la page ne propose que ce qu'elle autorise, et un débit qui nomme un autre canal est refusé par un `422` et le code `channel_not_accepted`. Si `accept` ne laisse aucun moyen de payer, c'est la création elle-même qui répond `422` sur `accept`, plutôt que de produire une page sans aucun moyen de paiement. Un débit envoyé sur `mobile` ou sur `cm.mobile` est vérifié sur l'opérateur que donne le numéro, pas sur l'agrégat. Avec la restriction ci-dessus, `cm.mobile` et un numéro MTN Cameroun est débité sur `cm.mtn`, et un numéro ivoirien est refusé. Un paiement restreint à `"channels": ["mobile"]` accepte tout opérateur Mobile Money, quel que soit celui que donne le numéro, et aucun canal carte, bancaire ou crypto. Un lien ou une facture porte son propre `accept`, que chaque paiement ouvert depuis lui hérite. Sur un lien ou une facture, `accept: {}` supprime la restriction. Dans le Dashboard, les mêmes champs se trouvent sous **Moyens de paiement**, dans le composer de lien et sur le formulaire de facture. ## Prévisualiser les moyens avant de créer un paiement `GET /payments/options` liste les canaux qu'un payeur pourrait utiliser pour une devise et un montant, avant qu'aucun paiement n'existe : ceux que votre compte propose sur la page de paiement, restreints au `country` du payeur et au minimum et au maximum de chaque canal. Il prend la même restriction `accept` que `POST /payments`. Servez-vous-en pour dessiner votre propre choix de moyen de paiement ; une fois le paiement créé, c'est lui qui fixe ce qui est réellement proposé au payeur. ```bash title="Moyens pour 25 000 XAF au Cameroun" curl "https://api.wajub.com/payments/options?currency=XAF&amount=25000&country=CM&locale=fr" \ -H "Authorization: sk_test.xxxxxxxxxxxxxxxx…" ``` La réponse porte `code`, `status`, `message` et `channels` : chacun avec son `slug`, `name`, `name.fr`, `type`, `logo` et `countries`, et `operators` pour `cm.mobile`. `logo_png`, sur un canal et sur chaque opérateur, est le même logo en PNG, pour une application qui n'affiche pas de SVG, ou `null` quand il n'y en a pas. [Lister les options de paiement](https://docs.wajub.com/fr/api/payments/options) ## Montants et plafonds Deux limites différentes s'appliquent au même paiement, et elles sont faciles à confondre. La première concerne le paiement lui-même. En XAF et XOF, il doit être compris entre **25 et 2 000 000** ; en dehors de cette plage, l'appel de création est refusé avec un `422` qui indique la borne dans `errors.amount`. La seconde est ce qu'un seul débit Mobile Money peut porter, plafonné à **500 000 XAF**, et au même montant en XOF. Un paiement au-dessus est refusé avec un `422` au moment de le débiter. > [!WARNING] > **Votre propre plafond est plus bas tant que vous n'êtes pas vérifié** > > Les chiffres ci-dessus sont ceux de la plateforme. Ce que votre compte peut réellement encaisser > dépend de votre niveau de vérification, et un compte non vérifié a un plafond live de zéro. > Vérifiez-le dans **Paramètres → Conformité**, comme expliqué dans [Activation du > compte](https://docs.wajub.com/fr/getting-started/account-activation). - [Formats de numéros de téléphone](https://docs.wajub.com/fr/payments/payment-methods/phone-numbers): Ce que chaque opérateur accepte, avant même qu'un paiement puisse démarrer. - [Cycle de vie d'un paiement](https://docs.wajub.com/fr/payments/lifecycle): Chaque état que prend un paiement, et le webhook de chacun. - [Devise de règlement et solde](https://docs.wajub.com/fr/payouts/balance): Dans quelle devise vous êtes payé, et quand. - [Frais et tarifs](https://docs.wajub.com/fr/payouts/balance/fees): Ce que chaque canal vous coûte. - [Envoyer vers ces canaux](https://docs.wajub.com/fr/payouts/transfers): Des payouts Mobile Money avec Transferts. --- # Mobile Money URL: https://docs.wajub.com/fr/payments/payment-methods/mobile-money > Les opérateurs par lesquels Wajub encaisse, leurs canaux, pays et devises. La colonne vertébrale de l'encaissement sur le continent. Le client valide sur son propre téléphone, depuis une invite USSD ou l'application de l'opérateur, et rien n'est encaissé tant qu'il ne l'a pas fait. | Opérateur | Canaux | Pays | Devises | | --- | --- | --- | --- | | MTN MoMo | `cm.mtn` `ci.mtn` `bj.mtn` `gh.mtn` `ug.mtn` `rw.mtn` `zm.mtn` `cg.mtn` `gn.mtn` `lr.mtn` | CM, CI, BJ, GH, UG, RW, ZM, CG, GN, LR | XAF, XOF, GHS, UGX, RWF, ZMW, GNF, LRD | | Orange Money | `cm.orange` `ci.orange` `sn.orange` `bf.orange` `ml.orange` `gn.orange` `cd.orange` `sl.orange` | CM, CI, SN, BF, ML, GN, SL, CD | XAF, XOF, GNF, SLE, CDF | | Wave | `ci.wave` `sn.wave` | CI, SN | XOF | | Airtel Money | `ug.airtel` `rw.airtel` `tz.airtel` `ke.airtel` `zm.airtel` `mw.airtel` `cd.airtel` `cg.airtel` `ga.airtel` | UG, RW, TZ, KE, ZM, MW, CD, CG, GA | UGX, RWF, TZS, KES, ZMW, MWK, CDF, XAF | | Moov Money | `ci.moov` `bj.moov` `bf.moov` `tg.moov` `ml.moov` `ga.moov` | CI, BJ, BF, TG, ML, GA | XOF, XAF | | M-Pesa | `ke.mpesa` `tz.mpesa` `mz.mpesa` | KE, TZ, MZ | KES, TZS, MZN | D'autres opérateurs complètent le catalogue : Express Union au Cameroun (`cm.eu`), Free au Sénégal, T-Money au Togo, Vodafone et AirtelTigo au Ghana, Tigo et Halopesa en Tanzanie, Vodacom et Africell en RD Congo, Zamtel en Zambie, TNM au Malawi, Vodafone Cash en Égypte, Capitec Pay en Afrique du Sud et OPay au Nigeria (`ng.opay`), débité par une connexion Flutterwave v4. `mobile` et `cm.mobile`, pour le Cameroun, ne sont pas des canaux du catalogue. Ce sont les deux raccourcis qu'accepte l'[appel de débit](https://docs.wajub.com/fr/payments/direct-api#letting-wajub-find-the-operator), pour laisser Wajub déduire l'opérateur à partir du numéro plutôt que de le nommer à l'avance. Aucun autre pays n'a d'agrégat : débitez le canal de son opérateur. > [!NOTE] > **`GET /providers` donne la liste de votre compte** > > La couverture évolue. [`GET /channels`](https://docs.wajub.com/fr/api/channels/list) est le catalogue global : tous les > canaux pris en charge par Wajub, la même réponse pour chaque clé, filtrée par `country` si vous le > passez. Ce que votre propre compte peut accepter dépend des prestataires que votre équipe a > activés, et c'est [`GET /providers`](https://docs.wajub.com/fr/api/providers/list) : chaque connexion active avec les canaux > qu'elle propose réellement, ceux qu'affiche le checkout hébergé. Considérez le tableau ci-dessus > comme la forme de l'offre. Un nouveau canal est un changement rétrocompatible, il ne casse donc > jamais une intégration existante. - [Formats de numéros de téléphone](https://docs.wajub.com/fr/payments/payment-methods/phone-numbers): Ce que chaque opérateur accepte, avant même qu'un paiement puisse démarrer. - [Choisir ce qu'un paiement accepte](https://docs.wajub.com/fr/payments/payment-methods#choosing-what-a-payment-accepts): Restreindre un paiement à certains opérateurs ou pays. - [API directe](https://docs.wajub.com/fr/payments/direct-api): Débiter un opérateur vous-même, une fois le numéro en main. --- # Formats de numéros de téléphone URL: https://docs.wajub.com/fr/payments/payment-methods/phone-numbers > Comment Wajub lit un numéro Mobile Money, pays par pays, et ce qu'il rejette. Les formats de numéro que Wajub accepte pour le Mobile Money, dans les paiements, les payouts et les règlements de marketplace. Si le format est faux, le paiement échoue avant même que le client voie une demande de confirmation. ## Envoyer au format E.164 Wajub attend la forme internationale : un `+`, l'indicatif du pays, puis le numéro d'abonné. Pas d'espaces, pas de tirets, pas de parenthèses. Retirez le 0 qu'un format national compose d'abord, comme au Kenya ou au Ghana, mais gardez celui qui fait partie du numéro : en Côte d'Ivoire, au Bénin, au Congo et au Burkina Faso, un numéro peut commencer par 0 après son indicatif. ```bash title="La forme d'un numéro accepté" +[country code][subscriber number] +237670000000 Cameroon, MTN +221770000000 Senegal, Orange +254700000000 Kenya, Safaricom +2250700000000 Côte d'Ivoire, Orange ``` Un numéro qui arrive sans son indicatif n'est pas automatiquement refusé. Quand l'appel porte un pays sur lequel l'ancrer (un `channel` comme `cm.mtn` suffit), un numéro local tel que `670000000` est lu comme `+237670000000`. Sans cet ancrage, il n'y a rien sur quoi s'appuyer pour deviner, et le numéro revient en `422`. Pour un débit, `00` à la place du `+` se lit de la même façon : `00237670000000` est `+237670000000`. Un numéro qui a perdu le 0 qui fait partie de lui, comme `+225707000000`, le retrouve, et les numéros d'une renumérotation se lisent sous leur nouvelle forme : un numéro béninois à huit chiffres prend `01` devant, et un ancien numéro gabonais à huit chiffres son bloc de 2024, `07 28 01 50` devenant `+24177280150`. > [!TIP] > **Envoyez quand même au format E.164** > > Compter sur ce repli, c'est compter sur l'exactitude de votre propre `channel`. Normalisez de votre > côté, au moment où le client saisit le numéro, et vous éliminez toute une catégorie d'échecs de > chaque appel qui suit. ## Tous les pays couverts par Wajub Vingt-quatre pays : chacun de ceux où le catalogue annonce un canal payé avec un numéro de téléphone, avec son indicatif et ces canaux. | Pays | Indicatif | Canaux | | --- | --- | --- | | Afrique du Sud | `+27` | Capitec Pay | | Bénin | `+229` | MTN MoMo, Moov Money | | Burkina Faso | `+226` | Orange Money, Moov Money | | Cameroun | `+237` | MTN MoMo, Orange Money, Express Union | | Congo | `+242` | MTN MoMo, Airtel Money | | Côte d'Ivoire | `+225` | MTN MoMo, Orange Money, Moov Money, Wave, Djamo | | Égypte | `+20` | Vodafone Cash | | Gabon | `+241` | Airtel Money, Moov Money | | Ghana | `+233` | MTN MoMo, Vodafone Cash, AirtelTigo Money | | Guinée | `+224` | MTN MoMo, Orange Money | | Kenya | `+254` | M-Pesa, Airtel Money | | Libéria | `+231` | MTN MoMo | | Malawi | `+265` | Airtel Money, TNM Mpamba | | Mali | `+223` | Orange Money, Moov Money | | Mozambique | `+258` | M-Pesa | | Nigeria | `+234` | OPay | | Ouganda | `+256` | MTN MoMo, Airtel Money | | RD Congo | `+243` | Airtel Money, Vodacom M-Pesa, Orange Money, Africell Money | | Rwanda | `+250` | MTN MoMo, Airtel Money | | Sénégal | `+221` | Orange Money, Free Money, Wave, Djamo | | Sierra Leone | `+232` | Orange Money | | Tanzanie | `+255` | M-Pesa, Tigo Pesa, Airtel Money, HaloPesa | | Togo | `+228` | T-Money, Moov Money | | Zambie | `+260` | MTN MoMo, Airtel Money, Zamtel Kwacha | ## Comment l'opérateur est identifié C'est là que la production et la sandbox diffèrent vraiment, et cette différence compte. **En production**, Wajub identifie l'opérateur qui détient le numéro. Un numéro qu'il ne peut attribuer à aucun opérateur pris en charge est considéré comme n'en ayant aucun. Certains canaux portent le nom d'un portefeuille et non celui d'un opérateur, et le numéro est lu en conséquence. Wave (`ci.wave`, `sn.wave`), Express Union (`cm.eu`), Djamo (`ci.djamo`, `sn.djamo`), Capitec Pay (`za.capitec`), OPay (`ng.opay`) et PalmPay (`ng.palmpay`) se détiennent quel que soit l'opérateur du payeur : un numéro n'y est jamais refusé à cause du réseau auquel il appartient. Les autres portefeuilles appartiennent à un opérateur, et un numéro de cet opérateur paie sur le canal du portefeuille : `ke.mpesa` prend les numéros Safaricom, `tz.mpesa` et `mz.mpesa` prennent les numéros Vodacom, et `gh.vodafone` prend les numéros de Telecel, anciennement Vodafone Ghana. Tous les autres canaux portent le nom de leur opérateur, comme `zm.zamtel`, `mw.tnm` ou `cd.africell`. Un agrégat se résout de la même façon : un numéro Telecel envoyé sur `mobile` est débité sur `gh.vodafone`. **En sandbox**, Wajub compare plutôt les préfixes de test ci-dessous. Ils ne servent qu'à choisir un résultat en sandbox : certains suivent un vrai plan de numérotation, d'autres non, et aucun ne décrit l'attribution des vrais numéros. Un portefeuille détenu quel que soit l'opérateur, comme Capitec Pay, prend le numéro de test de n'importe quel opérateur, le sien (`+2761…`) ou celui d'un autre, mais jamais un numéro qui n'est pas un numéro de test. > [!WARNING] > **Ne construisez pas votre propre table de préfixes** > > Les préfixes ci-dessous sont ceux de la sandbox. Les recopier dans votre code revient à > réimplémenter la détection d'opérateur avec des données fausses en production, et périmées le jour > où une plage est réattribuée. Envoyez le numéro et laissez Wajub le résoudre. | Pays et opérateur | Préfixe sandbox | Canal | | --- | --- | --- | | Cameroun / MTN MoMo | `+23767…` | `cm.mtn` | | Cameroun / Orange Money | `+23769…` | `cm.orange` | | Cameroun / Express Union | `+23768…` | `cm.eu` | | Côte d'Ivoire / MTN MoMo | `+22505…` | `ci.mtn` | | Côte d'Ivoire / Orange Money | `+22507…` | `ci.orange` | | Côte d'Ivoire / Moov Money | `+22501…` | `ci.moov` | | Côte d'Ivoire / Wave | `+22503…` | `ci.wave` | | Sénégal / Orange Money | `+22177…` | `sn.orange` | | Sénégal / Free Money | `+22176…` | `sn.free` | | Sénégal / Wave | `+22178…` | `sn.wave` | | Bénin / MTN MoMo | `+22990…`, `+2290190…` | `bj.mtn` | | Bénin / Moov Money | `+22991…`, `+2290191…` | `bj.moov` | | Burkina Faso / Orange Money | `+22670…` | `bf.orange` | | Burkina Faso / Moov Money | `+22671…` | `bf.moov` | | Ghana / MTN MoMo | `+23324…` | `gh.mtn` | | Ghana / Vodafone Cash | `+23320…` | `gh.vodafone` | | Ghana / AirtelTigo Money | `+23327…` | `gh.airteltigo` | | Kenya / M-Pesa | `+25470…` | `ke.mpesa` | | Kenya / Airtel Money | `+25478…` | `ke.airtel` | | Ouganda / MTN MoMo | `+25677…` | `ug.mtn` | | Ouganda / Airtel Money | `+25675…` | `ug.airtel` | | Rwanda / MTN MoMo | `+25078…` | `rw.mtn` | | Rwanda / Airtel Money | `+25073…` | `rw.airtel` | | Tanzanie / Airtel Money | `+25567…` | `tz.airtel` | | Tanzanie / Tigo Pesa | `+25565…` | `tz.tigo` | | Tanzanie / HaloPesa | `+25562…` | `tz.halopesa` | | Tanzanie / M-Pesa | `+25576…` | `tz.mpesa` | | RD Congo / Airtel Money | `+24399…` | `cd.airtel` | | RD Congo / Orange Money | `+24389…` | `cd.orange` | | RD Congo / Vodacom M-Pesa | `+24381…` | `cd.vodacom` | | RD Congo / Africell Money | `+24390…` | `cd.africell` | | Gabon / Airtel Money | `+2410…`, `+24174…`, `+24177…` | `ga.airtel` | | Gabon / Moov Money | `+2416…`, `+24162…`, `+24165…`, `+24166…` | `ga.moov` | | Congo / MTN MoMo | `+24206…` | `cg.mtn` | | Congo / Airtel Money | `+24204…` | `cg.airtel` | | Zambie / MTN MoMo | `+26096…` | `zm.mtn` | | Zambie / Airtel Money | `+26097…` | `zm.airtel` | | Zambie / Zamtel Kwacha | `+26095…` | `zm.zamtel` | | Malawi / Airtel Money | `+26599…` | `mw.airtel` | | Malawi / TNM Mpamba | `+26588…` | `mw.tnm` | | Mali / Orange Money | `+22370…` | `ml.orange` | | Mali / Moov Money | `+22366…` | `ml.moov` | | Togo / Moov Money | `+22899…` | `tg.moov` | | Togo / T-Money | `+22890…` | `tg.tmoney` | | Guinée / MTN MoMo | `+22466…` | `gn.mtn` | | Guinée / Orange Money | `+22462…` | `gn.orange` | | Liberia / MTN MoMo | `+23188…` | `lr.mtn` | | Mozambique / M-Pesa | `+25884…` | `mz.mpesa` | | Égypte / Vodafone Cash | `+2010…` | `eg.vodafone` | | Sierra Leone / Orange Money | `+23276…` | `sl.orange` | | Afrique du Sud / Capitec Pay | `+2761…` | `za.capitec` | ## Laisser Wajub choisir le canal La page hébergée et les composants choisissent l'opérateur avec le client : ceci ne concerne donc que l'appel de débit d'une intégration [API directe](https://docs.wajub.com/fr/payments/direct-api). Sur cet appel, `channel` est obligatoire. Envoyez `mobile`, ou `cm.mobile` pour le Cameroun, et Wajub résout l'opérateur à partir du numéro. C'est le cas à privilégier. Ce sont les deux seuls agrégats : dans un autre pays, nommez le canal de l'opérateur, comme `ci.orange`. Le corps de l'appel de débit nomme alors l'agrégat et le numéro : ```json title="Opérateur résolu à partir du numéro" { "channel": "cm.mobile", "data": { "phone": "+237670000000" } } ``` Ne nommez un canal précis comme `cm.mtn` que si vous voulez imposer un opérateur. Si le numéro et le canal ne concordent pas, l'appel est refusé plutôt que rerouté en silence. Un agrégat fonctionne aussi sur un paiement restreint par [`accept`](https://docs.wajub.com/fr/payments/payment-methods#choosing-what-a-payment-accepts). La restriction est vérifiée sur l'opérateur que donne le numéro : `cm.mobile` avec un numéro MTN est accepté partout où `cm.mtn` l'est, et refusé là où il ne l'est pas. ## Ce qui revient quand le numéro est faux | Réponse | Cause | Correction | | ----------------------------------------- | ----------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ | | `422` sur `phone` | Pas de `+`, pas d'indicatif et rien pour ancrer le numéro | Normalisez au format E.164 avant l'envoi | | `422` sur `channel` | Le canal désigne un opérateur qui ne dessert pas ce pays | Vérifiez les opérateurs du pays ci-dessus | | `422`, numéro et canal discordants | Le numéro appartient à un autre opérateur que celui indiqué | Envoyez `cm.mobile` et laissez Wajub le résoudre | | `422` sur `phone`, aucun opérateur trouvé | Aucun opérateur pris en charge ne détient le numéro | Demandez au client de confirmer son numéro, ou envoyez l'opérateur qu'il a choisi dans `data.operator` | Les quatre sont refusés sur l'appel de débit, `POST /payments/{id}`, et non à la création du paiement. Le paiement reste `pending` et rien n'atteint un opérateur : le même paiement peut donc être débité de nouveau une fois le numéro corrigé. Un numéro que l'opérateur refuse après l'envoi de la demande est un autre cas : le paiement échoue, et le motif figure dans le catalogue des [motifs d'échec](https://docs.wajub.com/fr/api/failure-reasons). - [Moyens de paiement et canaux](https://docs.wajub.com/fr/payments/payment-methods): Chaque opérateur, son canal et où il fonctionne. - [Numéros de test sandbox](https://docs.wajub.com/fr/getting-started/quickstart#4-pay-it-with-a-sandbox-number): Les suffixes qui déclenchent chaque résultat en mode test. - [Motifs d'échec](https://docs.wajub.com/fr/api/failure-reasons): Pourquoi un paiement qui a atteint un opérateur revient en échec. - [Transferts](https://docs.wajub.com/fr/payouts/transfers): Le même format, utilisé comme destination de payout. - [Sync](https://docs.wajub.com/fr/sync): Le même format, utilisé pour régler un vendeur de marketplace. --- # Portefeuilles et cryptomonnaies URL: https://docs.wajub.com/fr/payments/payment-methods/wallets-and-crypto > Apple Pay et Google Pay, et les cryptoactifs dans lesquels un paiement peut être réglé. Deux familles qui viennent avec leurs propres conditions : les portefeuilles ne fonctionnent qu'en live, et aucun prestataire crypto ne peut encore être connecté. ## Portefeuilles Apple Pay et Google Pay tokenisent la carte sur l'appareil : Wajub ne voit donc jamais la carte en clair ni les identifiants de l'appareil. | Portefeuille | `wallet_type` | Nécessite | | --- | --- | --- | | Apple Pay | `apple_pay` | Safari, iOS | | Google Pay | `google_pay` | Chrome, Android | > [!WARNING] > **Les portefeuilles fonctionnent en live uniquement** > > Un portefeuille apparaît sur la page hébergée et dans les composants intégrés quand l'un de vos > prestataires le propose, en live. La sandbox masque tous les portefeuilles : vous ne pouvez pas en > tester un. Consultez [Wajub Components → JS](https://docs.wajub.com/fr/libraries/components/js) pour le côté composants. ## Cryptomonnaies Le paiement est réglé une fois le transfert confirmé sur la blockchain. Les canaux suivent le format `crypto.{asset}`, et si vous ne fournissez pas de `wallet_address`, le payeur voit une adresse de dépôt vers laquelle envoyer les fonds. Quatre actifs figurent au catalogue, les deux stablecoins en dollar et les deux principales blockchains : | Actif | Canal | | --- | --- | | Bitcoin | `crypto.btc` | | Ethereum | `crypto.eth` | | Tether | `crypto.usdt` | | USD Coin | `crypto.usdc` | Ceux que vos clients voient réellement parmi les quatre dépendent du prestataire crypto activé sur votre compte : lisez donc `GET /providers` avant de construire un sélecteur. > [!NOTE] > **La crypto est bientôt disponible** > > Aucun prestataire portant ces quatre actifs ne peut encore être connecté : ils ne peuvent donc pas encore > être débités en live. [Couverture](https://docs.wajub.com/fr/resources/coverage) liste les autres rails > dans la même situation. - [Wajub Components, JS](https://docs.wajub.com/fr/libraries/components/js): Les boutons de portefeuille sur votre propre page. - [Couverture](https://docs.wajub.com/fr/resources/coverage): Les rails qui ne peuvent pas encore être connectés. --- # Créer un remboursement URL: https://docs.wajub.com/fr/payments/refunds/create > L'appel qui restitue des fonds sur un paiement réussi, ses paramètres et sa réponse. Le paiement est désigné par son `id` Wajub. Votre propre `reference` sur le paiement n'est pas acceptée ici. `POST /refunds` - `payment` (string, required): L'`id` du paiement, par exemple `trx_test_CSUGajfv9xh0XQ5wu2lx`. Votre `reference` marchand n'est pas acceptée. - `reason` (enum, required): La raison du remboursement. Les valeurs acceptées sont listées plus bas. - `amount` (number): Montant dans l'unité principale, décimales autorisées et arrondies à deux. Omettez-le pour rembourser en totalité ce qui reste. - `currency` (string): Doit être égale à la devise du paiement, qui est la valeur par défaut. - `fees_bearer` (enum): `merchant` ou `customer` : qui supporte les frais Wajub du paiement pour la part remboursée. Par défaut : vos réglages de remboursement, sinon celui qui a payé les frais au paiement. Voir plus bas. - `reference` (string): Votre propre référence pour ce remboursement, jusqu'à 255 caractères. Renvoyée à la lecture. - `metadata` (object): Données clé-valeur libres, renvoyées telles quelles sur l'objet remboursement. Une clé est réservée : `dispute_settlement` marque le remboursement que Wajub crée quand vous acceptez un litige, et elle est retirée si vous l'envoyez. `reason` est obligatoire et sa liste est fermée. Toute valeur hors de cette liste donne un `422` : choisissez la plus proche plutôt que d'en inventer une. | Motif | Quand l'utiliser | | ----------------------- | -------------------------------------------------------------------------------------- | | `requested_by_customer` | Le client l'a demandé, et vous avez accepté | | `duplicate` | La même commande a été payée deux fois | | `fraudulent` | Vous pensez que le paiement n'a pas été fait par le titulaire de la carte ou du compte | | `product_not_received` | La marchandise n'est jamais arrivée | | `service_not_delivered` | Un service a été payé mais pas fourni | | `wrong_amount` | Vous avez débité plus que prévu | | `customer_complaint` | Une réclamation réglée sans désigner de responsable | | `merchant_error` | Votre propre erreur : mauvais article, mauvais prix, mauvais client | | `network_error` | Le paiement est passé de votre côté mais pas du leur | | `transaction_error` | Une panne technique dans le paiement lui-même | | `reconciliation` | Correction d'un écart trouvé lors d'un rapprochement | Envoyez l'appel depuis votre serveur, avec une `Idempotency-Key` si le remboursement peut être déclenché par un processus qui retente ses appels. **Rembourser une partie d'un paiement** ```bash curl https://api.wajub.com/refunds \ -H "Authorization: sk_test.xxxxxxxxxxxxxxxx…" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: refund-order-4172" \ -d '{ "payment": "trx_test_CSUGajfv9xh0XQ5wu2lx", "amount": 2000, "reason": "product_not_received", "reference": "rma-881" }' ``` ```javascript const refund = await wajub.refunds.create({ payment: 'trx_test_CSUGajfv9xh0XQ5wu2lx', amount: 2000, reason: 'product_not_received', reference: 'rma-881', }); console.log(refund.id, refund.status); ``` ```python refund = wajub.refunds.create({ "payment": "trx_test_CSUGajfv9xh0XQ5wu2lx", "amount": 2000, "reason": "product_not_received", "reference": "rma-881", }) print(refund.id, refund.status) ``` ```php $refund = $wajub->refunds->create([ 'payment' => 'trx_test_CSUGajfv9xh0XQ5wu2lx', 'amount' => 2000, 'reason' => 'product_not_received', 'reference' => 'rma-881', ]); echo $refund->id; ``` ```go refund, err := client.Refunds.Create(context.Background(), map[string]any{ "payment": "trx_test_CSUGajfv9xh0XQ5wu2lx", "amount": 2000, "reason": "product_not_received", "reference": "rma-881", }, nil) ``` Wajub répond `201 Created`. Rien n'a encore quitté votre solde : le remboursement a été accepté, et `status` vous indique où il en est. ```json title="Réponse · 201 Created" { "code": 201, "status": "Created", "message": "Refund created successfully", "refund": { "id": "rfd_test_9xh0XQ5wu2lxCSUGajfv", "transaction": "trx_test_CSUGajfv9xh0XQ5wu2lx", "reference": "rma-881", "amount": 2000, "currency": "XAF", "status": "processing", "reason": "product_not_received", "metadata": {}, "sandbox": true, "created_at": "2026-09-11T10:30:00+00:00" } } ``` Le paiement est porté par `transaction`, pas par `payment`. Les lectures renvoient aussi un détail `tax` quand une taxe s'applique, une `timeline` des changements de statut, et `failure_reason` avec `failure_message` quand le remboursement a échoué. Un remboursement qui a pris de l'argent sur votre solde renvoie en plus `ledger_balance_currency`, `ledger_balance_before` et `ledger_balance_after` : votre solde juste avant le remboursement et juste après, si bien que la différence est ce qu'il a pris, part des frais du paiement comprise quand elle a bougé avec lui. En sandbox, ce sont ceux de votre solde sandbox. Le contenu de `refund.succeeded` les porte aussi. Un remboursement qui n'a rien pris, parce qu'un litige perdu l'avait déjà fait, n'a aucun des trois. > [!NOTE] > **Idempotency-Key, et ce sur quoi porte la clé** > > La clé n'expire jamais : la même clé renvoie toujours le même remboursement, jamais un second, et > la réutiliser pour un autre paiement ou un autre `amount` répond `422`. Une clé est consommée pour > toujours : > dérivez-la de ce remboursement précis, une commande et un numéro de remboursement, pas de la > commande seule. Un second remboursement du même montant ne ferait que vous rendre le premier. - [Suivre un remboursement](https://docs.wajub.com/fr/payments/refunds/track): Le suivre jusqu'à son propre résultat. - [Idempotence](https://docs.wajub.com/fr/best-practices/idempotency): Rejouer l'appel sans rembourser deux fois. --- # Remboursements URL: https://docs.wajub.com/fr/payments/refunds > Restituer des fonds sur un paiement réussi, puis suivre le remboursement jusqu'à son propre résultat. Un remboursement restitue tout ou partie d'un paiement réussi, et vous pouvez cumuler plusieurs remboursements partiels jusqu'à épuisement du montant d'origine. C'est un objet à part entière, avec son propre id, son propre statut et ses propres webhooks. > [!CAUTION] > **Les remboursements exigent la clé secrète** > > `POST /refunds` exige une clé secrète. Un appel qui porte une clé publique > est refusé avec `406 Not Acceptable` et le message `Private Key Required`. Cet endpoint a sa place > sur votre serveur, jamais dans un navigateur ni dans une application mobile. Deux pages vont plus loin : - [Créer un remboursement](https://docs.wajub.com/fr/payments/refunds/create), l'appel, ses paramètres et sa réponse. - [Suivre un remboursement](https://docs.wajub.com/fr/payments/refunds/track), ses webhooks, pourquoi un remboursement échoue, comment tester un échec, et la liste des remboursements. ## Ce qui peut être remboursé Cinq conditions sont vérifiées avant l'enregistrement d'un remboursement, et chacune échoue avec son propre `422`. | Condition | Ce que vous recevez en cas d'échec | | ----------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Le paiement est `succeeded` | `Transaction must be completed to be refunded. Current status: …` | | Aucune rétrofacturation n'est ouverte sur le paiement | `Transaction cannot be refunded while a chargeback is open: the payer's bank may return the funds itself. It can be refunded again once the dispute is decided.` | | Il reste un montant remboursable | `Transaction has already been fully refunded.`, ou `Transaction has already been fully refunded or charged back.` quand une rétrofacturation perdue a pris ce qui restait | | Le montant tient dans ce qui reste | `Refund amount exceeds refundable amount (…)` | | La devise correspond à celle du paiement | `Refunds must be in the transaction currency (XAF).` | Le montant remboursable est le montant du paiement moins tout ce qui a déjà été remboursé, en comptant les remboursements encore `pending` ou `processing` comme ceux qui ont réussi, et moins les rétrofacturations que vous avez perdues sur ce paiement : la banque du payeur lui a déjà rendu cet argent. Une rétrofacturation est un litige que le payeur a ouvert auprès de sa banque : les litiges dont `metadata.source` vaut `provider_webhook`. Tant qu'elle est `open` ou `under_review`, la banque peut rendre l'argent elle-même, alors aucun remboursement de ce paiement n'est accepté jusqu'à ce que le litige soit tranché. Un litige que le payeur a ouvert depuis Pocket ne bloque aucun remboursement. > [!NOTE] > **Un remboursement ne peut pas convertir une devise** > > `currency` est accepté, mais la seule valeur possible est la devise du paiement lui-même. Le champ > existe pour que vous puissiez être explicite, pas pour rembourser en XOF un paiement en XAF. Si > vous l'omettez, Wajub utilise de toute façon la devise du paiement. ## Le remboursement a son propre cycle de vie Cinq états, dont trois terminaux. Un remboursement ne revient jamais à un état précédent. **Remboursement** `pending` (accepté, pas encore envoyé) → [`refund.processing`] `processing` (transmis au prestataire) → [`refund.succeeded`] `succeeded` (fonds restitués, solde débité) Sorties anticipées, depuis pending ou processing: - `failed` (lire failure_reason) - `cancelled` (arrêté par Wajub avant l'envoi, depuis pending) Le délai ne dépend pas de Wajub. Sur une carte, c'est l'émetteur qui décide, et plusieurs jours sont normaux. Sur Mobile Money, le crédit arrive généralement en quelques minutes, parfois en quelques heures. Rien dans votre intégration n'y change quoi que ce soit : annoncez au client une fourchette plutôt qu'une heure précise. > [!WARNING] > **Un remboursement ne démarre pas dans le même état selon l'environnement** > > En production, un remboursement est créé `pending` et passe à `processing` quand il est envoyé. > En sandbox, il est créé directement en `processing` et se résout en quelques secondes. Écrivez votre handler sur les états terminaux et vous > ne verrez pas la différence ; si vous testez `pending`, vos tests en sandbox n'entreront jamais dans > cette branche. ## Qui envoie un remboursement live En production, un remboursement est envoyé de l'une de trois façons. `execution_mode` sur le remboursement dit laquelle, une fois que Wajub l'a planifié, et `manual_reason` dit pourquoi quand il n'est pas envoyé automatiquement. | `execution_mode` | Qui l'envoie | | ---------------- | -------------------------------------------------------------------------------------------------------------- | | `automatic` | Wajub. Voir les trois voies ci-dessous | | `merchant` | Vous : le paiement a été encaissé sur votre propre compte prestataire, qui ne peut ici ni rembourser ni verser | | `manual` | Le support Wajub | Un remboursement automatique repart par l'une de trois voies, essayées dans cet ordre : 1. **L'API de remboursement de votre prestataire**, quand il en a une que Wajub pilote : Stripe, Paystack, Flutterwave et PayPal aujourd'hui. L'argent repart par où il est venu, cartes comprises. 2. **Le réseau Wajub**, pour un paiement qu'il a encaissé : le montant est renvoyé sur le numéro mobile money du payeur. 3. **Un versement sur le numéro du payeur, par le prestataire qui a encaissé le paiement**, quand ce prestataire n'a pas d'API de remboursement mais sait verser sur ce canal : Fapshi, Campay, MeSomb, pawaPay et les prestataires du même type. Le versement part de votre propre compte chez ce prestataire. Il faut que ses versements soient approuvés sur Wajub et que le numéro du payeur soit connu. Quand aucune ne s'applique, le remboursement est à faire par vous (`merchant`) : remboursez le client depuis votre prestataire, puis marquez le remboursement comme fait sur sa page dans le Dashboard, ou annulez-le. Il vous revient aussi quand Wajub a tenté de l'envoyer depuis votre propre compte prestataire et que le prestataire l'a refusé, ou que son issue n'a pas pu être confirmée : Wajub ne peut pas consulter ce compte, vérifiez-le donc avant de rembourser à nouveau. Un tel remboursement est `processing`, et l'annuler le clôt en `failed`. Il se met aussi à jour seul quand le prestataire notifie Wajub du remboursement, ce que font Stripe, Paystack, PayPal, Adyen et FedaPay. `manual_reason` est un objet avec un `code` stable sur lequel brancher votre logique et un `message` que vous pouvez afficher. | `code` | Signification | | ------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `refund_from_your_provider` | Encaissé sur votre propre compte prestataire, qui ne peut ici ni rembourser ni verser : remboursez-le là-bas, puis marquez-le comme fait dans le Dashboard. Il se met aussi à jour quand le prestataire confirme | | `card_or_bank_payment` | Le réseau qui l'a encaissé ne rembourse que le mobile money. Le support Wajub envoie celui-ci | | `insufficient_balance` | Votre solde ne couvre pas encore le remboursement. Il part tout seul dès que le solde le couvre, pendant 72 heures ; passé ce délai, le support Wajub le traite | | `platform_balance_insufficient` | Sur une connexion Sync `lite` : le solde du vendeur ne couvre pas encore le remboursement, et le solde de la plateforme ne contient pas le reste. Il part tout seul dès qu'ils le couvrent, pendant 72 heures ; passé ce délai, le support Wajub le traite. [Quand un marchand passe en négatif](https://docs.wajub.com/fr/sync/payouts#when-a-merchant-goes-negative) | | `payer_number_missing` | Le numéro mobile money du payeur n'est pas connu | | `requested_over_24h` | Demandé il y a plus d'un jour : le support Wajub l'envoie | | `outcome_being_confirmed` | Envoyé, et la réponse de l'opérateur n'est pas encore définitive | | `automatic_attempt_failed` | L'opérateur l'a refusé et aucun argent n'est parti : le support Wajub le traite | | `wajub_review` | Le support Wajub le traite | `execution_mode` et `manual_reason` peuvent changer sans que le statut change ; chaque changement envoie `refund.updated` avec le remboursement tel qu'il est désormais. Dans tous les cas, le remboursement se termine `succeeded` ou `failed`. Les remboursements sandbox n'ont aucun des deux champs. ## Ce que dit le statut du paiement Un paiement affiche `partially_refunded` dès que des remboursements **réussis** couvrent une partie de son montant, et `refunded` dès qu'ils le couvrent en entier. Un remboursement `pending`, `processing` ou `failed` ne change rien. Le statut est une lecture, et rien d'autre ne bouge avec lui : aucun événement de paiement n'est émis, et le paiement n'est pas modifié par ailleurs. Pour savoir ce qui reste remboursable, listez les remboursements du paiement et additionnez ceux qui sont `pending`, `processing` ou `succeeded`. `GET /payments/{id}/refunds` Soustrayez ce total, et le montant des rétrofacturations que vous avez perdues sur le paiement, du montant du paiement et vous obtenez ce qui reste remboursable, c'est-à-dire exactement le chiffre que l'API vérifie quand vous envoyez le remboursement suivant. [Gérer les remboursements](https://docs.wajub.com/fr/guides/handle-refunds) le fait en code. > [!NOTE] > **Filtrer les paiements remboursés** > > `GET /payments?status=refunded` et `?status=partially_refunded` listent ces paiements, et > `?status=succeeded` les laisse de côté. ## Qui supporte les frais Wajub garde les frais d'un paiement que vous remboursez. Ce que vous décidez, c'est qui les supporte au final, pour la part des frais qui correspond au montant remboursé : vous, ou le client. C'est `fees_bearer`. | Les frais ont été payés par | `fees_bearer: merchant` | `fees_bearer: customer` | | ----------------------------------------- | ------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------- | | Vous (`bearer: merchant` sur le paiement) | Le client récupère le montant. Les frais que vous avez payés ne vous sont pas rendus | La part des frais est déduite de ce que le client récupère, et vous êtes débité d'autant en moins | | Le client, en plus (`bearer: customer`) | Le client récupère le montant et la part des frais, et vous êtes débité des deux | Le client récupère le montant, pas les frais | Sans ce champ, les frais restent à celui qui les a payés : c'est la première et la dernière case du tableau. Pour changer cela pour tous les remboursements, réglez-le une fois dans **Paramètres, Remboursements** ; `fees_bearer` sur un remboursement prend le dessus. Le remboursement vous dit ce qui a été appliqué : `fee_amount` est la part des frais, et `payer_amount` ce que le client reçoit. Votre solde est débité de `payer_amount`, ni plus ni moins. Un remboursement partiel prend la même proportion des frais, et le remboursement qui solde le paiement prend ce qu'il en reste : les parts s'additionnent exactement. Dans une devise sans subdivision, comme le XAF, une part est un nombre entier, et `payer_amount` aussi. Un paiement encaissé sur votre propre compte prestataire est différent. Wajub ne détient rien de son argent : votre solde n'est pas débité, vous envoyez le remboursement vous-même depuis ce prestataire, et le montant à envoyer est `payer_amount`. Avec `bearer: merchant`, Wajub n'a facturé aucuns frais sur ce paiement : `fee_amount` vaut `0` et `payer_amount` est égal à `amount`. Avec `bearer: customer`, le payeur a payé les frais en plus à votre prestataire, et le tableau ci-dessus s'applique. ## L'argent bouge au succès, pas à la création Créer un remboursement réserve le montant sur ce qui est remboursable, mais ne touche à aucun solde. Le débit a lieu quand le remboursement atteint `succeeded`, et seulement à ce moment-là, pour `payer_amount` : le montant, plus ou moins la part des frais. Deux conséquences à anticiper. En sandbox, un remboursement réussi débite votre solde sandbox du montant remboursé, comme un remboursement live débite votre solde. Un remboursement qui rembourse un litige que vous avez accepté le débite même s'il échoue, puisque le litige est perdu dans tous les cas. Et un remboursement émis sur un paiement déjà perdu dans un litige est plafonné au montant principal qui n'a pas déjà été repris : le même argent ne peut pas sortir deux fois par deux portes différentes. Ce que devient ensuite le solde, et comment se comporte un solde négatif, est expliqué dans [Solde et règlements](https://docs.wajub.com/fr/payouts/balance). ## Dans le Dashboard Un remboursement peut être émis sans écrire de code. Ouvrez un paiement dans **Paiements**, utilisez son action de remboursement, et le résultat est le même objet que celui que crée l'API. Le formulaire demande qui supporte les frais quand le paiement en portait, et affiche ce que le client recevra. L'action exige la permission `refund_payments`, distincte de `manage_payments` : un membre de l'équipe peut ainsi gérer les commandes sans pouvoir rendre de l'argent. **Remboursements** les liste tous avec leur statut, et les exporte en CSV ou Excel en production. Les remboursements que les payeurs demandent depuis Pocket se trouvent dans **Litiges**, comme une étape à part : voir [Demandes de remboursement](#refund-requests). ## Demandes de remboursement Un payeur qui utilise [Pocket](https://docs.wajub.com/fr/payments/customers/pocket) peut vous demander le remboursement d'un paiement qu'il a effectué, avec un montant et un motif. La demande apparaît dans la liste **Litiges** du Dashboard, comme une étape à part, et attend que vous l'approuviez ou la refusiez. Rien n'est remboursé avant l'approbation, et l'approbation crée le remboursement exactement comme le ferait l'API. Les membres qui gèrent les paiements reçoivent un e-mail à l'arrivée d'une demande. La demande est l'étape amiable. Si elle ne règle pas le problème, le payeur peut la faire passer en [litige](https://docs.wajub.com/fr/payments/disputes) : | Votre réponse | Quand le payeur peut passer en litige | | --------------------- | --------------------------------------------------------------------------------------------------------------------------- | | Aucune pour l'instant | À partir de 7 jours après la demande. Deux jours avant, les membres qui gèrent les paiements reçoivent un rappel par e-mail | | Un refus | Pendant 30 jours après votre réponse. Passé ce délai, la demande est close | | Une approbation | Jamais, l'argent a été rendu | Tant qu'une rétrofacturation est `open` ou `under_review` sur le paiement, c'est la banque du payeur qui décide. Une demande ne peut être ni approuvée ni passée en litige, et le payeur ne peut pas en envoyer une nouvelle. Ses délais cessent de courir et aucun rappel n'est envoyé. Une fois que la banque a tranché, ils reprennent là où ils en étaient : le jour où le payeur peut passer en litige, et la fin des 30 jours après un refus, arrivent plus tard, du temps qu'a duré la rétrofacturation. - [Gérer les remboursements](https://docs.wajub.com/fr/guides/handle-refunds): Le parcours complet, rapprochement compris. - [Litiges](https://docs.wajub.com/fr/payments/disputes): Quand l'argent est repris plutôt que rendu. - [Solde et règlements](https://docs.wajub.com/fr/payouts/balance): Où arrive un remboursement une fois qu'il a réussi. - [Cycle de vie d'un paiement](https://docs.wajub.com/fr/payments/lifecycle): Pourquoi le paiement reste succeeded pendant tout ce temps. - [Mode sandbox](https://docs.wajub.com/fr/developer-tools/testing/sandbox-mode): Les numéros et cartes de test, et ce que chacun déclenche. - [Référence API des remboursements](https://docs.wajub.com/fr/api/refunds): Tous les champs de la ressource, et les trois endpoints. --- # Suivre un remboursement URL: https://docs.wajub.com/fr/payments/refunds/track > Ses webhooks, pourquoi un remboursement échoue, un échec dans la sandbox, et la liste des remboursements. ## Webhooks Six événements suivent un remboursement. Abonnez-vous à chacun par son nom : un abonnement ne reconnaît que des noms exacts, et `refund.*` ne correspond à rien. | Événement | Déclenché quand | | ------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `refund.created` | Le remboursement a été accepté et enregistré | | `refund.processing` | Le remboursement a été envoyé. En live uniquement | | `refund.succeeded` | Fonds restitués. C'est sur celui-ci qu'il faut faire le rapprochement | | `refund.failed` | Le prestataire l'a refusé ou n'a pas pu le finaliser, lisez `failure_reason` | | `refund.cancelled` | Wajub a arrêté un remboursement live avant de l'envoyer : rien n'a quitté votre solde. Il arrive en `refund.failed`, avec `cancelled_by_wajub` pour `failure_reason` | | `refund.updated` | Un remboursement live a changé de voie : `execution_mode` ou `manual_reason` a changé. Live uniquement | > [!NOTE] > **refund.processing n'arrive jamais en sandbox** > > En live, un remboursement passe de `pending` à `processing` quand il est envoyé, et > `refund.processing` est envoyé. En sandbox, un remboursement est créé directement en `processing` : > cet événement n'arrive donc jamais. Utilisez `refund.created` si vous avez besoin d'un signal au > démarrage dans les deux environnements. **`refund.succeeded`**: Un remboursement total ou partiel est terminé sur le paiement. ```json title="refund.succeeded" { "id": "evt_Lm2Xc94Rf8Qp7Tz3Wk5Yb1Nd", "event": "refund.succeeded", "created": "2026-09-11T11:02:41+00:00", "livemode": true, "data": { "id": "rfd_9xh0XQ5wu2lxCSUGajfv", "transaction": "trx_CSUGajfv9xh0XQ5wu2lx", "reference": "rma-881", "amount": 2000, "currency": "XAF", "status": "succeeded", "reason": "product_not_received" } } ``` Dédupliquez sur l'`id` de l'événement, comme partout ailleurs. L'enregistrement et la vérification de signature sont dans [Webhooks](https://docs.wajub.com/fr/developer-tools/webhooks). ## Tester un remboursement en échec dans la sandbox Les résultats en sandbox sont déterministes, et ils dépendent du moyen de paiement du **paiement d'origine**, pas de ce que vous envoyez sur le remboursement. Payez avec le bon numéro, remboursez ensuite, et vous obtenez le résultat voulu. Pour un paiement fait par Mobile Money, ce sont les six derniers chiffres du numéro de téléphone qui décident. | Suffixe sur le paiement d'origine | Résultat du remboursement | | -------------------------------------- | ----------------------------------------------------------------------------------------------------- | | `000000` | Réussit | | `000009` | Le paiement réussit, le remboursement échoue toujours. C'est celui à utiliser pour vos tests | | `000001`, `000002`, `000003`, `000004` | Rien à rembourser : le paiement lui-même n'aboutit jamais, donc l'appel de remboursement répond `422` | | Tout autre suffixe | Réussit | Pour un paiement par carte, `4000000000005423` débite normalement puis fait échouer chaque remboursement. Toutes les autres cartes de test se remboursent sans problème. Les paiements en cryptomonnaies et les paiements bancaires se remboursent toujours avec succès, car il n'existe pas d'adresse d'échec pour les tester. Un remboursement sandbox échoué porte un `failure_reason` tiré au hasard parmi `insufficient_funds`, `refund_rejected_by_issuer`, `transaction_already_reversed`, `network_error`, `provider_error` et `provider_declined`, accompagné d'un `failure_message` lisible. Ce sont des codes qu'utilise aussi un remboursement live, listés dans [Pourquoi un remboursement a échoué](#why-a-refund-failed). > [!NOTE] > **Le seul cas aléatoire** > > Quand le paiement d'origine n'a aucun moyen de paiement rattaché, le résultat en sandbox est > aléatoire. Si vos tests sont instables, voici pourquoi : payez avec un numéro de test pour que le > résultat soit choisi. ## Pourquoi un remboursement a échoué Un remboursement `failed` porte toujours un `failure_reason`, pris dans cette liste en production comme en sandbox, et un `failure_message` à côté : les mots du fournisseur quand il en a envoyé. | `failure_reason` | Ce qu'il signifie | | ------------------------------ | ---------------------------------------------------------------------------------------------------------- | | `insufficient_funds` | Le fournisseur n'a pas pu financer le remboursement | | `refund_rejected_by_issuer` | Un émetteur de carte l'a refusé | | `transaction_already_reversed` | Le paiement était déjà annulé ou remboursé chez le fournisseur | | `invalid_number` | Le numéro ou le compte du payeur ne peut pas le recevoir, par exemple fermé ou non abonné. Live uniquement | | `limit_exceeded` | Un plafond du compte destinataire ou du fournisseur a été atteint. Live uniquement | | `network_error` | Le fournisseur n'a pas pu être joint à temps | | `provider_error` | Le fournisseur était indisponible, ou a refusé l'appel lui-même | | `provider_declined` | Le fournisseur l'a refusé sans dire pourquoi | | `ops_failed` | Le support Wajub n'a pas pu le mener à bien. `failure_message` dit pourquoi. Live uniquement | Un remboursement échoué ne prend rien sur votre solde, à une exception près en sandbox : le remboursement d'un litige que vous avez accepté, qui tient lieu de perte du litige (voir [L'argent bouge au succès](https://docs.wajub.com/fr/payments/refunds#the-money-moves-on-success-not-on-creation)). Une nouvelle tentative est un nouveau remboursement. ## Lister les remboursements Les remboursements sont renvoyés du plus récent au plus ancien, tous paiements confondus. `GET /refunds` | Paramètre de requête | Accepte | | ---------------------- | ----------------------------------------------------------- | | `per_page` | De 1 à 100, 25 par défaut | | `status` | `pending`, `processing`, `succeeded`, `failed`, `cancelled` | | `search` | Texte libre sur la référence et l'id du remboursement | | `date_from`, `date_to` | Dates, `date_to` jamais antérieure à `date_from` | | `cursor` | Passe en pagination par curseur, pour les exports | La récupération d'un remboursement se fait par son id. `GET /refunds/{id}` - [Créer un remboursement](https://docs.wajub.com/fr/payments/refunds/create): L'appel et ses paramètres. - [Webhooks](https://docs.wajub.com/fr/developer-tools/webhooks): Recevoir et vérifier les événements. --- # Facturation et abonnements URL: https://docs.wajub.com/fr/billing > Les factures, leur paiement par un client et le fonctionnement actuel de la facturation récurrente. Une facture est un document que vous remettez à un client, qui la règle quand il le décide sur une page hébergée par Wajub. Cette section explique comment émettre, envoyer et suivre vos factures. ## Contenu de la section Un produit est disponible : **Factures**. Il produit un document numéroté, héberge la page de paiement du client et suit les fonds encaissés pour cette facture. Un abonnement, au sens d'un plan auquel un client souscrit et d'un portefeuille débité chaque mois sans intervention, n'est pas encore disponible. | Besoin | Solution | | ---------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- | | Facturer une fois un client et être payé en ligne | [Factures](https://docs.wajub.com/fr/billing/invoice) | | Facturer le même client à intervalle fixe | Une facture récurrente : un nouveau brouillon à chaque cycle, qui reste à envoyer et à payer | | Débiter automatiquement un portefeuille enregistré selon un calendrier | Aucune pour le moment, consultez [Abonnements](https://docs.wajub.com/fr/billing/subscriptions) | | Accepter un paiement lancé par votre propre checkout | [Paiements](https://docs.wajub.com/fr/payments), pas la facturation | > [!WARNING] > **Mode live uniquement et accès selon le plan** > > Toutes les routes `/invoices` sont réservées au mode live. Une clé sandbox renvoie donc `403` > avec `This feature is only available in live mode.`, y compris pour les appels `GET`. La > fonctionnalité s'appelle Invoicing : **10 factures au total avec Pay as you go**, et non dix par > mois, puis un nombre illimité à partir de Growth. Une fois ce plafond atteint, la création renvoie > un code `403` avec une invitation à changer de plan. ## Une facture est un document, pas un débit Créer une facture ne déplace aucun fonds et n'envoie aucune notification. L'opération enregistre un document numéroté avec ses lignes, ses totaux et un statut, puis s'arrête. L'envoi, le paiement et les relances constituent trois opérations distinctes effectuées ensuite. `POST /invoices` - `customer_name` (string, required): Le destinataire de la facture. Un nom suffit, aucun enregistrement client n'est obligatoire. - `items` (array, required): Au moins une ligne. Chacune contient `name`, `quantity` et `unit_price`. - `invoice_date` (string (date), required): La date imprimée sur le document. Elle est obligatoire et ne possède aucune valeur par défaut. - `currency` (string, required): Code ISO 4217 d'une devise que Wajub prend en charge ; toute autre renvoie `422`. Tous les montants de la facture utilisent cette devise. - `language` (enum): `fr` ou `en`, la langue de l'e-mail et du PDF. Par défaut, la langue préférée du client lié, sinon la langue de votre compte ([**Paiement — Langue**](https://dashboard.wajub.com/settings/regional/language)), sinon `en`. - `customer_id` (string): Associe la facture à l'un de vos [clients](https://docs.wajub.com/fr/payments/customers), par son identifiant `cus_`. Ses coordonnées sont copiées dans le document lors de la création. - `customer_email` (string): Adresse à laquelle `/send` envoie la facture et son PDF, et adresse utilisée pour son paiement et son reçu. Facultatif : une facture sans e-mail reste payable, et [sa page demande une adresse au payeur](#where-the-customer-pays). - `due_date` (string (date)): Date égale ou postérieure à `invoice_date`. La facture passe à `overdue` une fois cette date passée. - `payment_terms_days` (integer): Définit `due_date` à ce nombre de jours après aujourd'hui, uniquement en l'absence de `due_date`. - `items[].tax_rate` (number): Pourcentage appliqué à cette ligne, de 0 à 100. Il est calculé par ligne, pas par facture. - `items[].discount_type` (enum): `percentage` ou `fixed`, associé à `items[].discount_value`. - `items[].discount_value` (number): Le pourcentage, ou le montant déduit de cette ligne. Une remise sur toute la facture se donne avec `global_discount_type` et `global_discount_value` : voir [Une remise sur toute la facture](https://docs.wajub.com/fr/billing/invoice#an-invoice-wide-discount). - `document_type` (enum, default `invoice`): `invoice`, `quote` ou `estimate`. Un devis ou une estimation se lit et se liste comme une facture, et reste un brouillon : voir [Devis et estimations](https://docs.wajub.com/fr/billing/invoice#quotes-and-estimates). - `is_recurring` (boolean): Marque le document comme récurrent. Lisez la section sur les factures récurrentes avant de vous y fier. - `notes` (string): Texte libre sous les lignes, limité à 5 000 caractères. `terms` et `footer` se trouvent à côté. Les totaux sont calculés à partir des lignes. Vous n'envoyez donc jamais `subtotal` ou `total`. Envoyez la facture avec une clé secrète live. **Créer une facture** ```bash curl https://api.wajub.com/invoices \ -H "Authorization: sk.xxxxxxxxxxxxxxxx…" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: invoice-amina-september" \ -d '{ "customer_name": "Amina Traoré", "customer_email": "amina@example.com", "invoice_date": "2026-09-11", "due_date": "2026-09-25", "currency": "XAF", "items": [ { "name": "Consulting, September", "quantity": 3, "unit_price": 150000 } ] }' ``` ```javascript const invoice = await wajub.invoices.create({ customer_name: 'Amina Traoré', customer_email: 'amina@example.com', invoice_date: '2026-09-11', due_date: '2026-09-25', currency: 'XAF', items: [ { name: 'Consulting, September', quantity: 3, unit_price: 150000 }, ], }); console.log(invoice.invoice_number, invoice.total); ``` ```python invoice = wajub.invoices.create({ "customer_name": "Amina Traoré", "customer_email": "amina@example.com", "invoice_date": "2026-09-11", "due_date": "2026-09-25", "currency": "XAF", "items": [ { "name": "Consulting, September", "quantity": 3, "unit_price": 150000 }, ], }) print(invoice.invoice_number, invoice.total) ``` ```php $invoice = $wajub->invoices->create([ 'customer_name' => 'Amina Traoré', 'customer_email' => 'amina@example.com', 'invoice_date' => '2026-09-11', 'due_date' => '2026-09-25', 'currency' => 'XAF', 'items' => [ ['name' => 'Consulting, September', 'quantity' => 3, 'unit_price' => 150000], ], ]); echo $invoice->invoice_number; ``` ```go invoice, err := client.Invoices.Create(context.Background(), map[string]any{ "customer_name": "Amina Traoré", "customer_email": "amina@example.com", "invoice_date": "2026-09-11", "due_date": "2026-09-25", "currency": "XAF", "items": []map[string]any{ {"name": "Consulting, September", "quantity": 3, "unit_price": 150000}, }, }, nil) ``` La réponse est `201 Created`. Tous les autres appels utilisent l'`id`. `invoice_number` vaut encore `null` : la référence lisible imprimée sur le document est attribuée à l'envoi de la facture, selon la numérotation de votre compte, la même séquence que celle du Dashboard : `INV-` (ou le préfixe que vous avez choisi), l'année, puis un compteur qui repart à `0001` chaque année. ```json title="Réponse · 201 Created" { "code": 201, "status": "Created", "message": "Invoice created", "invoice": { "id": "inv_LRQqYvlhrgUOE225KMKU", "invoice_number": null, "document_type": "invoice", "status": "draft", "customer_name": "Amina Traoré", "customer_email": "amina@example.com", "invoice_date": "2026-09-11", "due_date": "2026-09-25", "currency": "XAF", "subtotal": 450000, "discount_amount": 0, "tax_amount": 0, "total": 450000, "amount_paid": 0, "amount_due": 450000, "is_recurring": false, "sent_at": null, "paid_at": null, "created_at": "2026-09-11T14:00:00+00:00" } } ``` ## Cycle de vie d'une facture **Facture** `draft` (pas encore payable) → [`invoice.updated`] `sent` (la page s'ouvre) → [`invoice.updated`] `viewed` (le client l'a ouverte) → [`invoice.updated`] `paid` (amount_due atteint zéro) Les autres états possibles d'une facture: - `partial` (une partie du total est encaissée) - `overdue` (la date d'échéance est dépassée) - `cancelled` (fermée et plus payable) - `refunded` (payée, puis remboursée) La répétition sur ces flèches est volontaire. Chaque transition effectuée par l'API arrive sous la forme `invoice.updated`, et le champ `status` du payload indique laquelle. Quatre événements en disent plus : `invoice.sent` quand la facture est envoyée, `invoice.cancelled` quand elle est annulée, `invoice.paid` quand elle est réglée en totalité, et `invoice.payment_succeeded` pour chaque paiement effectué sur sa page, échéance comprise. Il n'existe aucun `invoice.overdue`. Deux états changent automatiquement. `viewed` est écrit lors de la première ouverture de la page de paiement par le client. Une facture passe à `overdue` pendant la nuit une fois sa `due_date` passée. Vous ne définissez aucun de ces deux états. ## Envoyer une facture `POST /invoices/{id}/send` Sur un brouillon, l'appel attribue le `invoice_number`, passe la facture en `sent`, renseigne `sent_at` et envoie à `customer_email` un e-mail avec le lien de la facture et une copie PDF en pièce jointe, dans la `language` de la facture. Rappelé sur une facture déjà envoyée, il renvoie l'e-mail et renseigne de nouveau `sent_at`, sans changer son statut. L'appel a besoin d'un destinataire : `customer_email`, ou l'e-mail du client que désigne `customer_id`. Sans l'un ni l'autre, il répond `422` sur `customer_email` et ne change rien, même sur un brouillon. Une facture déjà `paid`, `cancelled` ou `refunded` répond `400` : il n'y a plus rien à réclamer. Un devis ou une estimation répond `400 Only an invoice can be sent through the API.` Un brouillon adressé à un nom seulement peut être envoyé depuis le Dashboard, qui le numérote et ouvre sa page sans envoyer d'e-mail ; partagez vous-même le lien, et la page demande un e-mail au payeur. C'est aussi l'envoi qui ouvre la page de paiement : la page d'un brouillon ne s'ouvre pas, et seuls quatre statuts sont payables : `sent`, `viewed`, `overdue` et `partial`. ## Page de paiement du client La page de paiement possède son propre domaine et utilise l'id de la facture comme chemin complet. ```text title="URL du client" https://invoice.wajub.com/inv_LRQqYvlhrgUOE225KMKU ``` Cette adresse ne figure pas dans la réponse de l'API. Construisez-la à partir de l'`id` reçu ou copiez-la depuis le Dashboard. C'est aussi le seul endroit où elle peut changer : un marchand qui héberge ses factures sur un domaine personnalisé vérifié utilise ce domaine au lieu de `invoice.wajub.com`. La page s'ouvre dans la `language` de la facture, celle de son e-mail et de son PDF. Le payeur peut l'afficher dans l'autre langue en ajoutant `?locale=fr` ou `?locale=en` à l'adresse. La page constitue un checkout ordinaire. Elle affiche votre marque, les lignes de la facture et les opérateurs disponibles pour sa devise. Un paiement effectué sur cette page reste un paiement ordinaire : il apparaît dans votre liste Payments, émet `payment.succeeded`, rejoint votre solde et peut être remboursé comme les autres. Après sa réussite, la facture passe à `paid`. Elle passe à `partial` si elle est divisée en plusieurs échéances et qu'une seule a été réglée. Le paiement désigne la facture dans son champ `invoice`, l'`id` de la facture. Remboursez ce paiement en totalité, ou tous les paiements faits sur la facture, et la facture passe à `refunded`, avec `refunded_at` renseigné et l'envoi de `invoice.updated`. Cela vaut aussi pour une facture payée en partie, `partial` ou `overdue` avec une part réglée : dès que tout ce qui est entré en ligne est rendu, elle est `refunded`. Un remboursement partiel laisse la facture en l'état. Une facture qui porte de l'argent enregistré avec `mark-paid` garde son statut : cet argent n'est jamais passé par Wajub, un remboursement Wajub ne peut donc pas le rendre. Émettez un avoir depuis le Dashboard pour cette part. Une facture n'a pas besoin d'e-mail pour être payée. Quand elle n'en porte aucun, c'est-à-dire sans `customer_email` ni `customer_id`, la page affiche au payeur un champ e-mail au-dessus du bouton de paiement et n'ouvre le paiement qu'avec une adresse valide. Cette adresse reçoit la confirmation du paiement et son reçu, et le paiement est rattaché à celui de vos [clients](https://docs.wajub.com/fr/payments/customers) qui la porte, créé avec le nom de la facture si vous n'en avez pas encore. L'adresse est aussi inscrite sur la facture comme son `customer_email`, et `invoice.updated` vous en informe : l'échéance suivante ne la redemande pas, et `/send` comme les relances ont désormais un destinataire. Seule la première adresse donnée est conservée, et un e-mail que vous avez mis sur la facture n'est jamais remplacé. La page ne demande rien quand la facture porte un e-mail, et le payeur ne peut pas lui en substituer un autre. Elle ne demande rien non plus quand la facture est associée à un client : c'est ce client qui paie, que sa fiche comporte un e-mail ou non. La page sert aussi la facture au format PDF, pour que le client la conserve, à l'adresse `https://api.wajub.com/i/{id}/pdf`, dans la `language` de la facture sauf si `?locale=fr` ou `?locale=en` demande l'autre. Toute personne qui détient l'`id` peut ouvrir les deux : partagez-le comme vous partageriez le lien lui-même. ## Enregistrer des fonds encaissés ailleurs De nombreuses factures sont payées en espèces ou par un virement bancaire extérieur à Wajub. Vous pouvez enregistrer ce paiement sur le document sans créer un faux paiement. `POST /invoices/{id}/mark-paid` Omettez `amount` pour régler intégralement la facture. Si vous le transmettez, supérieur à zéro, il est ajouté à `amount_paid`. La facture reste alors `partial` jusqu'au règlement du total. La facture doit être ouverte : un brouillon répond `400`, puisqu'il n'a jamais été envoyé, de même qu'une facture déjà `paid`, qui garde son `paid_at`. Une facture `cancelled` ou `refunded` refuse aussi l'appel avec un code `400`. Un document fermé par son propre parcours ne peut donc pas être réactivé. Un `amount` nul répond `422`. ## État actuel des factures récurrentes La création accepte `is_recurring` et `recurring_interval`. L'intervalle peut valoir `daily`, `weekly`, `monthly`, `quarterly` ou `yearly`. Quand un cycle arrive à échéance, Wajub copie la facture récurrente dans un nouveau document avec de nouvelles dates et les coordonnées actuelles du client. La première copie est due un intervalle après la date de la facture elle-même, et chaque cycle est généré une seule fois. Deux points définissent la récurrence sur Wajub. Chaque facture générée est créée avec `draft`. La chaîne produit donc des documents, et non des débits. Chaque document doit encore être envoyé et payé. Elle nécessite la fonctionnalité Facturation récurrente, disponible à partir de **Growth**. Sans elle, aucune copie n'est générée et la facture parente est conservée. Les renouvellements reprennent automatiquement si un compte ayant changé pour un plan inférieur repasse ensuite au plan requis. La création d'une facture récurrente via l'API réussit avec tous les plans. Sans la fonctionnalité, c'est la génération qui est ignorée. [Factures récurrentes](https://docs.wajub.com/fr/billing/invoice/recurring) détaille le calendrier, ce qu'une copie reprend et la façon dont une récurrence se termine. ## Événements envoyés à votre webhook Cinq événements portent la facture, pas les fonds. | Événement | Déclencheur | | --------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `invoice.created` | Une facture est créée avec `draft` : une seule fois, avec ses lignes et ses totaux | | `invoice.updated` | Un champ ou un statut change via l'API, y compris `viewed` et un paiement. Un seul par `PUT`, avec ses lignes et ses totaux, et aucun pour un `PUT` qui ne change rien | | `invoice.payment_succeeded` | Un paiement effectué sur la page de la facture réussit, chaque échéance comprise | | `invoice.paid` | La facture est réglée en totalité, en ligne ou avec `mark-paid` | | `invoice.deleted` | Une facture `draft` est supprimée | Les fonds produisent un événement distinct. Lorsqu'un client paie une facture en ligne, vous recevez `payment.succeeded` pour le paiement, puis `invoice.updated` et `invoice.payment_succeeded` pour le document, et `invoice.paid` une fois la facture réglée. Livrez la commande avec `payment.succeeded`, car il contient le montant, le canal et la référence du prestataire, et son champ `invoice` désigne la facture payée. > [!WARNING] > **Seule l'API émet ces événements** > > Une modification effectuée dans le Dashboard n'envoie aucun webhook. L'envoi, le marquage comme > payée ou l'annulation d'une facture depuis l'interface restent silencieux. Les factures passent à > `overdue` pendant la nuit, et ce changement n'envoie aucun webhook non plus. Utilisez le polling sur `GET /invoices` si vous devez les détecter. ## Dans le Dashboard **Factures** va plus loin que l'API : elle suit les relances, exporte la liste, agit sur plusieurs factures à la fois, duplique une facture et émet des avoirs. Le guide du tableau de bord couvre chacun : [le suivi et les relances](https://docs.wajub.com/dashboard/invoices/track-and-remind), [les corrections et les avoirs](https://docs.wajub.com/dashboard/invoices/correct-cancel-refund), et [les actions groupées et l'export](https://docs.wajub.com/dashboard/invoices/export-and-bulk). Un avoir est un document : il ne déplace aucun argent. Il diminue le `amount_paid` de la facture de son montant, et un paiement ultérieur sur la facture en tient compte : la facture passe à `paid` quand ce qui a été payé, moins ses avoirs, couvre le total. Une facture impayée passe à `overdue` pendant la nuit une fois sa `due_date` passée, et les [relances](https://docs.wajub.com/fr/billing/invoice/reminders) partent d'elles-mêmes, avant et après l'échéance, vers les clients dont la facture reste ouverte. - [Factures](https://docs.wajub.com/fr/billing/invoice): Tous les champs, le calcul des totaux et les huit appels. - [Démarrage rapide](https://docs.wajub.com/fr/billing/invoice/quickstart): Émettez votre première facture et faites-la payer. - [Abonnements](https://docs.wajub.com/fr/billing/subscriptions): Les besoins de la facturation récurrente et la raison pour laquelle elle n'est pas encore un produit. - [Clients](https://docs.wajub.com/fr/payments/customers): Associez une facture à un client enregistré plutôt qu'à un simple nom. - [Webhooks](https://docs.wajub.com/fr/developer-tools/webhooks): Écoutez payment.succeeded et rapprochez la facture. - [Référence API des factures](https://docs.wajub.com/fr/api/invoices): Tous les champs et les huit endpoints. --- # Factures URL: https://docs.wajub.com/fr/billing/invoice > L'objet facture, les montants calculés et les huit appels qui permettent de le gérer. Une facture est un document que vous émettez et que votre client règle sur une page hébergée par Wajub. Cette page sert de référence pour l'objet facture et ses appels ; [Facturation et abonnements](https://docs.wajub.com/fr/billing) présente le cycle. La facturation est un produit live dont l'accès dépend de votre plan. Une clé sandbox renvoie `403 This feature is only available in live mode.`. Un plan sans cette fonctionnalité renvoie `403 Invoicing is not available on your plan.`. Une fois le plafond total d'un plan atteint, la réponse est `403 You have reached the maximum number of invoices for your plan.`. Seuls les documents de type `invoice` comptent dans ce plafond. ## Les huit appels Voici toutes les opérations proposées par l'API pour les factures. `/send` est l'appel qui envoie une facture par e-mail, son PDF est un lien public ([plus bas](#the-pdf)), et aucun endpoint ne débite un client. | Appel | Fonction | | ------------------------------- | -------------------------------------------------------------------------- | | `GET /invoices` | Lister, filtrer et trier vos factures | | `POST /invoices` | Créer une facture, toujours avec `draft` | | `GET /invoices/{id}` | Récupérer une facture | | `PUT /invoices/{id}` | Remplacer une facture tant qu'elle est un brouillon | | `DELETE /invoices/{id}` | Supprimer une facture tant qu'elle est un brouillon | | `POST /invoices/{id}/send` | La numéroter, l'envoyer par e-mail avec son PDF et ouvrir sa page publique | | `POST /invoices/{id}/mark-paid` | Enregistrer un paiement encaissé ailleurs | | `POST /invoices/{id}/cancel` | Fermer une facture | `{id}` correspond à l'`id` renvoyé par l'API, soit la chaîne `inv_`. ## L'objet facture Tous les appels renvoient cet objet. `items` est présent chaque fois que la facture est chargée avec ses lignes, ce qui est le cas pour les huit appels. ```json title="Réponse · une facture avec une ligne taxée" { "id": "inv_LRQqYvlhrgUOE225KMKU", "invoice_number": "INV-2026-0001", "document_type": "invoice", "status": "sent", "customer": "cus_7Kq2mX9vL4tRb3nP8sZcWd1e", "customer_name": "Amina Traoré", "customer_email": "amina@example.com", "customer_company_name": "Traoré & Fils", "customer_phone": "+237670000000", "customer_address": "BP 1204, Douala", "invoice_date": "2026-09-12", "due_date": "2026-10-12", "currency": "XAF", "language": "fr", "subtotal": 300000, "discount_amount": 0, "has_global_discount": false, "global_discount_type": null, "global_discount_value": null, "tax_amount": 57750, "total": 357750, "amount_paid": 0, "amount_due": 357750, "payment_type": "full", "is_recurring": false, "recurring_interval": null, "next_invoice_date": null, "recurring_parent": null, "notes": null, "terms": null, "footer": null, "accept": {}, "sent_at": "2026-09-12T09:14:02+00:00", "paid_at": null, "cancelled_at": null, "items": [ { "id": "00000000-0000-0000-0000-000000000001", "name": "Consulting service", "description": null, "quantity": 2, "unit": null, "unit_price": 150000, "tax_rate": 19.25, "tax_amount": 57750, "discount_type": null, "discount_value": 0, "discount_amount": 0, "subtotal": 300000, "total": 357750, "sort_order": 0 } ], "created_at": "2026-09-12T09:10:44+00:00", "updated_at": "2026-09-12T09:14:02+00:00" } ``` `invoice_number` vaut `null` sur un brouillon et est attribué au premier envoi de la facture. Il vient de la numérotation de votre compte, la même séquence que celle du Dashboard, que vous envoyiez la facture ici ou là-bas : le préfixe (`INV-` si vous ne l'avez pas changé), l'année, puis un compteur à quatre chiffres, tels que réglés dans les paramètres de facturation du Dashboard. Le compteur repart à `0001` chaque année, sauf si vous l'avez désactivé, et un numéro est unique au sein de votre compte. `status` peut valoir `draft`, `sent`, `viewed`, `partial`, `paid`, `overdue`, `cancelled` ou `refunded`. [Facturation et abonnements](https://docs.wajub.com/fr/billing) présente les transitions entre ces statuts et les webhooks émis. `customer` désigne le client à qui la facture est adressée, par l'identifiant `cus_` que renvoie l'[API Clients](https://docs.wajub.com/fr/payments/customers), et vaut `null` quand vous l'avez adressée à un nom et un e-mail seulement. Rapprochez vos données sur `customer`. `language` est la langue de l'e-mail et du PDF de la facture, `fr` ou `en`, enregistrée à la création de la facture, ici ou dans le Dashboard. `accept` est la restriction des moyens proposés au payeur sur la page de la facture, `{}` quand il n'y en a pas. Deux champs sont calculés plutôt que stockés. `amount_due` vaut toujours `total` moins `amount_paid`, avec un minimum de zéro. Il ne devient donc jamais négatif en cas de trop-perçu. `amount_paid` ne change qu'avec `mark-paid`, un paiement effectué sur la page hébergée ou un avoir émis depuis le Dashboard, qui le diminue de son montant. Un paiement sur la page compte les trois : les paiements en ligne de la facture, plus ce que `mark-paid` a enregistré, moins ses avoirs. Une facture qui porte un avoir de 1 000 ne passe à `paid` qu'une fois 1 000 de plus que son total reçus. ## Créer une facture Les quatre champs obligatoires sont `customer_name`, `items`, `invoice_date` et `currency`. Tous les autres sont facultatifs. La facture est toujours créée avec `draft`, quelle que soit votre requête. `POST /invoices` - `customer_name` (string, required): Le destinataire de la facture. Ce champ reste obligatoire même avec `customer_id`. - `customer_id` (string): L'un de vos clients, par son identifiant `cus_`. Son nom, son e-mail, son entreprise, son téléphone et son adresse sont copiés sur la facture et remplacent les champs `customer_*` envoyés. Un client qui n'est pas le vôtre renvoie `422`. - `customer_email` (string): L'adresse à laquelle `/send` envoie la facture et son PDF, et à laquelle partent ses [relances](https://docs.wajub.com/fr/billing/invoice/reminders). - `customer_company_name` (string): Imprimé sur le document à côté du nom. - `customer_phone` (string): Imprimé sur le document. - `customer_address` (string): Imprimée sur le document. - `items` (array, required): Au moins une ligne. Consultez l'objet ligne ci-dessous. - `invoice_date` (date, required): La date d'émission imprimée sur le document. - `due_date` (date): La date de paiement attendue. Elle doit être égale ou postérieure à `invoice_date`. - `payment_terms_days` (integer): Définit `due_date` à ce nombre de jours après aujourd'hui, uniquement si `due_date` est absent. Le calcul part de la date du jour, pas de `invoice_date`. - `currency` (string, required): Une devise que Wajub prend en charge : `XAF`, `XOF`, `NGN` et les autres de la [liste](https://docs.wajub.com/fr/resources/coverage). Tout autre code renvoie `422`. - `language` (enum): `fr` ou `en` : la langue de l'e-mail envoyé par `/send`, des relances et du PDF. Par défaut, la langue préférée du client que désigne `customer_id`, sinon la langue de votre compte ([**Paiement — Langue**](https://dashboard.wajub.com/settings/regional/language)), sinon `en`. Toute autre valeur renvoie `422`. - `accept` (object): Restreint les moyens proposés au payeur sur la page de la facture, comme sur [`POST /payments`](https://docs.wajub.com/fr/payments/payment-methods#choosing-what-a-payment-accepts). - `is_recurring` (boolean, default `false`): Marque la facture comme modèle. Consultez [Factures récurrentes](https://docs.wajub.com/fr/billing/invoice/recurring). - `recurring_interval` (enum): `daily`, `weekly`, `monthly`, `quarterly` ou `yearly`. - `payment_type` (enum, default `full`): `full`, `split` ou `milestone`. Les paiements en plusieurs fois sont décrits ci-dessous. - `payment_schedules` (array): Les échéances lorsque `payment_type` ne vaut pas `full`. - `notes` (string): Texte libre imprimé sur le document, limité à 5 000 caractères. - `terms` (string): Conditions générales, limitées à 5 000 caractères. - `footer` (string): Texte de pied de page, limité à 500 caractères. - `template_id` (string (uuid)): Un modèle de facture créé dans le Dashboard. Il détermine uniquement la mise en page imprimée. - `document_type` (enum, default `invoice`): `invoice`, `quote` ou `estimate`. Un devis et une estimation restent des brouillons : voir [Devis et estimations](#quotes-and-estimates). - `global_discount_type` (enum): `percentage` ou `fixed` : une remise sur toute la facture. Avec `has_global_discount: true` et sans type, la remise est un `percentage`. Voir [Une remise sur toute la facture](#an-invoice-wide-discount). - `global_discount_value` (number): Le pourcentage, 100 au plus, ou le montant lorsque le type vaut `fixed`, dans l'unité principale, avec au plus deux décimales et pas plus que la devise n'en a ; un montant déduit au plus le montant des lignes. Requis lorsque `has_global_discount` vaut `true`. Sans `has_global_discount`, il va avec `global_discount_type` : l'un sans l'autre renvoie `422`. - `has_global_discount` (boolean): `true` applique la remise que fixe `global_discount_value`, un `percentage` sauf si `global_discount_type` vaut `fixed`. `false` retire la remise sur toute la facture, quoi qu'indiquent les deux autres. Chaque entrée de `items` constitue un objet distinct. - `name` (string, required): Le libellé de la ligne. - `description` (string): Une seconde ligne sous le libellé. - `quantity` (number, required): La quantité. - `unit_price` (integer, required): Le prix unitaire, en unités entières de la devise. - `unit` (string): Un libellé comme `hour` ou `day`. Il sert uniquement à l’affichage. - `tax_rate` (number): Un pourcentage de 0 à 100, ajouté à la ligne. - `discount_type` (enum): `percentage` ou `fixed`. - `discount_value` (number): Le pourcentage, 100 au plus, ou le montant lorsque le type vaut `fixed`, au plus `quantity` × `unit_price` de la ligne : une remise ne fait jamais passer une ligne sous zéro. Au-delà, `422` sur `items.N.discount_value`. **Une facture avec TVA et remise sur une ligne** ```bash curl https://api.wajub.com/invoices \ -H "Authorization: sk.xxxxxxxxxxxxxxxx…" \ -H "Content-Type: application/json" \ -d '{ "customer_name": "Traoré & Fils", "customer_email": "amina@example.com", "invoice_date": "2026-09-12", "payment_terms_days": 30, "currency": "XAF", "items": [ { "name": "Consulting service", "quantity": 2, "unit_price": 150000, "tax_rate": 19.25 }, { "name": "Onboarding", "quantity": 1, "unit_price": 100000, "discount_type": "percentage", "discount_value": 10 } ] }' ``` ```javascript const invoice = await wajub.invoices.create({ customer_name: 'Traoré & Fils', customer_email: 'amina@example.com', invoice_date: '2026-09-12', payment_terms_days: 30, currency: 'XAF', items: [ { name: 'Consulting service', quantity: 2, unit_price: 150000, tax_rate: 19.25 }, { name: 'Onboarding', quantity: 1, unit_price: 100000, discount_type: 'percentage', discount_value: 10 }, ], }); ``` ```python invoice = wajub.invoices.create({ "customer_name": "Traoré & Fils", "customer_email": "amina@example.com", "invoice_date": "2026-09-12", "payment_terms_days": 30, "currency": "XAF", "items": [ {"name": "Consulting service", "quantity": 2, "unit_price": 150000, "tax_rate": 19.25}, {"name": "Onboarding", "quantity": 1, "unit_price": 100000, "discount_type": "percentage", "discount_value": 10}, ], }) ``` ```php $invoice = $wajub->invoices->create([ 'customer_name' => 'Traoré & Fils', 'customer_email' => 'amina@example.com', 'invoice_date' => '2026-09-12', 'payment_terms_days' => 30, 'currency' => 'XAF', 'items' => [ ['name' => 'Consulting service', 'quantity' => 2, 'unit_price' => 150000, 'tax_rate' => 19.25], ['name' => 'Onboarding', 'quantity' => 1, 'unit_price' => 100000, 'discount_type' => 'percentage', 'discount_value' => 10], ], ]); ``` ```go invoice, err := client.Invoices.Create(context.Background(), map[string]any{ "customer_name": "Traoré & Fils", "customer_email": "amina@example.com", "invoice_date": "2026-09-12", "payment_terms_days": 30, "currency": "XAF", "items": []map[string]any{ {"name": "Consulting service", "quantity": 2, "unit_price": 150000, "tax_rate": 19.25}, {"name": "Onboarding", "quantity": 1, "unit_price": 100000, "discount_type": "percentage", "discount_value": 10}, }, }, nil) ``` La création est le seul appel de facture qui respecte `Idempotency-Key`. Rejouer une création avec la même clé renvoie la première facture au lieu d'en émettre une seconde. Rejouer un appel `send` ou `mark-paid` l'exécute une nouvelle fois. ## Les montants sont en unité principale `unit_price`, `subtotal`, `discount_amount`, `tax_amount`, `total` et `amount_paid` sont tous exprimés dans l'unité principale de la devise : `150000` représente cent cinquante mille francs, et non mille cinq cents. Chaque montant est arrondi à l'unité mineure de la devise au fil du calcul, et le suivant part de la valeur arrondie : des francs entiers en XAF et en XOF, donc 19,25 % de 1 000 vaut 193 ; deux décimales dans la plupart des autres devises, trois en KWD, BHD, JOD, OMR et TND. Les montants d'une ligne gardent au plus deux décimales. ## Calcul d'une ligne Chaque ligne effectue ses propres calculs à chaque enregistrement, dans l'ordre suivant. Vous envoyez les quatre premières valeurs. Les quatre autres sont calculées et renvoyées. ``` subtotal = quantity × unit_price discount_amount = discount_type = percentage → subtotal × discount_value / 100 discount_type = fixed → discount_value otherwise → 0 taxable = subtotal − discount_amount tax_amount = taxable × tax_rate / 100 total = taxable + tax_amount ``` La taxe est exclusive. Elle est ajoutée à la ligne et n'en est jamais extraite. Elle est aussi calculée après la remise. Une remise de 10 % sur une ligne taxée réduit donc également la taxe. Sur une facture avec une [remise sur toute la facture](#an-invoice-wide-discount), la taxe de la ligne se calcule sur `taxable` moins la part de cette remise qui revient à la ligne ; la part elle-même reste dans le `discount_amount` de la facture, si bien que le `total` de la ligne reste `taxable` plus cette taxe. La facture additionne ensuite les lignes, chacune nette de sa remise. ``` subtotal = Σ (subtotal de la ligne − discount_amount de la ligne) discount_amount = la remise sur toute la facture, 0 sans elle tax_amount = Σ tax_amount des lignes total = Σ total des lignes − discount_amount amount_due = max(0, total − amount_paid) ``` Une remise sur une ligne est déduite du `subtotal`, du `total` et du `amount_due` de la facture, et sa taxe avec elle. Le `discount_amount` de la facture est la seule remise sur toute la facture : celles des lignes sont dans `items[].discount_amount`. ## Une remise sur toute la facture `global_discount_type` et `global_discount_value` déduisent une remise de toute la facture, après les remises des lignes. Un pourcentage se calcule sur le `subtotal`, les lignes après leurs propres remises et hors taxe ; un montant `fixed` est déduit tel quel, au plus ce `subtotal`. La remise est répartie sur les lignes au prorata de leur montant, avant la taxe : la taxe de chaque ligne se calcule sur ce qui en reste, si bien que la remise baisse aussi la taxe, et qu'une remise de 100 % n'en laisse aucune. Le `total` est le `subtotal` moins la remise, plus la taxe et les éventuels frais de livraison. ```text title="Deux lignes et 10 % sur toute la facture" 2 × 50 000, 10 % de remise, TVA 19,25 % net de la ligne 90 000 part 9 000 1 × 20 000, 5 000 de remise net de la ligne 15 000 part 1 500 subtotal 105 000 (90 000 + 15 000) discount_amount 10 500 (10 % de 105 000, réparti 9 000 + 1 500) tax_amount 15 593 (19,25 % de 81 000, la première ligne moins sa part) total 110 093 (105 000 − 10 500 + 15 593) ``` La facture renvoie la remise choisie dans `has_global_discount`, `global_discount_type` et `global_discount_value`, et ce qu'elle représente dans `discount_amount`. La page de paiement encaisse le total remisé, et le reçu comme la confirmation de paiement indiquent la remise après les lignes. ## Devis et estimations Créez un devis ou une estimation avec `document_type: quote` ou `estimate`. Il se lit, se corrige, s'annule et se supprime par son `id` comme une facture, et `GET /invoices?document_type=quote` liste les devis. Il reste un `draft` : l'API ne l'envoie pas, ne le numérote pas et ne l'encaisse pas. `POST /invoices/{id}/send` renvoie donc `400 Only an invoice can be sent through the API.` et `mark-paid` renvoie `400 Only an invoice can be marked as paid.` Le `document_type` est fixé à la création et conservé : `PUT` ne le change pas. ## Paiement en plusieurs fois Définissez `payment_type` sur `split` ou `milestone`, puis transmettez le calendrier. La page hébergée débite alors une échéance à la fois au lieu du solde total. - `amount` (number, required): Le montant débité pour cette échéance. - `label` (string): Affiché sur la page de paiement. La valeur par défaut est `Installment 1` ou `Milestone 1`. - `due_date` (date): Affichée sur la page de paiement. Le client ouvre la facture et voit la première échéance non payée. Son `amount` est débité dans la limite de l'`amount_due` restant. Après son règlement, Wajub marque cette échéance comme payée, ajoute le montant à `amount_paid` et fait passer la facture à `partial`. La visite suivante propose l'échéance suivante. La facture passe à `paid` lorsque `amount_paid` atteint le total. Si toutes les échéances sont réglées mais qu'un solde reste dû, la page propose le paiement du reste en une fois. > [!WARNING] > **Vous pouvez définir un calendrier, mais pas le relire** > > L'objet facture renvoie `payment_type`, mais jamais `payment_schedules`. Les échéances existantes, > leur paiement et la transaction associée à chacune sont visibles uniquement dans le Dashboard. > Conservez votre propre copie du calendrier envoyé si vous devez le suivre de votre côté. ## Lister les factures `GET /invoices` renvoie vos factures live, de la plus récente à la plus ancienne, par groupes de vingt-cinq. `GET /invoices` - `search` (string): Recherche en texte intégral sur le numéro, le nom et l’e-mail du client. - `status` (enum): Un statut, exactement comme il apparaît sur l’objet : `draft`, `sent`, `viewed`, `partial`, `paid`, `overdue`, `cancelled` ou `refunded`. - `customer_id` (string): Un client, par son identifiant `cus_`. - `date_from` (date): Limite inférieure de `invoice_date`. - `date_to` (date): Limite supérieure de `invoice_date`, égale ou postérieure à `date_from`. - `due_date_from` (date): Limite inférieure de `due_date`. - `due_date_to` (date): Limite supérieure de `due_date`, égale ou postérieure à `due_date_from`. - `amount_min` (number): Limite inférieure de `total`, en unité principale, comme `total` se lit : `10000` vaut dix mille francs. Chaque facture est comparée dans sa propre devise. - `amount_max` (number): Limite supérieure de `total`, en unité principale. - `payment_status` (enum): `unpaid`, `partially_paid` ou `fully_paid`, déterminé en comparant `amount_paid` à `total`. - `sort_by` (enum, default `created_at`): `invoice_date`, `due_date`, `total`, `amount_paid`, `status` ou `created_at`. La liste le suit en premier, puis du plus récent au plus ancien entre factures à égalité. - `sort_dir` (enum, default `desc`): `asc` ou `desc`. - `per_page` (integer, default `25`): Entre 1 et 100. - `document_type` (enum, default `invoice`): `invoice`, `quote` ou `estimate` : un type de document par liste. Sans lui, la liste ne contient que des factures. Un `status`, un `payment_status`, un `document_type`, un `sort_by` ou un `sort_dir` hors de ces valeurs renvoie une `422` sur ce champ, comme un `per_page` hors limites. De même pour une borne de date qui n'est pas une date, ou une borne supérieure antérieure à la borne inférieure. **Toutes les factures en retard d'un client** ```bash curl -G https://api.wajub.com/invoices \ -H "Authorization: sk.xxxxxxxxxxxxxxxx…" \ -d status=overdue \ -d customer_id=cus_7Kq2mX9vL4tRb3nP8sZcWd1e ``` ```javascript const { data, meta } = await wajub.invoices.list({ status: 'overdue', customer_id: 'cus_7Kq2mX9vL4tRb3nP8sZcWd1e', }); ``` ```python page = wajub.invoices.list({ "status": "overdue", "customer_id": "cus_7Kq2mX9vL4tRb3nP8sZcWd1e", }) ``` ```php $page = $wajub->invoices->list([ 'status' => 'overdue', 'customer_id' => 'cus_7Kq2mX9vL4tRb3nP8sZcWd1e', ]); ``` ```go page, err := client.Invoices.List(context.Background(), map[string]any{ "status": "overdue", "customer_id": "cus_7Kq2mX9vL4tRb3nP8sZcWd1e", }) ``` La liste utilise une pagination par curseur avec le tri par défaut. Si vous demandez un `sort_by` ou un `sort_dir` personnalisé, elle revient aux numéros de page. ## Corriger une facture `PUT /invoices/{id}` remplace le document au lieu de le modifier partiellement. `customer_name`, `items`, `invoice_date` et `currency` sont obligatoires à chaque appel. Renvoyez donc toute la facture avec votre modification, pas uniquement le changement. Les lignes envoyées remplacent entièrement les précédentes : chaque mise à jour remplace les lignes et leurs id. Tous les `items[].id` changent donc. > [!CAUTION] > **Seul un brouillon est modifiable** > > Dès que la facture a quitté `draft`, et sur un brouillon qui a reçu des fonds, `PUT` renvoie > `400 This invoice cannot be edited (paid, cancelled, or has payments).` et `DELETE` renvoie > `400 This invoice cannot be deleted.` Une facture envoyée est déjà figée. Annulez-la et émettez-en > une nouvelle. Vous pouvez modifier `recurring_interval` pendant une mise à jour. L'alias `recurring_frequency` accepté à la création ne l'est pas. Utilisez donc toujours `recurring_interval`. La remise sur toute la facture est conservée tant que vous ne l'envoyez pas : `has_global_discount: false` la retire. `language` reste tel quel tant que vous ne l'envoyez pas, même quand `customer_id` change. Un `PUT` envoie un seul `invoice.updated`, avec les lignes et les totaux enregistrés, et aucun quand il ne change rien. Une facture supprimée ne vous est plus jamais renvoyée, et son numéro de facture reste utilisé. ## Enregistrer un paiement encaissé ailleurs `mark-paid` sert aux fonds reçus hors de Wajub, en espèces ou par virement bancaire. Il modifie le solde de la facture, mais ne crée aucune transaction et ne règle rien. `POST /invoices/{id}/mark-paid` - `amount` (number): Le montant reçu, supérieur à zéro. Omettez-le pour enregistrer la totalité de `total`. - `payment_date` (date): Le jour où l'argent est arrivé. Devient `paid_at` quand ce paiement règle la facture, y compris un paiement unique du montant total. Aujourd'hui si omis. - `transaction_id` (string): Votre référence pour l'argent reçu, un numéro de virement par exemple. Conservée sur le paiement que la facture enregistre, que le Dashboard affiche dans son historique ; l'API ne la renvoie pas. - `payment_method` (string): Conservé de la même façon, pour vos dossiers. - `notes` (string): Conservées de la même façon, pour vos dossiers. Un `amount` inférieur au total est ajouté à `amount_paid` et fait passer le statut à `partial`. Rappelez l'endpoint pour l'échéance suivante. Les montants s'accumulent et la facture passe à `paid` avec un `paid_at` dès qu'ils atteignent le total. **Enregistrer la moitié d'un paiement reçu par virement bancaire** ```bash curl https://api.wajub.com/invoices/inv_LRQqYvlhrgUOE225KMKU/mark-paid \ -H "Authorization: sk.xxxxxxxxxxxxxxxx…" \ -H "Content-Type: application/json" \ -d '{ "amount": 178875, "payment_date": "2026-09-20" }' ``` ```javascript const invoice = await wajub.invoices.markPaid('inv_LRQqYvlhrgUOE225KMKU', { amount: 178875, payment_date: '2026-09-20', }); ``` ```python invoice = wajub.invoices.mark_paid("inv_LRQqYvlhrgUOE225KMKU", { "amount": 178875, "payment_date": "2026-09-20", }) ``` ```php $invoice = $wajub->invoices->markPaid('inv_LRQqYvlhrgUOE225KMKU', [ 'amount' => 178875, 'payment_date' => '2026-09-20', ]); ``` ```go invoice, err := client.Invoices.MarkPaid(context.Background(), "inv_LRQqYvlhrgUOE225KMKU", map[string]any{ "amount": 178875, "payment_date": "2026-09-20", }, nil) ``` La facture doit être ouverte : envoyée, consultée, en retard ou partiellement payée. Un brouillon renvoie `400`, puisqu'il n'a été ni envoyé ni numéroté : envoyez-le d'abord. Une facture déjà `paid` renvoie aussi `400` et garde son `paid_at` ; de même pour une facture `cancelled` ou `refunded`, avec `400 This invoice cannot be marked as paid`, et pour un devis ou une estimation, avec `400 Only an invoice can be marked as paid.` Un `amount` nul ou négatif renvoie `422`. ## Le PDF Une fois envoyée, une facture a un PDF que toute personne qui détient son `id` peut télécharger, sans clé : la copie que votre client archive. Un brouillon renvoie `404`, comme sa page. ```text title="La facture en PDF" https://api.wajub.com/i/inv_LRQqYvlhrgUOE225KMKU/pdf ``` Il est rédigé dans la `language` de la facture. Ajoutez `?locale=fr` ou `?locale=en` pour l'obtenir dans l'autre langue. C'est le lien que propose la page de la facture : partagez-le comme vous partagez la page. ## Annuler une facture `POST /invoices/{id}/cancel` définit le statut sur `cancelled`, renseigne `cancelled_at` et ferme la page publique. Une facture déjà `paid`, `cancelled` ou `refunded` renvoie `400 This invoice cannot be cancelled`. Une facture partiellement payée ne peut plus être modifiée ni supprimée. L'annuler la clôt sans rembourser les fonds encaissés. Rembourser en totalité ce qui a été payé en ligne, avec les [remboursements](https://docs.wajub.com/fr/payments/refunds) sur les paiements sous-jacents, la fait passer à `refunded`, sauf si une part a été enregistrée avec `mark-paid`. - [Démarrage rapide](https://docs.wajub.com/fr/billing/invoice/quickstart): Émettez et suivez votre première facture de bout en bout. - [Factures récurrentes](https://docs.wajub.com/fr/billing/invoice/recurring): Ce que l'indicateur de récurrence configure ou non. - [Relances et suivi](https://docs.wajub.com/fr/billing/invoice/reminders): Quand votre client est relancé d'une facture impayée. - [Facturation et abonnements](https://docs.wajub.com/fr/billing): Les statuts, les transitions et les webhooks. --- # Démarrage rapide URL: https://docs.wajub.com/fr/billing/invoice/quickstart > Émettre une facture, ouvrir sa page de paiement et savoir quand elle a été payée. Quatre étapes suffisent pour passer de rien à de l'argent sur votre solde : créez le document, ouvrez sa page, transmettez l'URL au client, puis attendez le paiement. Rien ne se passe automatiquement entre ces étapes. > [!WARNING] > **Uniquement en live, et votre première facture est réelle** > > Les factures n'existent pas dans la sandbox. Toutes les routes `/invoices`, y compris `GET`, > répondent `403` avec `This feature is only available in live mode.` à une clé `sk_test.`. Vous ne > pouvez donc rien essayer au préalable. Émettez votre première facture à votre propre nom, pour un > petit montant. La fonctionnalité est Invoicing : **10 factures au total avec Pay as you go**, et > un nombre illimité à partir de Growth. ## 1. Créer le document Une facture est créée comme brouillon et le reste jusqu'à ce que vous la fassiez avancer. Sa création enregistre un document numéroté, rien de plus : aucun argent ne circule, aucun e-mail n'est envoyé et le client n'est informé de rien. Quatre champs sont obligatoires, mais la fiche d'un client n'en fait pas partie. Une facture est adressée à un nom. Vous pouvez donc facturer une personne qui ne vous a encore jamais payé. `POST /invoices` - `customer_name` (string, required): Nom de la personne à qui la facture est adressée. - `items` (array, required): Au moins une ligne, chacune avec `name`, `quantity` et `unit_price`. - `invoice_date` (string (date), required): Date imprimée sur le document. - `currency` (string, required): Code ISO 4217. Tous les montants de la facture utilisent cette devise. - `customer_email` (string): Adresse à laquelle `/send` envoie la facture et son PDF, et adresse utilisée pour son paiement et son reçu. Sans elle, `/send` répond `422`, sauf si `customer_id` désigne un client doté d'un e-mail ; une facture envoyée sans e-mail depuis le Dashboard voit sa page le demander au payeur. - `due_date` (string (date)): Égale ou postérieure à `invoice_date`. Détermine quand la facture devient en retard. - `accept` (object): Réduit les moyens de paiement proposés par la page de la facture, par `countries`, `channels`, `types` et `currencies`. Voir [Choisir ce qu'un paiement accepte](https://docs.wajub.com/fr/payments/payment-methods#choosing-what-a-payment-accepts). - `customer_id` (string): Associe un [client](https://docs.wajub.com/fr/payments/customers) existant, par son identifiant `cus_`. Ses informations sont copiées dans le document lors de sa création. La liste complète des champs, les taxes, les remises et le reste se trouvent sur la page [Factures](https://docs.wajub.com/fr/billing/invoice). Envoyez cette requête avec une clé secrète live. **Créer une facture** ```bash curl https://api.wajub.com/invoices \ -H "Authorization: sk.xxxxxxxxxxxxxxxx…" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: invoice-amina-september" \ -d '{ "customer_name": "Amina Traoré", "customer_email": "amina@example.com", "invoice_date": "2026-09-11", "due_date": "2026-09-25", "currency": "XAF", "items": [ { "name": "Consulting, September", "quantity": 3, "unit_price": 150000 } ] }' ``` ```javascript const invoice = await wajub.invoices.create({ customer_name: 'Amina Traoré', customer_email: 'amina@example.com', invoice_date: '2026-09-11', due_date: '2026-09-25', currency: 'XAF', items: [ { name: 'Consulting, September', quantity: 3, unit_price: 150000 }, ], }); console.log(invoice.id, invoice.total); ``` ```python invoice = wajub.invoices.create({ "customer_name": "Amina Traoré", "customer_email": "amina@example.com", "invoice_date": "2026-09-11", "due_date": "2026-09-25", "currency": "XAF", "items": [ { "name": "Consulting, September", "quantity": 3, "unit_price": 150000 }, ], }) print(invoice.id, invoice.total) ``` ```php $invoice = $wajub->invoices->create([ 'customer_name' => 'Amina Traoré', 'customer_email' => 'amina@example.com', 'invoice_date' => '2026-09-11', 'due_date' => '2026-09-25', 'currency' => 'XAF', 'items' => [ ['name' => 'Consulting, September', 'quantity' => 3, 'unit_price' => 150000], ], ]); echo $invoice->id; ``` ```go invoice, err := client.Invoices.Create(context.Background(), map[string]any{ "customer_name": "Amina Traoré", "customer_email": "amina@example.com", "invoice_date": "2026-09-11", "due_date": "2026-09-25", "currency": "XAF", "items": []map[string]any{ {"name": "Consulting, September", "quantity": 3, "unit_price": 150000}, }, }, nil) ``` La réponse est `201 Created`. Les totaux sont calculés à partir des lignes. `subtotal`, `total` et `amount_due` sont donc renseignés dans la réponse, même si vous ne les avez pas envoyés. ```json title="Réponse · 201 Created" { "code": 201, "status": "Created", "message": "Invoice created", "invoice": { "id": "inv_LRQqYvlhrgUOE225KMKU", "invoice_number": null, "status": "draft", "customer_name": "Amina Traoré", "invoice_date": "2026-09-11", "due_date": "2026-09-25", "currency": "XAF", "subtotal": 450000, "total": 450000, "amount_paid": 0, "amount_due": 450000, "sent_at": null, "paid_at": null } } ``` Conservez l'`id` : tous les appels suivants en ont besoin. `invoice_number` vaut encore `null`. La référence lisible imprimée sur le document est attribuée à l'étape suivante, selon la numérotation de votre compte, la même séquence que celle du Dashboard : `INV-` (ou le préfixe que vous avez choisi), l'année, puis un compteur qui repart à `0001` chaque année. ## 2. Ouvrir sa page de paiement Une facture au statut `draft` ne peut pas être payée : sa page ne s'ouvre pas. Seuls quatre statuts permettent le paiement : `sent`, `viewed`, `overdue` et `partial`. Un appel suffit pour la sortir du statut `draft`. `POST /invoices/{id}/send` **Ouvrir la facture au paiement** ```bash curl -X POST https://api.wajub.com/invoices/inv_LRQqYvlhrgUOE225KMKU/send \ -H "Authorization: sk.xxxxxxxxxxxxxxxx…" ``` ```javascript const invoice = await wajub.invoices.send('inv_LRQqYvlhrgUOE225KMKU'); console.log(invoice.status); ``` ```python invoice = wajub.invoices.send("inv_LRQqYvlhrgUOE225KMKU") print(invoice["status"]) ``` ```php $invoice = $wajub->invoices->send('inv_LRQqYvlhrgUOE225KMKU'); echo $invoice['status']; ``` ```go invoice, err := client.Invoices.Send(context.Background(), "inv_LRQqYvlhrgUOE225KMKU", nil) if err != nil { log.Fatal(err) } log.Println(invoice["status"]) ``` La réponse est `200`, avec `status: "sent"`, `sent_at` horodaté et le `invoice_number` attribué. L'appel envoie aussi à `customer_email` un e-mail avec le lien de la facture et une copie PDF en pièce jointe. Le rappeler plus tard renvoie l'e-mail et renseigne de nouveau `sent_at`, sans changer le statut. L'appel refuse d'envoyer à personne. Sans `customer_email`, et sans `customer_id` dont le client a un e-mail, il répond `422` sur `customer_email` et la facture reste un brouillon. Une facture déjà `paid`, `cancelled` ou `refunded` répond `400`. ## 3. Transmettre l'URL L'e-mail ne suffit pas toujours : c'est peut-être par WhatsApp ou par SMS que vous joignez vraiment ce client. L'adresse à partager correspond à l'identifiant de la facture sur son propre domaine. ```text title="L'URL du client" https://invoice.wajub.com/inv_LRQqYvlhrgUOE225KMKU ``` Cette URL ne figure pas dans la réponse de l'API. Construisez-la à partir de l'`id` conservé. Seul le domaine peut varier : un marchand qui distribue ses factures depuis un domaine personnalisé et vérifié utilise ce domaine. Le Dashboard affiche l'adresse réelle sur la facture. La page qui s'ouvre est un checkout classique. Elle reprend votre identité visuelle, les lignes de la facture et les opérateurs disponibles pour sa devise. La première fois que le client l'ouvre, la facture passe automatiquement de `sent` à `viewed`. Si vous n'avez pas renseigné `customer_email`, `/send` refuse la facture : envoyez-la plutôt depuis le Dashboard, qui ouvre sa page sans envoyer d'e-mail. La page affiche alors au payeur un champ e-mail au-dessus du bouton de paiement et n'ouvre le paiement qu'une fois ce champ rempli. Cette adresse reçoit la confirmation du paiement et son reçu, et elle est inscrite sur la facture comme son `customer_email` (`invoice.updated` est envoyé) : les échéances suivantes et `/send` l'utilisent. ## 4. Savoir quand elle a été payée Une facture payée produit deux événements qui ne sont pas interchangeables. `payment.succeeded` représente l'argent. Il contient le montant, le canal et la référence du prestataire. C'est cet événement qui doit déclencher la livraison, car lui seul prouve que les fonds ont circulé. `invoice.updated` représente le document. Il est émis à chaque modification de la facture. Le paiement n'est qu'une de ces modifications. **`invoice.updated`**: Émis à chaque modification de la facture. Lisez `data.status` pour connaître laquelle. ```json title="invoice.updated" { "id": "evt_aio5DpN577tNU2vOxdmuZGhT", "event": "invoice.updated", "livemode": true, "created": "2026-09-11T15:42:10+00:00", "api_version": "2026-10-11", "pending_webhooks": 1, "request": { "id": null, "idempotency_key": null }, "data": { "id": "inv_LRQqYvlhrgUOE225KMKU", "invoice_number": "INV-2026-0001", "status": "paid", "currency": "XAF", "total": 450000, "amount_paid": 450000, "amount_due": 0, "paid_at": "2026-09-11T15:42:09+00:00" } } ``` Deux autres événements suivent l'argent du côté du document. `invoice.payment_succeeded` arrive pour chaque paiement effectué sur la page de la facture, échéance comprise, et `invoice.paid` une fois la facture réglée en totalité. Tous deux portent la facture, comme `invoice.sent` quand la facture est envoyée et `invoice.cancelled` quand elle est annulée. Il n'existe aucun `invoice.overdue` : pour celui-là, le statut du payload d'un `invoice.updated` vous indique la transition concernée. Et `payment.succeeded` désigne la facture payée dans son champ `invoice`. > [!NOTE] > **Livrez à partir du paiement, rapprochez à partir de la facture** > > Livrez l'achat du client à la réception de `payment.succeeded`. Utilisez `invoice.updated` pour > maintenir votre copie du document à jour. Faire l'inverse revient à agir selon un statut que le > marquage manuel comme payé peut également produire. ## Quand l'argent a été reçu ailleurs Espèces, virement bancaire ou paiement qui n'est jamais passé par Wajub : enregistrez-le sur le document au lieu de laisser la facture ouverte. `POST /invoices/{id}/mark-paid` N'envoyez aucun `amount` pour régler entièrement la facture. Si vous en envoyez un, supérieur à zéro, il est ajouté à `amount_paid`. La facture reste alors au statut `partial` jusqu'à ce que le total soit couvert. Un brouillon, une facture déjà payée, annulée ou remboursée refusent l'appel avec `400` ; un `amount` nul répond `422`. ## Les statuts et qui les attribue Vous ne pouvez définir que trois des huit statuts. Les autres résultent des actions du client ou de Wajub, pendant la nuit. Il est utile de le savoir avant de construire votre propre machine à états. | Statut | Signification | Défini par | | ----------- | ----------------------------------- | ------------------------------------------------------------------------ | | `draft` | Créée, non payable | Création | | `sent` | Payable, en attente | Votre appel `/send` | | `viewed` | Le client a ouvert la page | Le client, à la première ouverture | | `partial` | Une partie du total a été reçue | Un paiement ou votre appel `/mark-paid` | | `paid` | Entièrement réglée | Un paiement ou votre appel `/mark-paid` | | `overdue` | Échéance dépassée, toujours impayée | Wajub, pendant la nuit une fois `due_date` passée | | `cancelled` | Clôturée, plus payable | Votre appel `/cancel` | | `refunded` | Payée, puis remboursée | Des remboursements couvrant tous les paiements en ligne qui l'ont réglée | - [Factures](https://docs.wajub.com/fr/billing/invoice): Tous les champs, le calcul des totaux et les huit appels. - [Factures récurrentes](https://docs.wajub.com/fr/billing/invoice/recurring): Ce que fait aujourd'hui l'indicateur de récurrence, et ce qu'il ne fait pas. - [Relances et suivi](https://docs.wajub.com/fr/billing/invoice/reminders): Relancer une facture qui n'a plus donné signe de vie. - [Clients](https://docs.wajub.com/fr/payments/customers): Facturer la fiche d'un client plutôt qu'un simple nom. - [Référence API des factures](https://docs.wajub.com/fr/api/invoices): Tous les champs et les huit endpoints. --- # Factures récurrentes URL: https://docs.wajub.com/fr/billing/invoice/recurring > Ce que configure l'indicateur de récurrence, ce qui génère la facture suivante et ce qui ne le fait pas. Une facture récurrente est une facture classique que Wajub copie dans un nouveau brouillon à chaque cycle. Chaque copie doit encore être envoyée et réglée par le client : rien n'est débité automatiquement. ## Marquer une facture comme récurrente Il n'existe ni endpoint distinct ni ressource d'abonnement. Deux champs de l'appel de création classique couvrent toute la fonctionnalité. `POST /invoices` - `is_recurring` (boolean, default `false`): Marque cette facture comme celle que Wajub copie à chaque cycle. La première copie est due un intervalle après `invoice_date`. Seule une facture peut être récurrente : sur un devis ou une estimation, `true` répond `422`. - `recurring_interval` (enum): `daily`, `weekly`, `monthly`, `quarterly` ou `yearly`. Intervalle entre les copies. - `recurring_frequency` (enum): Accepté à la création comme autre nom de `recurring_interval`, avec les cinq mêmes valeurs. - `customer_id` (string): Obligatoire ici. Une facture récurrente sans fiche client ne génère jamais rien. Tout le reste de la facture, notamment les lignes, les totaux et les notes, fonctionne exactement comme sur une facture ponctuelle. **Une facture répétée chaque mois** ```bash curl https://api.wajub.com/invoices \ -H "Authorization: sk.xxxxxxxxxxxxxxxx…" \ -H "Content-Type: application/json" \ -d '{ "customer_id": "cus_7Kq2mX9vL4tRb3nP8sZcWd1e", "customer_name": "Amina Traoré", "invoice_date": "2026-09-11", "currency": "XAF", "items": [ { "name": "Retainer", "quantity": 1, "unit_price": 250000 } ], "is_recurring": true, "recurring_interval": "monthly" }' ``` ```javascript const invoice = await wajub.invoices.create({ customer_id: 'cus_7Kq2mX9vL4tRb3nP8sZcWd1e', customer_name: 'Amina Traoré', invoice_date: '2026-09-11', currency: 'XAF', items: [{ name: 'Retainer', quantity: 1, unit_price: 250000 }], is_recurring: true, recurring_interval: 'monthly', }); ``` ```python invoice = wajub.invoices.create({ "customer_id": "cus_7Kq2mX9vL4tRb3nP8sZcWd1e", "customer_name": "Amina Traoré", "invoice_date": "2026-09-11", "currency": "XAF", "items": [{ "name": "Retainer", "quantity": 1, "unit_price": 250000 }], "is_recurring": True, "recurring_interval": "monthly", }) ``` ```php $invoice = $wajub->invoices->create([ 'customer_id' => 'cus_7Kq2mX9vL4tRb3nP8sZcWd1e', 'customer_name' => 'Amina Traoré', 'invoice_date' => '2026-09-11', 'currency' => 'XAF', 'items' => [ ['name' => 'Retainer', 'quantity' => 1, 'unit_price' => 250000], ], 'is_recurring' => true, 'recurring_interval' => 'monthly', ]); ``` ```go invoice, err := client.Invoices.Create(context.Background(), map[string]any{ "customer_id": "cus_7Kq2mX9vL4tRb3nP8sZcWd1e", "customer_name": "Amina Traoré", "invoice_date": "2026-09-11", "currency": "XAF", "items": []map[string]any{ {"name": "Retainer", "quantity": 1, "unit_price": 250000}, }, "is_recurring": true, "recurring_interval": "monthly", }, nil) ``` La réponse est la même que pour toute autre facture, avec `201 Created`, `status: "draft"`, les deux champs de récurrence et rien de plus. ```json title="Réponse · 201 Created, abrégée" { "invoice": { "id": "inv_LRQqYvlhrgUOE225KMKU", "invoice_number": null, "status": "draft", "currency": "XAF", "total": 250000, "is_recurring": true, "recurring_interval": "monthly" } } ``` > [!WARNING] > **recurring_frequency est un autre nom, pas un multiplicateur** > > `recurring_frequency: "monthly"` signifie chaque mois, pas un nombre de mois. La mise à jour ne > l'accepte pas : envoyez `recurring_interval` partout. ## Ce que l'API ne peut pas définir La récurrence possède d'autres réglages. Aucun n'est disponible dans l'API. Une fin après N occurrences, ou un intervalle de N mois, ne peut pas être défini par l'API. | Réglage | Rôle | Emplacement | | --------------------------------- | ------------------------------------------------------------------------------------------ | -------------------------- | | Une date de début | Place la première copie à la date de votre choix, au lieu d'un intervalle après la facture | Le formulaire du Dashboard | | Une date de fin | Le dernier jour pour lequel un cycle est généré | Le formulaire du Dashboard | | Une fin après un nombre de copies | Arrête la génération après ce nombre de copies | Non disponible | | Un multiple de l'intervalle | Tous les deux mois, toutes les trois semaines | Non disponible | Une date de fin saisie dans le Dashboard est appliquée : le cycle qui tombe ce jour-là est le dernier généré, puis la série s'arrête définitivement. Une récurrence créée par l'API n'a aucune règle de fin : elle court jusqu'à ce que vous [l'arrêtiez](#stopping-a-recurrence). ## Ce qui est renvoyé et ce qui ne l'est pas Quatre champs de récurrence reviennent sur l'objet facture. | Champ | Sur une facture récurrente | Sur une copie générée | | -------------------- | --------------------------------------------------------------------------------------------------- | ------------------------------------------------------- | | `is_recurring` | `true` tant que la série court, `false` une fois arrêtée | `false` : une copie ne génère rien | | `recurring_interval` | `daily`, `weekly`, `monthly`, `quarterly` ou `yearly` | Celui du modèle, recopié | | `next_invoice_date` | La date de la prochaine copie, `YYYY-MM-DD`. `null` une fois la série arrêtée ou la facture annulée | `null` | | `recurring_parent` | `null` | L'`id` de la facture récurrente dont elle a été générée | Une copie est donc la facture dont `recurring_parent` est renseigné. La règle de fin ne figure pas dans la réponse, et `GET /invoices` n'a pas de filtre de récurrence, contrairement à la liste du Dashboard. ## Déroulement d'un cycle La première copie est due un intervalle après l'`invoice_date` de la facture, jamais dans le passé : une facture antidatée ne produit donc pas les cycles écoulés avant qu'elle soit récurrente. Un cycle n'est jamais généré deux fois, même pour une série désactivée puis réactivée. Une copie ne peut pas devenir récurrente elle-même (`422`), et le duplicata d'une facture récurrente est un simple brouillon, qui ne se répète que si vous le décidez. À la date de chaque cycle, Wajub copie chaque facture récurrente non annulée, sauf si sa date de fin est passée ou si votre plan n'inclut pas la fonctionnalité. | La copie hérite | La copie a en propre | | -------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- | | Les lignes, avec leurs quantités, prix et taxes | Aucun `invoice_number` avant son envoi, comme tout brouillon | | La devise et la remise globale de la facture | `invoice_date`, définie sur la date du cycle arrivé à échéance | | Les notes, les conditions, le pied de page et les instructions de paiement | `due_date`, trente jours plus tard | | Le modèle, la langue et les réglages d'affichage | Le bloc client, relu depuis la fiche du client | | Les moyens de paiement acceptés | `is_recurring: false`. Une copie est une facture ordinaire et ne génère jamais ses propres copies | Chaque cycle produit exactement une copie. Une série mensuelle, trimestrielle ou annuelle ne saute jamais un mois : un mois après le 31 janvier, c'est le 28 février, et la série continue à partir du 28\. Les dates des cycles sont en UTC. Deux de ces points méritent votre attention. Le bloc client est repris depuis la fiche actuelle à chaque cycle. Une adresse ou un nom d'entreprise corrigé sur la fiche apparaît donc dans le document suivant sans modifier les précédents. Par ailleurs, `due_date` est toujours fixée à trente jours après la date de la copie, quelles que soient les conditions de la facture d'origine. > [!CAUTION] > **Une copie est un brouillon, pas un débit** > > Chaque facture générée arrive au statut `draft`, avec `amount_paid` remis à zéro. Elle n'est ni > ouverte au paiement, ni envoyée par e-mail, ni payée, et elle reste un brouillon après son > échéance : seule une facture envoyée passe `overdue`. Quelqu'un doit encore appeler `/send` et > transmettre l'URL à chaque cycle, exactement comme pour une facture ponctuelle. La récurrence vous > évite seulement de rédiger le document. > [!WARNING] > **Sans fiche client, aucune copie** > > Une facture sans `customer_id` ne génère jamais rien. Une facture adressée uniquement à un > `customer_name`, ce qui est parfaitement valide pour une facture ponctuelle, ne produit aucune > copie et ne signale rien. > Envoyez `customer_id` lorsque vous définissez `is_recurring`. ## Arrêter une récurrence Une date de fin, quand le Dashboard en a enregistré une, arrête la série d'elle-même. Sinon, vous l'arrêtez, à tout moment et quel que soit le statut de la facture, payée comprise. `POST /invoices/{id}/stop-recurring` ```bash title="Arrêter la série et conserver le document" curl -X POST https://api.wajub.com/invoices/inv_LRQqYvlhrgUOE225KMKU/stop-recurring \ -H "Authorization: sk.xxxxxxxxxxxxxxxx…" ``` L'appel ne prend pas de corps. La facture revient avec `is_recurring: false` et `next_invoice_date: null`, rien d'autre ne change, et `invoice.updated` est émis. Aucune copie n'est générée après cet appel, et les copies déjà générées restent telles quelles : chacune est une facture à part entière, à envoyer, annuler ou supprimer comme une autre. Arrêter une série déjà arrêtée répond `200` sans rien changer. Dans le Dashboard, la même action s'appelle **Arrêter la récurrence**, dans le menu d'actions de la facture. Appelez-le sur la facture récurrente, pas sur une copie. Une copie n'a pas de série propre : l'appel y répond `400`, avec l'identifiant du modèle dans `recurring_parent` : ```json title="Réponse · 400 sur une copie générée" { "code": 400, "status": "Bad Request", "message": "This invoice was generated by a recurring invoice. Stop the series on that one.", "recurring_parent": "inv_LRQqYvlhrgUOE225KMKU" } ``` Deux autres appels touchent la série, et tous deux sont plus restreints. `PUT /invoices/{id}` avec `is_recurring: false` l'arrête aussi, mais seulement tant que la facture est un brouillon, puisque seul un brouillon est modifiable. Annuler la facture arrête aussi la génération, et efface `next_invoice_date`, mais l'annulation est refusée une fois la facture payée. ## Coût selon le plan La récurrence nécessite la fonctionnalité Facturation récurrente, disponible à partir de **Growth**. Le Dashboard refuse d'enregistrer une facture récurrente sans cette fonctionnalité. Sans le plan, la génération est ignorée et le document n'est pas modifié. Après le passage à un plan inférieur, la génération reprend donc automatiquement si le compte revient à un plan supérieur, avec les cycles arrivés à échéance entre-temps. `POST /invoices` ne vérifie pas le plan. La création d'une facture récurrente par l'API réussit avec tous les plans, mais ne génère simplement rien. - [Factures](https://docs.wajub.com/fr/billing/invoice): Le document, sa page de paiement et le reste de son cycle de vie. - [Démarrage rapide](https://docs.wajub.com/fr/billing/invoice/quickstart): Émettre une facture et obtenir son paiement, du début à la fin. - [Relances et suivi](https://docs.wajub.com/fr/billing/invoice/reminders): Relancer une facture d'un cycle restée impayée. - [Abonnements](https://docs.wajub.com/fr/billing/subscriptions): Pourquoi le débit récurrent sans intervention n'est pas encore un produit. - [Référence API des factures](https://docs.wajub.com/fr/api/invoices): Tous les champs et les neuf endpoints. --- # Relances et suivi URL: https://docs.wajub.com/fr/billing/invoice/reminders > Quand Wajub relance votre client d'une facture impayée, et comment assurer le suivi depuis votre propre code. Wajub relance par e-mail votre client d'une facture impayée, avant et après son échéance, que vous ayez envoyé la facture par l'API ou depuis le Dashboard. Les relances sont actives tant que vous ne les désactivez pas. ## Quand partent les relances Chaque relance tombe un jour compté à partir du `due_date` de la facture. Tant que vous n'en choisissez pas d'autres, ceux d'un nouveau compte sont : | Relance | Jour | | --------------------- | -------------- | | Une semaine avant | `due_date` − 7 | | Trois jours avant | `due_date` − 3 | | La veille | `due_date` − 1 | | Un jour de retard | `due_date` + 1 | | Une semaine de retard | `due_date` + 7 | **Paramètres → Facture → Rappels** dans le Dashboard montre les jours de votre compte, et choisit d'autres jours, 1, 3, 7 ou 14 jours avant l'échéance, le jour même, ou 1, 3, 7 ou 14 jours après, ou désactive les relances. Le choix vaut pour toutes les factures du compte : aucune facture ne les désactive à elle seule, ni par l'API ni ailleurs. Une relance dont le jour tombe le jour de l'envoi de la facture ou avant est sautée : une facture envoyée après son échéance n'est relancée que les jours encore à venir. Une relance ne tombe jamais un jour où le client a déjà été relancé. Quand plusieurs relances sont dues en même temps, seule la plus récente part, et aucune ne part plus d'une semaine après son jour. ## Qui reçoit quoi Une facture est relancée quand elle a un `due_date`, qu'elle a été envoyée (`sent`, `viewed`, `partial` ou `overdue`) et qu'il reste quelque chose à payer. L'e-mail part au client que désigne `customer_id`, sinon à `customer_email` ; une facture sans l'un ni l'autre n'est pas relancée. Les brouillons, les devis et les estimations ne le sont jamais. La relance est rédigée dans la `language` de la facture, avec le PDF en pièce jointe. Elle indique le numéro de la facture, le montant restant dû et l'échéance, avec un bouton vers la page de la facture. Une facture partiellement payée est relancée pour ce qu'il reste. Une relance n'envoie aucun webhook et ne change rien à la facture. ## Ce qui arrête les relances Le paiement, l'annulation ou le remboursement de la facture, ou plus rien à payer. Une relance sur le point de partir quand la facture a été payée n'est pas envoyée. ## Effectuer le suivi depuis votre propre code Pour assurer le suivi sur un autre canal, comme le SMS ou WhatsApp, ou selon votre propre calendrier, vous disposez de deux signaux qui fonctionnent différemment. Le premier est la liste, filtrée sur les montants encore dus. **Toutes les factures échues avec un montant encore dû** ```bash curl "https://api.wajub.com/invoices?status=overdue&payment_status=unpaid" \ -H "Authorization: sk.xxxxxxxxxxxxxxxx…" ``` ```javascript const { data } = await wajub.invoices.list({ status: 'overdue', payment_status: 'unpaid', }); for (const invoice of data) { console.log(invoice.invoice_number, invoice.amount_due, invoice.customer_email); } ``` ```python result = wajub.invoices.list({"status": "overdue", "payment_status": "unpaid"}) for invoice in result.data: print(invoice["invoice_number"], invoice["amount_due"]) ``` ```php $result = $wajub->invoices->list([ 'status' => 'overdue', 'payment_status' => 'unpaid', ]); foreach ($result->data as $invoice) { echo $invoice['invoice_number'], ' ', $invoice['amount_due'], PHP_EOL; } ``` ```go result, err := client.Invoices.List(context.Background(), map[string]any{ "status": "overdue", "payment_status": "unpaid", }) if err != nil { log.Fatal(err) } for _, invoice := range result.Data { log.Println(invoice["invoice_number"], invoice["amount_due"]) } ``` `payment_status` accepte `unpaid`, `partially_paid` ou `fully_paid`. Il filtre selon ce qui a réellement été reçu, pas selon le libellé du statut. `due_date_from` et `due_date_to` délimitent la période lorsque vous cherchez les factures échues cette semaine plutôt que leur totalité. > [!NOTE] > **Le statut overdue peut avoir un jour de retard** > > Rien ne fait passer une facture à `overdue` à minuit. Ce passage a lieu pendant la nuit une fois > `due_date` passée. Une facture arrivée à échéance ce matin reste donc au statut `sent` jusqu'au lendemain. > Pour faire la distinction le jour même, comparez vous-même `due_date` à la date actuelle au lieu > de filtrer sur le statut. Le second signal est le webhook. Il présente une lacune dont vous devez tenir compte. **`invoice.updated`**: Émis après les modifications effectuées par l'API, lors de la première consultation et lors d'un paiement. Lisez `data.status`. ```json title="invoice.updated" { "id": "evt_aio5DpN577tNU2vOxdmuZGhT", "event": "invoice.updated", "livemode": true, "created": "2026-09-25T09:12:44+00:00", "api_version": "2026-10-11", "pending_webhooks": 1, "request": { "id": null, "idempotency_key": null }, "data": { "id": "inv_LRQqYvlhrgUOE225KMKU", "invoice_number": "INV-2026-0001", "status": "partial", "currency": "XAF", "total": 450000, "amount_paid": 150000, "amount_due": 300000, "due_date": "2026-09-25" } } ``` Cette lacune concerne le statut `overdue`. Les factures passent à `overdue` pendant la nuit, et ce changement n'envoie aucun webhook. Vous devez rechercher cette situation, elle ne vous est pas signalée. Le modèle qui fonctionne consiste à conserver votre propre liste de factures ouvertes, à la contrôler selon votre propre calendrier et à envoyer vous-même une relance sur le canal que le client consulte vraiment. Le message doit contenir l'URL de paiement, que vous reconstruisez à partir de l'identifiant de la facture. ```text title="Contenu de votre relance" https://invoice.wajub.com/inv_LRQqYvlhrgUOE225KMKU ``` - [Factures](https://docs.wajub.com/fr/billing/invoice): Le document, sa page de paiement et son cycle de vie complet. - [Démarrage rapide](https://docs.wajub.com/fr/billing/invoice/quickstart): Émettre une facture et obtenir son paiement, du début à la fin. - [Factures récurrentes](https://docs.wajub.com/fr/billing/invoice/recurring): Ce que configure l'indicateur de récurrence, et ce qu'il ne fait pas. - [Webhooks](https://docs.wajub.com/fr/developer-tools/webhooks): La place d'invoice.updated aux côtés de payment.succeeded. - [Référence API des factures](https://docs.wajub.com/fr/api/invoices): Tous les filtres de l'endpoint de liste. --- # Capacités du compte URL: https://docs.wajub.com/fr/sync/account-types > Les sept capacités, ce que chacune atteint et le calcul de votre commission. ## Les trois modes `account_type` dit ce que le marchand possède chez Wajub et où se trouve l'argent. Les capacités, la commission et le consentement à un changement de conditions fonctionnent de la même façon dans les trois ; ce qui découle du mode est listé sous le tableau. Le mode est choisi à la création de la connexion et ne change jamais ensuite : en changer modifierait ce que le marchand a accepté, c'est donc une nouvelle connexion qu'il accepte à nouveau. | Mode | Le marchand | L'argent | À utiliser pour | | --------------------- | --------------------------------------------- | ---------------------------------------------------------------------------- | ------------------------------------- | | `direct` (par défaut) | Un compte Wajub complet qu'il pilote lui-même | Rail Wajub, ou ses propres contrats providers | Les marchands déjà équipés | | `lite` | Un portail hébergé léger | Rail Wajub, toujours | Les petits vendeurs, le cas courant | | `relay` | Aucun compte Wajub : son portefeuille vérifié | Le vôtre : vous encaissez et Wajub verse à chaque vendeur ce qui lui revient | Les marketplaces *merchant of record* | Ce qui découle du mode : - une connexion `lite` refuse de lancer un paiement tant que le marchand n'est pas sur le rail Wajub (`409`, `error_code: account_not_on_rail`), et refuse la carte, que le rail n'encaisse pas encore (`422` avec `error_code: card_not_available`, [La réserve carte](https://docs.wajub.com/fr/sync/payouts#the-card-reserve)) ; - une connexion `relay` n'a pas d'onboarding : il n'y a aucun compte marchand à revendiquer. Elle se crée avec `POST /accounts` et le portefeuille du vendeur, n'a pas de lien d'autorisation (`authorization_url` vaut `null`, `POST /accounts/{id}/token` répond `422`) ni de date d'invitation, et devient `active` dès que l'opérateur a confirmé le nom du portefeuille. Les ventes arrivent sur votre solde, et Wajub verse à chaque vendeur ce qui lui revient. [Relay](https://docs.wajub.com/fr/sync/relay) > [!WARNING] > **Ce ne sont pas des paliers Standard, Express ou Custom** > > Le mode n'est pas un niveau de service et ne conditionne aucune fonctionnalité. Deux connexions de > modes différents peuvent porter exactement les mêmes capacités et la même tarification. ## Les sept capacités Une connexion reçoit un sous-ensemble de cette liste fermée. Au moins une capacité est obligatoire à la création. Une valeur inconnue est refusée avec `422`. | Capacité | Fonction désignée | | ------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `read` | Lire les événements de ce que la connexion a apporté | | `payments` | Lancer des paiements et des liens de paiement | | `withdrawals` | Verser des fonds, et gérer les bénéficiaires payés. Pas sur une connexion `lite` : seul Wajub paie un vendeur Lite, elle est donc refusée avec `400` `capability_not_allowed_for_mode`, et un versement ou une écriture de bénéficiaire sous `X-Sync` sur une connexion Lite répond `403` avec le même code | | `refunds` | Émettre des remboursements | | `disputes` | Répondre aux litiges | | `customers` | Gérer des clients | | `invoices` | Émettre des factures | Toute autre capacité répond `422` à la création ou à la modification d'une connexion. ## Chaque ressource déclare ce qu'elle exige Chaque route déclare la capacité qu'elle exige, et une route qui n'en déclare aucune ne peut pas être appelée avec `X-Sync`. Le refus est la règle par défaut : une capacité non accordée est une capacité que la plateforme n'a pas, et une requête `X-Sync` qui l'exige est refusée avec `403`. | La requête porte sur | Capacité vérifiée | | -------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- | | `/payments`, `/links` | `payments` | | `/invoices` | `invoices` | | `/customers`, `/customers/{id}/tax_ids` | `customers` | | `/refunds` | `refunds` | | `GET /payments/{id}/refunds`, `POST /payments/{id}/close` avec `outcome: refund` | `payments` et `refunds` | | `/disputes` | `disputes` | | `/transfers`, `/beneficiaries`, `/identity` | `withdrawals` | | `/`, `/providers`, `/events` | `read` | | `/channels`, `/countries`, `/currencies` | aucune : les catalogues répondent la même chose à tout le monde | | `/balance`, `/webhooks`, `/shield`, `/tax` | ne peuvent pas être appelées avec `X-Sync` : elles concernent tout le compte du marchand | | `/accounts` | ne peuvent pas être appelées avec `X-Sync` : elles sont les vôtres | Une ressource qui ne peut pas être appelée avec `X-Sync` répond `403` avec `This endpoint cannot be called on behalf of a Sync account`, quelles que soient les capacités de la connexion. ## Une capacité ne couvre que ce que la connexion a apporté Les capacités disent *quoi* ; la connexion dit *à qui*. Avec `X-Sync`, une plateforme atteint ce que cette connexion a apporté et rien d'autre du marchand : ni ses ventes directes, ni ses propres liens, factures ou bénéficiaires, ni ce qu'une autre plateforme a apporté. | Ressource | Ce que la plateforme atteint | | --------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `/payments`, `/refunds` | Uniquement ceux qui portent cette connexion | | `/disputes` | Uniquement les litiges sur les paiements de cette connexion | | `/links`, `/invoices` | Uniquement ceux créés avec le `X-Sync` de cette connexion | | `/beneficiaries` | Uniquement ceux créés avec le `X-Sync` de cette connexion, y compris un bénéficiaire fourni directement dans un transfert | | `/transfers` | Uniquement les versements lancés par cette connexion, et seulement vers ses propres bénéficiaires | | `/customers`, `/customers/{id}/tax_ids` | Les clients vus sur les paiements de cette connexion, et ceux qu'elle a créés ou désignés par e-mail ou téléphone, sauf si le marchand lui en a retiré l'accès ; sans les notes, le motif de blocage ni les metadata du marchand | | `/events` | Uniquement les événements des paiements, remboursements, transferts, litiges, liens, factures et bénéficiaires ci-dessus | Tout le reste répond `404`, comme s'il n'existait pas. Un bénéficiaire que le marchand paie déjà ne fait pas exception : en créer un pour le même compte avec `X-Sync` donne à la connexion le sien, et payer celui du marchand répond `422`. ### Les clients sont partagés avec le marchand Un client appartient au marchand, pas à la connexion. La connexion atteint un client dès qu'il a acheté par elle, ou dès que la plateforme l'a créé ou l'a désigné par son e-mail ou son téléphone. C'est la règle « trouver ou créer » : `POST /customers` avec l'e-mail ou le téléphone d'un client du marchand (l'e-mail quelle que soit sa casse, le téléphone quelle que soit son écriture) renvoie ce client avec `200` au lieu d'un doublon, et `POST /payments` lui rattache le paiement. L'un comme l'autre ne remplit que les champs que le marchand a laissés vides, jamais un champ qu'il a renseigné. Dès lors, la plateforme peut le lire, le retrouver dans la liste et l'utiliser sur ses paiements et ses factures, et le marchand en voit le résultat. Un client que la plateforme a créé est le sien à gérer : elle peut le modifier et le bloquer. Sur un client que le marchand avait déjà, une modification ne remplit que les champs que le marchand a laissés vides, et le bloquer, le débloquer, l'activer, le désactiver ou supprimer un numéro fiscal répond `403`. Plusieurs connexions peuvent atteindre le même client. La plateforme ne peut pas supprimer un client : `DELETE /customers/{id}` avec `X-Sync` répond `403`, car effacer un client est une décision du marchand. La plateforme voit l'identité, les coordonnées et les adresses d'un client, jamais les `notes`, le `block_reason` ni les `metadata` du marchand, et les `notes` qu'elle envoie sont ignorées. Les `metadata` qu'elle lit et écrit sont les siennes, séparées pour chaque connexion : sur un client que le marchand avait déjà, `POST /customers` et les paiements ajoutent les clés que la plateforme n'a pas encore définies, et `PUT /customers/{id}` les remplace. Les `metadata` du marchand ne changent jamais par `X-Sync`. Le marchand voit sur la page du client, dans le Dashboard, quelles plateformes atteignent ce client et depuis quand, et peut retirer l'accès d'une plateforme. Ce retrait dure jusqu'à ce que le marchand rétablisse l'accès : la plateforme n'atteint plus le client, pas même sur ses propres paiements passés, le désigner à nouveau par son e-mail ou son téléphone ne le lui rend pas, et ses nouveaux paiements pour cet e-mail ou ce téléphone sont créés sans client. Ses `metadata` sur ce client sont supprimées. Effacer un client retire l'accès de toutes les plateformes. Un client que la connexion n'a ni vu ni désigné reste hors de portée : `/customers/{id}` répond `404`, et son identifiant `cus_` donné comme `customer_id` sur un paiement ou une facture répond `422`, comme un identifiant inconnu. Remplacer l'e-mail ou le téléphone d'un client par ceux d'un autre client répond `422`, comme pour le marchand. ### Les liens et les factures encaissent pour la connexion Un paiement fait sur un lien ou une facture créé par la connexion porte la connexion, comme un paiement fait avec `POST /payments` et `X-Sync` : la commission s'applique et la plateforme le voit dans `/payments`. Dès que la connexion ne peut plus encaisser (annulée, paiements suspendus, capacité retirée, ou Sync absent de votre forfait), le lien répond `404` au payeur et la facture ne peut plus être payée. Ils encaissent de nouveau quand la connexion le peut. ### Les événements, et leur renvoi `GET /events` avec `X-Sync` liste les événements enregistrés sur ce que la connexion a apporté. `POST /events/{id}/resend` avec `X-Sync` envoie l'événement à **vos** endpoints, jamais à ceux du marchand, avec `data.account`. ## Modifier les conditions d'une connexion active Les capacités et la tarification sont ce que le marchand a accepté : une fois la connexion active, elles se proposent au lieu de se modifier. `PUT /accounts/{id}` répond `202 Accepted` et renvoie la proposition dans `pending_changes` ; la connexion continue de fonctionner aux conditions en vigueur jusqu'à ce que le marchand accepte ou refuse depuis son dashboard. | Ensuite | Ce qui se passe | | ----------------------- | ---------------------------------------------------------------------------------------------------- | | Le marchand accepte | Les nouvelles conditions s'appliquent à partir de cet instant, et `account.change_accepted` est émis | | Le marchand refuse | Rien ne change, et `account.change_declined` est émis | | Vous proposez à nouveau | La nouvelle proposition remplace celle encore sur la table | Les ventes déjà réalisées conservent les conditions sous lesquelles elles ont eu lieu : un changement de tarif ne retarife jamais une commission déjà prélevée. Tant que la connexion est `pending`, personne n'a rien accepté et `PUT` applique le changement directement, avec un `200`. ## Tarification La tarification représente ce que votre plateforme retient sur l'activité du compte connecté. C'est une règle unique associée à la connexion, créée par `POST /accounts` à partir de l'objet `pricing`, puis modifiée avec `PUT /accounts/{id}` ou depuis le Dashboard. - `percentage_fee` (number): Pourcentage du montant du paiement, entre 0 et 100, avec jusqu'à quatre décimales. - `fixed_fee` (number): Montant fixe ajouté au pourcentage, dans les unités principales de la devise de la règle. - `min_fee` (number): Plancher. Des frais calculés inférieurs à cette valeur sont relevés jusqu'à celle-ci. - `max_fee` (number): Plafond. Des frais calculés supérieurs à cette valeur sont ramenés à celle-ci. - `currency` (string): Code à trois lettres de la devise dans laquelle les frais sont exprimés. Obligatoire dès que vous définissez fixed_fee, min_fee ou max_fee. Les deux types se cumulent au lieu de se concurrencer. Une règle qui contient un pourcentage et des frais fixes prélève le pourcentage du montant, puis ajoute la valeur fixe. Elle applique ensuite le plancher, puis le plafond, dans cet ordre. ## Calcul des frais Cette séquence explique tous les chiffres présents dans un événement `fee.received`. | Étape | Déroulement | | ----- | -------------------------------------------------------------------------------------------------- | | 1 | Le paiement réussit et possède une connexion | | 2 | La tarification de la connexion s'applique | | 3 | La devise des frais est le `currency` de la règle, ou celle du paiement si la règle n'en a pas | | 4 | Le pourcentage et les frais fixes sont additionnés, puis limités par `min_fee` et `max_fee` | | 5 | Des frais nuls ne sont pas prélevés | | 6 | Les frais sont prélevés une seule fois pour le paiement | | 7 | Le montant quitte le solde du marchand et arrive sur le vôtre, sous la rétention propre à la vente | Un paiement porte au plus une commission. La commission circule dans la devise de règlement de la vente, convertie lorsque la règle utilise une autre devise. Une commission est une part d'une vente : une vente défaite emporte sa part avec elle. ## Quand la vente est remboursée `commission_refund_policy`, défini sur la connexion, décide de ce qui revient. | Politique | Au remboursement | | ---------------------- | ------------------------------------------------------------------------------------ | | `prorata` (par défaut) | La commission est rendue au prorata du montant remboursé | | `full` | La totalité de la commission est rendue dès le premier remboursement, partiel ou non | | `none` | Rien n'est rendu ; le marchand porte seul le remboursement | Définissez-la avec `POST /accounts`, et ne la modifiez avec `PUT /accounts/{id}` que tant que la connexion est encore `pending` : c'est une condition commerciale que le marchand a acceptée. Rien n'est jamais rendu deux fois, et plusieurs remboursements sur une même vente ne peuvent jamais rendre plus que ce qui a été prélevé. ### Quand un litige sur la vente est perdu Un litige perdu défait la vente comme un remboursement, et la même politique s'applique au montant contesté : un chargeback que le fournisseur déclare perdu, un litige que votre marchand accepte, ou un litige clos après son échéance. Quand votre marchand accepte un litige, l'acheteur est remboursé par un remboursement ; le litige et ce remboursement rendent la commission une seule fois à eux deux, selon celui qui est enregistré en premier. Un litige gagné ne rend rien : la vente tient. ### En sandbox Une vente sandbox déplace la commission entre les deux soldes sandbox, et un remboursement sandbox la rend selon la même politique : vous pouvez vérifier ce que verront vos marchands. La réserve, la couverture après un remboursement et le recouvrement tournent aussi en sandbox ([Tout essayer en sandbox](https://docs.wajub.com/fr/sync/payouts#trying-it-all-in-sandbox)) ; seules les commissions qu'un marchand doit lorsqu'il encaisse sur son propre contrat n'existent qu'en live. > [!NOTE] > **La devise de la règle indique l'unité, pas un filtre** > > `currency` indique la devise des frais, pas les paiements auxquels la règle s'applique. Des frais > fixes de 500 XAF sur un paiement en NGN sont convertis au taux actif. Une deuxième conversion a > lieu si le solde de votre plateforme utilise une troisième devise. Les `metadata` des frais > enregistrent les deux taux. ## Une seule règle, pour chaque paiement Une connexion porte une seule règle de tarification, appliquée à chaque paiement effectué sur la connexion. Il n'existe aucun moyen de prélever une commission différente sur les petits paniers ou d'exempter une devise : aucun endpoint ni formulaire du Dashboard ne définit de conditions sur une règle. > [!WARNING] > **La tarification aussi demande le consentement** > > Comme pour les capacités, la tarification d'un marchand déjà connecté se propose au lieu de se > modifier : `PUT` répond `202` et le marchand décide. Définissez la commission souhaitée avant > d'envoyer le lien d'autorisation, et vous n'aurez jamais à la demander. ## Ce qui reste librement modifiable Deux champs survivent à l'acceptation sans l'accord du marchand, et seulement ces deux-là. | Champ | Pourquoi il reste ouvert | | ---------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `callback` | La page vers laquelle le marchand est renvoyé après avoir accepté, et l'origine que doit partager un `redirect_uri` sur le lien d'autorisation. En HTTPS uniquement (`http://localhost` et `http://127.0.0.1` avec une clé sandbox), sinon `422`. Aucun événement n'y est envoyé : les événements d'une connexion vont à vos [endpoints de webhook](https://docs.wajub.com/fr/developer-tools/webhooks/events#accounts-for-sync-platforms) | | `payment_status` | `active` ou `suspended`, votre propre interrupteur pour autoriser les débits sur la connexion. `active` répond `409` tant que la vérification du marchand est en cours ou refusée | La suspension d'une connexion arrête à la fois les paiements entrants et les transferts sortants. Elle émet `account.payment_suspended`. Utilisez-la lorsque vous auriez autrement besoin de révoquer une capacité. Contrairement à une capacité, elle est réversible. - [Sync](https://docs.wajub.com/fr/sync): La nature d'une connexion et ses limites. - [Démarrage rapide](https://docs.wajub.com/fr/sync/quickstart): Créer une connexion et y recevoir votre premier paiement. - [Intégration des marchands](https://docs.wajub.com/fr/sync/onboarding): Le cycle de vie, le lien d'autorisation et les statuts. - [Référence API des sous-comptes](https://docs.wajub.com/fr/api/subaccounts): La spécification de l'endpoint. --- # Analyses URL: https://docs.wajub.com/fr/sync/analytics > Le volume de vos vendeurs, la commission que vous gardez, ce que vous risquez de perdre et ce que vos vendeurs ont reçu, dans le Dashboard et par l'API. Combien vos vendeurs ont-ils vendu, combien avez-vous gardé, combien pourrait vous revenir à la charge, et combien Wajub leur a-t-il versé ? **Sync, Analyses** dans le Dashboard et `GET /sync/metrics` répondent avec les mêmes chiffres, pour une période comparée à la période de même longueur juste avant. ## D'où viennent les chiffres Rien n'est estimé : chaque montant est une ligne que Wajub a écrite quand l'argent a bougé. | Chiffre | Compté à partir de | Rangé dans la période par | | ---------------------------------- | ----------------------------------------------------------------------------------------------------------------------- | ------------------------- | | Volume, vente d'un vendeur | Un paiement fait avec `X-Sync` sur un de vos comptes, `succeeded`, `refunded` ou `partially_refunded`, son montant brut | Sa date de crédit | | Volume, part d'un paiement partagé | Une part passée à son vendeur ; une part encore en attente ne compte pas | Sa date de passage | | Commission prise | La commission de la vente, de la part, ou celle qu'a enregistrée le dû d'un vendeur Relay | Sa date de prélèvement | | Commission rendue | Rendue sur un remboursement ou un litige perdu | Sa date de retour | | Abandonnée | Ce que votre politique demandait de rendre, moins ce que votre solde a permis | Sa date de retour | | Commission nette | Prise moins rendue | | | Taux effectif | Commission nette sur le volume de la même devise, en pourcentage | | | Versé | Les versements de Wajub à vos vendeurs qui ont réussi | Leur date de valeur | - **Les devises ne s'additionnent jamais.** Chaque chiffre est par devise. Les chiffres d'en-tête sont dans la devise qui a le plus de volume sur la période (`currency`). - Une commission peut être dans une autre devise que sa vente : elle compte dans sa propre devise, et le taux effectif ne rapproche que des montants de même devise. - Un remboursement d'une vente Relay réduit le dû du vendeur et sort de votre solde : aucune ligne de commission « rendue » n'est écrite pour lui, donc aucune n'est comptée. - Les **vendeurs actifs** sont les comptes avec au moins une vente ou une part sur la période. Le **taux de litige** rapporte les litiges ouverts sur la période sur les ventes de vos vendeurs aux ventes de la période faites avec `X-Sync` : les litiges d'un paiement partagé sont les vôtres. ## Ce que vous voyez | Bloc | Dit | | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Volume | Par devise et par mode (`direct`, `lite`, `relay`), ventes, vente moyenne, part passée par les paiements partagés | | Commission | Prise, rendue, abandonnée, nette, taux effectif, par mode | | Exposition et risque | Votre [plafond de versement](https://docs.wajub.com/fr/sync/payouts#your-exposure-cap) utilisé, les réserves de vos vendeurs (la réserve Lite, et la [réserve carte](https://docs.wajub.com/fr/sync/payouts#the-card-reserve) des ventes par carte de vos vendeurs Lite et Relay), les ventes [bloquées jusqu'à la livraison](https://docs.wajub.com/fr/sync/holds) et celles libérées d'elles-mêmes sous 7 jours, les remboursements que vous avez couverts et ce qui est revenu, vos vendeurs par [niveau de risque](https://docs.wajub.com/fr/sync/seller-risk) et gelés, les litiges en cours et le taux de litige | | Versements | Versé sur la période, en cours d'envoi, dû à vos vendeurs Relay, sur les soldes de vos vendeurs Lite, et les vendeurs dont les versements sont retenus, par raison | | Vendeurs | Les dix premiers par volume, par commission nette, et les dix plus risqués | Dans le Dashboard, la période est de 7, 30 ou 90 jours, 12 mois, ou des jours que vous choisissez, dans les jours de votre navigateur ; le graphique montre la période précédente en pointillés. Les membres qui peuvent voir les versements l'ouvrent. Quand les chiffres ne peuvent pas être lus pour un moment, la page le dit, avec **Réessayer**. ## Par l'API ```bash title="Les 90 derniers jours" curl "https://api.wajub.com/sync/metrics?period=90d" \ -H "Authorization: sk.xxxxxxxxxxxxxxxx…" ``` | Règle | | | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Clé | La vôtre, jamais avec `X-Sync` (`403`). Sync dans votre forfait, sinon `403 feature_not_in_plan` | | `period` | `7d`, `30d` (par défaut), `90d` ou `12m` (365 jours, le graphique par mois). Une autre valeur : `422` | | Jours | UTC, aujourd'hui compris | | Sandbox | Une clé de test lit la sandbox : `sandbox: true`, `risk.exposure` est vide, et les soldes de sandbox de vos vendeurs Lite sont entièrement en `lite_available` (`lite_pending` vaut 0) | | Fraîcheur | Ce qui s'est passé sur la période (ventes, commission, versements faits, litiges ouverts, couvertures) compte tout jusqu'à `as_of`, en général une à deux minutes avant l'appel. Ce qui est en cours (réserves, ventes bloquées, litiges ouverts, versements en route, ce qui est dû à vos vendeurs et ce qu'ils détiennent, exposition) est lu au moment du calcul. Dans les deux cas, la réponse est gardée cinq minutes | | Limite | 10 appels par minute par plateforme et par environnement, en plus de la limite de votre forfait : `429` au-delà | ```json title="Réponse · 200 OK, abrégée" { "data": { "period": { "start": "2026-10-22T00:00:00+00:00", "end": "2026-11-20T23:59:59+00:00", "previous_start": "2026-09-22T00:00:00+00:00", "days": 30 }, "sandbox": false, "as_of": "2026-11-20T23:58:00+00:00", "currency": "XAF", "volume": { "active_sellers": 4, "previous_active_sellers": 1, "currencies": [ { "currency": "XAF", "amount": 49000, "previous_amount": 4000, "change_percent": 1125, "sales": 5, "average": 9800, "shared_amount": 6000, "shared_percent": 12.24 } ] }, "commission": [ { "currency": "XAF", "taken": 2450, "returned": 300, "forgone": 70, "net": 2150, "take_rate": 4.39 } ], "risk": { "reserve": [ { "currency": "XAF", "held": 4000, "next_release_at": "2026-11-30T10:00:00+00:00", "card": { "held": 1500, "sales": 3, "next_release_at": "2027-02-18T10:00:00+00:00" } } ], "sellers": { "scored": 3, "elevated": 1, "high": 1, "frozen": 1, "high_not_frozen": 1 }, "disputes": { "open": 1, "opened": 1, "sales": 4, "rate": 25 } }, "payouts": { "currencies": [ { "currency": "XAF", "paid": 11000, "payouts": 2, "in_flight": 2000, "relay_payable": 7600, "lite_available": 12000 } ], "held": [ { "reason": "frozen", "sellers": 1 } ] }, "sellers": { "currency": "XAF", "by_volume": [], "by_commission": [], "by_risk": [] } } } ``` Les montants sont en unités majeures ; les pourcentages sur 100 avec deux décimales, `change_percent` avec une. Un pourcentage vaut `null` quand il n'y a rien à comparer : une période précédente à zéro, aucun volume, aucune vente. `payouts.held[].reason` vaut `frozen`, `new_seller`, `exposure_cap`, `approval_withdrawn`, `insufficient_balance` ou `identity_required`. Dans `sellers`, `connected: false` signale un compte déconnecté ou supprimé depuis, et `risk_score` vaut `null` pour un vendeur jamais évalué. Dans `risk.reserve`, `held` et `next_release_at` comprennent la réserve carte, et `card` la donne à part : ce que gardent les ventes par carte de vos vendeurs, combien de ventes, et sa prochaine libération. [La réponse complète](https://docs.wajub.com/fr/api/subaccounts/metrics) ### Appelez-la en tâche de fond Toute période répond vite, mais appelez cette route depuis une tâche programmée de votre côté, toutes les cinq minutes au plus, et gardez la réponse chez vous : pas à chaque affichage de page. | Réponse | Quand | Que faire | | -------------------------------------------- | -------------------------------------------------------------------------------------------------- | -------------------------------------------------------- | | `429` avec `error_code: metrics_busy` | Un autre appel calcule les mêmes chiffres, et ils n'étaient pas prêts au bout de quelques secondes | Réessayez après `Retry-After` | | `429` sans `error_code` | Plus de 10 appels dans la minute | Attendez la minute suivante | | `503` avec `error_code: metrics_unavailable` | Les chiffres de la période ne peuvent pas être lus pour un moment | Réessayez après `Retry-After`, pas en boucle | | `503` avec `error_code: metrics_timeout` | Les chiffres n'ont pas pu être calculés à temps | Réessayez plus tard, ou demandez une période plus courte | Un `503` n'est jamais une réponse partielle : les chiffres que vous recevez sont toujours complets jusqu'à `as_of`. - [Rapports et relevés](https://docs.wajub.com/fr/sync/reports): Le même grand livre, ligne à ligne, en CSV, Excel ou PDF. - [Risque vendeur](https://docs.wajub.com/fr/sync/seller-risk): Score, délai des nouveaux vendeurs et gel. - [Lire les chiffres de votre plateforme](https://docs.wajub.com/fr/api/subaccounts/metrics): La spécification de l'endpoint. --- # Litiges sur les ventes de vos vendeurs URL: https://docs.wajub.com/fr/sync/disputes > Laissez un vendeur Lite répondre à un litige sur sa propre vente, avec sa preuve de livraison, et complétez sa réponse par l'API. Un litige sur une vente faite avec `X-Sync` est un litige du compte du vendeur. C'est souvent lui qui détient la preuve : le bon de livraison, les messages échangés avec l'acheteur. Avec Sync, un vendeur Lite peut répondre depuis son portail ou depuis le [composant embarqué](https://docs.wajub.com/fr/sync/embedded-components) `disputes`, et vous en êtes prévenu. ## Qui répond Chaque connexion porte `dispute_handling` : | Valeur | Qui répond | Par défaut | | ---------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------- | | `both` | Le vendeur envoie ses preuves ; vous en êtes prévenu et pouvez les compléter par l'API. Le vendeur peut encore modifier sa réponse jusqu'à 24 heures avant l'échéance | `lite` | | `seller` | Le vendeur répond ; sa réponse est **définitive** une fois envoyée | | | `platform` | Vous seul, par l'API. Le vendeur voit le litige, en lecture | `relay`, et sa seule valeur : un vendeur Relay n'a pas d'espace d'où répondre | **Vous pouvez toujours répondre par l'API avec `X-Sync`**, quelle que soit la valeur. Un marchand `direct` répond depuis son propre Dashboard : le réglage est refusé pour lui. Un [paiement partagé](https://docs.wajub.com/fr/sync/split-payments#one-payment-several-sellers) est le vôtre : ses litiges aussi. Réglez-le avec `POST /accounts`, ou changez-le tout de suite avec `PUT /accounts/{id}` ; une réponse déjà envoyée par le vendeur reste dans le litige. ```bash title="Le vendeur répond seul" curl -X PUT https://api.wajub.com/accounts/acc_Gt6yU3nE8rM1kS5vX9bQ \ -H "Authorization: sk.xxxxxxxxxxxxxxxx…" \ -H "Content-Type: application/json" \ -d '{"dispute_handling":"seller"}' ``` | `error_code` | Statut | Quand | | -------------------------------- | ------ | -------------------------------------------------------------------------------- | | `dispute_handling_not_available` | `400` | `seller` ou `both` sur un compte `relay`, ou toute valeur sur un compte `direct` | | | `422` | Une valeur inconnue (`errors.dispute_handling`) | ## Ce que fait le vendeur 1. **Il prépare un brouillon** Une pièce par type de preuve : `proof_of_delivery`, `customer_communication`, `receipt`, `product_description`, `refund_policy` ou `other`. Un texte de 2 000 caractères au plus, un fichier, ou les deux. Rien n'atteint le litige tant qu'il ne l'a pas envoyé. 2. **Il joint des fichiers** PDF, JPG ou PNG seulement, 5 Mo au plus. Le contenu est contrôlé : un script déguisé en PDF ou en image est refusé. 3. **Il l'envoie** Chaque pièce pas encore envoyée entre dans le litige, le litige passe `under_review`, et vous recevez `account.dispute_evidence_submitted`. **24 heures avant l'échéance**, le vendeur ne peut plus écrire. Ce qu'il a enregistré sans l'envoyer est **envoyé pour lui**, et une réponse `both` devient définitive ; s'il n'a rien écrit, sa réponse passe `lapsed`. Un litige sans échéance n'a ni coupure ni rappel : le vendeur peut répondre tant qu'il est ouvert. Quand un litige se termine alors que la réponse du vendeur est encore ouverte, elle passe `closed`. Avec `platform`, le vendeur lit que « votre plateforme répond à ce litige ». Vous n'êtes pas coupé à ce moment-là : l'API vous reste ouverte jusqu'à la décision du litige. Complétez tout de même la réponse **avant** la coupure du vendeur, pour qu'il la voie entière. Le vendeur est prévenu par e-mail, à [votre marque](https://docs.wajub.com/fr/sync/own-domain#e-mails-in-your-brand), quand le litige s'ouvre, et 3 jours avant l'échéance s'il n'a rien envoyé, quand la connexion le laisse répondre. Un litige sans échéance n'a que l'e-mail d'ouverture. ## Compléter sa réponse Lisez le dossier avec `GET /disputes/{id}` et `X-Sync`, puis complétez-le avec `POST /disputes/{id}/submit-evidence`. Une pièce que vous envoyez sous un type que le vendeur a déjà envoyé **remplace** la sienne : un type, une pièce. Un vendeur qui renvoie en `both` ne réécrit que les pièces qu'il a modifiées, si bien que ce que vous avez envoyé sous un autre type reste. Vous et le vendeur pouvez envoyer en même temps : chaque pièce s'ajoute par son type sans effacer celle de l'autre. Une pièce envoyée après la clôture du litige est refusée avec `422`. Qui a envoyé chaque pièce est dans le `evidence_submitted_by` du litige, par type de preuve, pièce texte seul comprise : | Valeur | Qui | | ---------- | ------------------------------------------------------------- | | `merchant` | Le marchand, dans le Dashboard ou par l'API sans `X-Sync` | | `platform` | Vous, par l'API avec `X-Sync` | | `seller` | Le vendeur Lite, depuis son espace ou le composant `disputes` | | `null` | Une pièce envoyée avant que Wajub garde qui l'a envoyée | ```json title="Qui a envoyé quoi" "evidence": { "proof_of_delivery": { "file_name": "bon-de-livraison.pdf", "submitted_by": "seller", "url": "https://…" }, "customer_communication": "L'acheteur a confirmé la réception par message le 18 novembre." }, "evidence_submitted_by": { "proof_of_delivery": "seller", "customer_communication": "platform" } ``` `evidence` lui-même ne change pas : une pièce texte seul est toujours rendue comme son texte, si bien qu'un code qui lit une chaîne continue de marcher, et une pièce avec fichier est un objet qui porte aussi son propre `submitted_by`. ## L'événement `account.dispute_evidence_submitted` parvient à votre plateforme, dans l'environnement du litige, chaque fois qu'un envoi du vendeur ajoute ou change une pièce, et quand la coupure envoie son brouillon pour lui. C'est une [livraison du cycle de vie Sync](https://docs.wajub.com/fr/developer-tools/webhooks/events#sync-lifecycle-deliveries) : listez-le par son nom dans les événements de votre endpoint. ```json title="Une livraison account.dispute_evidence_submitted" { "event": "account.dispute_evidence_submitted", "account": "acc_Gt6yU3nE8rM1kS5vX9bQ", "sandbox": false, "timestamp": "2026-11-21T09:12:04+00:00", "dispute": { "id": "dsp_8Hq2Lw4Tz6Nc1Vb3Xk9R", "payment": "trx_Lw2Ka8Qd1Fz6Tn4Bc7Xm", "status": "under_review", "reason": "product_not_received", "amount": 20000, "currency": "XAF", "due_date": "2026-11-30T10:00:00+00:00" }, "submitted_by": "seller", "evidence_types": ["proof_of_delivery"], "dispute_handling": "both", "seller_may_change_until": "2026-11-29T10:00:00+00:00" } ``` `submitted_by` vaut `seller`, ou `auto` quand la coupure a envoyé le brouillon. `seller_may_change_until` est renseigné en `both` tant que la réponse reste ouverte au vendeur, `null` sinon. Les copies `dispute.*` que vous recevez déjà ne changent pas. ## Le composant `disputes` Activez-le avec `components: { disputes: { enabled: true } }` sur `POST /accounts/{id}/embedded_sessions`, puis `wajub.create('disputes').mount('#wajub-disputes')`. Comptes `lite` seulement : un compte `relay` répond `component_not_available`. Il n'a aucune fonction à activer : il suit `dispute_handling`, un formulaire pour `seller` et `both`, la lecture seule pour `platform`. Il ne montre jamais vos propres pièces ni l'adresse d'un fichier. ## L'argent ne change pas Un litige perdu est débité comme il l'a toujours été ([Remboursements Sync](https://docs.wajub.com/fr/sync/refunds#a-lost-dispute-is-always-debited)). Un litige gagné sur une vente [bloquée jusqu'à la livraison](https://docs.wajub.com/fr/sync/holds) rend au vendeur ce que le litige retenait, et la vente reste bloquée jusqu'à votre libération. - [Litiges](https://docs.wajub.com/fr/api/disputes): Le cycle de vie d'un litige et l'API des preuves. - [Composants embarqués](https://docs.wajub.com/fr/sync/embedded-components): Le composant `disputes` et les autres. - [Remboursements Sync](https://docs.wajub.com/fr/sync/refunds): Qui paie un remboursement ou un litige perdu. --- # Composants embarqués URL: https://docs.wajub.com/fr/sync/embedded-components > Montrez à un vendeur ses ventes, ses versements, son solde, son compte, ses litiges et ce qui l'attend, dans vos propres pages, à vos couleurs. Vos vendeurs se connectent déjà à votre produit. Les composants embarqués y mettent des morceaux de leur espace Wajub, dans vos pages et à vos couleurs : leurs ventes, leurs versements, leur solde, les actions qui les attendent. Ils ne quittent jamais votre site, et vous ne refaites pas des écrans que Wajub tient déjà à jour. ## Les composants | Composant | Montre | `lite` | `relay` | | --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- | ------ | ------------------------------ | | `notifications` | Les actions qui attendent le vendeur : vérification d'identité, compte de versement manquant, pièce d'identité demandée, versements retenus | Oui | Oui | | `payments` | Ses ventes, page par page (montant, frais, votre commission, remboursé, net, statut), et le détail de chaque vente avec ses remboursements | Oui | Non | | `payouts` | Les versements que Wajub lui a envoyés, ce que chacun règle ligne à ligne, le prochain versement, ce qui retient ses versements, et ses relevés annuels | Oui | Oui, les versements de ses dus | | `balance` | Lite : disponible, en attente, en réserve, bloqué jusqu'à la livraison. Relay : ce qui lui est dû et à verser, ce qui est encore retenu | Oui | Oui | | `account` | La vérification d'identité à terminer, ses comptes de versement (4 derniers caractères), et en option leur changement | Oui | Non | | `disputes` | Les litiges sur ses ventes, et sa réponse quand vous le laissez la donner ([Litiges sur les ventes de vos vendeurs](https://docs.wajub.com/fr/sync/disputes)) | Oui | Non | Un marchand `direct` a son propre Dashboard : une session embarquée pour lui est refusée avec `account_type_not_embeddable`. Tout fonctionne en sandbox, avec une clé de test et un compte sandbox. Le portail entier dans une iframe ([`portal_sessions`](https://docs.wajub.com/fr/sync/onboarding#the-portal-in-your-own-pages)) reste disponible. Les composants sont la voie recommandée : vous choisissez quoi montrer, et où. ## Comment les pièces s'assemblent 1. **Déclarez les origines de vos pages** Sous **Paramètres, Sync, Plateforme**, listez jusqu'à 5 origines `https` d'où vos pages sont servies. Les composants s'affichent là, et nulle part ailleurs. 2. **Votre serveur demande une session** `POST /accounts/{id}/embedded_sessions` avec votre clé secrète, en nommant les composants à activer. Vous recevez un `client_secret`, valable une fois pendant 5 minutes, et `loader_url`. 3. **Votre page charge le script** `WajubConnect.init({ fetchClientSecret })` appelle votre serveur quand il lui faut un secret, l'échange contre une session de 30 minutes, puis monte chaque composant dans son propre cadre. 4. **La session finit, une autre commence** Quand la session expire, le chargeur redemande un secret à votre `fetchClientSecret`. Si le vendeur a quitté votre plateforme entre-temps, le composant envoie `exit`. ## Créer une session ```bash title="Une session avec quatre composants" curl https://api.wajub.com/accounts/acc_Gt6yU3nE8rM1kS5vX9bQ/embedded_sessions \ -H "Authorization: sk.xxxxxxxxxxxxxxxx…" \ -H "Content-Type: application/json" \ -d '{ "components": { "notifications": { "enabled": true }, "payments": { "enabled": true }, "payouts": { "enabled": true }, "account": { "enabled": true, "features": { "edit_payout_account": true } } } }' ``` | Champ | | | ------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `components` | Requis. Des clés parmi `notifications`, `payments`, `payouts`, `balance`, `account`, `disputes` ; au moins une avec `enabled: true` | | `components.*.enabled` | `false` par défaut | | `components.account.features.edit_payout_account` | Laisse le vendeur changer son compte de versement depuis le composant. **Toujours** après un code envoyé au propriétaire de son espace, valable pour ce nouveau compte seulement, jamais sur votre seule parole, et le nouveau compte attend la période de refroidissement habituelle ([Changer de compte de versement](#changing-the-payout-account)) | | `components.payments.features.refund_management` | Réservée : `true` est refusé avec `feature_not_available` pour l'instant | ```json title="Réponse · 201 Created" { "code": 201, "status": "Created", "message": "Embedded session created", "embedded_session": { "id": "es_0193f3c2a1b47c9e8d2f5a6b7c8d9e0f", "client_secret": "es_0193f3c2a1b47c9e8d2f5a6b7c8d9e0f_secret_…", "expires_at": "2026-11-20T10:05:00+00:00", "account_type": "lite", "components": { "notifications": { "enabled": true, "features": {} }, "payments": { "enabled": true, "features": { "refund_management": false } }, "payouts": { "enabled": true, "features": {} }, "balance": { "enabled": false, "features": {} }, "account": { "enabled": true, "features": { "edit_payout_account": true } }, "disputes": { "enabled": false, "features": {} } }, "loader_url": "https://acme.wajub.app/embed/v1.js" } } ``` `components` liste toujours les six composants, chacun avec `enabled` et ses fonctions, que vous l'ayez activé ou non. Le `client_secret` sert **une fois**, avant `expires_at`, et seulement depuis une page d'une de vos origines déclarées. Wajub n'en garde que l'empreinte. Donnez-le au navigateur qui l'a demandé et à rien d'autre : ne le journalisez jamais, ne le mettez jamais dans une URL. `loader_url` est sur l'adresse de vos vendeurs : [votre propre domaine](https://docs.wajub.com/fr/sync/own-domain) quand il est actif, `votrenom.wajub.app` une fois le nom validé par Wajub, `lite.wajub.com` avant. | `error_code` | Statut | Quand | | -------------------------------------- | ------ | --------------------------------------------------------- | | `account_type_not_embeddable` | `400` | Un compte `direct` | | `component_not_available` | `400` | `payments`, `account` ou `disputes` sur un compte `relay` | | `feature_not_available` | `400` | `payments.refund_management: true` | | `unknown_component`, `unknown_feature` | `400` | Une clé que Wajub ne connaît pas | | `no_component_enabled` | `400` | Rien d'activé | | `account_not_active` | `409` | La connexion n'est pas encore active | | `frame_origins_missing` | `409` | Vous n'avez déclaré aucune origine | Un compte d'une autre plateforme, ou de l'autre environnement, répond `404`. ## Une intégration complète Votre serveur détient la clé secrète et sait quel vendeur est connecté. Il crée la session et ne donne au navigateur que le `client_secret`. ```js title="Serveur · Node.js (Express)" import express from 'express'; const app = express(); app.post('/wajub/embedded-session', requireSellerLogin, async (req, res) => { const accountId = req.user.wajubAccountId; // acc_… const response = await fetch(`https://api.wajub.com/accounts/${accountId}/embedded_sessions`, { method: 'POST', headers: { Authorization: process.env.WAJUB_SECRET_KEY, 'Content-Type': 'application/json', }, body: JSON.stringify({ components: { notifications: { enabled: true }, payments: { enabled: true }, payouts: { enabled: true }, balance: { enabled: true }, account: { enabled: true, features: { edit_payout_account: true } }, }, }), }); const body = await response.json(); if (!response.ok) return res.status(502).json({ error: body.error_code }); res.json({ client_secret: body.embedded_session.client_secret }); }); ``` ```php title="Serveur · PHP (Laravel)" $session = Http::withHeaders(['Authorization' => config('services.wajub.secret')]) ->post("https://api.wajub.com/accounts/{$accountId}/embedded_sessions", [ 'components' => [ 'payments' => ['enabled' => true], 'payouts' => ['enabled' => true], ], ]) ->throw() ->json('embedded_session'); return ['client_secret' => $session['client_secret']]; ``` Votre page charge le script depuis `loader_url` et monte les composants où vous les voulez. ```html title="Navigateur"
``` Avant d'essayer : déclarez `https://votre-site.example` sous **Paramètres, Sync, Plateforme**, et en test utilisez une clé de test et un compte sandbox. ## Le chargeur `WajubConnect` est en version `1`, et reste tel quel : un changement ultérieur sortira à une autre adresse. | Appel | Fait | | -------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- | | `WajubConnect.init({ fetchClientSecret, appearance, locale })` | Démarre une session. Tous les composants créés depuis elle la partagent | | `wajub.create(name)` | Un composant : `notifications`, `payments`, `payouts`, `balance`, `account` ou `disputes` | | `component.mount(target)` | Le dessine dans un sélecteur CSS ou un élément. Il prend toute la largeur du conteneur, et sa hauteur suit son contenu | | `component.unmount()` | Le retire | | `component.on(event, handler)` | Écoute `ready`, `loaderror` ou `exit` ; renvoie le composant, les appels s'enchaînent | | `wajub.destroy()` | Retire tous les cadres et l'écouteur | `locale` vaut `en` ou `fr` ; sans elle, la langue du navigateur, et le français à défaut. `WajubConnect.version` vaut `'1'` et `WajubConnect.components` liste les noms. | Événement | Quand | | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `ready` | Le composant est dessiné : `{ component }` | | `loaderror` | Il n'a pas pu se charger : `{ type, message }`, avec un `type` comme `frame_timeout` (rien n'a répondu en 15 secondes : vérifiez vos origines déclarées), `invalid_client_secret`, `origin_not_allowed`, `component_not_enabled` ou `load_error` | | `exit` | La session est finie et ne peut pas être renouvelée | ### L'apparence L'apparence est vérifiée par Wajub : pas de CSS libre. | Clé | Valeurs | | ---------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `colors.primary`, `colors.background`, `colors.text` | `#rgb` ou `#rrggbb` | | `border_radius` | `0px`, `4px`, `8px`, `12px` ou `9999px` | | `font` | Instrument Sans, Inter, Roboto, Open Sans, Lato, Montserrat, Poppins, DM Sans, Plus Jakarta Sans, Raleway, Nunito, Work Sans, Manrope, Outfit, Space Grotesk, Public Sans, Figtree, Lexend, Sora, Source Sans 3 ou IBM Plex Sans | | `mode` | `light`, `dark` ou `system` | Toute autre valeur est ignorée, signalée dans la console, et remplacée par votre marque de **Paramètres, Image de marque**. Une couleur qui manque de contraste est ajustée pour rester lisible, comme sur le portail. ## Changer de compte de versement Avec `edit_payout_account`, le composant `account` permet à un vendeur Lite de changer l'endroit où il est payé. Ni votre parole ni votre session n'y suffisent : | Étape | | | ------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Le vendeur saisit le nouveau compte | L'opérateur et le numéro, ou le compte bancaire, vérifiés comme dans son portail avant tout envoi de code | | Un code part au propriétaire de son espace | À l'adresse e-mail qui ouvre son espace, jamais à une adresse que vous avez enregistrée. L'e-mail nomme le nouveau compte (l'opérateur, les 4 derniers chiffres) et dit de ne jamais donner le code à personne, pas même à votre plateforme ni à quelqu'un qui dit travailler pour Wajub. Il part de Wajub, sous le nom d'espace validé (« votrenom via Wajub »), sans votre logo, votre couleur ni votre adresse de réponse | | Le code ne confirme que ces coordonnées | Envoyé avec d'autres coordonnées, il est refusé et consommé : le vendeur en demande un nouveau. Demander un code pour d'autres coordonnées annule le précédent | | Le compte change | Après la période de refroidissement habituelle. Le vendeur reçoit un e-mail de Wajub disant que son compte de versement a changé, dont le lien mène à son adresse Wajub, jamais à votre domaine | Sur [votre propre domaine](https://docs.wajub.com/fr/sync/own-domain), rien ne se confirme dans le cadre : vous tenez le certificat de ce domaine. Le composant montre les comptes de versement en lecture seule, et son bouton **Changer de compte de versement** ouvre l'adresse Wajub du vendeur, `https://votrenom.wajub.app/payout-account` (le `change_url` du composant, `null` sur une adresse Wajub), dans un nouvel onglet. Le vendeur s'y connecte avec son propre code et change le compte sur place. Le chargeur et le composant gèrent eux-mêmes ces réponses du cadre : | Réponse | Quand | | ----------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- | | `409` `change_on_wajub`, avec `url` | Un code demandé, ou un changement envoyé, sur votre propre domaine : le changement se fait à `url` | | `429` `too_many_codes` | 3 codes par heure ou 6 par jour ; ou un code pour d'autres coordonnées est en route et le délai entre deux codes n'est pas écoulé | | `429` `payout_account_locked` | 5 codes faux en 24 heures : le changement est bloqué pendant 24 heures | ## Fermer les sessions d'un vendeur `POST /accounts/{id}/embedded_sessions/revoke` met fin d'un coup à toutes les sessions embarquées du vendeur : les secrets clients pas encore échangés ne marchent plus, et les sessions ouvertes se terminent. Leurs cadres répondent `session_expired`, et le chargeur redemande un secret à votre `fetchClientSecret`. Appelez-la quand un vendeur quitte votre plateforme, ou quand un secret client a pu fuiter ; si le vendeur ne doit plus rien voir, faites refuser ce secret suivant par votre serveur. ```bash title="Fermer les sessions d'un vendeur" curl -X POST https://api.wajub.com/accounts/acc_Gt6yU3nE8rM1kS5vX9bQ/embedded_sessions/revoke -H "Authorization: sk.xxxxxxxxxxxxxxxx…" ``` ```json title="Réponse · 200 OK" { "code": 200, "status": "OK", "message": "Embedded sessions revoked", "revoked": 2 } ``` | Règle | | | ------------- | --------------------------------------------------------------------------------------------------------------------------- | | `revoked` | Combien de sessions encore vivantes ont été fermées, secrets pas encore échangés compris ; `0` s'il n'y en avait aucune | | Environnement | Celui du compte : une clé de test ferme les sessions de test | | Clé | Votre clé secrète, sans `X-Sync`. Une clé restreinte est refusée (`403`), comme sur `POST /accounts/{id}/embedded_sessions` | | Refus | `400` `account_type_not_embeddable` sur un compte `direct` ; `404` pour un compte d'une autre plateforme | ## Ce qui le rend sûr | Règle | Pourquoi | | --------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Aucun cookie tiers | La session passe par `postMessage` vers l'origine exacte du cadre, puis dans un en-tête `Authorization`. Ça marche dans les navigateurs qui bloquent les cookies tiers | | Le jeton n'est jamais dans une URL | L'adresse du cadre ne porte que l'identifiant public de la session, qui dit quelles origines peuvent l'encadrer | | Les messages sont vérifiés dans les deux sens | Le cadre n'écoute que son parent sur une origine déclarée ; le chargeur, que ses propres cadres | | Encadré par vos seules origines | Les cadres envoient `frame-ancestors` avec les origines que vous avez déclarées | | `Origin` protège un navigateur, pas un secret | Le secret n'est échangé que depuis une page d'une origine déclarée. Un serveur qui détient un secret client peut envoyer n'importe quel `Origin` : gardez le secret sur votre serveur jusqu'à ce que votre page le demande, et [fermez les sessions du vendeur](#revoking-sessions) s'il a pu fuiter | | Votre clé secrète seulement | Créer et fermer des sessions demande votre clé secrète : une clé restreinte est refusée | | Lecture seule, sauf une fonction | Seule `edit_payout_account` écrit, et seulement après un code à usage unique envoyé à l'adresse du propriétaire de l'espace du vendeur, jamais à une adresse que vous avez enregistrée, et valable pour le seul compte qu'il nomme. Le code sert une fois, pendant 10 minutes. Au plus 3 codes par heure et 6 par jour ; 5 codes faux en 24 heures bloquent le changement pendant 24 heures. Sur votre propre domaine, le changement se fait sur l'adresse Wajub du vendeur. Après tout changement, le vendeur reçoit un e-mail de Wajub disant que son compte de versement a changé | | La session suit vos réglages | Elle se termine aussitôt (le chargeur redemande un secret à votre serveur) quand l'origine qui l'a ouverte n'est plus déclarée, que l'espace du vendeur est fermé, ou que Sync n'est plus dans votre forfait. Origines et forfait sont relus au moins toutes les 60 secondes | > [!NOTE] > **Appeler les cadres vous-même** > > Le chargeur et ses cadres appellent quelques routes sur l'adresse de vos vendeurs > (`/embed/v1/sessions`, `/embed/v1/payments`…). Ce n'est pas une API à appeler à la main, et elles > peuvent changer dans la version `1` tant que le chargeur, lui, ne change pas. - [Votre propre domaine](https://docs.wajub.com/fr/sync/own-domain): Servez le portail et les composants sur un domaine à vous. - [Litiges sur les ventes de vos vendeurs](https://docs.wajub.com/fr/sync/disputes): Laissez les vendeurs répondre depuis le composant `disputes`. - [Créer une session embarquée](https://docs.wajub.com/fr/api/subaccounts/create-embedded-session): La spécification de l'endpoint. - [Fermer les sessions](https://docs.wajub.com/fr/api/subaccounts/revoke-embedded-sessions): Mettre fin à toutes les sessions embarquées d'un vendeur. --- # Bloquer jusqu'à la livraison URL: https://docs.wajub.com/fr/sync/holds > Gardez l'argent d'une vente jusqu'à ce que l'acheteur ait la marchandise, puis libérez-le, ou laissez-le se libérer seul. Une marketplace de biens physiques paie son vendeur une fois le colis entre les mains de l'acheteur. Avec Sync, vous le demandez à la création du paiement : l'argent de la vente revenant au vendeur **reste bloqué jusqu'à ce que vous le libériez**, et se libère seul au plus tard après un délai que vous avez choisi. Un lien de paiement ou une facture que vous créez pour le vendeur peut porter le même blocage, pour chaque paiement fait par son intermédiaire. | Le mode du vendeur | Pendant le blocage | | ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `lite` | La vente est créditée au solde du vendeur comme toute vente, votre commission prise, mais la partie bloquée est exclue de tout versement : automatique, `POST /accounts/{id}/payouts` et simulateur de sandbox | | `relay` | Le dû du vendeur est enregistré comme d'habitude, et reste impayé | | `direct` | Refusé avec `hold_not_available_for_direct` : un marchand Direct retire depuis son propre solde, et Wajub ne le paie pas | Une fois libérée, par vous ou à son échéance, la vente est versée au vendeur **à son prochain versement**. ## Le blocage le plus long, par connexion Chaque connexion `lite` ou `relay` porte `hold_max_days` : **30** (par défaut), **60** ou **90** jours. Réglez-le avec `POST /accounts` ou `PUT /accounts/{id}`, à tout moment, comme `payout_schedule` ; une vente déjà bloquée garde sa propre échéance. L'envoyer pour un compte `direct` répond `400`, et toute autre valeur `422`. Le délai court à partir du **succès du paiement**, pas de sa création. ## Bloquer une vente Ajoutez `hold` à `POST /payments`. Sur une vente faite avec `X-Sync` : ```bash title="Une vente bloquée jusqu'à votre libération" curl https://api.wajub.com/payments \ -H "Authorization: sk.xxxxxxxxxxxxxxxx…" \ -H "X-Sync: acc_Gt6yU3nE8rM1kS5vX9bQ" \ -H "Content-Type: application/json" \ -d '{ "amount": 20000, "currency": "XAF", "email": "buyer@example.com", "hold": { "until": "released", "max_days": 30 } }' ``` Sur un [paiement partagé](https://docs.wajub.com/fr/sync/split-payments#one-payment-several-sellers), `hold` bloque toutes les parts, et `shares[].hold` ne bloque qu'une part, ou lui donne son propre `max_days` : il l'emporte sur le `hold` global. ```bash title="Seule la première part est bloquée, 60 jours au plus" curl https://api.wajub.com/payments \ -H "Authorization: sk.xxxxxxxxxxxxxxxx…" \ -H "Content-Type: application/json" \ -d '{ "amount": 100000, "currency": "XAF", "email": "buyer@example.com", "shares": [ { "account": "acc_Gt6yU3nE8rM1kS5vX9bQ", "amount": 20000, "hold": { "until": "released", "max_days": 60 } }, { "account": "acc_7Yh2MpL4tRb3nP8sZcXv", "amount": 10000 } ] }' ``` | Champ | | | ----------------------------------------------- | --------------------------------------------------------------- | | `hold.until` | Requis avec `hold`. Seulement `released` | | `hold.max_days` | De 1 au `hold_max_days` du compte, qui est la valeur par défaut | | `shares[].hold.until`, `shares[].hold.max_days` | Les mêmes, pour une part | | `error_code` (`422`) | Quand | | ------------------------------- | ------------------------------------------------------------------------------------------ | | `hold_not_available_for_direct` | `hold` sur un compte `direct`, par `X-Sync` ou sur une part `direct` d'un paiement partagé | | `hold_max_days_exceeded` | `max_days` au-dessus du `hold_max_days` du compte | | `hold_requires_sync` | `hold` sur un paiement ni fait avec `X-Sync` ni partagé | | `hold_with_deferred` | `hold` avec `deferred: true` | Quand le blocage est refusé, rien n'est créé : ni le paiement, ni ses parts. ### Une vente payée par échéances `hold` fonctionne sur un paiement que l'acheteur règle [par échéances](https://docs.wajub.com/fr/sync/split-payments#installment-splitting). Tant que le blocage est `pending`, **chaque échéance est bloquée dès qu'elle est créditée** : rien n'en est versé. À la dernière échéance, la vente entière est bloquée (`held`), comme toute vente, et son `release_at` court à partir de là. Un paiement dont les échéances n'arrivent jamais toutes garde son blocage `pending`, et ce que ses échéances ont crédité reste hors des versements, jusqu'à ce que vous fermiez le paiement (`POST /payments/{id}/close` : la vente est alors bloquée) ou que vous le libériez (`POST /payments/{id}/release`). ## Sur un lien de paiement ou une facture Un lien de paiement ou une facture que vous créez avec le `X-Sync` d'un compte `lite` ou `relay` accepte le même `hold`. Chaque paiement fait par son intermédiaire est alors bloqué comme si vous l'aviez créé avec `hold` : lu dans `GET /payments/{id}`, libéré avec `POST /payments/{id}/release`, ou seul à son échéance. Sur une facture, chaque paiement compte, une partie du solde ou une échéance, et une facture récurrente transmet le blocage à chaque facture qu'elle génère. ```bash title="Chaque paiement de ce lien est bloqué jusqu'à votre libération" curl https://api.wajub.com/links \ -H "Authorization: sk.xxxxxxxxxxxxxxxx…" \ -H "X-Sync: acc_Gt6yU3nE8rM1kS5vX9bQ" \ -H "Content-Type: application/json" \ -d '{ "type": "product", "title": "Panier tressé", "amount": 20000, "currency": "XAF", "cta_type": "buy_now", "price": 20000, "product_type": "physical", "hold": { "until": "released", "max_days": 30 } }' ``` | Champ | | | --------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `hold.until` | Requis avec `hold`. Seulement `released` | | `hold.max_days` | De 1 au `hold_max_days` du compte. Absent, chaque paiement est bloqué au plus le `hold_max_days` du compte au moment où il est ouvert. Si vous baissez `hold_max_days` ensuite, un paiement n'est jamais bloqué plus longtemps que la nouvelle valeur | Le lien ou la facture renvoie son `hold` (`until`, et `max_days`, `null` pour celui du compte), ou `null` quand ses paiements ne sont pas bloqués. Les refus sont ceux de `POST /payments` : `hold_requires_sync` sans `X-Sync`, `hold_not_available_for_direct` sur un compte `direct` et `hold_max_days_exceeded`. Pour le changer, envoyez `hold` à `PUT /links/{id}` ou `PUT /invoices/{id}`, ou `hold: null` pour le retirer ; absent, il reste tel quel. | Règle | | | ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Vous seul le changez | Avec le `X-Sync` du compte pour lequel le lien ou la facture a été créé ; sur un lien ou une facture `relay`, votre propre clé suffit aussi. La propre clé d'un vendeur Lite reçoit `403` avec `error_code: hold_set_by_platform`, pour retirer le blocage comme pour le raccourcir, et peut toujours changer les autres champs | | Jusqu'à son premier paiement | Dès qu'un paiement est fait ou en cours par son intermédiaire, `409` avec `error_code: hold_locked` : chaque paiement garde le blocage avec lequel il a été ouvert. Un paiement annulé, expiré ou échoué ne compte pas | | Le même blocage renvoyé | Jamais refusé | Rien n'est bloqué par défaut : seulement les paiements que vous créez avec `hold`, et ceux faits par un lien ou une facture que vous avez créés avec `X-Sync` et `hold`. ## Ce que vous lisez Une vente faite avec `X-Sync` porte `hold`, et chaque part d'un paiement partagé `shares[].hold`, dans `GET /payments/{id}`, la réponse de création et les webhooks `payment.*`. Une clé publiable ne le voit jamais. ```json title="L'objet hold" { "status": "held", "max_days": 30, "currency": "XAF", "amount": 19000, "held": 14250, "given_back": 4750, "held_at": "2026-11-20T09:12:04+00:00", "release_at": "2026-12-20T09:12:04+00:00", "released_at": null, "release_reason": null } ``` | Champ | | | ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `status` | `pending` (le paiement n'a pas encore réussi), `held`, `released`, ou `refunded` et `disputed` quand un remboursement ou un litige perdu a tout repris pendant le blocage | | `amount` | Ce que la vente a laissé au vendeur, dans la devise de règlement : en `lite`, la vente moins les frais de Wajub et votre commission ; en `relay`, son dû. En unités majeures, avec des décimales pour une devise qui en a, comme `held` et `given_back` | | `held` | Ce qui reste bloqué | | `given_back` | Ce que les remboursements et les litiges perdus ont repris | | `release_at` | Quand il se libère seul | | `release_reason` | `platform` (vous) ou `auto` (l'échéance) | Dans `shares[].hold` et dans les webhooks s'ajoutent `account` et `account_type`. ## Le libérer Une fois la marchandise chez l'acheteur, libérez le paiement, avec votre propre clé et **sans** `X-Sync` : ```bash title="Libérer un paiement bloqué" curl -X POST https://api.wajub.com/payments/trx_Lw2Ka8Qd1Fz6Tn4Bc7Xm/release \ -H "Authorization: sk.xxxxxxxxxxxxxxxx…" ``` Sans corps, toutes les parts bloquées sont libérées. Pour ne libérer que certaines parts d'un paiement partagé, nommez leurs comptes : `{"shares": [{"account": "acc_Gt6yU3nE8rM1kS5vX9bQ"}]}`. Une part est libérée entière, jamais un montant d'elle : `shares[].amount` est refusé. | Règle | | | ------------------- | ------------------------------------------------------------------------------------------------------------------- | | Idempotent | Relibérer ce qui l'est déjà répond `200` avec les blocages tels quels, et n'envoie pas de second `payment.released` | | Avant le succès | Une part encore `pending` peut être libérée : elle ne sera jamais bloquée | | Depuis le Dashboard | La page du paiement a un bouton **Libérer**, pour les membres qui gèrent les versements | | Réponse | Quand | | ------------------------------ | -------------------------------------------------------------------------------------------------------------- | | `200` | Les `holds` du paiement, tels que la libération les a laissés | | `404` | Pas un paiement à vous ni à vos comptes, ou de l'autre environnement | | `409` `payment_not_held` | Rien de ce paiement n'est ni n'a été bloqué : jamais demandé, ou tout repris par un remboursement ou un litige | | `422` `release_share_not_held` | Un compte de `shares` n'a pas de part bloquée dans ce paiement | | `403` | Appel avec `X-Sync` | ## Quand personne ne le libère Un blocage encore `pending` sur une vente déjà créditée garde aussi cette vente hors des versements, jusqu'à ce qu'il soit posé, au plus tard au passage horaire suivant. Une vente encaissée sur le rail Wajub dont le crédit au vendeur tarde (une écriture échouée, pas encore de taux de change) garde son blocage `pending` jusqu'à ce crédit, en `lite` comme en `relay` : elle n'est jamais libérée faute de quoi bloquer. Seule une vente encaissée hors du solde Wajub, sur le contrat propre d'un marchand, est libérée tout de suite : Wajub ne paie rien au vendeur pour elle. Chaque heure, Wajub libère les blocages dont `release_at` est passé (`payment.released` avec `reason: auto`). Trois jours avant, vous recevez `payment.hold_expiring`, une fois par blocage. ## Remboursements et litiges pendant le blocage Un remboursement est pris sur l'argent bloqué : en `lite` il est sur le solde du vendeur, en `relay` le dû est réduit. **Vous ne couvrez jamais la partie bloquée.** Le blocage diminue de ce qui a été repris : | La vente | Le blocage diminue de | | ------------------------------ | ----------------------------------------------------------------------------- | | Faite avec `X-Sync` | La part remboursée de la vente, tous remboursements et litiges perdus comptés | | Une part d'un paiement partagé | Exactement ce que la part a repris au vendeur | Le blocage diminue une fois le débit du remboursement inscrit, en sandbox comme en live ; d'ici là, l'argent reste hors des versements, si bien que vous ne couvrez jamais la partie bloquée même quand le débit arrive en retard. Remboursé en totalité, le blocage passe `refunded`, ou `disputed` après un litige perdu, avec `held: 0`. Votre commission suit sa règle habituelle, prise à la vente et rendue selon `commission_refund_policy` ; les frais de Wajub ne sont pas rendus, si bien qu'un blocage peut rester un peu au-dessus de ce qui reste de la vente jusqu'à sa libération. Par exemple, une vente Lite de 20 000 XAF avec 5 % de commission bloque 19 000. Un remboursement de 5 000 reprend 4 750 au vendeur (5 000 moins les 250 de commission que vous rendez) : 14 250 restent bloqués, et vous ne couvrez rien. Un litige **gagné** pendant le blocage rend au vendeur ce que le litige retenait, et ne libère pas la vente : elle reste bloquée jusqu'à votre libération ou son échéance. Une vente bloquée ne compte pas dans votre [exposition](https://docs.wajub.com/fr/sync/payouts#your-exposure-cap) : elle le devient quand elle est versée, après sa libération. ## Les événements Envoyés à votre plateforme, dans l'environnement de la vente, avec en `data` l'`id` du paiement, `object` et les `holds` concernés. | Événement | Quand | | ----------------------- | -------------------------------------------------------------------------------------------------------------------- | | `payment.held` | Un paiement que vous avez demandé à bloquer a réussi (un paiement partagé : une fois ses parts passées aux vendeurs) | | `payment.released` | Vous l'avez libéré, ou son échéance l'a fait ; `reason` vaut `platform` ou `auto` | | `payment.hold_expiring` | Trois jours avant qu'il se libère seul. Une fois par blocage | Ils sont listés dans `GET /events`, et filtrables avec `X-Sync`. ## En sandbox Pour ne pas attendre 30 jours, `POST /accounts/{id}/simulate` avec `{"action": "expire_holds"}` amène les ventes bloquées de la connexion à leur échéance tout de suite : elles sont libérées comme par le passage horaire, avec `payment.released` et `reason: auto`. ```json title="Réponse · 200 OK" { "code": 200, "status": "OK", "message": "Holds released", "action": "expire_holds", "account": "acc_test_Gt6yU3nE8rM1kS5vX9bQ", "released": { "holds": 2, "payments": 2 } } ``` ## Ce que voit le vendeur Dans son portail et dans les composants `payments`, `payouts` et `balance`, un vendeur Lite lit un montant « en attente de livraison », versé dès que vous confirmez la livraison et au plus tard à la date indiquée, et sur chaque vente bloquée si elle attend encore ou a été libérée par vous. L'estimation de son prochain versement laisse les ventes bloquées de côté. - [Payer les vendeurs](https://docs.wajub.com/fr/sync/payouts): Les versements, la réserve et ce qui retient un versement. - [Un paiement, plusieurs vendeurs](https://docs.wajub.com/fr/sync/split-payments#one-payment-several-sellers): Les paiements partagés, part par part. - [Libérer un paiement](https://docs.wajub.com/fr/api/subaccounts/release-payment): La spécification de l'endpoint. --- # Sync URL: https://docs.wajub.com/fr/sync > Encaissez pour les marchands et les vendeurs de votre plateforme, prélevez votre commission, et choisissez qui tient le compte, selon trois modes. Sync permet à une marketplace ou à une plateforme d'agir au nom des marchands avec lesquels elle travaille : une fois un marchand connecté, vous appelez l'API classique avec un en-tête supplémentaire et la requête s'exécute comme s'il l'avait envoyée. **Une connexion n'est pas un compte que vous créez à la place du marchand** : c'est lui qui l'accepte, après avoir lu ce que vous demandez. ## Choisir un mode Le mode d'une connexion dit ce que le vendeur possède chez Wajub, où se trouve l'argent, et ce que votre plateforme porte quand une vente est défaite. Il se choisit à la création, avec `account_type`, et ne change plus ensuite. | Mode | Le vendeur a | L'argent passe par | Qui lui envoie son argent | Ce que vous portez | Pour qui | | --------------------- | ------------------------------------------- | ----------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------- | | `direct` (par défaut) | Un compte Wajub complet, avec son Dashboard | Le rail Wajub, ou ses propres contrats de prestataire | Lui-même : il retire | Rien : il porte son propre solde négatif. S'il encaisse sur ses propres contrats, votre commission devient une créance | Les marchands déjà équipés | | `lite` | Un portail vendeur, à vos couleurs | Le rail Wajub, toujours | Wajub, au rythme que vous fixez | Ce qu'il ne peut plus rembourser après avoir été payé, une fois sa réserve épuisée. Vous pouvez le récupérer sur ses versements suivants | Les petits vendeurs, le cas courant | | `relay` | Aucun compte : son portefeuille vérifié | Votre propre solde | Wajub, depuis votre solde, au rythme que vous fixez : la vente moins les frais de Wajub, votre commission et ce qu'il doit | Tout : remboursements et litiges sortent de votre solde, et ce qu'un vendeur déjà payé doit est retenu sur son versement suivant | Les marketplaces *merchant of record* | > [!NOTE] > **Lite et Relay en live passent par la revue de Wajub** > > Une connexion `lite` ou `relay` en live s'ouvre une fois que Wajub a examiné votre plateforme pour > ce mode. Demandez-le sous **Paramètres, Sync, Plateforme**. Tout fonctionne en sandbox sans elle. > [Relay](https://docs.wajub.com/fr/sync/relay) Ce ne sont pas des paliers : deux connexions de modes différents peuvent porter les mêmes capacités et la même commission. Ce qui change est qui tient le compte, et donc [qui rembourse](https://docs.wajub.com/fr/sync/refunds) et [qui paie le vendeur](https://docs.wajub.com/fr/sync/payouts). ## Ce qu'il vous faut avant de commencer | Condition | Détail | | ------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Forfait | Scale ou Enterprise, ou l'option Sync avec un forfait inférieur. Sans cela, les routes de compte et tout appel portant `X-Sync` répondent `403` avec `error_code: feature_not_in_plan` | | Approbation, pour `lite` et `relay` en live | Wajub examine votre plateforme avant que vous ouvriez des connexions `lite` ou `relay` en live : demandez-la sous **Paramètres, Sync, Plateforme**. D'ici là, un `POST /accounts` live pour ces modes répond `403` avec `error_code: sync_mode_not_approved`. La sandbox et `direct` ne demandent rien. [Votre plafond d'exposition](https://docs.wajub.com/fr/sync/payouts#your-exposure-cap) | | Clé | La clé secrète de votre plateforme. Une clé publique sur une route de compte renvoie `406 Private Key Required` | | Marchand | En `direct`, un compte Wajub existant ou une personne prête à en ouvrir un. En `lite`, un vendeur qui accepte votre invitation et vérifie son identité : il n'a pas de compte à gérer | ## Les quatre fonctions de Sync **Connecter un compte.** Vous créez une connexion, transmettez un lien au marchand, puis celui-ci l'accepte en ligne. Un marchand `direct` le fait avec son propre compte ; un vendeur `lite` n'a pas de Dashboard, et retrouve ensuite ses ventes et ses versements dans son portail. **Vous prêter son identité.** Avec `X-Sync` dans une requête, la requête agit en tant que marchand connecté. Le paiement, le client et le remboursement lui appartiennent. **Prélever votre commission.** Chaque connexion possède une règle tarifaire. Lorsqu'un paiement attribué à cette connexion réussit, les frais quittent le solde du marchand et arrivent sur le vôtre, sous la même rétention que la vente. Ils sont rendus si la vente est remboursée ou si un litige sur elle est perdu, selon la politique fixée sur la connexion. **Vous envoyer une copie de ses événements.** Un paiement, un remboursement ou un transfert sur un compte connecté, et un litige sur l'un de ses paiements, déclenche le webhook du marchand et envoie une deuxième copie aux endpoints de votre plateforme. ## Ce que Sync ne fait pas > [!NOTE] > **Un paiement, plusieurs vendeurs** > > Un paiement porte un seul en-tête `X-Sync`. Pour partager un panier entre plusieurs vendeurs, créez > le paiement avec votre propre clé et listez les parts dans `shares` : l'acheteur paie une fois, et > Wajub répartit l'argent. [Un paiement, plusieurs vendeurs](https://docs.wajub.com/fr/sync/split-payments#one-payment-several-sellers) Deux autres limites doivent être connues avant de concevoir votre système. Qui paie un marchand dépend du mode de la connexion : Wajub paie un marchand `lite`, selon un calendrier ou lorsque vous appelez `POST /accounts/{id}/payouts`, et un marchand `direct` retire lui-même ou via un [transfert](https://docs.wajub.com/fr/payouts/transfers) classique que vous envoyez avec l'en-tête `X-Sync`, sur son solde. [Payer les vendeurs](https://docs.wajub.com/fr/sync/payouts) couvre les trois modes. De plus, les capacités sont figées dès la connexion du marchand, comme l'explique la [page des capacités](https://docs.wajub.com/fr/sync/account-types). ## L'en-tête en un seul endroit Toutes les routes de cette section sont des routes classiques. Seul un en-tête change. ```bash title="Un paiement attribué à une connexion" curl https://api.wajub.com/payments \ -H "Authorization: sk.xxxxxxxxxxxxxxxx…" \ -H "X-Sync: acc_7Yh2MpL4tRb3nP8sZcXv" \ -H "Content-Type: application/json" \ -d '{ "amount": 50000, "currency": "XAF", "customer": { "email": "buyer@example.com" } }' ``` L'en-tête contient l'`id` de la connexion, la valeur renvoyée sous la forme `account.id` lors de sa création. Ce n'est ni l'identifiant du compte du marchand ni l'une de vos clés. `X-Sync` est lu sur toutes les routes authentifiées, pas seulement celles des paiements. Les clients, remboursements, factures, transferts et liens de paiement l'acceptent, selon les capacités accordées. ## Les ressources | Méthode | Endpoint | Rôle | | -------------------- | -------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------ | | `POST` `GET` | [`/accounts`](https://docs.wajub.com/fr/api/subaccounts) | Créer, répertorier et récupérer une connexion | | `PUT` `DELETE` | [`/accounts/{id}`](https://docs.wajub.com/fr/api/subaccounts) | Mettre à jour la tarification et le statut, ou déconnecter | | `POST` | [`/accounts/{id}/token`](https://docs.wajub.com/fr/api/subaccounts) | Générer un nouveau lien d'autorisation | | `POST` | [`/accounts/{id}/payouts`](https://docs.wajub.com/fr/api/subaccounts/payouts) | Payer un marchand `lite` immédiatement | | `GET` | [`/accounts/{id}/commission-receivables`](https://docs.wajub.com/fr/api/subaccounts/commission-receivables) | Les commissions qu'un marchand vous doit encore | | `POST` | [`/accounts/{id}/embedded_sessions`](https://docs.wajub.com/fr/api/subaccounts/create-embedded-session) | Montrer l'espace d'un vendeur dans vos pages ([Composants embarqués](https://docs.wajub.com/fr/sync/embedded-components)) | | `POST` | [`/payments/{id}/release`](https://docs.wajub.com/fr/api/subaccounts/release-payment) | Libérer une vente bloquée jusqu'à la livraison ([Bloquer jusqu'à la livraison](https://docs.wajub.com/fr/sync/holds)) | | `POST` | [`/accounts/{id}/freeze`](https://docs.wajub.com/fr/api/subaccounts/freeze), [`/unfreeze`](https://docs.wajub.com/fr/api/subaccounts/unfreeze) | Cesser ou reprendre les versements d'un vendeur ([Risque vendeur](https://docs.wajub.com/fr/sync/seller-risk)) | | `GET` | [`/sync/limits`](https://docs.wajub.com/fr/api/subaccounts/limits) | Votre plafond de versement et ce qui en est utilisé | | `GET` `PUT` `DELETE` | [`/sync/portal_domain`](https://docs.wajub.com/fr/api/subaccounts/retrieve-portal-domain) | Le portail de vos vendeurs sur votre propre domaine ([Votre domaine](https://docs.wajub.com/fr/sync/own-domain)) | | `GET` | [`/sync/metrics`](https://docs.wajub.com/fr/api/subaccounts/metrics) | Les chiffres de votre plateforme ([Analyses](https://docs.wajub.com/fr/sync/analytics)) | | `POST` `GET` | [`/sync/reports`](https://docs.wajub.com/fr/api/subaccounts/create-report) | Exports comptables et relevés des vendeurs ([Rapports](https://docs.wajub.com/fr/sync/reports)) | Tous les autres appels utilisent l'API classique avec l'en-tête. - [Démarrage rapide](https://docs.wajub.com/fr/sync/quickstart): Créer une connexion, obtenir son autorisation et y recevoir un paiement. - [Capacités du compte](https://docs.wajub.com/fr/sync/account-types): Les sept capacités, ce que chacune atteint et le calcul de la tarification. - [Intégration des marchands](https://docs.wajub.com/fr/sync/onboarding): Le cycle de vie d'une connexion et ce qui est figé après l'acceptation du marchand. - [Remboursements](https://docs.wajub.com/fr/sync/refunds): Qui demande, qui envoie et qui paie, selon le mode et l'endroit où la vente a été encaissée. - [Paiements fractionnés](https://docs.wajub.com/fr/sync/split-payments): Les trois fonctionnalités derrière le mot split : paiement en plusieurs fois, votre commission, et un paiement partagé entre vendeurs. - [Composants embarqués](https://docs.wajub.com/fr/sync/embedded-components): Les ventes, versements et solde de vos vendeurs dans vos propres pages. - [Bloquer jusqu'à la livraison](https://docs.wajub.com/fr/sync/holds): Payez le vendeur une fois la marchandise chez l'acheteur. - [Risque vendeur](https://docs.wajub.com/fr/sync/seller-risk): Un score par vendeur, un délai pour les nouveaux, et le gel. - [Référence API des sous-comptes](https://docs.wajub.com/fr/api/subaccounts): La spécification de l'endpoint. --- # Intégration des marchands URL: https://docs.wajub.com/fr/sync/onboarding > Le cycle de vie d'une connexion et ce qui est figé dès son acceptation par un marchand. Une connexion possède deux statuts qui évoluent indépendamment. `status` indique si le marchand a accepté la connexion. `payment_status` indique si elle peut déplacer de l'argent. Une connexion live peut être `active` tout en refusant tous les paiements. C'est la surprise la plus fréquente de cette section. ## Le cycle de vie | `status` | Signification | Origine | | ----------- | ------------------------------------------- | ---------------------------------- | | `pending` | Créée, personne ne l'a acceptée | `POST /accounts` | | `active` | Un marchand s'est connecté et l'a autorisée | Il a ouvert le lien d'autorisation | | `cancelled` | Arrêtée par vous | `DELETE /accounts/{id}` | | `expired` | L'invitation a expiré avant son acceptation | Le temps | Il n'existe ni statut `restricted` ni état intermédiaire. Une connexion annulée renvoie `cancelled`, une connexion associée à un marchand renvoie `active`, une invitation que personne n'a acceptée avant sa date renvoie `expired`, et toutes les autres renvoient `pending`. `expires_at` est la date de l'invitation : elle est effacée quand un marchand accepte, et une connexion acceptée n'expire jamais. ## Le lien d'autorisation La création d'une connexion génère un jeton d'autorisation à usage unique et le renvoie dans une URL. ```json title="Réponse pour une connexion non revendiquée" { "id": "acc_7Yh2MpL4tRb3nP8sZcXv", "reference": "shop-amina", "status": "pending", "payment_status": "inactive", "authorization_url": "https://sync.wajub.com/oauth/v2/authorize?access_token=…" } ``` Le marchand ouvre le lien, se connecte à son propre compte Wajub, consulte les capacités demandées, puis accepte. Votre plateforme ne manipule jamais ses identifiants et ne crée rien de son côté. > [!WARNING] > **Le lien est un identifiant d'accès** > > Toute personne qui possède cette URL peut associer un compte à votre plateforme. Envoyez-la par > un canal que vous contrôlez et traitez-la comme un secret. Si elle est divulguée, > `POST /accounts/{id}/token` révoque tous les liens déjà émis, y compris celui d'un rappel, et en > génère un nouveau, valable de nouveau 30 jours. Cet appel est refusé > avec `400` dès qu'un marchand a revendiqué la connexion, qu'elle soit encore active ou déjà > déconnectée, car ce marchand y reste rattaché et le nouveau lien ne pourrait pas servir. Pour le > joindre à nouveau, créez une nouvelle connexion qu'il accepte à nouveau. Une invitation ne reste pas ouverte indéfiniment : elle expire 30 jours après la dernière émission de son lien, à la création de la connexion, par `POST /accounts/{id}/token` ou par **Renvoyer l'invitation** dans le Dashboard, chacun relançant les 30 jours. Les deux derniers révoquent les liens déjà envoyés. Trois jours avant, un rappel part à l'adresse du marchand si vous l'avez indiquée, avec `email` sur `POST /accounts` ou `PUT /accounts/{id}` ; elle est conservée dans `profile.email`. Le rappel porte son propre lien, et celui que vous avez déjà envoyé continue de fonctionner. Une fois l'invitation expirée, tous les liens qui dorment dans la boîte du marchand cessent de fonctionner. Une connexion Relay n'a ni invitation, ni lien d'autorisation (`authorization_url` vaut `null`), et n'expire jamais. Vous pouvez avoir au plus 50 invitations ouvertes par environnement : des connexions créées et ni acceptées, ni annulées, ni expirées. Les connexions Relay ne comptent pas, puisqu'aucun marchand ne les accepte. Au-delà, `POST /accounts` répond `429` avec `You have reached the maximum of 50 pending invitations.` Annulez les invitations dont vous n'avez plus besoin, ou laissez-les expirer. Vous ne voyez `authorization_url` qu'une fois, dans la réponse à l'appel qui l'a généré : la création du sous-compte, ou la régénération de son jeton. Lire le sous-compte ensuite ne le renvoie jamais, revendiqué ou non. Conservez-le dès que vous le recevez ; si vous le perdez, générez-en un nouveau. Une fois la connexion revendiquée, `connected_merchant` apparaît dans la réponse avec le nom et l'adresse e-mail de l'entreprise du marchand. ## Ce que le lien ne permet pas Une connexion ne se revendique qu'une fois, et les contrôles ont lieu au moment de la revendication, pas à l'ouverture du lien par le marchand : - une connexion que vous avez annulée reste annulée, et le lien ne peut pas la réactiver. `POST /accounts/{id}/token`, lui, le peut : sur une invitation annulée que personne n'a revendiquée, il génère un nouveau lien et remet la connexion à `pending`, pour 30 jours de nouveau ; - une connexion déjà revendiquée par un autre marchand ne peut pas être reprise ; - une invitation expirée est refusée ; - en mode live, le marchand ne peut pas la revendiquer avant d'avoir déposé son dossier KYC. Le dépôt suffit pour se connecter ; c'est la vérification qui débloque les paiements (voir plus bas) ; - le lien peut porter un `redirect_uri`, mais seulement s'il partage son origine avec le `callback` enregistré sur la connexion. Tout autre hôte est refusé, et une connexion sans callback n'en accepte aucun. Un marchand qui valide deux fois arrive sur sa propre connexion terminée, et non sur une erreur. ## Retour sur votre page Avant d'envoyer le lien, vous pouvez y ajouter `&state=…` (une valeur à vous, par exemple un jeton aléatoire lié à la session du vendeur) et `&redirect_uri=…`. Une fois la connexion acceptée, le marchand est envoyé vers ce `redirect_uri`, ou vers le `callback` de la connexion si le lien n'en porte pas, avec ces paramètres de requête : | Paramètre | Ce qu'il porte | | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `account` | L'`id` de la connexion (`acc_…`), celui de chaque appel et de chaque événement `account.*` | | `state` | Le `state` que vous avez mis sur le lien d'autorisation, renvoyé tel quel. Comparez-le à celui que vous avez conservé, pour savoir que la visite répond à votre propre lien | | `status` | `connected` | ```text title="Le retour, pour un lien ouvert avec state=8f3a" https://example.com/connected?account=acc_7Yh2MpL4tRb3nP8sZcXv&state=8f3a&status=connected ``` Le `callback` doit être une adresse HTTPS : `POST` et `PUT /accounts` répondent `422` sinon, sauf `http://localhost` et `http://127.0.0.1` avec une clé sandbox. Ce retour sert le navigateur du marchand, ce n'est pas une preuve : n'importe qui peut ouvrir cette adresse. Confirmez la connexion avec `GET /accounts/{account}` ou attendez `account.connected` sur votre endpoint de webhook avant d'agir. ## Activer ensuite les paiements L'acceptation ne donne pas toujours l'autorisation de débiter. `payment_status` est fixé au moment où le marchand accepte. | Le marchand accepte | `payment_status` | | ------------------------------------- | ----------------------------------------------------------------------------------------- | | En sandbox | `active` immédiatement | | En live, vérification déjà validée | `active` immédiatement, à condition qu'une connexion `lite` ait aussi accès au rail Wajub | | En live, vérification encore en cours | `inactive` | Une connexion `inactive` passe seule à `active` lorsque la vérification du marchand est validée et, pour une connexion `lite`, une fois le rail Wajub accordé. Wajub envoie alors `account.payment_activated`. | `payment_status` | Effet sur les requêtes qui contiennent `X-Sync` | | ---------------- | ------------------------------------------------------------------------ | | `inactive` | Appels qui déplacent de l'argent refusés avec `403` ; lectures exécutées | | `active` | Tout ce que permettent les capacités s'exécute | | `suspended` | Appels qui déplacent de l'argent refusés avec `403` ; lectures exécutées | Ce qui est refusé tant que `payment_status` n'est pas `active` : créer, activer, modifier ou débiter un paiement, créer ou modifier un lien de paiement, un remboursement, un transfert ou un lot, ajouter, modifier ou vérifier un bénéficiaire ou enregistrer ce qu'un vendeur doit rendre, et accepter ou clore un litige. Ce qui fonctionne encore : tous les `GET`, pour suivre ce que fait la connexion pendant l'examen de la vérification du marchand, ainsi qu'annuler un paiement, supprimer un lien de paiement ou un bénéficiaire, et les recherches d'identité (`/identity/resolve`, `/identity/validate`). Vous pouvez ensuite utiliser la suspension. Définir `payment_status` sur `suspended` arrête en même temps les paiements entrants et les transferts sortants. Ce comportement est volontaire : une connexion figée après l'échec d'un nouveau contrôle de conformité ne doit pas pouvoir vider son solde alors qu'elle ne peut plus recevoir d'argent. L'interrupteur ne lève qu'une suspension que vous avez posée vous-même. Repasser `payment_status` à `active` répond `409` avec `error_code: merchant_not_verified` tant que la vérification du marchand est en cours ou a été refusée : ces connexions reviennent d'elles-mêmes une fois la vérification validée. ## Le portail du vendeur Lite Un vendeur `lite` n'a pas de dashboard marchand : c'est tout l'objet du mode. Accepter votre invitation lui ouvre un espace vendeur dédié à votre plateforme, distinct de tout autre compte Wajub qu'il possède déjà : une connexion `lite` ne se rattache jamais à une organisation existante. Son onboarding se termine sur la demande d'accès au rail Wajub, et il utilise ensuite un portail qui lui est propre, à vos couleurs. | Ce qu'il y fait | Comment | | --------------------------------- | ---------------------------------------------------------------------------------------------------- | | Se connecter | Un code à usage unique envoyé à l'adresse de la boutique | | Voir ses ventes et ses versements | Uniquement ceux de cette connexion : jamais son autre activité, jamais celle d'une autre plateforme | | Demander l'accès au rail Wajub | Étape hébergée de l'onboarding ; la connexion ne peut pas encaisser tant qu'elle n'est pas approuvée | | Déclarer où va son argent | La page des coordonnées de versement du portail | > [!WARNING] > **Une nouvelle destination de versement est mise en attente** > > Une destination que le vendeur vient de déclarer ou de modifier ne peut recevoir aucun versement > pendant un délai de carence ; le portail indique au vendeur à partir de quand elle peut être > payée. Un transfert vers une destination en attente est refusé jusqu'à la fin de ce délai. ### L'adresse du portail Vos vendeurs se connectent à une adresse à votre nom, que vous choisissez et que Wajub valide. | Adresse | Quand elle sert | | -------------------- | ---------------------------------------------------------------------------------------- | | `votrenom.wajub.app` | Dès que Wajub a validé le nom que vous avez demandé | | `lite.wajub.com` | Tant qu'aucun nom n'est validé, et pour un vendeur qui ne connaît que son adresse e-mail | Vous demandez le nom dans le dashboard, sous **Paramètres, Sync, Plateforme** : 3 à 40 lettres minuscules, chiffres ou tirets isolés, sans tiret au début ni à la fin. - **Wajub valide chaque nom avant que son adresse ne réponde.** Un nom refusé vous revient avec son motif, et vous pouvez en demander un autre. - **Certains noms sont réservés** : ceux qui passeraient pour une adresse de Wajub, pour une page de connexion ou de paiement, pour un opérateur ou pour une banque. - **Demander un autre nom coupe l'adresse en service** jusqu'à la validation du nouveau ; entre-temps vos vendeurs se connectent sur `lite.wajub.com`. Sur votre adresse, le portail porte votre logo et vos couleurs, et la mention « Paiements opérés par Wajub » reste en pied de page. Un vendeur présent sur plusieurs plateformes retrouve chacun de ses espaces depuis `lite.wajub.com` ; une session n'ouvre jamais qu'une plateforme à la fois. Le portail peut aussi répondre sur un domaine à vous, comme `vendeurs.maplateforme.com`, avec les e-mails de Wajub à vos vendeurs à votre marque : [Votre domaine et votre marque](https://docs.wajub.com/fr/sync/own-domain). ### Le portail dans vos propres pages Montrez à un vendeur Lite son espace à l'intérieur de votre produit. `POST /accounts/{id}/portal_sessions` renvoie `portal_session` : `{ url, expires_at }`, un lien à usage unique, valable 5 minutes, qui ouvre le portail du vendeur déjà connecté sur cette seule connexion, pour 30 minutes. | Règle | Pourquoi | | ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ | | Usage unique, durée courte | Le lien est une clé : ouvrez-le tout de suite, ne le stockez ni ne le partagez | | Cette connexion seulement | La session ne peut ni lister ni ouvrir les autres espaces du vendeur | | Lecture seule | Changer la destination de l'argent du vendeur demande sa propre connexion, avec son code e-mail | | Encadrable seulement par vos origines | Déclarez jusqu'à 5 origines `https` sous **Paramètres, Sync, Plateforme** ; le portail peut être mis dans une iframe sur elles, et nulle part ailleurs | La page de connexion elle-même n'est jamais encadrable : à la fin de la session, ouvrez un nouveau lien. L'onboarding hébergé reste une redirection, jamais une iframe, pour la vérification d'identité et la caméra. Pour ne montrer que certains morceaux de l'espace, ses ventes, ses versements, son solde, là où vous les voulez dans vos pages et à vos couleurs, utilisez plutôt les [composants embarqués](https://docs.wajub.com/fr/sync/embedded-components) : c'est la voie recommandée. ## Ce que le marchand doit accepter à nouveau Dès l'acceptation du marchand, deux des quatre champs modifiables cessent de dépendre de vous seul. | Champ | Après l'acceptation | | ---------------- | -------------------------------------------------------------------- | | `capabilities` | `202 Accepted` : proposé au marchand, renvoyé dans `pending_changes` | | `pricing` | `202 Accepted` : proposé au marchand, renvoyé dans `pending_changes` | | `callback` | Reste librement modifiable | | `payment_status` | Reste librement modifiable, et ne l'est qu'à partir de ce moment | Cette asymétrie est volontaire. Ce que le marchand a accepté sur l'écran d'autorisation ne peut pas être modifié à son insu : une connexion élargie ou une commission relevée devient une proposition qu'il accepte ou refuse depuis son dashboard, la connexion continuant entre-temps aux conditions en vigueur. La suspension, elle, reste la vôtre et ne se propose pas. De son côté, le marchand retrouve toutes les plateformes auxquelles il est connecté sous **Paramètres, Applications connectées** : les capacités accordées, la commission acceptée, l'état des paiements et toute proposition en attente. Accepter ou refuser une proposition depuis cette page vous envoie `account.change_accepted` ou `account.change_declined`. La même page lui permet de se déconnecter de votre plateforme, ce qui met fin à la connexion exactement comme votre propre `DELETE`. ## Mettre fin à une connexion `DELETE /accounts/{id}` révoque les jetons, définit `status` sur `cancelled` et émet `account.deauthorized`. Si le marchand avait accepté, `payment_status` passe également à `inactive` et la réponse contient `Account disconnected`. Pour une invitation non revendiquée, elle contient `Account cancelled`. ```bash title="Déconnecter un marchand" curl -X DELETE https://api.wajub.com/accounts/acc_7Yh2MpL4tRb3nP8sZcXv \ -H "Authorization: sk.xxxxxxxxxxxxxxxx…" ``` La déconnexion ne modifie rien de ce qui s'est déjà produit. Le marchand conserve son compte, ses paiements et son solde. Les commissions déjà acquises restent acquises. Seule votre capacité à agir en son nom prend fin. ## Les événements à écouter Le cycle de vie d'une connexion est décrit par les événements ci-dessous, sur les endpoints de votre plateforme. Créer une connexion envoie `account.created`, avec le compte mais sans son lien : `authorization_url` ne figure que dans la réponse à `POST /accounts`. Le [catalogue des événements](https://docs.wajub.com/fr/developer-tools/webhooks/events#accounts-for-sync-platforms) les décrit tous. | Événement | Moment de l'envoi | | ----------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `account.created` | Vous la créez avec `POST /accounts` | | `account.onboarding_started` | Le marchand ouvre le lien d'autorisation | | `account.onboarding_email_verified` | Il confirme son adresse e-mail | | `account.onboarding_account_selected` | Il choisit le compte Wajub à connecter | | `account.onboarding_kyc_submitted` | Il dépose son KYC pendant l'onboarding | | `account.onboarding_declined` | Il refuse la connexion ; le lien reste valable, et `reason` contient ses mots quand il en a donné | | `account.connected` | Il accepte la connexion | | `account.payment_activated` | La connexion obtient la capacité de débiter | | `account.payment_suspended` | Elle est suspendue, par vous ou après l'échec d'une vérification | | `account.change_requested` | Vous proposez de nouvelles capacités ou une nouvelle tarification | | `account.change_accepted` | Le marchand accepte une proposition | | `account.change_declined` | Le marchand refuse une proposition | | `account.updated` | Elle change : par `PUT /accounts/{id}` (ni une proposition seule, ni un appel qui ne change rien), quand `POST /accounts/{id}/token` remet une invitation annulée en `pending`, ou quand Wajub envoie le versement d'un marchand Lite (`last_payout_at`) | | `account.commission_receivable_recorded` | Une commission est due sur une vente encaissée hors de Wajub | | `account.commission_receivable_collected` | Cette commission est recouvrée | | `account.deauthorized` | La connexion est déconnectée ou annulée | > [!WARNING] > **Deux formats, deux signatures** > > Les événements qui suivent vos propres appels à l'API (`POST /accounts`, `PUT` et > `DELETE /accounts/{id}`, `POST /accounts/{id}/token`, versements Lite, demandes de modification, > commissions dues) portent l'enveloppe habituelle, `X-Wajub-Signature` et `X-Wajub-Timestamp`. Les > événements des étapes du marchand lui-même (`onboarding_*`, `connected`, `change_accepted`, > `change_declined`, les activations qui suivent une vérification, et une déconnexion faite dans le > Dashboard) portent un en-tête `X-Sync-Event` et un corps à plat avec `event`, `account` (l'id > `acc_…`), `sandbox`, `timestamp` et les champs propres à l'événement. Ils sont signés de la même > façon que les autres, dans `X-Sync-Signature-V1` et `X-Sync-Timestamp`, avec le secret de > signature de votre endpoint : passez ces deux en-têtes à `constructEvent` du SDK, qui vérifie la > signature et refuse un horodatage vieux de plus de 300 secondes. Conservez ensuite le > `X-Idempotency-Key` de chaque livraison traitée et ignorez celle que vous avez déjà vue. Ces > événements n'atteignent qu'un endpoint abonné à leur nom exact, pas un endpoint abonné à `*`, et > ne sont plus relivrés au-delà de deux minutes environ : si votre endpoint était indisponible, > relisez la connexion avec `GET /accounts/{id}`. De plus, chaque paiement, remboursement et transfert effectué sur un compte connecté, et chaque litige ouvert sur l'un de ses paiements, déclenche son webhook normal pour le marchand **et** une copie pour votre plateforme. Vous n'avez pas besoin d'interroger régulièrement une connexion pour connaître son activité. - [Sync](https://docs.wajub.com/fr/sync): La nature d'une connexion et ses limites. - [Démarrage rapide](https://docs.wajub.com/fr/sync/quickstart): Créer une connexion et y recevoir votre premier paiement. - [Capacités du compte](https://docs.wajub.com/fr/sync/account-types): Les sept capacités et le calcul de la commission. - [Catalogue des événements](https://docs.wajub.com/fr/developer-tools/webhooks/events): Tous les événements envoyés par Wajub et la vérification d'une signature. --- # Votre domaine et votre marque URL: https://docs.wajub.com/fr/sync/own-domain > Servez le portail de vos vendeurs sur un domaine à vous, et envoyez-leur les e-mails de Wajub à votre marque. Vos vendeurs doivent voir votre plateforme, pas la nôtre. Leur portail peut répondre sur un domaine à vous, `vendeurs.maplateforme.com`, au lieu de `votrenom.wajub.app`, et les e-mails que Wajub leur envoie portent votre nom, votre logo et votre couleur. ## Votre propre domaine | Règle | | | ---------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Un domaine par plateforme | Un **sous-domaine** seulement, jamais la racine d'une zone : une racine ne peut pas porter de `CNAME` | | Test et live à la fois | Le domaine n'est pas lié à un environnement : il sert le portail dans les deux. Une clé de test le lit ; le déclarer et le retirer demandent une **clé live** (sinon `403 live_key_required`) | | Tout le suit | Une fois actif, le portail, les [composants embarqués](https://docs.wajub.com/fr/sync/embedded-components) et tous les liens que Wajub envoie à vos vendeurs l'utilisent | | L'ancienne adresse marche toujours | `votrenom.wajub.app` répond encore : un lien déjà envoyé s'ouvre toujours | ### Le mettre en place 1. **Déclarez le domaine** Sous **Paramètres, Sync, Plateforme**, dans **Votre propre domaine**, ou avec `PUT /sync/portal_domain`. 2. **Créez deux enregistrements DNS** Chez votre fournisseur DNS, les deux enregistrements que la réponse liste (ci-dessous). 3. **Attendez la vérification** Wajub les vérifie toutes les 10 minutes pendant 72 heures ; **Vérifier maintenant** dans le Dashboard le fait tout de suite. Quand les deux sont bons, Wajub route le domaine et obtient son certificat TLS : le statut passe `active`. ```bash title="Déclarer le domaine" curl -X PUT https://api.wajub.com/sync/portal_domain \ -H "Authorization: sk.xxxxxxxxxxxxxxxx…" \ -H "Content-Type: application/json" \ -d '{"domain":"vendeurs.maplateforme.com"}' ``` | Type | Nom | Valeur | | ------- | ----------------------------------------- | ---------------------------------------- | | `CNAME` | `vendeurs.maplateforme.com` | `portals.wajub.app` | | `TXT` | `_wajub-verify.vendeurs.maplateforme.com` | Le jeton de la réponse, `wajub-portal-…` | Gardez les deux enregistrements tant que vous utilisez le domaine. Une fois actif, Wajub les revérifie **chaque jour** : un échec isolé ne coupe rien et affiche un avertissement sous **Paramètres, Sync, Plateforme**, pas plus qu'une vérification dont la lecture DNS n'obtient aucune réponse, sauf si cela dure : quand les résolveurs de Wajub n'obtiennent aucune réponse de votre zone pendant **plus de 72 heures d'affilée**, le domaine est retiré comme après trois échecs. Après **trois échecs d'affilée**, environ 72 heures, le domaine passe `failed`, le portail cesse d'y répondre, tous les liens reviennent à `votrenom.wajub.app`, et le propriétaire et les administrateurs de votre organisation reçoivent un e-mail. Corrigez les enregistrements, puis déclarez de nouveau le domaine : le jeton ne change pas. Wajub ne reprend jamais un hôte déjà routé ailleurs sur Wajub, le domaine de paiement d'un marchand par exemple : la vérification reste alors `verifying` avec `routing_failed`. > [!WARNING] > **Trois pièges** > > Si votre DNS passe par un proxy (un nuage orange, par exemple), mettez le `CNAME` en **DNS seul** : > un enregistrement proxifié cache le `CNAME` (`cname_missing`) et empêche le certificat. Certains > panneaux DNS ajoutent votre domaine au nom tout seuls : saisissez-y `vendeurs` et > `_wajub-verify.vendeurs`. Les guillemets autour de la valeur `TXT` sont acceptés. ### Les statuts | `status` | Signifie | | ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `pending_dns` | Déclaré ; les enregistrements ne sont pas encore bons. `last_error` dit pourquoi | | `verifying` | Les enregistrements sont bons ; Wajub route le domaine et obtient son certificat, en quelques minutes | | `active` | Servi. Tous les liens du portail l'utilisent | | `failed` | Pas vérifié en 72 heures ; ou actif, puis en échec à trois vérifications quotidiennes d'affilée, ou sans réponse de votre zone pendant plus de 72 heures d'affilée. Déclarez-le de nouveau pour relancer 72 heures, **avec le même jeton** : l'enregistrement `TXT` déjà posé reste bon | | `removed` | Retiré par vous | | `blocked` | Bloqué par Wajub, qui dit pourquoi dans `removal_reason` : un domaine en service, retiré, en échec, ou jamais déclaré. Aucune plateforme ne peut le déclarer tant que Wajub n'a pas levé le blocage ; il passe alors `removed` | | `last_error` | Signifie | | -------------------- | ----------------------------------------------------------------------------------------------------------- | | `cname_missing` | Aucun `CNAME` sur le domaine, ou un `CNAME` proxifié | | `cname_wrong_target` | Le `CNAME` pointe ailleurs que sur `portals.wajub.app` | | `txt_missing` | Aucun enregistrement `TXT` sur `_wajub-verify.Vous finirez sur la page de paiement sécurisée de Wajub.
} @else if (method() === 'card') {Validez le paiement sur votre téléphone.
} `, }) export class PaymentStepComponent { // L'authorization_token et l'authorization_url du paiement préparé, transmis par votre serveur. @Input({ required: true }) sessionId!: string; @Input({ required: true }) hostedUrl!: string; readonly method = signal<'mobileMoney' | 'card'>('mobileMoney'); readonly complete = signal(false); readonly step = signal('INITIATED'); readonly fallback = signal(false); private readonly payment = injectConfirmPayment(() => this.sessionId); readonly locked = computed(() => this.payment.isConfirming() || RUNNING.includes(this.step())); private component: ComponentInstance | null = null; // Votre serveur vérifie le panier, passe la commande et active le paiement. // Une fonction fléchée, pour que this soit votre composant quand le champ l'appelle. readonly placeOrder = async (): Promise