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 đến trang web thân thiện với thiết bị di động của bạn để hoàn tất sau đó họ có thể thêm thẻ của họ 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 cần thiết để 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 lớp kiểm tra trong Google Wallet để kiểm tra quy trình đăng nhập của bạn.
- 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 học kiểm tra trong Google Wallet
Xác định URL đăng nhập, biểu trưng chương trình của bạn. Sau đó:
hãy sử dụng các trường discoverableProgram lồng nhau trong
giftcardclass để đặt
các giá trị phù 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 cho phép đă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 chi tiết về cách chia sẻ
Quyền truy cập của Google Pay và Bảng điều khiển Wallet với người khác, hãy xem
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 khi ở bảng điều khiển, chọn API Google Wallet trong chủ đề rồi 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:
- Cung cấp trải nghiệm người dùng thân thiện với thiết bị di động.
- Cho phép người dùng hoàn tất đăng nhập trong một trang.
- 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 đạt ít nhất 99,9% thời gian hoạt động.
Khi hiển thị trang đăng nhập, Google Wallet sẽ tạo
một Android WebView và một yêu cầu POST được gửi đến bạn đã cung cấp
URL. 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à
quy trình 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 được xác thực (đăng nhập), trang của bạn sẽ đẩy ngay thẻ quà tặng của người dùng vào 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 sẽ vẫn 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 vừa với giới hạn, hãy cân nhắc trước tiên hãy tạo đối tượng trong Google Wallet API và chỉ gửi mã đố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. Tất cả thao tác giữa "Máy chủ của bạn" bạn có trách nhiệm triển khai.
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, hãy kiểm tra định kỳ hoạt động đăng nhập của bạn sẽ được tiến hành để đảm bảo luôn tuân thủ các yêu cầu về tính năng. 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ị vô hiệu hoá 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 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ã 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 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 đầu 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.