Xác thực địa chỉ cho quy trình thanh toán

Mục tiêu

Tài liệu này mô tả các phương thức kết hợp Place Autocomplete, Address Validation API1 và Maps trong quy trình thanh toán thương mại điện tử nhằm thu thập địa chỉ chất lượng cao.

Điều kiện tiên quyết

Bạn nên làm quen với những nội dung sau đây:

  • Tài liệu dành cho nhà phát triển JavaScript về Place Autocomplete.
    • Hiểu về mặt kỹ thuật cách hoạt động của Place Autocomplete và các lựa chọn triển khai.
  • Hướng dẫn triển khai quy trình thanh toán cho Place Autocomplete.
    • Ví dụ về các phương pháp hay nhất khi triển khai Place Autocomplete trong quy trình thanh toán thương mại điện tử.
  • Tài liệu về sản phẩm Address Validation API , tập trung vào phần Xây dựng logic xác thực.
    • Hiểu về mặt kỹ thuật cách hoạt động của Address Validation API và xem xét các tín hiệu xác định chất lượng địa chỉ.

Quy trình xác thực địa chỉ là gì?

Address Validation API là một dịch vụ chấp nhận địa chỉ. Dịch vụ này xác định các thành phần của địa chỉ và xác thực các thành phần đó. Dịch vụ này cũng chuẩn hoá địa chỉ để gửi thư và tìm toạ độ vĩ độ/kinh độ được biết đến nhiều nhất cho địa chỉ đó. Bạn có thể bật Hệ thống hỗ trợ độ chính xác của mã (CASS™) cho các địa chỉ ở Hoa Kỳ và Puerto Rico.

Tại sao bạn cần xác thực địa chỉ khi thanh toán?

Thu thập địa chỉ chính xác trong quá trình đặt hàng:
Đây là một bước quan trọng để thúc đẩy việc giao hàng thành công, tăng tỷ lệ hoàn tất đúng hạn và giảm chi phí tốn kém cho việc chỉnh sửa địa chỉ.

Hướng dẫn khách hàng nhập địa chỉ một cách nhanh chóng và chính xác:
Place Autocomplete giúp tăng tốc độ nhập địa chỉ và giảm lỗi nhập, cho phép khách hàng dễ dàng thực hiện quy trình thanh toán. Xác thực địa chỉ cung cấp ý kiến phản hồi về chất lượng tổng thể của địa chỉ, thực hiện các chỉnh sửa như chuẩn hoá và sửa lỗi chính tả, đồng thời tăng cường siêu dữ liệu, chẳng hạn như cung cấp chỉ báo về địa chỉ nhà ở hoặc địa chỉ thương mại (có ở một số khu vực).

Tổng quan về quy trình triển khai

Phần này trình bày quy trình nhập địa chỉ được đề xuất cho quy trình thanh toán thương mại điện tử. Quy trình này bao gồm 3 bước:

  1. Sử dụng Place Autocomplete để thu thập địa chỉ ban đầu.
  2. Sử dụng Address Validation API để xác nhận địa chỉ đã nhập.
  3. Hiển thị vị trí của địa chỉ đã nhập trên bản đồ để khách hàng tin tưởng vào việc giao hàng.

Tiếp theo, chúng ta sẽ đi sâu vào từng bước.

Bước 1: Quy trình nhập địa chỉ – sử dụng dịch vụ Place Autocomplete

Triển khai Place Autocomplete bằng JavaScript API trên dòng đầu tiên của biểu mẫu nhập địa chỉ.

Place Autocomplete cung cấp các đề xuất cho khách hàng khi họ nhập thông tin chi tiết về địa chỉ. Khi được triển khai bằng JavaScript API, khi người dùng bắt đầu nhập, một trình đơn thả xuống sẽ xuất hiện bên dưới trường biểu mẫu nhập địa chỉ, cho thấy kết quả từ dịch vụ Tự động hoàn thành được cập nhật theo từng lần nhấn phím. Sau khi người dùng nhập đủ thông tin để tìm địa chỉ, họ sẽ chọn địa chỉ đó trong trình đơn thả xuống. Hành động này sẽ tự động điền dữ liệu địa chỉ vào các trường trong biểu mẫu.

Bạn có thể cung cấp 2 kiểu nhập biểu mẫu cho người dùng bằng Place Autocomplete: một kiểu hiển thị tất cả các trường địa chỉ hoặc một kiểu hiển thị một trường nhập duy nhất. Trường nhập dữ liệu duy nhất này nhắc người dùng bắt đầu tìm kiếm khi họ nhập, thay vì nhập từng thành phần địa chỉ. Sau khi tính năng tự động hoàn thành điền địa chỉ, quy trình sẽ mở rộng các trường trong biểu mẫu bằng dữ liệu địa chỉ, cho phép khách hàng xem xét và chỉnh sửa, chẳng hạn như thêm số căn hộ hoặc số nhà.

