Skip to main content
Trang thanh toán
Checkout của Dodo Payments là trang thanh toán được lưu trữ, được thiết kế cho các sản phẩm kỹ thuật số và SaaS. Trang này xử lý việc chuyển đổi tiền tệ, tính thuế, mã giảm giá, thu thập địa chỉ và lựa chọn phương thức thanh toán. Bạn tạo một phiên checkout thông qua API hoặc dashboard, sau đó khách hàng hoàn tất thanh toán trên một trang an toàn có thương hiệu.

Checkout Sessions API

Tạo các phiên checkout theo cách lập trình.

Preview Checkout

Tính toán giá và thuế trước khi tạo phiên.

Payment Methods

Các phương thức thanh toán được hỗ trợ và cấu hình.

Integration Guide

Hướng dẫn từng bước tích hợp checkout.
Các liên kết checkout được tạo thông qua Checkout Sessions API không thể tái sử dụng. Chúng hết hạn sau 24 giờ hoặc sau 15 phút nếu confirm: true được thiết lập. Hãy tạo một phiên mới cho mỗi khách hàng và mỗi lần thử thanh toán.

Adaptive Currency

Adaptive Currency cho phép khách hàng thanh toán bằng loại tiền tệ địa phương ưa thích, từ đó cải thiện mức độ tin cậy và tỷ lệ chuyển đổi. Khi được bật, khách hàng sẽ thấy bộ chọn tiền tệ trong checkout. Giá được chuyển đổi sang loại tiền tệ họ chọn theo tỷ giá FX trực tiếp. Nếu sản phẩm đã bật Purchasing Power Parity, giá đã điều chỉnh theo PPP sẽ được chuyển đổi thay cho giá cơ bản. Nếu đã bật Charm Pricing, số tiền sau chuyển đổi sẽ được làm tròn về một mức kết thúc dễ nhìn như 49.99.
Bộ chọn tiền tệ trên checkout
Để bật Adaptive Currency, hãy vào Settings → Business và bật tùy chọn này.

Adaptive Currency

Các loại tiền tệ được hỗ trợ, phí chuyển đổi và cách xử lý hoàn tiền.

Checkout đa ngôn ngữ

Checkout hỗ trợ 22 ngôn ngữ. Khách hàng có thể chuyển đổi ngôn ngữ trực tiếp trên trang, đồng thời văn bản UI, nhãn và thông báo hệ thống được bản địa hóa.
Bộ chọn ngôn ngữ trên checkout

Ngôn ngữ được hỗ trợ

Để buộc sử dụng một ngôn ngữ cụ thể, hãy thiết lập customization.force_language khi tạo phiên checkout. Xem Checkout Sessions API để biết chi tiết.

Tính thuế tự động

Thuế được tính tự động dựa trên địa điểm thanh toán của khách hàng, giúp đảm bảo tuân thủ các yêu cầu về GST, VAT và thuế bán hàng. Các quy tắc thuế được áp dụng dựa trên quốc gia và khu vực của khách hàng khi có liên quan. Số tiền thuế tự động cập nhật khi khách hàng thay đổi quốc gia hoặc cập nhật địa chỉ. Bảng phân tích thuế cuối cùng được hiển thị rõ ràng trước khi thanh toán.
Việc tính thuế được tự động hóa hoàn toàn. Không cần cấu hình thủ công đối với hàng hóa kỹ thuật số và sản phẩm SaaS tiêu chuẩn.

Hỗ trợ mã số thuế doanh nghiệp

Đối với các giao dịch B2B, checkout cho phép khách hàng nhập Mã số thuế doanh nghiệp (ví dụ: số VAT hoặc GST). Khi được nhập, mã số thuế sẽ được xác thực theo thời gian thực và các trường hợp miễn thuế hoặc quy tắc reverse charge áp dụng sẽ được tự động xử lý.
Nhập mã số thuế doanh nghiệp trên checkout

Mã giảm giá

Khách hàng có thể áp dụng mã giảm giá hoặc mã khuyến mãi mà bạn đã tạo trong dashboard. Mã giảm giá được xác thực ngay lập tức và giá cập nhật sẽ được hiển thị. Khi Purchasing Power Parity được bật cho một sản phẩm, mã giảm giá sẽ áp dụng cho giá đã điều chỉnh theo PPP, không phải giá cơ bản.
Nhập mã giảm giá trên checkout
Bạn có thể áp dụng trước mã giảm giá hoặc bật trường nhập mã giảm giá thông qua API:
discount_codes chấp nhận một mảng gồm tối đa 20 mã được cộng dồn theo thứ tự. Trường discount_code dạng đơn đã deprecated nhưng vẫn hoạt động để đảm bảo khả năng tương thích ngược.

Discount Codes

Tạo và quản lý mã giảm giá.

Validate Discount by Code

Tra cứu và xác thực mã giảm giá bằng tên mã.

Thu thập địa chỉ thông minh

Checkout hỗ trợ nhập địa chỉ linh hoạt để cân bằng tốc độ, độ chính xác và phạm vi hỗ trợ toàn cầu.

Tùy chọn

Chế độ địa chỉ tối thiểu

