Vue d'ensemble du flux de travail marchand

Ce guide résume le parcours d'une offre Revclic, depuis sa publication jusqu'à la facturation d'une conversion.

1. Configurer le marchand

Créez le profil marchand, associez ses catégories et ajoutez au moins un domaine. Le domaine doit être vérifié avant une intégration en production. La requête myMerchants permet de retrouver les identifiants accessibles au compte connecté.

2. Publier les produits

Une offre est créée avec la mutation createProduct. Elle contient au minimum un nom traduit et un prix ; vous pouvez aussi fournir l'URL, les images, les marchés ciblés, les catégories et le mode de tarification.

3. Recevoir une redirection

Lorsqu'un acheteur quitte Revclic pour le site marchand, l'URL contient un identifiant revclic_rid. Conservez-le dans la session ou le panier jusqu'à la commande. Cet identifiant permet d'attribuer correctement la transaction.

4. Signaler la transaction

Appelez la mutation createTransaction avec l'identifiant du marchand et un CreateTransactionInput. Chaque article doit fournir son GTIN, son prix, sa quantité et son taux de commission. redirectId est facultatif lorsqu'aucune redirection Revclic n'est disponible.

La transaction renvoyée par l'API possède son propre identifiant : stockez-le pour les mises à jour ultérieures.

5. Valider ou rejeter les articles

Utilisez updateTransaction avec l'identifiant de transaction et la liste des articles à modifier. Chaque élément de UpdateBasketItemInput contient l'identifiant de l'article et son nouveau statut.

Les articles encore en attente à la fin du délai de validation peuvent être traités automatiquement selon les règles de la plateforme. Envoyez donc les annulations et retours sans attendre.

6. Consulter les résultats

• merchantTransactions liste les transactions et accepte des filtres de dates.
• merchantTransaction affiche une transaction précise.
• transactionStats fournit les indicateurs agrégés.
• merchantInvoices liste les factures du marchand.

7. Facturation

Les articles validés alimentent la prochaine facture. Une facture est généralement générée le premier jour du mois suivant et dispose d'une échéance de paiement. Consultez le guide Fonctionnement de la facturation pour le détail.

Pour les payloads complets, utilisez les pages createTransaction, updateTransaction et merchantTransactions de la référence GraphQL.