--- sourceType: official-guide sourceTypeMatchedRule: fallback slug: MA/journeyMessage/integration title: Hướng dẫn tích hợp --- ## 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](/docs/MA/checkoutSdk/integration-process/overview/setting). | | Phương thức 2 | Đối tác tích hợp [API Checkout SDK tích hợp tuỳ chỉnh](/docs/MA/checkoutSdk/integration-process/custom/setting). | #### 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](/docs/MA/checkoutSdk/integration-process/overview/setting). - 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](/assets/MA/img/journey-message/checkout-comprehensive-flow.png) :::info 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](/docs/MA/checkoutSdk/webhooks/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](/docs/MA/api/widgets/showFunctionButtonWidget) 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](/docs/MA/checkoutSdk/integration-process/custom/order). - **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](/docs/MA/checkoutSdk/apis/updateOrderStatus) kèm `interactToken`. ![Quy trình ghi nhận tương tác qua Checkout SDK tích hợp tuỳ chỉnh](/assets/MA/img/journey-message/checkout-custom-flow.png) :::info Nhận token gửi tin (`oaMessageToken`) - Token gửi tin (`oaMessageToken`) được cấp khi trạng thái đơn hàng là Thành công và `interactToken` còn khả dụng. - Đối tác nhận `oaMessageToken` thông qua [callback của API cập nhật trạng thái đơn hàng](/docs/MA/checkoutSdk/apis/updateOrderStatus). ::: ### Bước 2: Đối tác gửi tin ![Quy trình đối tác gửi Tin nhắn hành trình](/assets/MA/img/journey-message/send-message-flow.png) :::info 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](/docs/MA/journeyMessage/send-journey-message) để 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ình | Template | Quy định sử dụng token | | ---------- | ------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------ | | Thanh toán | • [Template 104000 - Thanh toán thành công](/docs/MA/journeyMessage/templates#template-104000) | • 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](/docs/MA/journeyMessage/templates). #### Quy định về gửi tin nhắn ![Quy định gửi Tin nhắn hành trình](/assets/MA/img/journey-message/message-template-rules.png)