Codex · III

Płatność pocztą

Przebieg płatności pocztą

  1. Kupujący klika przycisk Coin Moebius na Twojej stronie i wybiera "Pay by mail" w selektorze. Najpierw widzi podgląd: Twój adres pocztowy, należną kwotę i wszelkie ustawione przez Ciebie instrukcje, z przyciskiem <strong>"Confirm, I'll send payment"</strong>. Nic nie jest jeszcze zapisane i na tym etapie nie ma kodu referencyjnego.
  2. Kupujący klika "Confirm, I'll send payment". To krok, który tworzy transakcję: Coin Moebius generuje unikalny kod referencyjny, taki jak X2M-K9P-R7QW, i pokazuje go obok Twojego adresu pocztowego. Kupujący umieszcza kod referencyjny w przesyłce lub na czeku.
  3. Gdy potwierdzi, w zakładce Transactions w Twoim panelu pojawia się wiersz ze statusem pending_manual. Góra listy pokazuje też wyróżnienie przypominające, że potwierdzenia płatności wysłanych pocztą czekają.
  4. Gdy płatność kupującego dotrze do Twojej skrzynki (gotówka, czek, Goldback, jakakolwiek była oczekiwana waluta), wpisz kod referencyjny w pole wyszukiwania w zakładce Transactions, by znaleźć odpowiedni wiersz. Kliknij Mark received. Uruchamia się success URL kupującego (więc dostaje stronę potwierdzenia), a Ty przechodzisz do wysyłki tego, co kupił.
  5. Jeśli płatność kupującego nigdy nie dotrze, wiersz wygasa automatycznie po 30 dniach. Możesz też anulować wiersz ręcznie wcześniej.
  6. Jeśli potwierdziłeś odbiór, ale później odkryjesz, że płatność była nieważna (podrobiona, niewłaściwa pozycja, pusta koperta), kliknij Undo confirmation na wierszu. Status zmienia się na manual_revoked. To poprawia Twoje zapisy w panelu. Komunikacja z kupującym o tym, co dalej, jest sprawą między Wami.

Testowanie płatności pocztą

Płatność pocztą nie ma sandboxa, kluczy testowych ani konta zewnętrznego do skonfigurowania. Cały przebieg dzieje się między Twoją stroną a Twoim panelem. Są dwa sposoby na test: pełna droga od przycisku kupna na stronie albo szybki test prosto z panelu.

Szybki test z panelu

Panel może utworzyć transakcję testową dla dowolnego dostawcy bez angażowania prawdziwej płatności. Jest to przydatne, by zobaczyć, jak wygląda wiersz transakcji, przećwiczyć przebieg "Mark received" dla płatności pocztą lub podejrzeć, jak płatność krypto pojawia się na Twojej liście, zanim wydasz prawdziwe pieniądze.

  1. Otwórz zakładkę Transactions w swoim projekcie i kliknij Send a test event.
  2. Wybierz produkt, wybierz, co się wydarzyło (płatność, zwrot, płatność pocztą, odnowienie subskrypcji), i wybierz dostawcę, którego chcesz zasymulować (Stripe, NOWPayments lub Pay by mail). Dla zdarzeń płatności pocztą dostawca ustawiany jest automatycznie.
  3. Kliknij Send test event. Pojawia się nowy wiersz z etykietą "test", więc nie miesza się z danymi na żywo. Wiersz pojawia się pod filtrem właściwego dostawcy, dokładnie jak prawdziwa transakcja.

W szczególności dla płatności pocztą wybierz "A pay-by-mail order is waiting", by utworzyć wiersz pending_manual z prawdziwym kodem referencyjnym. Możesz wtedy przećwiczyć klikanie "Mark received", "Cancel" i "Undo confirmation" na nim.

Zdarzenia testowe nie liczą się do Twojego miesięcznego limitu transakcji.

Pełna droga od przycisku kupna

Aby przetestować pełny przebieg (od tego, co widzi Twój kupujący, po to, co widzisz Ty), wykonaj te kroki. Całość zajmuje około dwóch minut.

  1. Skonfiguruj dostawcę. W panelu przejdź do zakładki Providers swojego projektu i kliknij "Add provider" → Pay by mail. Wpisz dowolny adres pocztowy (na potrzeby testu wystarczy Twój własny) i dowolną walutę (np. USD, GBK). Zapisz.
  2. Dodaj produkt. W zakładce Products utwórz produkt o nazwie takiej jak "Test item" i z ceną. Ustaw walutę, by pasowała do tej, którą wpisałeś dla dostawcy.
  3. Umieść przycisk kupna na stronie. Wklej HTML przycisku kupna na dowolnej stronie, nawet w gołym pliku HTML na Twoim komputerze. Skieruj atrybut endpoint na adres URL Twojego projektu Cloud. Jeśli uruchamiasz worker lokalnie, użyj zamiast tego http://localhost:8787.
  4. Kliknij przycisk i wybierz "Pay by mail". Selektor otwiera się, pokazując każdego podłączonego przez Ciebie dostawcę. Wybierz "Pay by mail". Zobaczysz podgląd z Twoim adresem pocztowym, oczekiwaną kwotą i walutą oraz przyciskiem "Confirm, I'll send payment". Jeszcze bez kodu referencyjnego.
  5. Kliknij "Confirm, I'll send payment". To kupujący zobowiązuje się wysłać płatność. Coin Moebius zapisuje transakcję i pokazuje kod referencyjny, taki jak X2M-K9P-R7QW.
  6. Otwórz panel. Przejdź do zakładki Transactions. Pojawia się nowy wiersz ze statusem pending_manual i tym samym kodem referencyjnym, który właśnie zobaczyłeś. Jeśli to Twój pierwszy oczekujący wiersz, wyróżnienie na górze listy przypomina, że płatności wysłane pocztą czekają na potwierdzenie.
  7. Kliknij "Mark received". Status wiersza zmienia się na succeeded. To pełna ścieżka pozytywna, od kliknięcia kupującego po Twoje potwierdzenie.

Znajdowanie transakcji po kodzie referencyjnym

Gdy płatność dotrze do Twojej skrzynki, poszukaj kodu referencyjnego, który dołączył kupujący (nadrukowany na kopercie, wpisany w tytule czeku lub schowany w przesyłce). Następnie wpisz ten kod w pole wyszukiwania w zakładce Transactions i naciśnij Enter. Tabela filtruje do pasujących wierszy, byś mógł kliknąć "Mark received" na właściwym, nie przeglądając całej historii transakcji.

Testowanie pozostałych wyników

Przejdź te same kroki ponownie, ale zamiast oznaczać wiersz jako odebrany, wypróbuj każdy z tych:

  • Anuluj go. Kliknij "Cancel" na oczekującym wierszu. Status zmienia się na manual_canceled. To zrobiłbyś, gdy kupujący powie Ci, że zmienił zdanie, zanim cokolwiek wysłał.
  • Pozwól mu wygasnąć. Zostaw oczekujący wiersz w spokoju. Po 30 dniach wygasa automatycznie do manual_expired. Nie musisz czekać 30 dni, by zweryfikować to zachowanie. Wygaśnięcie działa tak samo jak Cancel, z tym że dzieje się automatycznie według harmonogramu.
  • Wpisz inną kwotę. Klikając "Mark received", wpisz otrzymaną kwotę różną od oczekiwanej (np. kupujący wysłał 4 Goldbacks zamiast 5). Transakcja nadal kończy się powodzeniem, ale panel pokazuje zarówno kwotę oczekiwaną, jak i otrzymaną, by Twoje zapisy odzwierciedlały to, co faktycznie dotarło.
  • Cofnij potwierdzenie. Najpierw oznacz wiersz jako odebrany, by pokazywał succeeded, a potem kliknij "Undo confirmation" na tym wierszu. Status zmienia się na manual_revoked. Tak poprawiłbyś pomyłkę lub oznaczył płatność, która po fakcie okazała się nieważna.

Na co zwrócić uwagę

  • Kod referencyjny w selektorze zgadza się z kodem referencyjnym na wierszu panelu.
  • Twój adres pocztowy wyświetla się poprawnie w selektorze.
  • Przyciski "Mark received" i "Cancel" pojawiają się tylko na wierszach pending_manual, a nie na transakcjach kartowych czy krypto.
  • Po oznaczeniu jako odebrane wiersz pokazuje succeeded z poprawną kwotą.
  • Wyszukiwanie po kodzie referencyjnym w polu wyszukiwania znajduje właściwy wiersz.

Transakcje pełnej drogi tworzone podczas testowania liczą się do Twojego miesięcznego limitu. W planie darmowym (150 transakcji/miesiąc) garść przebiegów testowych nie zrobi wyłomu. Zdarzenia testowe wysyłane przyciskiem "Send a test event" w panelu nie liczą się wcale.

Gotowy to podłączyć?

Plan darmowy wystarcza większości stron i nigdy nie prosi o kartę.