Skip to main content
Trang thanh toán
Trang thanh toán Dodo Payments được tối ưu hóa chuyển đổi và tuân thủ toàn cầu, thiết kế dành cho sản phẩm kỹ thuật số và doanh nghiệp SaaS. Nó hỗ trợ nhiều loại tiền tệ, ngôn ngữ, thuế, giảm giá, tiện ích bổ sung và quy trình tuân thủ thân thiện với doanh nghiệp.

Checkout Sessions API

Tạo các phiên thanh toán lưu trữ theo chương 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à tùy chọn cấu hình.
Các liên kết checkout được tạo thông qua Checkout Sessions API không thể tái sử dụng và sẽ hết hạn trong vòng 24 giờ. Hãy tạo một session 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, giúp tăng độ tin cậy và tỷ lệ chuyển đổi.

Cách hoạt động

  1. Bật: Bật Adaptive Currency từ Settings → Business
  2. Chọn: Khách hàng có thể chuyển đổi tiền tệ trực tiếp trên checkout
  3. Quy đổi: Giá được quy đổi linh hoạt bằng tỷ giá FX theo thời gian thực
  4. Hiển thị: Số tiền cuối cùng cần thanh toán được hiển thị minh bạch trước khi thanh toán
Bộ chọn tiền tệ trên checkout

Adaptive Currency

Tìm hiểu thêm về các loại tiền tệ được hỗ trợ, phí quy đổi và cách xử lý hoàn tiền.

Checkout đa ngôn ngữ

Dodo Payments hỗ trợ nhiều ngôn ngữ trên trang checkout, cho phép khách hàng hoàn tất thanh toán bằng ngôn ngữ mà họ cảm thấy thoải mái.
Bộ chọn ngôn ngữ trên checkout

Điểm nổi bật

  • Bộ chọn ngôn ngữ có sẵn trực tiếp trên checkout
  • Văn bản UI, nhãn và thông báo hệ thống được bản địa hóa
  • Cải thiện khả năng tiếp cận và tỷ lệ chuyển đổi quốc tế

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

Trang checkout hỗ trợ 21 ngôn ngữ:
Bạn có thể buộc checkout sử dụng một ngôn ngữ cụ thể bằng cách đặt tham số force_language khi tạo checkout session. Xem Checkout Sessions API để biết chi tiết.

Tính thuế tự động

Thuế được tự động tính dựa trên địa chỉ thanh toán của khách hàng, đảm bảo tuân thủ các yêu cầu về GST, VAT và sales tax mà không cần thiết lập thủ công.

Cách tính thuế hoạt động

1

Location Detection

Quy tắc thuế được áp dụng dựa trên quốc gia của khách hàng (và khu vực nếu có).
2

Dynamic Updates

Số tiền thuế tự động cập nhật khi:
  • Quốc gia thay đổi
  • Địa chỉ được cập nhật
3

Transparent Display

Chi tiết 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 cho các sản phẩm kỹ thuật số và SaaS tiêu chuẩn.

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

Đối với các doanh nghiệp đã đăng ký, checkout cho phép khách hàng nhập Mã số thuế doanh nghiệp (ví dụ: số VAT/GST).

Điều gì xảy ra khi nhập mã số thuế

  • Tính đủ điều kiện về thuế được xác thực theo thời gian thực
  • Các trường hợp miễn thuế hoặc quy tắc reverse-charge áp dụng được sẽ được áp dụng
  • Số tiền thuế được cập nhật ngay lập tức trên checkout
Nhập Mã số thuế doanh nghiệp trên checkout
Điều này đặc biệt hữu ích cho B2B SaaS và các dịch vụ kỹ thuật số, nơi khách hàng doanh nghiệp có thể đủ điều kiện được miễn thuế.

Mã giảm giá

Khách hàng có thể áp dụng trực tiếp trên trang checkout các mã giảm giá hoặc mã khuyến mãi mà bạn đã tạo trong dashboard.

Trải nghiệm checkout

  1. Khách hàng nhập mã giảm giá
  2. Mã giảm giá được xác thực ngay lập tức
  3. Giá cập nhật và khoản tiết kiệm được hiển thị rõ ràng
Nhập mã giảm giá trên checkout

Tích hợp API

