Korzystanie z Adyen na platformie Shopify
Adyen to bramka płatnicza dla przedsiębiorstw, służąca do przyjmowania płatności. Sprzedawcy posiadający już konto Adyen mogą korzystać z tego rozwiązania jako podmiotu przetwarzającego płatności bezpośrednio w Shopify.
Platformę Shopify, w tym dane o płatnościach Adyen, można zintegrować z oprogramowaniem do planowania zasobów przedsiębiorstwa (ERP), aby zapewnić płynniejsze zarządzanie danymi i ich synchronizację pomiędzy systemami.
Na tej stronie
- Wymagania kwalifikacyjne dla bramki Adyen na platformie Shopify
- Niekompatybilne lub niedostępne funkcje dla bramki Adyen na platformie Shopify
- Aktywuj bramkę Adyen na platformie Shopify
- Skonfiguruj ustawienia bramki Adyen
- Korzystaj z bramki Adyen w usłudze Shopify Markets
- Zweryfikuj integrację za pomocą zamówień testowych
- Uzgadniaj zamówienia podczas korzystania z bramki Adyen
- Rozwiązywanie typowych problemów z bramką Adyen
- Często zadawane pytania
- Zanim skontaktujesz się z Pomocą techniczną Shopify w sprawie bramki Adyen
- Pomoc techniczna i zasoby Adyen
Wymagania kwalifikacyjne dla bramki Adyen na platformie Shopify
Zanim zaczniesz korzystać z bramki Adyen na platformie Shopify, musisz spełnić następujące wymagania:
- Musisz korzystać z planu korporacyjnego.
- Twoja firma musi spełniać określone kryteria kwalifikacyjne w zależności od regionu.
- Przed aktywacją integracji musisz mieć założone konto Adyen.
- Twój sklep musi korzystać z usługi Shopify Checkout.
Dostęp do bramki Adyen jest przyznawany wyłącznie po zatwierdzeniu i nie można go zagwarantować. Aby poprosić o aktywację bramki Adyen, skontaktuj się z przedstawicielem handlowym Shopify lub menedżerem rozwoju sprzedawcy (CSM). Jeśli nie masz menedżera rozwoju sprzedawcy, możesz skontaktować się z Pomocą techniczną Shopify, aby uzyskać wskazówki na temat dalszych kroków.
Niekompatybilne lub niedostępne funkcje dla bramki Adyen na platformie Shopify
Niektóre funkcje są niedostępne lub niekompatybilne z integracją Adyen na platformie Shopify:
- Klarna i PayPal nie są dostępne: Klarna i PayPal nie są obsługiwane jako metody płatności w ramach integracji bramki Adyen z platformą Shopify.
- Nie wszystkie lokalne metody płatności są dostępne: Lokalne metody płatności oferowane w ramach integracji bramki Adyen z platformą Shopify różnią się w zależności od regionu i mogą nie obejmować wszystkich metod oferowanych bezpośrednio przez firmę Adyen. Pełną listę znajdziesz w dokumentacji metod płatności Adyen.
- Narzędzia Shopify do zapobiegania oszustwom nie są dostępne: Korzystając z bramki Adyen, nie masz dostępu do narzędzi zapobiegania oszustwom z usługi Shopify Payments, takich jak zarządzanie sporami, ochrona przed testowaniem kart i analizy oszustw. Firma Adyen oferuje własne narzędzia do zapobiegania oszustwom, które mogą być dostępne za dodatkową opłatą. Nadal możesz jednak korzystać z funkcji analizy oszustw Shopify i aplikacji Shopify Flow w celu skonfigurowania niestandardowych reguł.
- Usługa Managed Markets nie jest obsługiwana: Usługa Managed Markets (pełniąca funkcję oficjalnego sprzedawcy) wymaga korzystania z usługi Shopify Payments i nie można z niej korzystać w połączeniu z bramką Adyen.
- Ręczne metody płatności nie obsługują funkcji wielowalutowej: Funkcja wielowalutowa działa tylko w przypadku kart kredytowych. Ręczne metody płatności, takie jak przelew bankowy czy płatność przy odbiorze, domyślnie korzystają z waluty sklepu.
Aktywuj bramkę Adyen na platformie Shopify
Zanim aktywujesz bramkę Adyen, skonsultuj się z przedstawicielem handlowym Shopify lub menedżerem rozwoju sprzedawcy w celu uzyskania zatwierdzenia. Po jego uzyskaniu załóż konto w serwisie Adyen, a następnie zainstaluj i aktywuj aplikację płatniczą.
Kroki:
W panelu administracyjnym Shopify przejdź do opcji Ustawienia > Płatności.
W sekcji Shopify Payments kliknij opcję Zarządzaj.
Kliknij opcję Przełącz na zewnętrznego dostawcę, a następnie kliknij ją ponownie, aby potwierdzić.
Wybierz opcję Adyen Payments - Credit Cards z listy dostępnych dostawców płatności. Jeśli nie uzyskasz zgody na korzystanie z bramki Adyen, opcja Adyen Payments - Credit Cards nie będzie wyświetlana na liście dostawców płatności.
Kliknij opcję Zarządzaj kontem.
W razie potrzeby zezwól rozszerzeniu płatności Adyen na dostęp do danych sklepu i ich modyfikację.
Na stronie Konfiguracja płatności Adyen wybierz konto Adyen, którego chcesz używać w swoim sklepie Shopify.
Postępuj zgodnie z instrukcjami w sekcji Customer Area firmy Adyen, aby zainstalować aplikację płatniczą Adyen dla platformy Shopify i przetestować integrację.
Skonfiguruj ustawienia bramki Adyen
Po aktywacji bramki Adyen możesz skonfigurować jej ustawienia w sposób odpowiadający Twoim potrzebom biznesowym.
Skonfiguruj ustawienia pobierania płatności
Pobieranie płatności decyduje o tym, kiedy środki od Twoich klientów zostają zaksięgowane.
Kroki:
W panelu administracyjnym Shopify przejdź do opcji Ustawienia > Płatności.
W sekcji wybranego dostawcy płatności kliknij Zarządzaj.
Wybierz preferowaną metodę pobierania płatności:
- Automatyczne pobieranie: Płatności są pobierane natychmiast po złożeniu zamówienia.
- Ręczne pobieranie: Płatności są autoryzowane, ale zostaną pobrane dopiero, gdy wykonasz to ręcznie.
- Pobieranie po realizacji: Płatności są pobierane w momencie realizacji zamówienia.
Zainstaluj lokalne metody płatności
Aby oferować lokalne metody płatności za pośrednictwem bramki Adyen, musisz najpierw zainstalować aplikację Adyen Payments - Credit Cards, która musi pełnić rolę głównej bramki płatniczej. Jeśli aplikacja obsługująca karty kredytowe nie jest zainstalowana, nie możesz zainstalować lokalnych metod płatności.
Po zainstalowaniu aplikacji obsługującej karty kredytowe skontaktuj się z menedżerem rozwoju sprzedawcy lub przedstawicielem handlowym Shopify, aby uzyskać dostęp do lokalnych metod płatności dla swojego regionu.
Skonfiguruj raty płatne kartą kredytową dla Brazylii i Meksyku
Jeśli sprzedajesz klientom w Brazylii lub Meksyku, możesz zaoferować im możliwość płatności ratalnej za pomocą karty kredytowej podczas realizacji zakupu.
Zanim skonfigurujesz raty, sprawdź, czy spełnione są następujące wymagania:
- W przypadku Brazylii dla Twojego rynku musi być ustawiona waluta BRL (real brazylijski).
- W przypadku Meksyku dla Twojego rynku musi być ustawiona waluta MXN (peso meksykańskie).
- Aplikacja Adyen Payments - Credit Cards musi być zainstalowana jako główna bramka płatnicza.
Kroki:
W panelu administracyjnym Shopify przejdź do opcji Ustawienia > Płatności.
W sekcji Adyen Payments - Credit Cards kliknij Zarządzaj.
Kliknij opcję Więcej akcji, a następnie kliknij Zarządzaj.
W pasku adresu przeglądarki dodaj ciąg
?credit_card_installments=1na końcu adresu URL, a następnie naciśnij klawisz Enter na klawiaturze.Opcje konfiguracji rat wyświetlają się na dole strony.
Skonfiguruj maksymalną liczbę rat i minimalną płatność dla jednej raty. W przypadku Brazylii można skonfigurować od 2 do 12 rat. W przypadku Meksyku możliwe jest ustawienie 3, 6, 9, 12 lub 18 rat.
Kliknij Zapisz.
Korzystanie z platformy Adyen z Shopify Markets
Bramka Adyen jest kompatybilna z usługą Shopify Markets. Gdy usługa Shopify Markets jest aktywna, transakcje są przetwarzane w walucie, którą platforma Shopify wysyła do Adyen.
Aby sprzedawać w wielu walutach za pomocą bramki Adyen, sprawdź, czy spełnione są następujące wymagania:
- Waluty rynków muszą być również skonfigurowane na koncie Adyen.
- Jeśli waluta jest jedną z walut rozliczeniowych Adyen dla danego regionu, Adyen rozlicza środki w tej samej walucie.
Sprawdzenie integracji za pomocą zamówień testowych
Zanim zaczniesz akceptować rzeczywiste płatności, przetestuj integrację z bramką Adyen za pomocą zamówień roboczych, aby potwierdzić, że płatności są przetwarzane poprawnie.
Kroki:
W panelu administracyjnym Shopify przejdź do opcji Zamówienia > Wersje robocze.
Kliknij Utwórz zamówienie.
Dodaj produkt i informacje o kliencie.
Kliknij Pobierz płatność, a następnie wybierz preferowaną metodę płatności.
Dokończ proces płatności i sprawdź, czy zamówienie wyświetla się poprawnie zarówno na platformie Shopify, jak i w portalu Adyen.
Uzgadnianie zamówień podczas korzystania z bramki Adyen
Gdy zamówienie jest opłacone za pomocą bramki Adyen, platforma Shopify wysyła do Adyen numer merchantReference dla transakcji. Numer merchantReference to unikalny identyfikator, którego można użyć do uzgadniania zamówień.
Numer merchantReference składa się z dwóch części:
- ID sklepu Shopify: Pierwsza część numeru identyfikuje sklep Shopify.
- ID płatności: Druga część to ID płatności dla określonej transakcji.
Na przykład numer merchantReference może mieć postać 12345-67890. W tym przykładzie 12345 to ID sklepu Shopify, a 67890 to ID płatności.
ID płatności dla transakcji wyświetla się na osi czasu zamówienia w panelu administracyjnym Shopify.
Aby uzgodnić transakcje, przeszukaj panel administracyjny Shopify, używając ID płatności z numeru merchantReference. Funkcja wyszukiwania zwraca zamówienie powiązane z ID płatności.
Uwagi dotyczące uzgadniania zamówień
Podczas korzystania z osi czasu zamówienia i ID płatności do uzgadniania zamówień z transakcjami w systemie Adyen, zapoznaj się z poniższymi uwagami:
- Znalezienie klucza autoryzacyjnego zamówienia: Klucz autoryzacyjny nie jest aktualizowany na osi czasu zamówienia w panelu administracyjnym Shopify po zakończeniu transakcji za pomocą bramki Adyen. Aby uzyskać klucz autoryzacyjny zamówienia, przejdź do konta Adyen.
- Oczekujący status płatności: Przetwarzanie płatności może potrwać kilka dni. Jeśli nie otrzymano odpowiedzi od dostawcy płatności, płatności mogą mieć status Oczekujące. Gdy status płatności zmieni się na Opłacone, możesz zrealizować zamówienie.
- Status płatności Wygasła: Jeśli status płatności zmieni się na Wygasła, upewnij się, że płatność nie wpłynęła na konto Adyen, zanim ponownie poprosisz klienta o zapłatę. Status płatności zmienia się na Wygasła, co oznacza, że przetworzenie płatności nie było możliwe.
Rozwiązywanie typowych problemów z bramką Adyen
Jeśli wystąpią problemy z integracją z bramką Adyen, zapoznaj się z poniższymi typowymi problemami i ich rozwiązaniami.
Rozwiązywanie problemów ze statusem Oczekujące dla płatności
Jest to oczekiwane zachowanie w przypadku lokalnych metod płatności (LPM), takich jak AliPay i WeChat Pay. Płatność przechodzi w stan oczekiwania do momentu jej pomyślnego zrealizowania po stronie podmiotu przetwarzającego. Po potwierdzeniu płatności status aktualizuje się zarówno w systemie Adyen, jak i na platformie Shopify.
Co należy zrobić: Poczekaj na przetworzenie płatności. Większość płatności aktualizuje się w ciągu kilku minut, ale niektóre mogą wymagać do 10–15 minut.
Rozwiązywanie problemów: klient obciążony, ale brak zamówienia w Shopify
Może się tak zdarzyć, jeśli klient rozpocznie płatność wymagającą weryfikacji 3D Secure, ale przerwie proces lub napotka problemy niezależne od platformy Shopify.
Co należy zrobić:
- Sprawdź w portalu Adyen, czy płatność została pobrana.
- Jeśli płatność została pobrana, utwórz wersję roboczą zamówienia w Shopify.
- Oznacz wersję roboczą zamówienia jako opłaconą i zrealizuj ją zgodnie z procedurą.
- Jeśli płatność nie została pobrana, żadne działanie nie jest wymagane.
Rozwiązywanie problemów: klient dwukrotnie obciążony
Może się to zdarzyć, gdy klient ukończy weryfikację 3D Secure, ale nie zostanie prawidłowo przekierowany z powrotem na platformę Shopify. Klient może zauważyć na swoim wyciągu dwie próby autoryzacji.
Co należy zrobić:
- Sprawdź w portalu Adyen, ile płatności zostało faktycznie pobranych.
- Jeśli pobrana została tylko jedna płatność, poinformuj klienta, że drugie obciążenie to oczekująca autoryzacja, która zostanie automatycznie zwolniona przez bank.
- Jeśli pobrano dwie płatności, dokonaj zwrotu kosztów zduplikowanej transakcji w portalu Adyen.
Rozwiązywanie problemów: zamówienie utworzone, ale płatność odrzucona
Jeśli przetworzenie odrzucenia płatności przez Adyen potrwa dłużej niż oczekiwano, płatność może przejść w status Oczekujące, a zamówienie zostanie utworzone w Shopify.
Co należy zrobić:
- Sprawdź status płatności zarówno w panelu administracyjnym Shopify, jak i w portalu Adyen.
- Jeśli płatność się nie powiodła, możesz anulować zamówienie lub poprosić klienta o ponowną płatność.
Rozwiązywanie problemów z przerwaną realizacją zakupu po potwierdzeniu płatności w Adyen
Może się to zdarzyć, gdy wygaśnie sesja lokalnej metody płatności, ale klient został już autoryzowany w Adyen.
Co należy zrobić:
- Odczekaj 10–15 minut na synchronizację statusu płatności między systemem Adyen a platformą Shopify.
- Jeśli po 15 minutach płatność widnieje w Adyen jako zrealizowana, ale zamówienie na platformie Shopify nadal nie zostało utworzone, utwórz wersję roboczą zamówienia i ręcznie oznacz ją jako opłaconą.
Rozwiązywanie problemów z błędem „Aplikacja jest niedostępna do instalacji”
Ten błąd zazwyczaj oznacza, że sklep nie spełnia wymagań uprawniających do korzystania z bramki Adyen.
Co należy zrobić:
- Sprawdź, czy Twój sklep korzysta z planu korporacyjnego.
- Skontaktuj się z menedżerem rozwoju sprzedawcy (CSM) lub przedstawicielem handlowym Shopify, aby omówić uprawnienia i aktywację.
- Jeśli nie masz menedżera rozwoju sprzedawcy, skontaktuj się z Pomocą techniczną Shopify, aby uzyskać wskazówki dotyczące kolejnych kroków.
Rozwiązywanie problemów z lokalnymi metodami płatności, które nie wyświetlają się podczas realizacji zakupu
Jeśli lokalne metody płatności nie wyświetlają się klientom, sprawdź, czy spełnione są następujące wymagania:
- Aplikacja Adyen Payments - Credit Cards musi być zainstalowana jako główna bramka płatnicza. Bez niej nie można korzystać z lokalnych metod płatności.
- Adres wysyłki klienta musi znajdować się w regionie, w którym dostępna jest lokalna metoda płatności.
- Waluta realizacji zakupu musi być obsługiwana przez lokalną metodę płatności.
Co należy zrobić:
- Potwierdź, że aplikacja Adyen Payments - Credit Cards jest zainstalowana i aktywna.
- Sprawdź, czy lokalne metody płatności są prawidłowo skonfigurowane na koncie Adyen.
- Przetestuj realizację zakupu z adresem klienta z regionu docelowego.
Rozwiązywanie problemów z ratami z użyciem karty kredytowej, które nie wyświetlają się podczas realizacji zakupu
Jeśli raty z użyciem karty kredytowej nie wyświetlają się klientom w Brazylii lub Meksyku, sprawdź, czy spełnione są następujące wymagania:
- W przypadku Brazylii rynek musi korzystać z waluty BRL (real brazylijski).
- W przypadku Meksyku rynek musi korzystać z waluty MXN (peso meksykańskie).
- Aplikacja Adyen Payments - Credit Cards musi być zainstalowana jako główna bramka płatnicza.
- Raty muszą zostać aktywowane za pomocą parametru adresu URL.
- Nie są używane kredyty sklepowe ani aplikacje płatnicze z zewnętrznymi kartami prezentowymi (nie są one kompatybilne z ratami).
Często zadawane pytania
Czy mogę używać bramki Adyen do lokalnych metod płatności, a innej bramki do kart kredytowych?
Nie. Aby przetwarzać lokalne metody płatności za pomocą Adyen, musisz mieć zainstalowaną aplikację Adyen Payments - Credit Cards jako główną bramkę płatniczą. Adyen wymaga takiej konfiguracji i monitoruje jej użycie, aby zapobiec częściowej integracji.
Czy mogę zobaczyć numer referencyjny PSP Adyen w panelu administracyjnym Shopify?
Nie. Numer referencyjny dostawcy usług płatniczych (PSP) Adyen nie jest zapisywany w Shopify. Jednak numer referencyjny transakcji Shopify jest przechowywany jako część pola merchantReference w portalu Adyen, co można wykorzystać do uzgodnienia.
Czy bramka Adyen jest kompatybilna z subskrypcjami?
Tak, aplikacja płatnicza Adyen obsługuje subskrypcje za pośrednictwem aplikacji subskrypcyjnych zintegrowanych z realizacją zakupu w Shopify. Jeśli musisz przenieść istniejące subskrypcje do Adyen, skontaktuj się z menedżerem rozwoju sprzedawcy (CSM) lub przedstawicielem handlowym Shopify, aby omówić opcje migracji.
Czy Adyen obsługuje usługi Apple Pay i Google Pay?
Tak, usługi Apple Pay (dla systemu iOS) i Google Pay (dla systemu Android) są dostępne za pośrednictwem integracji z Adyen.
Czy bramka Adyen jest kompatybilna ze sprzedażą droższych produktów po zakupie?
Tak, aplikacja Adyen obsługuje sprzedaż droższych produktów po zakupie za pośrednictwem rozszerzenia realizacji zakupu po zakupie. Zapoznaj się z dokumentacją dla deweloperów Shopify, aby dowiedzieć się więcej o ograniczeniach i uwagach dotyczących rozszerzeń realizacji zakupu po zakupie.
Jak dokonać migracji ze starszej integracji Active Merchant do nowej aplikacji płatniczej?
Starsza bramka Adyen nie jest już obsługiwana i może powodować problemy z płatnościami. Jeśli nadal korzystasz ze starszej bramki Adyen, od razu wykonaj migrację do nowej aplikacji płatniczej Adyen.
W celu dokonania migracji skontaktuj się z Pomocą techniczną Shopify lub z menedżerem rozwoju sprzedawcy, aby uzyskać wskazówki dotyczące procesu migracji.
Zanim skontaktujesz się z Pomocą techniczną Shopify w sprawie Adyen
Przed skontaktowaniem się z Pomocą techniczną Shopify w sprawie problemu z Adyen przygotuj następujące informacje, aby pomóc w szybszym jego rozwiązaniu:
- Nr zamówienia lub zamówień, których dotyczy problem
- Data i godzina wystąpienia problemu
- Zrzuty ekranu ze wszystkimi otrzymanymi komunikatami o błędach
- Status płatności wyświetlany w panelu administracyjnym Shopify i w portalu Adyen
- Numer merchantReference z systemu Adyen (jeśli dotyczy)
- Opis spodziewanego rezultatu w porównaniu z tym, co faktycznie się wydarzyło
- Podjęte już kroki z sekcji rozwiązywania problemów
Pomoc techniczna i zasoby Adyen
Wiedza o tym, z którym zespołem skontaktować się w celu uzyskania pomocy technicznej, ułatwia pracę i pozwala szybciej uzyskać odpowiedzi podczas korzystania z Adyen na platformie Shopify.
Obowiązki Pomocy technicznej Shopify
Pomoc techniczna Shopify to pierwszy punkt kontaktu, jeśli potrzebujesz wsparcia w zakresie integracji Adyen z Shopify, w tym pomocy w konfiguracji oraz rozwiązywaniu typowych problemów. Pomoc techniczna Shopify może pomóc w przypadku następujących rodzajów problemów:
- Wnioskowanie o dostęp i aktywacja bramki płatniczej Adyen na platformie Shopify
- Kwestie techniczne związane z bramką płatniczą Adyen na platformie Shopify
- Rozwiązywanie problemów z integracją
- Wskazówki dotyczące konfiguracji ustawień Adyen i zarządzania nimi na platformie Shopify
Obowiązki Pomocy technicznej Adyen
W sprawach dotyczących wyłącznie konta Adyen skontaktuj się bezpośrednio z obsługą klienta Adyen pod adresem support@adyen.com. Zespół wsparcia Adyen obsługuje następujące typy zapytań:
- Weryfikacja konta i wdrażanie sprzedawcy
- Zgodność z przepisami
- Ceny i stawki za przetwarzanie
- Harmonogramy wypłat, nieudane wypłaty oraz inne pytania dotyczące wypłat
- Strategie i narzędzia zapobiegania oszustwom
- Zarządzanie obciążeniami zwrotnymi i sporami
- Potrzeby związane ze szczegółowym raportowaniem i uzgodnieniami
Zasoby
Aby dowiedzieć się więcej o Adyen i integracji z platformą Shopify, zapoznaj się z poniższymi zasobami: