Weryfikacja adresu podczas płatności

Cel

W tym dokumencie opisujemy metody łączenia Autouzupełniania miejsc, interfejsu Address Validation API1 i Map w procesie płatności w e-commerce w celu uzyskiwania wysokiej jakości adresów.

Wymagania wstępne

Google zaleca zapoznanie się z tymi informacjami:

  • Dokumentacja dla programistów dotycząca usługi Autouzupełnianie miejsc w JavaScript.
    • Dowiedz się z technicznego punktu widzenia, jak działa autouzupełnianie miejsc i jakie są opcje jego wdrożenia.
  • Przewodnik po implementacji płatności w przypadku Autouzupełniania miejsc
    • Przykłady sprawdzonych metod wdrażania autouzupełniania miejsc na stronie płatności w sklepie internetowym.
  • Dokumentacja produktu Address Validation API, ze szczególnym uwzględnieniem tworzenia logiki weryfikacji.
    • Poznaj od strony technicznej działanie interfejsu Address Validation API i sprawdź sygnały, 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 je weryfikuje. Standaryzuje też adres na potrzeby wysyłki pocztą i określa dla niego najlepiej dopasowane współrzędne określające szerokość i długość geograficzną. Opcjonalnie w przypadku adresów w Stanach Zjednoczonych i Portoryko możesz włączyć system CASS™.

Dlaczego podczas płatności muszę potwierdzić adres?

Zbieraj dokładne adresy podczas procesu składania zamówienia:
Jest to ważny krok w promowaniu udanych dostaw, zwiększaniu terminowości realizacji i ograniczaniu kosztownych opłat za 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 adresu przekazuje informacje zwrotne na temat ogólnej jakości adresu, wprowadza poprawki, takie jak standaryzacja i korekta błędów pisowni, oraz wzbogaca metadane, np. podając wskaźnik adresu prywatnego lub komercyjnego (dostępny w wybranych regionach).

Omówienie wdrożenia

W tej sekcji opisujemy zalecany przepływ pracy związany z wpisywaniem adresu podczas płatności w sklepach internetowych. Proces ten składa się z 3 etapów:

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

Następnie szczegółowo omówimy każdy krok.

Krok 1. Proces wpisywania adresu – korzystanie z usługi Autouzupełnianie miejsc

Wdróż automatyczne uzupełnianie miejsca za pomocą interfejsu JavaScript API w pierwszym wierszu formularza wpisywania adresu.

Autouzupełnianie miejsca wyświetla klientowi sugestie podczas wpisywania szczegółów adresu. Gdy użytkownicy zaczną wpisywać tekst, pod polem formularza adresu pojawi się menu z wynikami z usługi Autocomplete, które będą się aktualizować po każdym naciśnięciu klawisza. Gdy użytkownik wpisze wystarczającą ilość informacji, aby znaleźć adres, wybiera go z menu. Spowoduje to automatyczne wypełnienie pól formularza danymi adresu.

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

Oto przykład, jak może wyglądać ten proces w przypadku 1 pola do wprowadzania danych:

obraz

Krok 2. Weryfikowanie adresów za pomocą interfejsu Address Validation API

Gdy użytkownik wpisze adres, zalecamy wywołanie interfejsu Address Validation API podczas płatności, aby potwierdzić, że adres jest prawidłowy i kompletny. Wywołaj interfejs 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 interfejsu Address Validation API w przypadku każdej transakcji.

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

obraz

Scenariusze akceptacji adresu omówimy w dalszej części tego dokumentu.

Krok 3. Prześlij potwierdzenie wizualne

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

Mapa może być wyświetlana podczas procesu płatności lub wysyłana w e-mailu z potwierdzeniem transakcji. Oba te przypadki użycia można zrealizować za pomocą tych interfejsów API:

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

Szczegółowe omówienie – scenariusze akceptacji adresu

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

  • Popraw – adres jest niskiej jakości. Poproś o więcej informacji.
  • Potwierdź – adres jest wysokiej jakości, ale różni się od adresu wejściowego. Może pojawić się prośba o potwierdzenie.
  • Accept (Zaakceptuj) – adres jest wysokiej jakości. Możesz zaakceptować podany adres.

Ten temat jest omówiony w sekcji Tworzenie logiki weryfikacji w dokumentacji interfejsu 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 zwracanych przez interfejs Address Validation API, które wskazują na niską jakość adresu, znajdziesz w sekcji Poprawianie adresu w dokumentacji Tworzenie logiki weryfikacji.

