Chuyển tới nội dung chính
ZZalo Platforms

Hướng dẫn tích hợp

Cập nhật lần cuối:

1. Hành trình Thanh toán​

Bước 1: Đối tác tích hợp để ghi nhận tương tác có ý nghĩa & nhận khả năng gửi tin​

Zalo Platform ghi nhận tương tác có ý nghĩa của người dùng (Thanh toán) trên Mini App của đối tác, sau đó cấp khả năng gửi tin cho đối tác thông qua token gửi tin (oaMessageToken).

Để ghi nhận tương tác có ý nghĩa, đối tác được chọn một trong hai phương thức sau:

Đối tượng áp dụng
Phương thức 1Đối tác tích hợp API Checkout SDK tích hợp toàn diện.
Phương thức 2Đối tác tích hợp API Checkout SDK tích hợp tuỳ chỉnh.

1.1. Phương thức 1: Áp dụng cho đối tác tích hợp API Checkout SDK tích hợp toàn diện​

Các bước kỹ thuật tích hợp ghi nhận tương tác có ý nghĩa

  • Đối tác tích hợp API Checkout SDK tích hợp toàn diện.
  • Platform tự động ghi nhận tương tác ngay khi người dùng thanh toán thành công qua Checkout Kit — đối tác không cần xử lý thêm.
Quy trình ghi nhận tương tác qua Checkout SDK tích hợp toàn diện
Nhận token gửi tin (oaMessageToken)

Sau khi ghi nhận và xác thực trạng thái tương tác thành công, đối tác nhận oaMessageToken thông qua API Callback.

1.2. Phương thức 2: Áp dụng cho đối tác tích hợp API Checkout SDK tích hợp tuỳ chỉnh​

Các bước kỹ thuật tích hợp ghi nhận tương tác có ý nghĩa

  • Tích hợp Function Button: Đối tác tích hợp Widget Function Button trên Mini App. Sau khi người dùng nhấn, đối tác nhận interactToken (hiệu lực 60 phút) để xác thực hành động thanh toán thực sự diễn ra.
  • Khởi tạo đơn hàng: Đối tác khởi tạo đơn hàng.
  • Cập nhật trạng thái đơn hàng: Đối tác cập nhật trạng thái đơn hàng kèm interactToken.
Quy trình ghi nhận tương tác qua Checkout SDK tích hợp tuỳ chỉnh
Nhận token gửi tin (oaMessageToken)

Bước 2: Đối tác gửi tin​

Quy trình đối tác gửi Tin nhắn hành trình
Quy định gửi Tin nhắn hành trình (qua oaMessageToken)

Sau khi có oaMessageToken, đối tác gọi API gửi tin để gửi Tin nhắn hành trình đến người dùng.

Mỗi oaMessageToken chỉ cho phép gửi template:

  • Do Platform định nghĩa.
  • Thuộc đúng hành trình tương ứng với tương tác của người dùng.
  • Trong phạm vi quota và thời hạn của token.

Danh sách hành trình & template tương ứng​

Hành trìnhTemplateQuy định sử dụng token
Thanh toán
  • Quota: 2 tin nhắn/token/hành trình
  • Thời gian sử dụng token: 15 ngày

Đối tác được sử dụng các template mà Zalo Platform đã định nghĩa sẵn tại đây.

Quy định về gửi tin nhắn​

Quy định gửi Tin nhắn hành trình