Un checkout de trois vendeurs, 4% de commission et une règle de versement vérifiée.
1. Prépare le projet
Ouvre Projet → Marketplace → Paramètres, active et sélectionne les boutiques. Laisse les versements en pause. Sauvegarde les wallets et active Bitcoin ou les méthodes EVM compatibles dans chaque boutique.
Les clients paient d’abord ces wallets. Tu contrôles les clés et dois les soldes enregistrés aux vendeurs. Garde des monnaies natives libres pour les frais. Les sweeps classiques ne dépensent pas les adresses Marketplace.
2. Ajoute et valide trois vendeurs
Dans Vendeurs, ajoute chacun et une adresse Bitcoin mainnet. Confirme-la avec lui par un autre canal avant validation. Pour les tokens EVM, chacun doit aussi avoir une adresse validée sur le réseau exact.
Fixe la commission du projet à 4%. Les réglages boutique, vendeur et facture autorisée sont figés ; les changements suivants ne modifient pas les parts existantes.
3. Crée la facture partagée
Dans Marketplace → Factures, crée 300 USD avec trois parts brutes de 100 USD. La somme doit correspondre exactement. Envoie le lien au client.
Pour l’API, utilise une clé Marketplace séparée et envoie des chaînes décimales à /v1/marketplace/invoices. Garde la clé d’idempotence avant la requête et réutilise-la après un délai dépassé. Exemples de requêtes →
4. Vérifie et envoie
Attends les parts vérifiées disponibles. Au cours fixé, chaque vendeur reçoit 96 USD équivalents et tu gardes 12 USD de commission. Si les frais de traitement sont à 1%, ils utilisent 3 USD de crédit prépayé. Les frais réseau sont séparés.
Dans Versements prépare les parts et plafonne frais natifs et gas. Bitcoin exige toutes les parts impayées d’une facture dans le même lot. Vérifie destinataires et plan exacts, approuve une fois et suis jusqu’à Paid, pas seulement Broadcast.
5. Active l’automatisation avec soin
Dans Paramètres ajoute une règle par actif : minimum, plafonds par versement et jour, budgets natifs et gas, intervalle et confirmations. Active après vérification des limites et adresses, puis reprends les versements.
Les règles automatiques peuvent envoyer sans autre clic. Crédit bas ou blocage serveur suspendent la dépense, mais suivi et registre continuent.
6. Gère les exceptions sans double envoi
- Sous-paiement : la tolérance ne crée pas de soldes sans fonds. Attends un complément, rembourse ou approuve explicitement une part réduite couverte.
- Gas manquant : ajoute des monnaies natives libres et vérifie le versement conservé. N’en crée pas un second pour contourner le problème.
- Délai webhook dépassé : renvoie le même événement signé. Vérifie signature brute et projet, sauvegarde event_id unique, puis confirme. Facture réglée ne veut pas dire versement terminé.
- Remboursement après versements : approvisionne l’adresse principale à part, vérifie l’adresse client, prépare le remboursement intégral dans le même actif et approuve. Aucun débit automatique des vendeurs.
- Restauration ou diffusion incertaine : garde les versements en pause et rapproche les hash conservés avant reprise. Un délai dépassé ne prouve pas qu’aucun envoi n’a eu lieu.