Aller au contenu principal

Sous-marchands

Acceptez des paiements pour le compte de plusieurs marchands avec une seule intégration Volet.com.

La prise en charge des sous-marchands permet aux plateformes de créer leurs propres produits de paiement sur Volet.com. Au lieu d’inscrire chaque marchand directement chez Volet.com, la plateforme s’intègre une seule fois et traite les paiements pour le compte de ses propres marchands.

Les clients continuent de payer via votre plateforme ou vos sous-marchands, tandis que votre plateforme reste le point d’intégration unique avec Volet.com.

Chaque paiement peut être associé à un sous-marchand précis, ce qui permet à la plateforme d’identifier le paiement, de suivre les commandes et de gérer le règlement selon sa propre logique métier.

Cas d’usage typiques :

  • Prestataires de paiement en marque blanche
  • Agrégateurs de marchands
  • Marketplaces
  • Plateformes pour créateurs
  • Plateformes SaaS servant plusieurs marchands

Fonctionnement​

Une plateforme s’intègre une seule fois à Volet.com et accepte des paiements pour le compte de plusieurs sous-marchands.

Le parcours de paiement général :

  1. Votre plateforme crée une demande de paiement pour le compte d’un sous-marchand.
  2. Votre plateforme inclut les informations du sous-marchand dans la demande de paiement.
  3. Le client effectue le paiement via Hosted Checkout, votre propre interface de paiement basée sur l’API ou un flux par smart contract.
  4. Les fonds sont reçus selon le modèle de paiement choisi.
  5. Votre plateforme rapproche le paiement effectué de la commande du sous-marchand correspondant.
  6. Votre plateforme règle les fonds au sous-marchand selon ses propres conditions commerciales.

Modèles d’intégration​

La prise en charge des sous-marchands est disponible avec différents modèles d’intégration.

Hosted Checkout​

Hosted Checkout offre une expérience de paiement prête à l’emploi tout en permettant à votre plateforme d’associer chaque paiement à un sous-marchand précis.

Lors de la création d’une demande de paiement Hosted Checkout, vous pouvez transmettre le site du sous-marchand dans le paramètre ac_submerchant_url.

Exemple :

<input type="hidden" name="ac_submerchant_url" value="https://seller.example.com">

Vous pouvez aussi inclure des champs personnalisés, par exemple :

  • Identifiant du sous-marchand
  • Identifiant du vendeur
  • Identifiant de commande de la marketplace
  • Numéro de facture interne
  • Identifiant du client

Ces valeurs sont renvoyées telles quelles dans les notifications de statut et les redirections du client, ce qui permet à votre plateforme d’associer les paiements effectués au bon sous-marchand et à la bonne commande.

Consultez Intégration de Hosted Checkout pour plus de détails.

API avec Hosted Checkout​

L’API et Hosted Checkout peuvent être combinés dans un même parcours de paiement.

L’API crée la facture de paiement, tandis que Hosted Checkout fournit l’interface de paiement côté client.

Dans ce modèle, votre plateforme crée une facture crypto via l’API et l’associe à une commande du sous-marchand avant de rediriger le client vers Hosted Checkout.

Contrairement au parcours Hosted Checkout standard, la facture de paiement est créée par votre plateforme et non par Hosted Checkout. Hosted Checkout se contente d’afficher la page de paiement de la facture existante et de gérer l’expérience de paiement du client.

Cette approche permet à votre plateforme :

  • D’associer le paiement à un sous-marchand avant que le client ne commence à payer.
  • De conserver sa propre logique de gestion des commandes et des factures.
  • D’éviter de créer et de maintenir une interface de paiement, pour elle-même comme pour ses sous-marchands.
  • De laisser Volet.com gérer les instructions de paiement, les QR codes, la surveillance de la blockchain et les mises à jour de statut.

Sans Hosted Checkout, le même parcours peut être entièrement mis en œuvre via l’API. Dans ce cas, votre plateforme ou chaque sous-marchand doit fournir sa propre interface de paiement aux clients.

Une fois le paiement effectué, votre plateforme reçoit ou vérifie son statut et le rapproche du sous-marchand correspondant grâce à la référence de facture ou de commande.

Voir :

Paiements par smart contract​

Les plateformes peuvent aussi prendre en charge des sous-marchands avec des paiements non dépositaires par smart contract.

Dans ce modèle, les clients paient directement depuis leur portefeuille et le paiement est exécuté on-chain par un smart contract.

Contrairement aux flux dépositaires, la logique de règlement peut être implémentée directement dans le smart contract. Par exemple, chaque paiement peut être réparti automatiquement entre la plateforme et un ou plusieurs sous-marchands au moment de son exécution.

Cas d’usage typiques :

  • Partage des revenus
  • Répartition des commissions de marketplace
  • Paiements à plusieurs destinataires
  • Règlement direct de portefeuille à portefeuille
  • Logique de paiement sur mesure

Consultez Partage des revenus pour plus de détails.

Suivi des paiements des sous-marchands​

