Lời nhắc
1. Kể từ ngày 2/8/2023, tất cả các ứng dụng mới phải sử dụng Thư viện Billing phiên bản 5 trở lên. Chậm nhất vào ngày 1/11/2023, tất cả các bản cập nhật cho ứng dụng hiện có đều phải sử dụng Thư viện Billing phiên bản 5 trở lên. Tìm hiểu thêm.
2. Nếu ứng dụng của bạn nhắm đến Android 14 trở lên, bạn phải cập nhật lên PBL 5.2.1 hoặc PBL 6.0.1 trở lên.

API hệ thống thanh toán thay thế dành cho Hàn Quốc

Hướng dẫn này đề cập đến các API dùng để tự động hiển thị hệ thống thanh toán thay thế cùng với hệ thống thanh toán của Google Play dành cho người dùng điện thoại di động và máy tính bảng ở Hàn Quốc, đồng thời báo cáo các giao dịch phát sinh. Trước khi sử dụng các API này, hãy đảm bảo:

Các mô-đun tích hợp Google Play Billing được đề xuất còn lại cũng giống như các mô-đun mà nhà phát triển hiện đã tích hợp.

Bạn nên thiết lập sẵn quy trình tích hợp API Nhà phát triển Google Play, vì việc tích hợp phần phụ trợ sẽ tận dụng API này.

Bảng chú giải thuật ngữ

Sau đây là hướng dẫn về quy ước sử dụng thuật ngữ:

  • API hệ thống thanh toán thay thế. API để hiển thị màn hình lựa chọn của người dùng, đồng thời giúp nhà phát triển báo cáo các giao dịch đã hoàn tất trên hệ thống thanh toán thay thế của nhà phát triển.
  • Hệ thống thanh toán thay thế Hệ thống thanh toán thay thế do nhà phát triển cung cấp, ngoài hệ thống thanh toán của Google Play.
  • Giao dịch bên ngoài. Giao dịch phát sinh bên ngoài hệ thống thanh toán của Google Play.
  • Mã thông báo giao dịch bên ngoài. Khi người dùng chọn hệ thống thanh toán thay thế, mã thông báo sẽ được cung cấp cho nhà phát triển thông qua Thư viện Play Billing. Mã này cũng được dùng để thông báo cho Google Play về giao dịch mua thành công.
  • Mã giao dịch bên ngoài. Giá trị nhận dạng riêng biệt do nhà phát triển tạo ra để xác định một giao dịch.

Chế độ cài đặt hệ thống thanh toán thay thế trong Play Console

Các nhà phát triển đã hoàn tất việc đăng ký chương trình KR có thể quản lý các chế độ cài đặt hệ thống thanh toán thay thế thông qua Play Console:

  • Đối với từng ứng dụng, hãy chọn cung cấp hoặc không cung cấp hệ thống thanh toán thay thế.
  • Tải biểu trưng của các phương thức thanh toán lên sao cho phù hợp với các nguyên tắc. Quan trọng là bạn phải xem xét và tuân thủ tất cả thông số kỹ thuật về định dạng. Biểu trưng được tải lên ở định dạng không tuân thủ các nguyên tắc này sẽ không xuất hiện cho hệ thống thanh toán thay thế của bạn trên màn hình lựa chọn của người dùng.
  • Nếu cung cấp gói thuê bao, bạn hãy cung cấp đường liên kết quản lý gói thuê bao.
Giao diện người dùng mô phỏng, nhằm mục đích minh họa, có thể thay đổi.

Trải nghiệm người dùng

API phía máy khách có chức năng sau:

  • Google Play kết xuất và quản lý thông tin phù hợp cũng như màn hình lựa chọn của người dùng.
  • Nếu người dùng chọn sử dụng hệ thống thanh toán của Google Play, thì quy trình thanh toán sẽ tiếp tục sử dụng giao diện thanh toán của Google Play như bình thường.

Ứng dụng của nhà phát triển.

Màn hình thông tin cho người dùng (chỉ xuất hiện một lần trong ứng dụng cho mỗi người dùng).

Màn hình lựa chọn phương thức thanh toán.

Ví dụ này chỉ nhằm mục đích minh hoạ.

Màn hình thông tin dành cho người dùng

Màn hình thông tin giúp người dùng nắm được các hệ thống thanh toán thay thế được cung cấp trong ứng dụng, đồng thời cung cấp thông tin về lựa chọn để người dùng có thể đưa ra quyết định sáng suốt. Sau khi bật hệ thống thanh toán thay thế, trong lần đầu tiên người dùng thực hiện giao dịch mua trong ứng dụng, họ sẽ thấy màn hình thông tin này. Thông báo này sẽ không xuất hiện trong các giao dịch mua sau này trong ứng dụng của bạn do chính người dùng đó thực hiện trên cùng thiết bị.

Màn hình lựa chọn của người dùng

Màn hình lựa chọn của người dùng trình bày cho người dùng lựa chọn sử dụng hệ thống thanh toán thay thế của nhà phát triển hoặc hệ thống thanh toán của Google Play.

Phân tích một tuỳ chọn hệ thống thanh toán thay thế

Tuỳ chọn hệ thống thanh toán thay thế trên màn hình lựa chọn của người dùng gồm các thành phần sau đây trên giao diện người dùng:

  1. Biểu tượng ứng dụng.
  2. Tên ứng dụng.
  3. Thành phần hình ảnh bao gồm các phương thức thanh toán do nhà phát triển cung cấp.
  4. Thành phần chỉ báo bổ sung (và các thành phần khác không thuộc thành phần hình ảnh trên giao diện người dùng).

Thành phần hình ảnh cho các phương thức thanh toán

Mỗi thành phần hình ảnh được tạo thành từ nhiều thẻ phương thức thanh toán và phải tuân thủ các thông số kỹ thuật được xác định trong các nguyên tắc này.

Kích thước 192 dp X 20 dp
Khoảng cách giữa các thẻ 8 dp
Định dạng tệp PNG, nền trong suốt

Biến thể phương thức thanh toán

Nhà phát triển có thể chọn số lượng biểu tượng phương thức thanh toán hiện có mà mình muốn đưa vào thành phần hình ảnh (tối đa 5 biểu tượng).

Không được thêm hình ảnh hoặc văn bản nào khác vào hình ảnh đó.

Thông số kỹ thuật của thẻ

Các thẻ phương thức thanh toán có trong thành phần hình ảnh phải tuân thủ các nguyên tắc sau đây về kích thước, khoảng cách và kiểu.

Kích thước thẻ 32 dp X 20 dp
Khoảng đệm bên trong 3 dp
Đường viền 1 dp (kích thước bao gồm cả nét bên trong), Bán kính 2 dp, #E0E0E0
Nền thẻ Màu đồng nhất (tốt nhất là màu trắng)

Bước tiếp theo

Để tìm hiểu thêm về cách tích hợp các API hệ thống thanh toán thay thế, hãy xem hướng dẫn chi tiết về cách tích hợp trong ứng dụngtích hợp phần phụ trợ.