Sau đây là ví dụ về cách quy trình này có thể xuất hiện khi sử dụng một trường nhập dữ liệu duy nhất:

hình ảnh

Bước 2: Sử dụng Address Validation API để xác thực địa chỉ

Sau khi người dùng nhập địa chỉ, Google khuyên bạn nên gọi Address Validation API khi thanh toán để xác nhận rằng địa chỉ đó hợp lệ và đầy đủ. Kích hoạt lệnh gọi đến Address Validation API khi người dùng nhấp vào nút Tiếp theo hoặc Tiếp tục trên biểu mẫu địa chỉ. Nút này thường dẫn đến trang thanh toán.

Bạn nên gọi Address Validation API cho mọi giao dịch.

Sơ đồ quy trình sau đây minh hoạ ví dụ về quy trình tích hợp toàn diện Address Validation API trong quy trình thanh toán:

hình ảnh

Tài liệu này sẽ thảo luận về các trường hợp chấp nhận địa chỉ sau.

Bước 3: Cung cấp thông tin xác nhận bằng hình ảnh

Sau khi nhập địa chỉ, hãy cung cấp cho người dùng thông tin xác nhận bằng hình ảnh về vị trí giao hàng bằng cách hiển thị vị trí đó trên bản đồ. Điều này giúp khách hàng yên tâm hơn rằng địa chỉ là chính xác và giảm thiểu tình trạng giao hàng hoặc nhận hàng không thành công.

Bạn có thể hiển thị bản đồ trong quá trình thanh toán hoặc gửi bản đồ trong email xác nhận giao dịch. Bạn có thể thực hiện cả hai trường hợp sử dụng này bằng các API sau.

Maps JavaScript API cung cấp một bản đồ tương tác để hiển thị vị trí của người dùng. Maps Static API cho phép nhúng hình ảnh trong trang web hoặc ở giai đoạn sau trong email.

Tìm hiểu sâu – các trường hợp chấp nhận địa chỉ

Bạn có thể phân loại các phản hồi của Address Validation API thành 3 trường hợp chính:

  • Khắc phục—địa chỉ có chất lượng thấp. Bạn nên yêu cầu cung cấp thêm thông tin.
  • Xác nhận – địa chỉ có chất lượng cao nhưng có thay đổi so với địa chỉ nhập. Bạn có thể yêu cầu xác nhận.
  • Chấp nhận—địa chỉ có chất lượng cao. Bạn có thể chấp nhận địa chỉ được cung cấp.

Khái niệm này được đề cập trong phần Xây dựng logic xác thực của tài liệu Address Validation API và chúng ta sẽ thảo luận về từng trường hợp trong phần này.

Cách khắc phục

hình ảnh

Phần này cho biết cách khắc phục lỗi nhập địa chỉ. Để biết thông tin về các tín hiệu cụ thể mà Address Validation API trả về để cho biết địa chỉ có chất lượng thấp, hãy xem phần Khắc phục địa chỉ trong tài liệu Xây dựng logic xác thực.

Nếu phản hồi từ Address Validation API cho biết địa chỉ không hợp lệ, hãy chuyển hướng khách hàng đến biểu mẫu nhập địa chỉ để kiểm tra dữ liệu đã nhập. Sau khi địa chỉ được khắc phục, dịch vụ của bạn phải gửi lại đến Address Validation API để đảm bảo các chỉnh sửa được thực hiện là hợp lệ.

Bạn cũng có thể làm nổi bật các lỗi cụ thể trên dòng địa chỉ bằng cách sử dụng các tín hiệu được trả về ở cấp addressComponents. Bạn có thể xem ví dụ về vấn đề này trong ảnh chụp màn hình ở bên phải.

Xác nhận

hình ảnh

Phần này cho biết cách xác nhận địa chỉ. Để biết thông tin về các tín hiệu cụ thể mà Address Validation API trả về để cho biết cần xác nhận địa chỉ, hãy xem phần Xác nhận địa chỉ trong tài liệu Xây dựng logic xác thực.

Hệ thống của bạn thường sẽ nhắc người dùng xác nhận địa chỉ. Ví dụ: khách hàng viết sai tên thành phố, sau đó Address Validation API sẽ sửa tên thành phố đó. Bạn nên xác nhận bản sửa lỗi này với khách hàng. Lý do là vì các thay đổi do API thực hiện có thể làm thay đổi cơ bản nội dung đã nhập ban đầu.

Sử dụng phương thức xen kẽ để hiển thị thông tin cho khách hàng, cho phép 3 lựa chọn để tiếp tục:

  1. Xác nhận địa chỉ do API trả về và quy trình thanh toán tiếp tục bằng địa chỉ đã sửa.
  2. Chọn địa chỉ đã nhập ban đầu, bỏ qua bản sửa lỗi của Address Validation API. Quy trình thanh toán có thể tiếp tục như bình thường và đơn đặt hàng có thể được gắn cờ để xem xét ở giai đoạn sau trước khi vận chuyển, nếu quy trình của bạn cho phép.
  3. Khách hàng huỷ hoặc thoát khỏi phương thức, đưa họ trở lại giai đoạn nhập địa chỉ của quy trình thanh toán, nơi họ có thể nhập lại địa chỉ từ đầu, bắt đầu lại quy trình.