Jeśli odpowiedź z interfejsu Address Validation API wskazuje, że adres jest nieprawidłowy, przekieruj klienta do formularza wpisywania adresu, aby mógł sprawdzić wprowadzone dane. Po poprawieniu adresu usługa powinna ponownie wysłać go do interfejsu Address Validation API, aby upewnić się, że wprowadzone zmiany są prawidłowe.

Możesz też wyróżnić konkretne błędy w wierszu adresu, korzystając z 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 zwracanych przez interfejs Address Validation API, które wskazują, że adres powinien zostać potwierdzony, znajdziesz w sekcji Potwierdzanie adresu w dokumentacji Tworzenie logiki weryfikacji.

Często system będzie prosić użytkownika o potwierdzenie adresu. Na przykład klient może popełnić błąd w pisowni nazwy miasta, który zostanie poprawiony przez interfejs Address Validation API. Potwierdź z klientem, że problem został rozwiązany. Dzieje się tak, ponieważ zmiany wprowadzone przez interfejs API mogą zasadniczo zmienić pierwotnie wprowadzone dane.

Użyj modalnego okna pełnoekranowego, aby wyświetlić informacje klientowi, umożliwiając mu wybór jednej z 3 opcji:

  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 formie, w jakiej został pierwotnie wpisany, ignorując poprawkę z interfejsu Address Validation API. Proces płatności może przebiegać normalnie, a zamówienie może zostać oznaczone do dalszej weryfikacji przed wysyłką, jeśli Twój proces na to pozwala.
  3. Klient anuluje lub zamyka okno, wracając do etapu wprowadzania adresu w procesie płatności, gdzie może ponownie wpisać adres od zera, rozpoczynając proces od nowa.

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

Zaakceptuj

Z tej sekcji dowiesz się, jak zaakceptować adres. Informacje o konkretnych sygnałach zwracanych przez interfejs Address Validation API, które wskazują, że adres jest dobrej jakości i powinien zostać zaakceptowany, znajdziesz w sekcji Akceptowanie adresu w dokumentacji Tworzenie logiki weryfikacji.

W takim przypadku 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 na niego dostarczyć przesyłkę.

Zalecamy porównanie danych adresu zwróconych przez interfejs Address Validation API z zamówieniem, ponieważ mogą one zawierać drobne poprawki i dodatki, takie jak:

  • Użycie wielkich liter
  • Korekty formatowania, np.
    • Street to St
    • Prawidłowa kolejność elementów adresu
  • ZIP+4 w Stanach Zjednoczonych.

Uwagi o wdrażaniu

Podczas tworzenia logiki akceptacji adresu upewnij się, że wdrożenie nie blokuje klientom możliwości dokonania 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. Przy drugiej próbie zaakceptuj wpis, nawet jeśli nie zostanie on zweryfikowany. Za drugim razem celem jest umożliwienie użytkownikowi przejścia dalej niezależnie od weryfikacji.

Dwie sugerowane metody zaakceptowania drugiej próby:

  • Wymuś kontynuację: wyświetl klientowi okno modalne z informacją, że adres nie jest weryfikowany, ale zezwól na kontynuowanie z wpisanym adresem.
  • Cicha akceptacja: automatyczne akceptowanie drugiej próby 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 krok pozwoli Ci wychwycić wszelkie błędy.

Dobrym przykładem, dlaczego warto przeprowadzić tę kontrolę, 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ść przejścia do strony płatności z wpisanym adresem, nawet jeśli nie zostanie on zweryfikowany.

Po zakończeniu sesji płatności możesz użyć metody provideValidationFeedback do wysłania do Google opinii o konkretnej próbie weryfikacji adresu.

Podsumowanie

Ten dokument zawiera omówienie procesu płatności z implementacją funkcji autouzupełniania, weryfikacji adresu i wizualnego potwierdzenia na mapie Google. Użyj tego dokumentu jako punktu początkowego do zaprojektowania implementacji, korzystając z zalecanych ścieżek wprowadzania adresu.

Następne kroki

Sugerowane dodatkowe materiały:

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. Poniższe znaki towarowe są własnością United States Postal Service® i są używane za zgodą tej firmy: CASS™, USPS®, DPV®. ↩