Płatność dla trzech sprzedających z prowizją 4% i sprawdzoną polityką wypłat.
1. Przygotuj projekt
Otwórz Projekt → Marketplace → Ustawienia. Włącz Marketplace i wybierz uczestniczące sklepy. Na razie pozostaw wypłaty wstrzymane. Zrób kopie portfeli projektu i włącz Bitcoin lub obsługiwane metody EVM w każdym sklepie.
Klienci najpierw płacą do tych portfeli projektu. Kontrolujesz klucze i jesteś winien sprzedającym zapisane salda. Zachowaj osobne wolne natywne monety na opłaty. Zwykłe operacje sweep nie mogą wydawać z adresów odbiorczych Marketplace.
2. Dodaj i zatwierdź trzech sprzedających
W sekcji Sprzedający dodaj każdego sprzedawcę i adres sieci głównej Bitcoin. Niezależnie potwierdź adres ze sprzedawcą przed zatwierdzeniem. Dla tokenów EVM każdy sprzedawca potrzebuje także zatwierdzonego adresu dokładnie w tej sieci.
Ustaw prowizję projektu na 4%. Nadpisania sklepu, sprzedającego i autoryzowane nadpisania faktury są utrwalane w migawce, więc późniejsze zmiany nie zmieniają istniejącego przydziału.
3. Utwórz wspólną fakturę
W Marketplace → Faktury utwórz fakturę na 300 USD z trzema udziałami brutto sprzedających po 100 USD. Ich suma musi dokładnie się zgadzać. Wyślij klientowi link do płatności.
Do integracji API użyj osobnego klucza Marketplace i wyślij ciągi dziesiętne do /v1/marketplace/invoices. Zapisz klucz idempotencji przed żądaniem i użyj go ponownie po przekroczeniu czasu. Przykłady żądań →
4. Sprawdź i wyślij
Poczekaj, aż zweryfikowane przydziały staną się dostępne. Według zablokowanej wyceny każdy sprzedający otrzymuje równowartość 96 USD w opłaconym aktywie, a Ty zachowujesz równowartość 12 USD prowizji. Istniejąca opłata za przetwarzanie 1%, jeśli skonfigurowana, kosztuje 3 USD środków przedpłaconych. Opłaty blockchain są osobne.
W Wypłatach przygotuj dostępne przydziały i ogranicz natywne opłaty oraz gas. Bitcoin wymaga każdego niewypłaconego udziału wybranej faktury w tej samej partii. Sprawdź dokładnych odbiorców i plan, a następnie zatwierdź raz. Śledź do stanu Wypłacono, nie tylko Nadano.
5. Ostrożnie włącz automatyzację
W Ustawieniach dodaj politykę dla jednego aktywa: minimum wypłaty, limity kwoty głównej na wypłatę i dziennie, budżety natywnych opłat i gasu, interwał i potwierdzenia. Włącz dopiero po sprawdzeniu tych limitów i adresów docelowych, a następnie wznów wypłaty.
Automatyczne polityki mogą wysyłać bez kolejnych kliknięć. Niskie saldo lub blokada przelewów serwera nadal wstrzymują wydawanie. Monitorowanie i rejestr działają dalej.
6. Obsługuj wyjątki bez podwójnych wysyłek
- Niedopłata: tolerancja strony płatności nie tworzy sald sprzedających bez pokrycia. Poczekaj na dopłatę, zwróć środki lub jawnie zatwierdź mniejszy podział z pełnym pokryciem.
- Brak gasu tokena: dodaj wolne natywne monety do portfela projektu i sprawdź zachowaną wypłatę. Nie twórz drugiej wypłaty, aby ją ominąć.
- Przekroczenie czasu webhooka: ponów to samo podpisane zdarzenie. Zweryfikuj podpis surowej treści i projekt, zapisz event_id jako unikalny, a następnie potwierdź. Zdarzenie rozliczenia faktury nie oznacza zakończenia wypłaty.
- Zwrot po wypłaceniu sprzedającym: osobno zasil główny portfel, zweryfikuj adres klienta, przygotuj pełny zwrot w tym samym aktywie i zatwierdź. Sprzedający nie są automatycznie obciążani.
- Odtworzenie lub niepewne nadanie: pozostaw wypłaty wstrzymane i uzgodnij zachowane hashe transakcji przed wznowieniem. Nigdy nie zakładaj, że przekroczenie czasu oznacza brak wysyłki.
Zbuduj wspólny koszyk: poradnik platformy handlowej krypto →