---
title: "Thiết lập checkout cho Adapty Mail"
description: "Xây dựng web paywall và kết nối nhà cung cấp thanh toán để cung cấp web checkout được cá nhân hóa cho chiến dịch email của bạn."
---

Mỗi email mà Adapty Mail gửi đều chứa một link checkout duy nhất dành riêng cho người nhận đó. Khi họ nhấp vào, họ sẽ đến một web checkout funnel nhận dạng họ theo hồ sơ người dùng, hiển thị ưu đãi của bạn và xử lý thanh toán. Các checkout funnel nằm trong **Web Paywalls** bên trong Adapty Mail và được chỉnh sửa trong **web paywall builder** tích hợp sẵn.

## Yêu cầu \{#requirements\}

- Một nhà cung cấp thanh toán web đã được cấu hình với các sản phẩm gói đăng ký của bạn. **Generate with AI** chỉ hỗ trợ Stripe và kết nối trong builder. **Use your own hosted paywall** chấp nhận bất kỳ nhà cung cấp nào — Stripe, Paddle, PayPal hoặc khác — vì việc thanh toán được xử lý ở phía bạn.

Bạn không cần tài khoản riêng để dùng web paywall builder. Nó được tích hợp sẵn với Adapty Mail: một workspace sẽ được tự động tạo lần đầu tiên bạn đăng nhập, và bạn được đăng nhập vào editor bằng thông tin đăng nhập Adapty của mình. Điều này độc lập với bất kỳ web paywall nào bạn có thể đã cấu hình trên trang paywall của Adapty Dashboard chính — các web paywall của Adapty Mail là các thực thể riêng biệt, được quản lý hoàn toàn từ Adapty Mail.

## Thiết lập checkout funnel của bạn \{#set-up-your-checkout-funnel\}

Trong Adapty Mail, đi tới **Web Paywalls → Create**. Bạn có hai lựa chọn:

- **Generate with AI**: Web paywall builder tích hợp của Adapty Mail sẽ tự động tạo funnel cho bạn. Chỉ hỗ trợ Stripe — đối với Paddle hoặc PayPal, hãy dùng lựa chọn thứ hai.
- **Use your own hosted paywall**: Kết nối một paywall bạn đã tự host, trên bất kỳ nhà cung cấp thanh toán nào.

### Generate with AI \{#generate-with-ai\}

Trang Create hiển thị bảng **Prerequisites** ở đầu trang với các nút thao tác nội tuyến hướng dẫn bạn qua từng điều kiện tiên quyết — sẵn sàng thương hiệu, đăng nhập builder, kết nối Stripe, sản phẩm và bước xem lại và đăng cuối cùng. Thực hiện từng bước; bảng sẽ tự động làm mới khi mỗi bước hoàn tất.

Khi các điều kiện tiên quyết đã xanh, nhấp **Generate** để mở hộp thoại tạo. Có hai lựa chọn cần thực hiện:

- **Environment**: Chọn **Production** hoặc **Sandbox**. Sandbox sử dụng các sản phẩm chế độ test Stripe của bạn và là lựa chọn mặc định an toàn cho môi trường dev và local — tài khoản của nó được tách biệt hoàn toàn khỏi môi trường production, nên các giao dịch test không bao giờ ảnh hưởng đến dữ liệu thực.
- **Plans**: Chọn tối đa **3 Stripe plans**. Mỗi plan là một tổ hợp sản phẩm + giá. Paywall sẽ trình bày các plan này dưới dạng các ưu đãi tại checkout. Nếu bạn chọn ít hơn 3, paywall chỉ hiển thị các plan bạn đã chọn.

Nhấp **Generate** để chạy quá trình tạo. Khi hoàn tất, mở editor trong builder để xem lại kết quả và đăng. Sau đó, nhấp **Save**.

:::important
Paywall phải được đăng trước khi có thể phục vụ lưu lượng checkout. Các paywall chưa được đăng sẽ trả về lỗi khi người dùng nhấp vào link checkout trong email.
:::