Để tối đa hóa tỷ lệ chuyển đổi, hãy bật tính năng thu thập địa chỉ tối thiểu nhằm giảm trở ngại trong checkout. Khi minimal_address được thiết lập thành true, checkout chỉ thu thập:
  • Quốc gia — luôn bắt buộc để xác định thuế
  • Mã ZIP/bưu chính — chỉ tại các khu vực cần thông tin này để tính thuế bán hàng, VAT hoặc GST
Tất cả trường địa chỉ khác sẽ được bỏ qua.
Chế độ địa chỉ tối thiểu chỉ hiển thị các trường quốc gia và mã ZIP/bưu chính trên checkout
Thu thập địa chỉ đầy đủ là tùy chọn mặc định. Bật minimal_address cho các luồng sản phẩm kỹ thuật số và SaaS không yêu cầu đầy đủ thông tin thanh toán.

Thu thập số điện thoại

Kiểm soát việc trường số điện thoại có xuất hiện trên checkout hay không và trường này có bắt buộc hay không.
require_phone_number: true yêu cầu allow_phone_number_collection: true. API sẽ từ chối các phiên trong đó tính năng thu thập số điện thoại bị tắt nhưng số điện thoại lại được yêu cầu.

Trường tùy chỉnh

Thu thập thêm thông tin từ khách hàng trong quá trình checkout bằng cách định nghĩa các trường biểu mẫu tùy chỉnh. Tính năng này hữu ích để thu thập tên công ty, quy mô nhóm, nguồn giới thiệu hoặc bất kỳ dữ liệu nào khác dành riêng cho doanh nghiệp.

Các loại trường hiện có

Ví dụ

Phản hồi của khách hàng được tự động đưa vào payload webhook (payment.succeeded, subscription.active) và phản hồi API thông qua mảng custom_field_responses. Bạn có thể định nghĩa tối đa 5 trường tùy chỉnh cho mỗi phiên checkout.

Custom Fields Guide

Cấu hình trường tùy chỉnh và truy cập phản hồi.

Chấp nhận Chính sách quyền riêng tư và Điều khoản

Để đảm bảo tính minh bạch về pháp lý và tuân thủ:
Điều này giúp đáp ứng các yêu cầu về bảo vệ người tiêu dùng và quyền riêng tư dữ liệu trên toàn cầu, bao gồm tuân thủ GDPR.

Bộ sưu tập sản phẩm

Bộ sưu tập sản phẩm mang đến trải nghiệm checkout thống nhất, trong đó khách hàng có thể xem và lựa chọn nhiều sản phẩm liên quan (ví dụ: các gói Starter, Pro, Enterprise) trong một checkout duy nhất. Khi sử dụng một bộ sưu tập, tất cả sản phẩm đang hoạt động trong bộ sưu tập sẽ được hiển thị. Sản phẩm đầu tiên được chọn trước, cho phép khách hàng so sánh các tùy chọn trước khi lựa chọn.
Khi sử dụng product_collection_id, hãy truyền một mảng product_cart trống. Không thể áp dụng trước mã giảm giá khi tạo phiên.

Product Collections

Tạo và quản lý bộ sưu tập sản phẩm.

Cấu hình phiên checkout

Kiểm soát hành vi của checkout bằng Checkout Sessions API:
Sau khi thanh toán, khách hàng được chuyển hướng đến return_url của bạn với các query parameter được tự động thêm vào — bao gồm payment_id hoặc subscription_id, status, email và license_key (nếu có). Xem hướng dẫn Checkout Sessions để biết danh sách đầy đủ.

Checkout Sessions API

Tài liệu tham khảo API đầy đủ cho các phiên checkout.

Checkout Integration Guide

Hướng dẫn từng bước tích hợp checkout.

Tùy chỉnh giao diện

Tùy chỉnh giao diện trang checkout để phù hợp với thương hiệu của bạn bằng tham số customization.theme_config. Cấu hình màu sắc, font, bán kính đường viền và văn bản nút cho cả chế độ sáng và tối. Phần này đề cập đến API phía máy chủ, sử dụng các tên thuộc tính như bg_primary. Giao diện được thiết lập trên phiên sẽ áp dụng cho checkout hosted, overlay và inline. Tùy chọn themeConfig phía client của Checkout SDK, sử dụng các tên thuộc tính như bgPrimary, đã deprecated. Xem Overlay Checkout.
Trang checkout với giao diện tùy chỉnh

Design & Theme Customization

Cấu hình giao diện trực quan từ dashboard với các giao diện dựng sẵn, kiểu chữ, màu sắc và bản xem trước trực tiếp.

Tùy chọn cấu hình giao diện

Cấu hình màu (chế độ sáng/tối)

Mỗi chế độ hỗ trợ các thuộc tính màu sau:
Tất cả trường màu đều chấp nhận các định dạng màu CSS tiêu chuẩn:
  • Hex: #fff, #ffffff, #ffffffff
  • RGB/RGBA: rgb(255, 255, 255), rgba(255, 255, 255, 0.5)
  • HSL/HSLA: hsl(120, 100%, 50%), hsla(120, 100%, 50%, 0.5)
  • Màu được đặt tên: red, blue, transparent

Ví dụ

Bạn không cần chỉ định tất cả thuộc tính màu. Các thuộc tính không được chỉ định sẽ sử dụng giá trị giao diện mặc định.
Lần sửa đổi cuối 26 tháng 9, 2026