Ten dokument wyjaśnia, jak rozszerzenie Płatności cykliczne działa ze Stripe.
Konfiguracja Stripe
Ważne jest, aby wykonać wszystkie kroki opisane w Dokumentacji konfiguracji Stripe.
Ważna uwaga dotycząca konfiguracji: Jeśli Webhooki nie są poprawnie skonfigurowane, subskrypcje nie będą działać prawidłowo!
Anulowanie subskrypcji
Podczas korzystania ze Stripe anulowanie może być zainicjowane zarówno z poziomu EDD, jak i z poziomu Panelu Stripe.
Anulowanie przez klienta
Klienci mogą samodzielnie anulować swoje subskrypcje ze strony konta Twojego sklepu.
Anulowanie przez administratora witryny
Aby anulować subskrypcję z poziomu administratora EDD, przejdź do Pobrane produkty → Subskrypcje i kliknij „Wyświetl” przy elemencie, który chcesz anulować.
Następnie na dole następnego ekranu kliknij „Anuluj subskrypcję”.
Gdy ustawisz status subskrypcji na anulowany, zostanie ona natychmiast anulowana, ale klient nadal będzie miał dostęp do zakupionych materiałów przez opłacony okres.
Na przykład, jeśli zapłacili 10 USD/miesiąc, a Ty anulujesz w połowie miesiąca, nadal będą mieli dostęp do materiałów przez resztę miesiąca, ale nie zostaną obciążeni ponownie, a dostęp zakończy się pod koniec miesiąca.
Z Panelu Stripe
Aby anulować subskrypcję z poziomu Panelu Stripe, zaloguj się do Stripe i znajdź pasek wyszukiwania na górze strony.
Możesz znaleźć klientów, wyszukując:
- ID transakcji
- ID profilu subskrypcji
- numer ID klienta EDD
- e-mail klienta
Po znalezieniu i wybraniu klienta w Stripe zobaczysz listę subskrypcji.
Jeśli klikniesz Anuluj (ikona X obok nazwy subskrypcji), otrzymasz trzy opcje; anuluj natychmiast, na koniec bieżącego okresu lub w niestandardowej dacie. Dla celów EDD nie ma znaczenia, którą opcję wybierzesz: natychmiast lub na koniec bieżącego okresu, klient nie zauważy różnicy między nimi. Jeśli wybierzesz niestandardową datę, która przypada po końcu bieżącego okresu, będą oni nadal obciążani do momentu upłynięcia tej niestandardowej daty.
Podsumowanie anulowania
Nie ma znaczenia, czy anulujesz subskrypcję w EDD, czy w Stripe, efekt jest dokładnie taki sam i klient nie zauważy różnicy.
Aktualizacja informacji o karcie kredytowej/debetowej
Klienci mogą aktualizować informacje o swojej karcie dla swoich konkretnych subskrypcji ze strony konta swojego sklepu.
Deskryptory wyciągu
Gdy produkt jest skonfigurowany jako subskrypcja, zachowanie deskryptora jest nieco inne niż w przypadku zakupów niebędących subskrypcjami. Kiedy subskrypcja jest kupowana po raz pierwszy w Twojej witrynie, w Stripe tworzony jest „Produkt”, który będzie używany do wszystkich kolejnych zakupów tej konkretnej subskrypcji. Możesz zobaczyć swoją bieżącą listę Produktów, logując się na swoje konto Stripe i przechodząc do Produkty.
Po utworzeniu tego Produktu deskryptor wyciągu jest tworzony na podstawie nazwy Twojego produktu, niezależnie od wspomnianego wyżej ustawienia w Twoim panelu WordPress. Deskryptor będzie również zapisany małymi literami, a słowa będą oddzielone myślnikami. Zrozumiałe jest, że nie wygląda to dobrze na wyciągu bankowym. Istnieją dwa sposoby na zmianę tego zachowania, które najlepiej stosować razem, jeśli nie podoba Ci się domyślne zachowanie:
1. Edytuj szczegóły Planu
Przechodząc do Produkty w swoim koncie Stripe, możesz kliknąć dowolny Produkt, aby zobaczyć jego szczegóły. Po przejściu na stronę szczegółów kliknij przycisk Edytuj szczegóły. Zostanie wyświetlony modal, który pozwoli Ci ustawić deskryptor wyciągu dla tego konkretnego Produktu.
To, co tutaj ustawisz, będzie używane do wszystkich płatności tego planu subskrypcji na Twojej stronie.
2. Filtruj domyślny deskryptor wyciągu dla planów Stripe
Powyższa metoda pozwala kontrolować deskryptor wyciągu dla konkretnej subskrypcji, która już istnieje. Ale jeśli nowa subskrypcja zostanie utworzona z pierwszego zakupu innej subskrypcji na Twojej stronie, zastosowanie będzie miało domyślne zachowanie. Oznacza to, że nowa subskrypcja domyślnie nadal będzie miała deskryptor wyciągu oparty na nazwie produktu.
Aby utworzyć nowy domyślny deskryptor wyciągu dla wszystkich subskrypcji utworzonych w przyszłości (nie wpłynie to na istniejące subskrypcje), użyj następującego filtra:
function custom_edd_recurring_stripe_plan_statement_descriptor( $args, $subscription ) {
$args['statement_descriptor'] = 'New Statement Desc';
return $args;
}
add_filter( 'edd_recurring_create_stripe_plan_args', 'custom_edd_recurring_stripe_plan_statement_descriptor', 10, 2 );
Zastąp Nowy Deskryptor Wyciągu preferowanym domyślnym deskryptorem wyciągu (pamiętaj o limicie 22 znaków).
Podsumowując, użyj pierwszej metody, aby edytować deskryptor wyciągu dla istniejącej subskrypcji. Użyj drugiej metody, aby ustawić nowy domyślny deskryptor wyciągu dla wszystkich przyszłych subskrypcji.
Częste problemy związane z webhookami
Klienci są obciążani zbyt wiele razy
Jeśli nie skonfigurujesz poprawnie webhooków Stripe przed dokonaniem zakupu przez klienta i używasz opcji „Razy” w EDD Recurring do obciążania klienta określoną liczbę razy (na przykład 5 razy), zostanie on obciążony zbyt wiele razy.
Dzieje się tak, ponieważ bez webhooka Stripe nie jest w stanie poinformować EDD o pomyślnym przejściu płatności, więc EDD o tym nie wie. Z tego powodu EDD uważa, że klient nie został jeszcze obciążony – mimo że mógł już zostać obciążony 5 razy (lub więcej).
EDD automatycznie wysyła do Stripe polecenie „anuluj subskrypcję”, gdy osiągnięto określoną liczbę razy. Ale ponieważ nie ma webhooka, EDD nie wie, że klient został w ogóle obciążony i nigdy nie anuluje subskrypcji. Powoduje to, że klient jest nadal obciążany nawet po osiągnięciu określonej liczby razy. Dlatego ważne jest, aby skonfigurować webhook natychmiast po zainstalowaniu rozszerzenia Stripe.