Để biết chi tiết về nhà cung cấp thanh toán trong builder (tài khoản Stripe, chế độ test vs live, thiết lập sản phẩm), xem [Cấu hình web paywall](web-paywall-configuration).

### Use your own hosted paywall \{#use-your-own-hosted-paywall\}

1. Trên trang Create, chọn **Enter URL manually**.
2. Dán URL paywall bạn đã host. URL phải bao gồm các placeholder `{email}` và `{external_profile_id}` dưới dạng query parameter — Adapty Mail sẽ điền các giá trị này cho từng người nhận để trang biết ai đang truy cập. Ví dụ:

   ```
   https://example.com/paywall?email={email}&profile={external_profile_id}
   ```
3. Lưu.

Lựa chọn này hoạt động với bất kỳ nhà cung cấp thanh toán nào — Adapty Mail chỉ xử lý việc chuyển hướng và thay thế tham số; việc thanh toán và cá nhân hóa xảy ra hoàn toàn ở phía bạn.

## Giao diện checkout trông như thế nào \{#what-the-checkout-looks-like\}

Khi người dùng nhấp vào link checkout, họ sẽ đến **Main conversion page**. Sau khi họ thực hiện thanh toán, họ sẽ thấy **Payment success** hoặc **Payment failed** — chỉ hiển thị một trang cho mỗi lần thử.

**Main conversion page**
Một trang trình bày bán hàng toàn trang. AI tạo nội dung và hình ảnh cho từng phần:

| Phần | Nội dung AI tạo |
|---|---|
| Headline | Tiêu đề đậm, hướng đến lợi ích |
| Subheadline | Đề xuất giá trị bổ sung |
| Offer badge | Badge tạo cảm giác cấp bách (không bịa đặt giá — sử dụng ngôn ngữ khuyến mãi chung) |
| CTA button | Văn bản hướng đến hành động, 2–5 từ |
| Benefits | 3–6 thẻ lợi ích dạng emoji + văn bản |
| Features | 3–8 mô tả tính năng với tiêu đề và phụ đề |
| Plans | Tiêu đề lựa chọn plan và văn bản đồng hồ đếm ngược ưu đãi |
| Social proof | Văn bản chứng minh cộng đồng và 3–5 đánh giá người dùng thực tế |
| FAQ | 3–6 câu hỏi và câu trả lời phổ biến |
| Guarantee | Văn bản đảm bảo hoàn tiền hoặc đảm bảo sự hài lòng |

**Payment success**
Thông báo chúc mừng kèm các bước tiếp theo và hình ảnh do AI tạo.

**Payment failed**
Thông báo thân thiện nhắc người dùng thử lại. Trạng thái checkout được giữ nguyên.

## Cách cá nhân hóa hoạt động \{#how-personalization-works\}

Mỗi email chứa một URL checkout duy nhất với `customer_user_id` và địa chỉ email của người nhận được nhúng dưới dạng tham số:

```
https://your-funnel.com/?cid={{customer_user_id}}&email={{email}}
```

Adapty tự động tạo các URL này khi gửi từng email — không cần cấu hình gì trong web paywall builder. Khi người dùng nhấp, builder đọc các tham số để nhận dạng họ. Khi hoàn tất mua hàng, Adapty kết nối doanh thu với email cụ thể đã dẫn đến chuyển đổi. Dữ liệu này xuất hiện trong [Phân tích chiến dịch](mail-analytics).

## Xử lý sự cố \{#troubleshooting\}

| Vấn đề | Giải pháp |
|---|---|
| Link checkout không mở được | Xác minh paywall đã được đăng trong web paywall builder |
| Người dùng không được nhận dạng tại checkout | Xác nhận `Adapty.identify()` đã được gọi với đúng user ID trước khi email được gửi |
| Mua hàng không được gắn với email | Kiểm tra xem tham số `cid` có trong URL checkout không — liên hệ hỗ trợ nếu thiếu tham số |