Tính năng Đăng ký thẻ quà tặng (đăng nhập) cho phép người dùng tìm kiếm thẻ quà tặng và thêm thẻ đó vào Google Wallet. Người dùng sẽ được chuyển hướng đến trang web thân thiện với thiết bị di động của bạn để hoàn tất quy trình. Sau đó, họ có thể thêm thẻ vào Google Wallet.
Hướng dẫn này cung cấp thông tin tổng quan về các bước triển khai bắt buộc để bật tính năng này cho chương trình thẻ quà tặng.
Tổng quan
Để bắt đầu, hãy đảm bảo rằng bạn đã thiết lập dự án và có quyền truy cập vào API Google Wallet.
Bạn phải làm theo 4 bước sau để triển khai tính năng đăng nhập cho chương trình thẻ quà tặng:
- Thiết lập một lớp kiểm thử trong Google Wallet để kiểm thử quy trình đăng nhập.
- Phát triển các trang đăng nhập sử dụng
SharedDataTypeGoogle Wallet. - Triển khai tính năng đẩy thẻ quà tặng trở lại Google Wallet sau khi đăng nhập.
- Yêu cầu xác minh và kích hoạt.
Thiết lập lớp kiểm thử trong Google Wallet
Xác định URL đăng nhập, biểu trưng chương trình. Sau đó, sử dụng các trường lồng nhau discoverableProgram trong giftcardclass để đặt các giá trị thích hợp.
Đặt các giá trị trong discoverableProgram để tạo phiên bản nháp của chương trình thẻ quà tặng có hỗ trợ đăng nhập. Để đảm bảo người kiểm thử có thể thấy thông tin này, hãy xác minh rằng người kiểm thử có quyền truy cập vào Google Pay và Wallet Console của bạn. Để biết thông tin chi tiết về cách chia sẻ quyền truy cập vào Google Pay và Wallet Console với người khác, hãy xem phần Tìm hiểu về trang Người dùng.
Để hoàn tất quy trình xác minh chức năng triển khai trong quá trình phát triển, hãy liên hệ với chúng tôi bằng tiện ích hỗ trợ liên hệ trong Google Pay và Wallet Console. Trong bảng điều khiển, hãy chọn Google Wallet API trong chủ đề và chọn Đăng nhập bằng thẻ quà tặng trong chủ đề phụ.
Phát triển trang đăng nhập sử dụng dữ liệu người dùng Google Wallet
Khi người dùng chọn thêm thẻ quà tặng của bạn, họ sẽ được chuyển đến một trang được điều chỉnh trên trang web của bạn để hoàn tất quy trình đăng nhập.
Bạn phải cung cấp URL đăng nhập để người dùng có thể đăng nhập vào một tài khoản hiện có.
Trang đăng nhập của bạn phải đáp ứng các yêu cầu sau:
- Mang đến trải nghiệm người dùng phù hợp với thiết bị di động.
- Cho phép người dùng hoàn tất quy trình đăng nhập trong một trang duy nhất.
- Sử dụng phương thức mã hoá
HTTPSbằng chứng chỉ hợp lệ để đảm bảo dữ liệu người dùng được truyền một cách an toàn. - Đảm bảo trang đăng nhập của bạn có thời gian hoạt động ít nhất là 99,9%.
Khi hiển thị trang đăng nhập, Google Wallet sẽ tạo một WebView Android và một yêu cầu POST sẽ được thực hiện đến URL mà bạn cung cấp. Dữ liệu người dùng được cung cấp trong tham số SharedDataType
có trong yêu cầu POST bằng cách sử dụng
loại nội dung
application/x-www-form-urlencoded và
bộ mã hoá UTF-8. Giá trị của tham số SharedDataType là một đối tượng JSON được mã hoá Base64.
Triển khai tính năng đẩy lại thẻ quà tặng ngay lập tức vào Google Wallet
Sau khi xác thực (đăng nhập), trang của bạn sẽ ngay lập tức đẩy thẻ quà tặng của người dùng trở lại Google Wallet.
Bạn có thể đẩy thẻ quà tặng trở lại Google Wallet bằng cách chuyển hướng đến một đường liên kết tuân theo cấu trúc
https://pay.google.com/gp/v/save/{jwt_generated}
Độ dài an toàn cho một URL là 2.000 ký tự. Đường liên kết của bạn phải nằm trong giới hạn này. Các đối tượng được mã hoá trong JWT phải có kích thước nhỏ, chỉ chứa dữ liệu dành riêng cho người dùng. Cố gắng giữ hầu hết dữ liệu trong lớp của đối tượng, tạo dữ liệu trước khi tạo JWT. Đối với các đối tượng lớn hơn không phù hợp với giới hạn, trước tiên, hãy cân nhắc tạo đối tượng trong API Google Wallet và chỉ gửi mã nhận dạng đối tượng trong JWT.
Quy trình giao tiếp thông thường
Quy trình giao tiếp khi người dùng hoàn tất quy trình đăng nhập được minh hoạ trong hình ảnh sau. Bạn chịu trách nhiệm triển khai tất cả các hành động giữa "Máy chủ của bạn".
Yêu cầu xác minh và kích hoạt
Sau khi bạn hoàn tất công việc phát triển và kiểm thử quy trình đăng nhập, hãy gửi yêu cầu thông qua tiện ích hỗ trợ liên hệ Google Pay và Wallet Console.
Sau khi xem xét toàn bộ quá trình triển khai của bạn và xác nhận tính năng chính xác kết hợp với ứng dụng Google Wallet, tính năng đăng nhập bằng thẻ quà tặng sẽ được ra mắt công khai cho chương trình thẻ quà tặng của bạn. Điều này sẽ cho phép mọi người dùng xem chương trình và sử dụng tính năng này.
Để đảm bảo trải nghiệm người dùng tối ưu, chúng tôi sẽ tiến hành kiểm tra định kỳ việc triển khai tính năng đăng nhập để đảm bảo bạn luôn tuân thủ các yêu cầu của tính năng này. Bạn sẽ được thông báo trong trường hợp có sự khác biệt và tính năng đăng nhập có thể bị tắt cho đến khi vấn đề được giải quyết.
Câu hỏi thường gặp
- Có yêu cầu nào đối với hình ảnh dùng trong chương trình thẻ quà tặng của tôi không?
- Có, hình ảnh của bạn phải được lưu trữ trên vị trí
HTTPSvì nếu không, hình ảnh sẽ không xuất hiện trong Google Wallet.
- Có, hình ảnh của bạn phải được lưu trữ trên vị trí
- Có công cụ nào đơn giản hoá việc triển khai và gỡ lỗi JWT không?
- Có, các nền tảng như www.jwt.io cho phép bạn giải mã và gỡ lỗi mã thông báo trong quá trình phát triển, cho phép bạn xác minh nội dung mà bạn đang gửi. Xin lưu ý rằng Google không liên kết với và không đề xuất cụ thể bất kỳ bên thứ ba nào như vậy.
- Làm cách nào để xử lý chính xác dữ liệu SharedDataType được mã hoá Base64?
- Đảm bảo rằng bạn đang sử dụng phương thức mã hoá UTF-8 trong suốt quy trình. Chuỗi JSON được mã hoá UTF-8 trước tiên, sau đó được mã hoá bằng android.util.Base64 với các tuỳ chọn NO_WRAP và URL_SAFE. Điều này tương ứng với phần 4 của RFC 3548.