Associez chaque paiement à vos propres identifiants afin de pouvoir le rapprocher du sous-marchand et de la commande correspondants.

Identifiants courants :

  • Identifiant du sous-marchand
  • Site du sous-marchand
  • Identifiant de commande de la marketplace
  • Identifiant de facture interne
  • Identifiant du client
  • Identifiant du lot de règlement

Avec Hosted Checkout, vous pouvez utiliser le paramètre ac_submerchant_url et des champs personnalisés.

Pour les flux de factures crypto via l’API, enregistrez l’identifiant de la facture crypto avec la commande de votre plateforme et la fiche du sous-marchand.

Pour les flux par smart contract, votre application peut utiliser les métadonnées de transaction, les références de commande ou les événements on-chain, selon l’architecture de smart contract retenue.

Règlement aux sous-marchands​

Avec les flux de paiement dépositaires, les fonds reçus sont crédités sur le compte Volet.com du marchand principal.

Une fois le paiement effectué, le marchand principal est responsable du règlement au sous-marchand selon son propre modèle commercial.

Vous pouvez régler les sous-marchands de l’une des façons suivantes :

  • Transférer des cryptomonnaies vers un portefeuille crypto.
  • Transférer des fonds vers le compte Volet.com du sous-marchand.
  • Envoyer manuellement un virement bancaire depuis l’interface du compte, lorsque c’est possible.
remarque

Les virements bancaires aux sous-marchands ne sont pas disponibles via l’API pour le moment. Si un règlement par virement bancaire est nécessaire, il doit être effectué manuellement depuis l’interface du compte.

Votre plateforme peut aussi prélever sa propre commission avant de régler le montant restant au sous-marchand.

Par exemple :

  1. Le client paie 100 USDT.
  2. Votre plateforme reçoit le paiement.
  3. Votre plateforme conserve une commission de 10 USDT.
  4. Votre plateforme règle 90 USDT au sous-marchand.

Conformité et examen​

Le traitement pour les sous-marchands est soumis à examen.

Votre plateforme doit savoir qui sont ses sous-marchands, quels biens ou services ils proposent et si leur activité est autorisée par les politiques de Volet.com.

remarque

Toutes les exigences de conformité, d’activités interdites et de vérification applicables aux marchands s’appliquent également aux sous-marchands.

Volet.com peut demander des informations sur votre modèle de sous-marchands, votre processus d’inscription, les catégories d’activité, les sites web, les flux de transactions et la logique de règlement avant d’activer ou d’approuver l’intégration.

Comment l’activer​

Étape 1. Contactez-nous​

Le traitement pour les sous-marchands est configuré au cas par cas. Planifiez un appel avec notre équipe commerciale.

Contactez notre équipe et décrivez :

  • Le modèle de votre plateforme
  • Les types de sous-marchands que vous servez
  • Les moyens de paiement prévus
  • Le flux de règlement prévu

Notre équipe vous aidera à choisir le modèle adapté :

  • Hosted Checkout, pour une expérience de paiement prête à l’emploi.
  • API avec Hosted Checkout, pour des factures crypto créées à l’avance et l’interface de paiement Hosted Checkout.
  • Intégration API seule, si votre plateforme fournit sa propre interface de paiement.
  • Smart contracts, pour les flux non dépositaires et une logique de règlement on-chain sur mesure.

Étape 2. Configurez l’acceptation des paiements​

Si vous utilisez Hosted Checkout, l’API ou l’API avec Hosted Checkout, créez et configurez une passerelle de paiement dans votre compte Volet.com.

La passerelle définit comment les paiements sont acceptés, quels moyens de paiement sont activés et comment les informations de statut sont traitées.

Voir :

Si vous utilisez un flux de paiement par smart contract, notre équipe vous fournira la configuration de smart contract nécessaire.

Étape 3. Mettez en œuvre l’intégration​

Mettez en œuvre le parcours de paiement correspondant au modèle d’intégration choisi.

Pour les détails de mise en œuvre, voir :

Étape 4. Configurez les données des sous-marchands et le rapprochement des commandes​

Définissez comment votre plateforme transmettra, stockera et rapprochera les informations des sous-marchands.

Étape 5. Testez les flux de paiement et de règlement​

Avant de passer en production, testez :

  • La création des paiements
  • L’identification des sous-marchands
  • Le traitement des statuts de paiement
  • Le rapprochement des commandes
  • Le calcul des commissions
  • Le règlement aux sous-marchands
  • Les scénarios de paiements échoués et annulés

Étape 6. Passez en production​

Une fois l’intégration approuvée, configurée et testée, votre plateforme peut commencer à accepter des paiements pour le compte de ses sous-marchands.

Limites​

  • Votre plateforme est responsable du règlement au sous-marchand.
  • Le règlement par virement bancaire aux sous-marchands n’est pas disponible via l’API.
  • Certains modèles d’activité de sous-marchands peuvent nécessiter un examen de conformité supplémentaire avant l’activation.