Bạn có thể xem ví dụ về vấn đề này trong ảnh chụp màn hình ở bên phải.

Chấp nhận

Phần này cho biết cách chấp nhận địa chỉ. Để biết thông tin về các tín hiệu cụ thể mà Address Validation API trả về để cho biết địa chỉ có chất lượng tốt và nên được chấp nhận, hãy xem phần Chấp nhận địa chỉ trong tài liệu Xây dựng logic xác thực.

Trong trường hợp này, quy trình thanh toán sẽ chuyển sang giai đoạn tiếp theo, có thể là thu thập thông tin thanh toán, mà không có lời nhắc nào cho khách hàng về chất lượng địa chỉ. API đã xác nhận rằng địa chỉ do khách hàng nhập có chất lượng tốt và có thể giao hàng.

Bạn nên sử dụng dữ liệu địa chỉ được trả về từ Address Validation API so với đơn đặt hàng, vì dữ liệu này có thể chứa các chỉnh sửa và bổ sung nhỏ, chẳng hạn như sau:

  • Cách viết hoa
  • Chỉnh sửa định dạng, ví dụ:
    • Đường thành Đường
    • Sắp xếp chính xác các thành phần địa chỉ
  • Mã bưu chính + 4 ở Hoa Kỳ.

Cân nhắc khi triển khai

Khi xây dựng logic chấp nhận địa chỉ, hãy đảm bảo rằng quá trình triển khai của bạn không chặn khách hàng thanh toán do nhập địa chỉ không hợp lệ. Xây dựng logic theo cách ngăn chặn khả năng xảy ra vòng lặp vô hạn nếu API liên tục cho biết địa chỉ nhập của họ không hợp lệ.

Bạn nên cho khách hàng tối đa 2 cơ hội để nhập địa chỉ và ở lần nhập thứ hai, hãy chấp nhận địa chỉ đó, ngay cả khi địa chỉ đó không hợp lệ. Ở lần nhập thứ hai, mục tiêu là cho phép họ tiếp tục bất kể quá trình xác thực.

Hai phương thức được đề xuất để chấp nhận lần nhập thứ hai:

  • Buộc tiếp tục: Hiển thị cho khách hàng một phương thức giải thích rằng địa chỉ không hợp lệ, nhưng cho phép họ tiếp tục với địa chỉ đã nhập.
  • Chấp nhận âm thầm: Tự động chấp nhận lần nhập thứ hai mà không cần bước xác nhận, ngay cả khi địa chỉ không hoàn toàn hợp lệ.

Nếu có thể, hãy thiết kế hệ thống của bạn để gắn cờ các địa chỉ không hợp lệ, để đại diện dịch vụ khách hàng có thể xem xét các địa chỉ đó trước khi đơn đặt hàng được vận chuyển. Biện pháp bổ sung này đảm bảo bạn phát hiện mọi lỗi.

Việc xây dựng toà nhà mới là một ví dụ minh hoạ rõ ràng về lý do bạn nên kiểm tra này. Có thể có khoảng thời gian giữa thời điểm xây dựng toà nhà mới hoàn tất và thời điểm địa chỉ của toà nhà đó được điền vào cơ sở dữ liệu địa chỉ bưu chính. Khách hàng nên có thể buộc tiếp tục qua trang thanh toán bằng địa chỉ đã nhập, ngay cả khi địa chỉ đó không hợp lệ.

Sau khi hoàn tất phiên thanh toán, bạn có thể sử dụng provideValidationFeedback phương thức để gửi Google Feedback về một lần Xác thực địa chỉ cụ thể.

Kết luận

Tài liệu này đã cung cấp thông tin tổng quan về quy trình thanh toán triển khai tính năng Tự động hoàn thành, Xác thực địa chỉ và xác nhận bằng hình ảnh trên Google Maps. Hãy sử dụng tài liệu này làm điểm khởi đầu để thiết kế quá trình triển khai của bạn, theo các quy trình nhập địa chỉ được đề xuất.

Các bước tiếp theo

Tài liệu đọc thêm được đề xuất:

Người đóng góp

Henrik Valve | Kỹ sư giải pháp
Thomas Anglaret | Kỹ sư giải pháp
Sarthak Ganguly | Kỹ sư giải pháp

  1. Bên được cấp phép không độc quyền của Dịch vụ Bưu chính Hoa Kỳ. Các nhãn hiệu sau đây thuộc sở hữu của Dịch vụ Bưu chính Hoa Kỳ® và được sử dụng khi có sự cho phép: CASS™, USPS®, DPV®. ↩