Áp dụng trước một hoặc nhiều mã giảm giá xếp chồng hoặc bật trường nhập mã giảm giá:
discount_codes chấp nhận một mảng tối đa 20 mã được xếp chồng theo thứ tự. Trường discount_code dạng số ít đã lỗi thời nhưng vẫn hoạt động — các tích hợp hiện có chưa cần thay đổi ngay. Hãy chuyển sang discount_codes khi thuận tiện để sử dụng tính năng xếp chồng và cấu trúc response phong phú hơn.

Discount Codes

Tìm hiểu cách tạo và quản lý mã giảm giá.

Validate Discount by Code

Tra cứu và xác thực các khoản 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 để hoàn tất nhanh hơn.

Các tùy chọn hiện có

Việc thu thập địa chỉ cân bằng tốc độ, độ chính xác và phạm vi toàn cầu để tối đa hóa tỷ lệ chuyển đổi đồng thời đảm bảo compliance.

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

Để đạt tỷ lệ chuyển đổi tối đa, hãy bật tính năng thu thập địa chỉ tối thiểu nhằm giảm trở ngại trên checkout. Khi minimal_address được đặt 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 sales tax, VAT hoặc GST
Tất cả các trường địa chỉ khác (đường, thành phố, bang/tỉnh) được bỏ qua, giúp đẩy nhanh đáng kể quá trình hoàn tất checkout.
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 đủ vẫn là mặc định. Bật minimal_address cho các sản phẩm kỹ thuật số và quy trình SaaS không yêu cầu đầy đủ thông tin thanh toán.

Minimal Address Reference

Xem tài liệu tham chiếu đầy đủ về tham số minimal_address trong hướng dẫn Checkout Sessions API.

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à có bắt buộc hay không — bằng các feature flag của checkout session.
require_phone_number: true yêu cầu allow_phone_number_collection: true. API từ chối các session 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 bắt buộc.
Sử dụng require_phone_number cho B2B SaaS, các ngành được quản lý hoặc bất kỳ quy trình nào cần kênh liên hệ đã xác minh để hỗ trợ, xem xét gian lận hoặc compliance.

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. Điều này hữu ích để thu thập dữ liệu như tên công ty, quy mô nhóm, nguồn giới thiệu hoặc bất kỳ thông tin cụ thể nào khác về 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à các response 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 checkout session.

Custom Fields Guide

Tìm hiểu thêm về cấu hình trường tùy chỉnh và cách truy cập response.

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

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

Checkout bộ sưu tập

Product Collections mang đến trải nghiệm checkout thống nhất, trong đó khách hàng có thể xem và 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.

Cách hoạt động

  1. Hiển thị tất cả sản phẩm: Khách hàng nhìn thấy mọi sản phẩm đang hoạt động trong collection
  2. Chọn trước sản phẩm đầu tiên: Sản phẩm đầu tiên trong collection được tự động chọn
  3. So sánh các tùy chọn: Khách hàng có thể so sánh giá và tính năng trước khi lựa chọn
  4. Chọn một sản phẩm: Sau khi chọn sản phẩm, checkout tiếp tục với quy trình thanh toán tiêu chuẩn

Tạo checkout cho collection

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 session.

Product Collections

Tìm hiểu cách tạo và quản lý product collection để mang lại trải nghiệm checkout thống nhất.

Cấu hình Checkout Session

Kiểm soát hành vi 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, emaillicense_key (nếu áp dụng). Xem hướng dẫn Checkout Sessions để biết danh sách đầy đủ.

Checkout Sessions API

Tài liệu tham chiếu API đầy đủ cho checkout session.

Checkout Integration Guide

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

Tùy chỉnh giao diện checkout

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 khi tạo checkout session thông qua API. Cấu hình màu sắc, font, border radius và văn bản nút cho cả chế độ sáng và tối.
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 theme dựng sẵn, typography, màu sắc và bản xem trước trực tiếp.
Phần này đề cập đến cấu hình theme server-side API bằng customization.theme_config. Nếu bạn đang sử dụng Checkout SDK (overlay hoặc inline checkout), hãy xem phần tùy chỉnh theme trong Overlay Checkout, sử dụng các property camelCase (ví dụ: bgPrimary thay vì bg_primary).

Tùy chọn cấu hình theme

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

Mỗi chế độ (lightdark) hỗ trợ các thuộc tính màu sau:
Tất cả các trường mà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ê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ị theme mặc định.
Lần sửa đổi cuối 31 tháng 7, 2026