Un checkout di tre venditori, commissione del 4% e regola pagamenti verificata.
1. Prepara il progetto
Apri Progetto → Marketplace → Impostazioni. Attiva e seleziona i negozi. Lascia i pagamenti in pausa. Salva i wallet e abilita Bitcoin o metodi EVM supportati in ogni negozio.
I clienti pagano prima questi wallet. Controlli le chiavi e devi ai venditori i saldi registrati. Tieni monete native libere separate per i costi. Gli sweep normali non possono spendere gli indirizzi Marketplace.
2. Aggiungi e approva tre venditori
In Venditori aggiungi ogni venditore e indirizzo Bitcoin mainnet. Confermalo direttamente tramite un canale indipendente prima di approvarlo. Per token EVM serve anche un indirizzo approvato su quella rete esatta.
Imposta la commissione progetto al 4%. Le personalizzazioni di negozio, venditore e fattura autorizzata sono salvate: le modifiche successive non cambiano le quote esistenti.
3. Crea la fattura condivisa
In Marketplace → Fatture crea 300 USD con tre quote lorde da 100 USD. La somma deve essere esatta. Invia il link al cliente.
Per l’API usa una chiave Marketplace separata e invia stringhe decimali a /v1/marketplace/invoices. Salva la chiave di idempotenza prima della richiesta e riusala dopo un timeout. Esempi di richieste →
4. Controlla e invia
Attendi quote verificate disponibili. Al cambio fissato ogni venditore riceve 96 USD equivalenti e trattieni 12 USD di commissione. Se il costo di elaborazione è 1%, usa 3 USD di credito prepagato. I costi di rete sono separati.
In Pagamenti prepara quote disponibili e limita costi nativi e gas. Bitcoin richiede tutte le quote non pagate della fattura nello stesso lotto. Controlla destinatari e piano esatti, approva una volta e segui fino a Paid, non solo Broadcast.
5. Attiva l’automazione con attenzione
In Impostazioni aggiungi regola per asset: minimo, limiti per pagamento e giorno, budget nativi e gas, intervallo e conferme. Attivala solo dopo aver verificato limiti e indirizzi, poi riprendi i pagamenti.
Le regole automatiche inviano senza altri clic. Credito basso o blocco trasferimenti sospendono la spesa, ma monitoraggio e registro continuano.
6. Gestisci eccezioni senza invii duplicati
- Pagamento insufficiente: la tolleranza non crea saldi senza fondi. Attendi altro pagamento, rimborsa o approva esplicitamente una quota minore coperta.
- Gas mancante: aggiungi monete native libere al wallet e verifica il pagamento salvato. Non crearne un altro per aggirarlo.
- Timeout webhook: ripeti lo stesso evento firmato. Verifica firma originale e progetto, salva event_id unico e conferma. Fattura saldata non significa pagamento venditore completato.
- Rimborso dopo i venditori: finanzia separatamente l’indirizzo principale, verifica quello del cliente, prepara rimborso completo nello stesso asset e approva. Nessun addebito automatico ai venditori.
- Ripristino o trasmissione incerta: lascia i pagamenti in pausa e riconcilia gli hash conservati prima di riprendere. Un timeout non prova che nulla sia partito.