Korzystanie z Adyen na platformie Shopify

Adyen to bramka płatnicza, której możesz używać do akceptowania płatności na platformie Shopify. Dostęp do aplikacji płatniczej Adyen jest ograniczony do organizacji korzystających z kwalifikujących się ofert dla firm, takich jak plan Shopify Plus lub rozwiązanie Commerce Components by Shopify for Enterprise, z aktualnym zatwierdzeniem Adyen. Jeśli Twoja organizacja uzyskała takie zatwierdzenie, możesz używać swojego konta Adyen jako podmiotu przetwarzającego płatności bezpośrednio w systemie 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.

Wymagania kwalifikacyjne dla bramki Adyen na platformie Shopify

Tylko organizacje korzystające z kwalifikujących się ofert dla firm z aktualnym zatwierdzeniem Adyen mogą używać bramki Adyen na platformie Shopify. Zatwierdzone organizacje zachowują obecny dostęp bez zmian w sposobie przetwarzania płatności. Organizacje bez zatwierdzenia lub sklepy, które nie korzystają z kwalifikującej się oferty dla firm, nie mogą aktywować bramki Adyen. Zalecanym rozwiązaniem płatniczym dla tych sprzedawców jest Shopify Payments.

Jeśli organizacja posiada istniejące zatwierdzenie Adyen, sklep musi również spełniać następujące wymagania:

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.
  • Zgodność metody płatności za subskrypcję może się różnić: aplikacja płatnicza Adyen obsługuje subskrypcje za pośrednictwem aplikacji subskrypcyjnych zintegrowanych z systemem realizacji zakupu Shopify, ale nie każda metoda płatności Adyen może być używana dla produktów subskrypcyjnych. Cykliczne fakturowanie wymaga metody płatności i konfiguracji bramki Adyen obsługujących płatności okresowe, dlatego lokalne, ręczne i oparte na rozwiązaniach innych niż karty kredytowe metody płatności mogą być niedostępne.
  • 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 będzie można aktywować bramkę Adyen, Twoja organizacja musi korzystać z kwalifikującej się oferty dla firm i posiadać aktualne zatwierdzenie Adyen. Jeśli dodajesz dodatkowy sklep w ramach swojej organizacji, skontaktuj się ze swoim menedżerem rozwoju sprzedawcy, aby potwierdzić dostęp. Jeśli Twoja organizacja ma zatwierdzenie, ale nie współpracuje z menedżerem rozwoju sprzedawcy, skontaktuj się z Pomocą techniczną Shopify, aby poprosić o dostęp.

Kroki:

  1. W panelu administracyjnym Shopify przejdź do opcji Ustawienia > Płatności.

  2. W sekcji Shopify Payments kliknij opcję Zarządzaj.

  3. Kliknij opcję Przełącz na zewnętrznego dostawcę, a następnie kliknij ją ponownie, aby potwierdzić.

  4. Wybierz opcję Adyen Payments - Credit Cards z listy dostępnych dostawców płatności. Jeśli aplikacja nie wyświetla się na liście, skontaktuj się z Pomocą techniczną Shopify.

  5. Kliknij opcję Zarządzaj kontem.

  6. W razie potrzeby zezwól rozszerzeniu płatności Adyen na dostęp do danych sklepu i ich modyfikację.

  7. Na stronie Konfiguracja płatności Adyen wybierz konto Adyen, którego chcesz używać w swoim sklepie Shopify.

  8. 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:

  1. W panelu administracyjnym Shopify przejdź do opcji Ustawienia > Płatności.

  2. W sekcji wybranego dostawcy płatności kliknij Zarządzaj.

  3. 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:

  1. W panelu administracyjnym Shopify przejdź do opcji Ustawienia > Płatności.

  2. W sekcji Adyen Payments - Credit Cards kliknij Zarządzaj.

  3. Kliknij opcję Więcej akcji, a następnie kliknij Zarządzaj.

  4. W pasku adresu przeglądarki dodaj ciąg ?credit_card_installments=1 na końcu adresu URL, a następnie naciśnij klawisz Enter na klawiaturze.

  5. Opcje konfiguracji rat wyświetlają się na dole strony.

  6. 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.

  7. 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:

  1. W panelu administracyjnym Shopify przejdź do opcji Zamówienia > Wersje robocze.

  2. Kliknij Utwórz zamówienie.

  3. Dodaj produkt i informacje o kliencie.

  4. Kliknij Pobierz płatność, a następnie wybierz preferowaną metodę płatności.

  5. 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ć:

  1. Sprawdź w portalu Adyen, czy płatność została pobrana.
  2. Jeśli płatność została pobrana, utwórz wersję roboczą zamówienia w Shopify.
  3. Oznacz wersję roboczą zamówienia jako opłaconą i zrealizuj ją zgodnie z procedurą.
  4. 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ć:

  1. Sprawdź w portalu Adyen, ile płatności zostało faktycznie pobranych.
  2. 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.
  3. 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ć:

  1. Sprawdź status płatności zarówno w panelu administracyjnym Shopify, jak i w portalu Adyen.
  2. 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ć:

  1. Odczekaj 10–15 minut na synchronizację statusu płatności między systemem Adyen a platformą Shopify.
  2. 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 Twój sklep nie kwalifikuje się lub nie ma zatwierdzenia na korzystanie z bramki Adyen. Dostęp jest ograniczony do organizacji korzystających z kwalifikujących się ofert dla firm z aktualnym zatwierdzeniem Adyen.

Co należy zrobić:

  1. Potwierdź, że Twoja organizacja korzysta z kwalifikującej się oferty dla firm i ma aktualne zatwierdzenie Adyen.
  2. Skontaktuj się z menedżerem rozwoju sprzedawcy lub przedstawicielem handlowym Shopify, aby aktywować bramkę Adyen w swoim sklepie. Jeśli nie współpracujesz z żadną z tych osób, skontaktuj się z Pomocą techniczną Shopify, aby poprosić o dostęp.
  3. Jeśli Twoja organizacja nie kwalifikuje się lub nie ma aktualnego zatwierdzenia, nie możesz aktywować bramki Adyen. Zapoznaj się z wymaganiami kwalifikacyjnymi dla bramki Adyen na platformie Shopify.
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ć:

  1. Potwierdź, że aplikacja Adyen Payments - Credit Cards jest zainstalowana i aktywna.
  2. Sprawdź, czy lokalne metody płatności są prawidłowo skonfigurowane na koncie Adyen.
  3. 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 systemem realizacji zakupu Shopify. Jednak nie każdej metody płatności Adyen można użyć w przypadku produktów subskrypcyjnych. Rozliczenia okresowe wymagają metody płatności i konfiguracji bramki Adyen obsługujących płatności okresowe, dlatego lokalne, ręczne i oparte na rozwiązaniach innych niż karty kredytowe metody płatności mogą być niedostępne.

Jeśli musisz przenieść istniejące subskrypcje do bramki Adyen lub potwierdzić, czy określona metoda płatności Adyen może być używana do subskrypcji, skontaktuj się z menedżerem rozwoju sprzedawcy lub przedstawicielem handlowym Shopify w celu omówienia dostępnych opcji.

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:

  • Aktywacja bramki płatniczej Adyen na platformie Shopify dla sklepów w organizacji posiadającej istniejące zatwierdzenie
  • 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: