Weryfikacja adresu podczas płatności

Cel

Z tego dokumentu dowiesz się, jak łączyć autouzupełnianie miejsc, Address Validation API1 i Mapy w procesie płatności w e-commerce, aby uzyskiwać adresy wysokiej jakości.

Wymagania wstępne

Google zaleca zapoznanie się z tymi materiałami:

  • Autouzupełnianie miejsc JavaScript dokumentacja dla deweloperów.
    • Z technicznego punktu widzenia dowiedz się, jak działa autouzupełnianie miejsc i jakie są opcje jego implementacji.
  • Przewodnik po wdrażaniu procesu płatności w przypadku autouzupełniania miejsc.
    • Przykłady sprawdzonych metod wdrażania autouzupełniania miejsc w procesie płatności w e-commerce.
  • Dokumentacja produktu Address Validation API ze szczególnym uwzględnieniem sekcji Tworzenie logiki weryfikacji.
    • Z technicznego punktu widzenia dowiedz się, jak działa Address Validation API działa, i zapoznaj się z sygnałami, które określają jakość adresu.

Na czym polega weryfikacja adresu?

Address Validation API to usługa, która akceptuje adres. Identyfikuje komponenty adresu i weryfikuje je. Standaryzuje też adres na potrzeby wysyłki pocztą i znajduje dla niego najlepiej dopasowane współrzędne szerokości i długości geograficznej. Opcjonalnie w przypadku adresów w Stanach Zjednoczonych i Portoryko możesz włączyć system CASS™ (Coding Accuracy Support System).

Dlaczego weryfikacja adresu jest potrzebna w procesie płatności?

Zbieraj dokładne adresy podczas procesu składania zamówienia:
jest to ważny krok, który pomaga zapewnić dostarczenie przesyłki, zwiększa odsetek dostaw na czas i zmniejsza koszty związane z korektą adresu.

Pomóż klientom szybko i dokładnie wpisywać adresy:
autouzupełnianie miejsc przyspiesza wpisywanie adresu i zmniejsza liczbę błędów, dzięki czemu klienci mogą łatwo przejść przez proces płatności. Weryfikacja adresów przekazuje informacje o ogólnej jakości adresu, wprowadza poprawki, takie jak standaryzacja i korekta błędów ortograficznych, oraz wzbogaca metadane, np. podając wskaźnik adresu domowego lub firmowego (dostępny w wybranych regionach).

Omówienie wdrożenia

W tej sekcji opisujemy zalecany proces wpisywania adresu w procesie płatności w e-commerce. Składa się on z 3 etapów:

  1. Użyj autouzupełniania miejsc, aby wstępnie uzyskać adres.
  2. Użyj Address Validation API, aby potwierdzić wpisany adres.
  3. Wyświetl lokalizację wpisanego adresu na mapie, aby zwiększyć zaufanie klientów do dostawy.

Teraz omówimy każdy z tych etapów.

Krok 1. Proces wpisywania adresu – korzystanie z usługi autouzupełniania miejsc

Zaimplementuj autouzupełnianie miejsc za pomocą interfejsu JavaScript API w pierwszym wierszu formularza wpisywania adresu.

Autouzupełnianie miejsc podaje sugestie klientowi podczas wpisywania danych adresu. Gdy usługa jest zaimplementowana za pomocą interfejsu JavaScript API, po rozpoczęciu wpisywania przez użytkownika pod polem formularza wpisywania adresu pojawia się menu rozwijane z wynikami z usługi autouzupełniania, które są aktualizowane po każdym naciśnięciu klawisza. Gdy użytkownik wpisze wystarczającą ilość informacji, aby znaleźć adres, wybiera go z menu rozwijanego. Ta czynność automatycznie wypełnia pola formularza danymi adresu.

Możesz udostępnić użytkownikowi 2 style wpisywania w formularzu za pomocą autouzupełniania miejsc: wyświetlanie wszystkich pól adresu lub wyświetlanie jednego pola wejściowego. To pojedyncze pole do wprowadzania danych zachęca użytkownika do rozpoczęcia wyszukiwania podczas wpisywania, zamiast wpisywania poszczególnych komponentów adresu. Gdy autouzupełnianie wypełni adres, proces rozszerza pola formularza o dane adresu, umożliwiając klientowi sprawdzenie i edytowanie, np. dodanie numeru mieszkania lub lokalu.

Oto przykład, jak może wyglądać ten proces, gdy używane jest pojedyncze pole do wprowadzania danych:

obraz

Krok 2. Użyj Address Validation API, aby sprawdzić adresy

Gdy użytkownik wpisze adres, Google zaleca wywołanie Address Validation API w procesie płatności, aby potwierdzić, że adres jest prawidłowy i kompletny. Wywołaj Address Validation API, gdy użytkownik kliknie przycisk Dalej lub Kontynuuj w formularzu adresu. Ten przycisk często prowadzi do strony płatności.

Google zaleca wywoływanie Address Validation API w przypadku każdej transakcji.

Na diagramie poniżej przedstawiono przykład pełnej integracji Address Validation API w procesie płatności:

obraz

W dalszej części tego dokumentu omówimy scenariusze akceptowania adresu.

Krok 3. Potwierdzenie wizualne

Po wpisaniu adresu wyświetl użytkownikowi potwierdzenie wizualne lokalizacji dostawy, pokazując ją na mapie. Daje to klientowi dodatkową pewność, że adres jest prawidłowy, i zmniejsza liczbę nieudanych dostaw lub odbiorów.

Mapę można wyświetlić podczas procesu płatności lub wysłać w e-mailu z potwierdzeniem transakcji. Oba te przypadki użycia można zrealizować za pomocą tych interfejsów API.

Maps JavaScript API udostępnia interaktywną mapę do wyświetlania lokalizacji użytkownika. Maps Static API umożliwia osadzanie obrazów na stronie internetowej lub na późniejszym etapie w e-mailu.

Szczegółowe omówienie – scenariusze akceptowania adresu

Odpowiedzi Address Validation API można podzielić na 3 główne scenariusze:

  • Napraw – adres jest niskiej jakości. Powinieneś/powinnaś poprosić o więcej informacji.
  • Potwierdź – adres jest wysokiej jakości, ale ma zmiany w stosunku do adresu wejściowego. Możesz poprosić o potwierdzenie.
  • Zaakceptuj – adres jest wysokiej jakości. Możesz zaakceptować podany adres.

Ten temat jest omówiony w sekcji Tworzenie logiki weryfikacji w dokumentacji Address Validation API. W tej sekcji omówimy każdy scenariusz.

Napraw

obraz

W tej sekcji dowiesz się, jak poprawić wpisany adres. Informacje o konkretnych sygnałach, które Address Validation API zwraca, aby wskazać adres niskiej jakości , znajdziesz w sekcji Poprawianie adresu w dokumentacji Tworzenie logiki weryfikacji.

Jeśli odpowiedź z Address Validation API wskazuje, że adres jest nieprawidłowy, przekieruj klienta do formularza wpisywania adresu, aby sprawdził wpisane dane. Gdy adres zostanie poprawiony, usługa powinna ponownie wysłać go do Address Validation API, aby upewnić się, że wprowadzone poprawki są prawidłowe.

Możesz też wyróżnić konkretne błędy w wierszu adresu, używając sygnałów zwracanych na poziomie addressComponents. Przykład tego można zobaczyć na zrzucie ekranu po prawej stronie.

Potwierdź

obraz

W tej sekcji dowiesz się, jak potwierdzić adres. Informacje o konkretnych sygnałach, które Address Validation API zwraca, aby wskazać, że adres należy potwierdzić, znajdziesz w sekcji Potwierdzanie adresu w dokumentacji Tworzenie logiki weryfikacji.

Często system będzie chciał poprosić użytkownika o potwierdzenie adresu. Na przykład klient może popełnić błąd w nazwie miasta, który zostanie poprawiony przez Address Validation API. Powinieneś/powinnaś potwierdzić tę poprawkę z klientem. Wynika to z tego, że zmiany wprowadzone przez interfejs API mogą zasadniczo zmienić to, co zostało pierwotnie wpisane.

Użyj modalnego okna pełnoekranowego, aby wyświetlić informacje klientowi, umożliwiając mu wykonanie 3 czynności:

  1. Potwierdź adres zwrócony przez interfejs API, a proces płatności będzie kontynuowany z użyciem poprawionego adresu.
  2. Wybierz adres w pierwotnej postaci, ignorując poprawkę z Address Validation API. Proces płatności może przebiegać normalnie, a zamówienie może zostać oznaczone do sprawdzenia przed wysyłką, jeśli Twój proces na to pozwala.
  3. Klient anuluje lub zamyka okno modalne, wracając do etapu wpisywania adresu w procesie płatności, gdzie może ponownie wpisać adres od początku, rozpoczynając proces od nowa.

Przykład tego można zobaczyć na zrzucie ekranu po prawej stronie.

Zaakceptuj

W tej sekcji dowiesz się, jak zaakceptować adres. Informacje o konkretnych sygnałach, które Address Validation API zwraca, aby wskazać, że adres jest dobrej jakości i należy go zaakceptować, znajdziesz w sekcji Akceptowanie adresu w dokumentacji Tworzenie logiki weryfikacji.

W tym scenariuszu proces płatności powinien przejść do następnego etapu, prawdopodobnie do pobrania płatności, bez wyświetlania klientowi żadnych komunikatów dotyczących jakości adresu. Interfejs API potwierdził, że adres wpisany przez klienta jest dobrej jakości i można go dostarczyć.

Zalecamy używanie danych adresu zwróconych przez Address Validation API w zamówieniu, ponieważ mogą one zawierać drobne poprawki i dodatki, takie jak:

  • użycie wielkich liter,
  • poprawki formatowania, np.
    • zamiana „Ulica” na „Ul.”,
    • prawidłowa kolejność komponentów adresu,
  • kod pocztowy ZIP+4 w Stanach Zjednoczonych.

Uwagi o wdrażaniu

Podczas tworzenia logiki akceptowania adresu upewnij się, że implementacja nie blokuje klientów w procesie płatności z powodu wpisania nieprawidłowego adresu. Zbuduj logikę w taki sposób, aby zapobiec możliwości wystąpienia nieskończonej pętli, jeśli interfejs API wielokrotnie wskazuje, że wpis jest nieprawidłowy.

Google zaleca, aby dać klientom maksymalnie 2 szanse na wpisanie adresu, a przy drugiej próbie zaakceptować wpis, nawet jeśli nie zostanie on zweryfikowany. Przy drugiej próbie celem jest umożliwienie klientowi kontynuowania procesu niezależnie od weryfikacji.

2 sugerowane metody akceptowania drugiej próby:

  • Wymuszenie kontynuacji: wyświetl klientowi okno modalne z informacją, że adres nie został zweryfikowany, ale umożliwiające kontynuowanie procesu z wpisanym adresem.
  • Ciche akceptowanie: automatycznie zaakceptuj drugą próbę bez etapu potwierdzenia, nawet jeśli adres nie zostanie w pełni zweryfikowany.

Jeśli to możliwe, zaprojektuj system tak, aby oznaczał adresy, które nie zostały zweryfikowane, aby pracownik obsługi klienta mógł je sprawdzić przed wysłaniem zamówienia. Ten dodatkowy środek zapewnia wykrycie wszelkich błędów.

Dobrym przykładem, dlaczego zalecamy to sprawdzenie, jest budowa nowego budynku. Może upłynąć trochę czasu między zakończeniem budowy nowego budynku a dodaniem jego adresu do baz danych adresów pocztowych. Klienci powinni mieć możliwość wymuszenia kontynuacji procesu płatności z wpisanym adresem, nawet jeśli nie zostanie on zweryfikowany.

Po zakończeniu sesji płatności możesz opcjonalnie użyć metody provideValidationFeedback, aby wysłać do Google opinię na temat konkretnej próby weryfikacji adresu.

Podsumowanie

Z tego dokumentu dowiesz się, jak wygląda proces płatności, w którym zaimplementowano autouzupełnianie, weryfikację adresu i potwierdzenie wizualne na mapie Google. Użyj tego dokumentu jako punktu wyjścia do zaprojektowania implementacji, postępując zgodnie z zalecanymi procesami wpisywania adresu.

Następne kroki

Sugerowane dalsze lektury:

Współtwórcy

Henrik Valve | Inżynier ds. rozwiązań
Thomas Anglaret | Inżynier ds. rozwiązań
Sarthak Ganguly | Inżynier ds. rozwiązań

  1. Niewyłączny licencjobiorca United States Postal Service. Następujące znaki towarowe należą do United States Postal Service® i są używane za zgodą: CASS™, USPS®, DPV®. ↩