Xác thực địa chỉ cho quy trình thanh toán thương mại điện tử

Mục tiêu

Tài liệu này mô tả các phương thức kết hợp tính năng Tự động hoàn thành địa điểm, API xác thực địa chỉ1 và Maps trong quy trình thanh toán thương mại điện tử nhằm mục đích thu thập các địa chỉ chất lượng cao.

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

Bạn nên nắm rõ những thông tin sau:

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

Xác thực địa chỉ là gì?

API xác thực địa chỉ là một dịch vụ chấp nhận một địa chỉ. Lớp này xác định các thành phần địa chỉ và xác thực các thành phần đó. Lớp này cũng chuẩn hoá địa chỉ để gửi thư và tìm toạ độ vĩ độ/kinh độ phổ biến nhất của địa chỉ đó. Nếu muốn, đối với các địa chỉ ở Hoa Kỳ và Puerto Rico, bạn có thể bật Hệ thống hỗ trợ độ chính xác lập trình (CASSTM).

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 khả năng thực hiện đơn hàng đúng thời điểm và giảm chi phí sửa lỗi tốn kém.

Hướng dẫn khách hàng nhập địa chỉ nhanh chóng và chính xác:
Tính năng Tự động hoàn thành giúp tăng tốc độ nhập địa chỉ và giảm lỗi nhập địa chỉ, cho phép khách hàng dễ dàng di chuyển qua quy trình thanh toán. Tính năng 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ỉ, chỉnh sửa các lỗi như chuẩn hoá và đánh vần, đồng thời cải thiện siêu dữ liệu, chẳng hạn như cung cấp chỉ báo nhà ở hoặc chỉ báo thương mại (có sẵn ở một số khu vực.

Tổng quan về hoạt động triển khai

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

  1. Sử dụng tính năng Tự động hoàn thành địa điểm để lấy được địa chỉ lúc ban đầu.
  2. Sử dụng API Xác thực địa chỉ để xác nhận địa chỉ đã nhập.
  3. Hiển thị vị trí của địa chỉ đã nhập trên bản đồ để giúp khách hàng yên tâm giao hàng.

Tiếp theo, chúng ta sẽ tìm hiểu kỹ hơn về từng bước.

Bước 1: Quy trình nhập địa chỉ – bằng cách sử dụng dịch vụ Tự động hoàn thành địa điểm

Triển khai tính năng Tự động hoàn thành bằng cách sử dụng API JavaScript trên dòng đầu tiên của biểu mẫu nhập địa chỉ.

Tính năng Tự động hoàn thành sẽ cung cấp đề xuất cho khách hàng khi họ nhập thông tin về địa chỉ. Khi được triển khai bằng API JavaScript, khi người dùng bắt đầu nhập, một trình đơn thả xuống sẽ xuất hiện trong trường biểu mẫu nhập địa chỉ, cho thấy kết quả của dịch vụ Tự động hoàn thành (được cập nhật sau mỗi lần nhấn phím). 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. Thao tác này sẽ tự động điền dữ liệu địa chỉ vào các trường biểu mẫu.

Bạn có thể cung cấp 2 kiểu mục nhập biểu mẫu cho người dùng bằng tính năng Tự động hoàn thành địa điểm: màn hình hiển thị có tất cả các trường địa chỉ hoặc màn hình hiển thị có một trường nhập dữ liệu duy nhất. Trường nhập dữ liệu 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 công việc 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 lại và chỉnh sửa, chẳng hạn như thêm số căn hộ hoặc số căn hộ.

Dưới đây là ví dụ về cách luồng này có thể xuất hiện, sử dụng một trường nhập duy nhất:

hình ảnh

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

Sau khi người dùng nhập địa chỉ, bạn nên gọi API Xác thực địa chỉ ở bước thanh toán để xác nhận rằng địa chỉ đó là hợp lệ và đầy đủ. Kích hoạt lệnh gọi đến API xác thực địa chỉ 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 API xác thực địa chỉ cho mọi giao dịch.

Sơ đồ quy trình sau đây minh hoạ một ví dụ về quá trình tích hợp toàn diện của API Xác thực địa chỉ trong quy trình thanh toán:

hình ảnh

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

Bước 3: Cung cấp hình ảnh xác nhận

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 đồ. Nhờ đó, khách hàng có thể yên tâm hơn rằng địa chỉ đã chính xác và giúp giảm thiểu trường hợp không thể giao hàng hoặc đến lấy hàng.

Bản đồ này có thể xuất hiện trong quy trình thanh toán hoặc được gửi 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.

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

Tìm hiểu chuyên sâu – xử lý các trường hợp chấp nhận

Phản hồi của API xác thực địa chỉ có thể được phân loại thành ba trường hợp chính:

  • Khắc phục – địa chỉ có chất lượng thấp. Bạn nên nhắc để biết thêm thông tin.
  • Xác nhận – địa chỉ có chất lượng cao, nhưng có những thay đổi so với địa chỉ nhập vào. Bạn có thể nhắc để 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ỉ mà mình 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 về API Xác thực địa chỉ. Chúng ta sẽ thảo luận từng tình huống trong phần này.

Khắc phục

hình ảnh

Phần này trình bày cách chỉnh sửa thông tin địa chỉ đã nhập. Để biết thông tin về các tín hiệu cụ thể mà API xác thực địa chỉ trả về nhằm chỉ ra địa chỉ chất lượng thấp, hãy xem phần Khắc phục một địa chỉ trong tài liệu Tạo logic xác thực.

Nếu phản hồi từ API xác thực địa chỉ cho thấy đị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 họ đã nhập. Sau khi địa chỉ được khắc phục, dịch vụ của bạn sẽ gửi lại tới API xác thực địa chỉ để đảm bảo rằng nội dung sửa lỗi là hợp lệ.

Bạn cũng có thể làm nổi bật các lỗi cụ thể đối với 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 trình bày cách xác nhận địa chỉ. Để biết thông tin về các tín hiệu cụ thể mà API xác thực địa chỉ trả về để cho biết một địa chỉ cần được xác nhận, hãy xem phần Xác nhận địa chỉ trong tài liệu Tạo logic xác thực.

Thông thường, hệ thống của bạn sẽ muốn nhắc người dùng xác nhận địa chỉ. Ví dụ: một khách hàng viết sai chính tả tên thành phố, sau đó, API Xác thực địa chỉ sẽ sửa lại. Bạn nên xác nhận kết quả khắc phục này với khách hàng. Lý do là 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 cửa sổ xen kẽ để hiển thị thông tin cho khách hàng, bật 3 lựa chọn để tiếp tục:

  1. Xác nhận địa chỉ do API trả về để quy trình thanh toán sẽ tiếp tục bằng cách sử dụng địa chỉ đã sửa.
  2. Chọn địa chỉ như đã nhập ban đầu, bỏ qua nội dung sửa lỗi khỏi API Xác thực địa chỉ. 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 về sau trước khi giao hàng, nếu quy trình của bạn cho phép.
  3. Khách hàng huỷ hoặc quay lại cửa sổ phụ, đưa họ trở lại giai đoạn nhập địa chỉ của quy trình thanh toán. Tại đây, họ có thể nhập lại địa chỉ từ đầu và bắt đầu lại quy trình.

Bạn có thể xem ví dụ 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 một địa chỉ. Để biết thông tin về các tín hiệu cụ thể mà API xác thực địa chỉ trả về nhằm cho biết một địa chỉ có chất lượng tốt và cần được chấp nhận, hãy xem phần Chấp nhận một địa chỉ trong tài liệu Tạo 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 khoản thanh toán mà không cần nhắc khách hàng về chất lượng xử lý vấn đề. API đã xác nhận rằng địa chỉ mà 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ừ API xác thực địa chỉ theo đơn đặt hàng, vì dữ liệu này có thể chứa các nội dung chỉnh sửa và bổ sung nhỏ, chẳng hạn như:

  • Cách viết hoa
  • Sửa đổi định dạng, ví dụ:
    • Đường đến St
    • Thứ tự chính xác của các thành phần địa chỉ
  • ZIP+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 cách 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 có một vòng lặp vô hạn nếu API nhiều lần cho biết mục nhập của chúng là không hợp lệ.

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

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

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

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 xác thực, để người đạ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 giúp đảm bảo bạn phát hiện được mọi sai sót.

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

Sau khi hoàn tất phiên thanh toán, bạn có thể sử dụng phương thức provideValidationFeedback (không bắt buộc) để gửi ý kiến phản hồi cho Google về một lần thử xác thực địa chỉ cụ thể.

Kết luận

Tài liệu này đã đưa ra 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 bắt đầu để thiết kế phương thức triển khai, theo các quy trình nhập địa chỉ được đề xuất.

Các bước tiếp theo

Tải xuống Sách trắng để cải thiện quy trình thanh toán, việc giao hàng và hoạt động với địa chỉ đáng tin cậy và xem Hội thảo trực tuyến về Cải thiện quy trình thanh toán, giao hàng và hoạt động bằng tính năng xác thực địa chỉ .

Bạn nên đọc thêm:

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 thuộc sở hữu của United States Postal Service® và được sử dụng khi được phép: CASSTM, USPS®, DPV®.