Tính năng đăng ký (đăng nhập) thẻ quà tặng cho phép người dùng tìm kiếm thẻ quà tặng rồi 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 trước đó 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 Google Wallet
SharedDataType. - Triển khai chế độ đẩy thẻ quà tặng về 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 phần này, hãy xác minh
người kiểm thử có quyền truy cập vào Google Pay và Bảng điều khiển Wallet 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 của bạn trong quá trình phát triển hãy liên hệ với chúng tôi qua tiện ích liên hệ với bộ phận hỗ trợ trong Google Pay và Bảng điều khiển Wallet. 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, họ sẽ được chuyển đến một trang phù hợp trên trang web của bạn để hoàn tất quá 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á
HTTPSvới một 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 thông số SharedDataType
có trong yêu cầu POST bằng cách sử dụng
thông tin về loại nội dung application/x-www-form-urlpersonalized và
UTF-8. Giá trị của SharedDataType
là một đối tượng JSON được mã hoá Base64.
Triển khai hệ thống đẩy ngay thẻ quà tặng về 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 lại thẻ quà tặng về Google Wallet bằng cách chuyển hướng đến đường liên kết 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 nhỏ, chỉ chứa dữ liệu cụ thể cho người dùng. Cố gắng giữ lại hầu hết dữ liệu trong lớp của đối tượng, tạo 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 điển hình
Luồng giao tiếp để người dùng hoàn tất đăng nhập được minh hoạ trong hình ảnh tiếp theo. 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 tra quy trình đăng nhập, hãy gửi yêu cầu thông qua Liên hệ với bộ phận hỗ trợ về Google Pay và Bảng điều khiển Wallet tiện ích.
Sau khi xem xét toàn bộ việc triển khai của bạn, trong đó xác nhận tính năng chính xác trong kết hợp với ứng dụng Google Wallet, thì tính năng đăng nhập vào thẻ quà tặng sẽ được 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 thấy 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ữ ở
HTTPSvị trí vì chúng sẽ không hiển thị trong Google Wallet.
- Có, hình ảnh của bạn phải được lưu trữ ở
- Có công cụ nào giúp đơ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 có liên kết 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 để chúng tôi xử lý chính xác dữ liệu SharedDataType được mã hoá theo Base64?
- Đảm bảo rằng bạn đang sử dụng bộ mã hoá UTF-8 trong suốt quy trình của mì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 Mục 4 của RFC 3548.