Poniższy artykuł przedstawi przegląd tego, co jest wymagane do zbudowania bramki płatności, która jest kompatybilna z WC Vendors i będzie obsługiwać wypłaty prowizji dla sprzedawców. Istnieją wymagania, które Twoja platforma płatnicza musi spełnić, aby stworzyć kompatybilną integrację. Gdy będziesz zadowolony, że Twoja platforma ma wymagane funkcje, istnieją dwie części budowania bramki kompatybilnej z WC Vendors.
- Wymagania platformy
- Płatności klientów
- Wypłaty dla sprzedawców
Możliwe jest stworzenie integracji tylko do wypłat, jednak nie będzie ona omawiana.
Wymagania platformy
Aby zaimplementować bramkę płatności, która jest kompatybilna z WC Vendors w zakresie płatności i wypłat, Twoja platforma musi być w stanie obsługiwać następujące funkcje:
- Przetwarzanie płatności (w tym zwroty i spory)
- Podział płatności lub zarządzanie wypłatami
Inne funkcje, które nie są wymagane, ale są przydatne, obejmują
- Onboarding sprzedawców
- KYC
- Raporty
- Zarządzanie podatkami
- Jasna dokumentacja dla wsparcia marketplace
Płatności Klientów
Podczas tworzenia bramki, pierwszym krokiem będzie upewnienie się, że zbudowałeś w pełni kompatybilną bramkę płatności WooCommerce. Zapewni to prawidłowe pobieranie płatności od klientów. Ponieważ jest to już szczegółowo omówione w oficjalnej dokumentacji WooCommerce, zalecamy jej przeczytanie.
Pamiętaj, aby zapoznać się z dokumentem dla deweloperów dostępnym w WooCommerce dla tej sekcji.
Wypłaty dla sprzedawców
Wypłaty dla sprzedawców zależą od rodzajów wypłat, które obsługujesz. Wszystkie te aspekty dotyczące tego, jak i kiedy płacić sprzedawcom, są określone przez Twoje API płatnicze. Dwa powszechne scenariusze wypłat dla sprzedawców:
- Podzielona płatność
- Zaplanowana wypłata
W zależności od Twojej platformy, wybierzesz jedną lub obie te opcje dla integracji. Aby zrozumieć, jak obsługiwać wypłaty dla sprzedawców, powinieneś zacząć od zrozumienia, jak działa nasz wewnętrzny system prowizji.
Wewnętrzne mechanizmy prowizji
System prowizji WC Vendors jest obecnie oparty na produktach. Oznacza to, że każda prowizja dla produktu w zamówieniu będzie obliczana i rejestrowana osobno. Może to obejmować koszty wysyłki i podatki.
Prowizje WC Vendors są rejestrowane tylko wtedy, gdy płatność została przetworzona. Po przetworzeniu płatności WC Vendors zarejestruje prowizję w tabeli prowizji. Aby prowizja została zarejestrowana, zamówienie WooCommerce musi mieć jeden z dwóch następujących statusów:
- Przetwarzanie
- Zakończone
Jeśli bramka płatności nie jest kompatybilna z WC Vendors, status prowizji jest ustawiany na 'do zapłaty'. Jeśli bramka jest kompatybilna z WC Vendors, a wypłata do sprzedawcy jest również zakończona, prowizja jest ustawiana na 'zapłacona'.
Schemat tabeli prowizji
Tabela prowizji to miejsce, w którym rejestrowane są wszystkie prowizje sprzedawców. Zarobki marketplace nie są obecnie rejestrowane w tej tabeli.
| Nazwa kolumny | Opis |
|---|---|
| id | Unikalne wewnętrzne identyfikatory prowizji |
| product_id | Identyfikator produktu dla prowizji |
| order_id | Identyfikator zamówienia dla prowizji |
| vendor_id | Ilość produktu |
| total_due | Jest to całkowita prowizja za produkt, nie obejmuje podatku ani wysyłki |
| qty | Całkowity koszt wysyłki produktu, musi być dostarczony przez kompatybilną wtyczkę wysyłkową |
| total_shipping | Podatek od produktu, musi być dostarczony przez kompatybilne rozwiązanie podatkowe |
| tax | Podatek od produktu, musi być dostarczony przez kompatybilne rozwiązanie podatkowe |
| status | Status prowizji (Zapłacona, Należna, Anulowana, Zwrócona) |
| time | Data i czas zalogowania prowizji |
Klasy WC Vendors
Podczas tworzenia integracji będziesz musiał uzyskać dostęp do tabeli prowizji i pobrać odpowiednie informacje o sprzedawcach, produktach i zamówieniach. Poniższe klasy są najczęściej używanymi klasami w bramkach płatności, które obsługują WC Vendors.
| Nazwa klasy | Opis |
|---|---|
| WCV_Commission | Ta klasa obsługuje wszystkie interakcje z powyższą tabelą prowizji. Metody, których powinieneś używać w swojej bramce: WCV_Commission::set_vendor_product_commission_paid(); aby zalogować, kiedy prowizja została zapłacona. |
| WCV_Vendors | Ta klasa obsługuje metody związane ze sprzedawcami i ich produktami. Metody, które będą używane w Twojej bramce płatności, obejmują: WCV_Vendors::is_vendor( $user_id ); Określ, czy podany identyfikator użytkownika jest sprzedawcą, czy nie. WCV_Vendors::get_vendor_dues_from_order( $order ); pobierz należne prowizje sprzedawcy z zamówienia. |
Podzielone płatności
Jeśli Twoja platforma obsługuje podział płatności w punkcie sprzedaży, będziesz wdrażać podział podczas przetwarzania płatności. Będzie to wymagało obliczenia prowizji przed przetworzeniem płatności.
Podział płatności pomiędzy sprzedawcami a platformą jest wyjaśniony w pseudokodzie w następujący sposób:
- Pobierz płatność od klienta
- Pobierz zamówienie
- Pobierz należności sprzedawcy z zamówienia
- Iteruj po należnościach sprzedawcy
- Podziel należności pomiędzy każdego sprzedawcę a platformę
- Wygeneruj płatność do wysłania na platformę
- Jeśli się powiedzie, ustaw status prowizji na „zapłacony”, w przeciwnym razie wystąpi błąd i prowizja pozostanie „do zapłaty”
Poniższy kod może służyć jako przewodnik do integracji bramki płatności. Nie jest kompletny ani przeznaczony do użytku produkcyjnego. Jest to tylko przewodnik po kodzie powyższego pseudokodu.
Wypłaty
Główna różnica między wypłatą a podziałem płatności polega na tym, że prowizja została już obliczona i zarejestrowana. Oznacza to, że będziesz musiał tylko odpytać tabelę prowizji, a następnie zaktualizować ją w razie potrzeby.
Wypłaty dla sprzedawców, obsługiwane przez większość platform płatności, są zarządzane za pomocą harmonogramu. Harmonogram ten może znajdować się po stronie WordPressa lub platformy płatności. Jeśli zarządzasz harmonogramem na platformie, a ona się tym zajmuje, będziesz musiał tylko wysłać należności sprzedawcy na platformę.
Sposób tworzenia interfejsu wypłat w ramach WordPressa i WC Vendors zależy od Ciebie jako dewelopera i platformy. Sugerujemy utworzenie ustawień dla następujących opcji:
- Harmonogram (dzienny, tygodniowy, miesięczny)
- Minimalne kwoty wypłat
- Minimalna liczba dni przed przetworzeniem wypłaty (może to pomóc w przypadku zwrotów lub sporów).
Wypłata dla sprzedawcy jest wyjaśniona w poniższym pseudokodzie
- Pobierz sprzedawcę(ów) do wypłaty
- Odpytaj tabelę prowizji o wszystkie należne prowizje dla powyższych sprzedawców
- Zsumuj wypłaty dla każdego sprzedawcy
- Przetwórz wypłatę
Powyższy proces byłby obsługiwany zgodnie z Twoim wyznaczonym harmonogramem za pośrednictwem WordPressa. Sugerujemy użycie harmonogramu akcji dołączonego do WooCommerce.
Klasy WC Vendors
| Klasa | Opis |
|---|---|
| WCV_Vendors | Ta klasa obsługuje metody związane ze sprzedawcami i ich produktami. Metody, które będą używane w Twojej bramce płatności, obejmują: WCV_Vendors::is_vendor( $user_id ); Określ, czy podane identyfikator użytkownika jest sprzedawcą, czy nie. WCV_Vendors::get_due_orders_by_vendor( $vendor_id); Pobierz wszystkie należne prowizje dla danego sprzedawcy. |
| WCV_Commission | Ta klasa obsługuje wszystkie interakcje z powyższą tabelą prowizji. Metody, których powinieneś używać w swojej bramce: WCV_Commission::set_vendor_product_commission_paid(); aby zalogować, kiedy prowizja została zapłacona. |