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 trang checkout
  3. Áp dụng PPP: Nếu sản phẩm đã bật Purchasing Power Parity, phần trăm theo quốc gia sẽ giảm giá cơ sở
  4. Chuyển đổi: Giá (hoặc giá đã điều chỉnh theo PPP) được chuyển đổi sang tiền tệ của khách hàng theo tỷ giá FX hiện tại
  5. Làm tròn: Nếu đã bật Charm Pricing, số tiền sau chuyển đổi sẽ được làm tròn về đuôi dễ nhớ như 49.99
  6. Hiển thị: Số tiền cuối cùng phải 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
Khi Purchasing Power Parity được bật cho một sản phẩm, khoản giảm giá sẽ áp dụng cho giá đã điều chỉnh theo PPP, không phải giá cơ sở.
Discount code entry on 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 gồm tối đa 20 mã được xếp chồng theo thứ tự. Trường đơn discount_code đã deprecated nhưng vẫn hoạt động — các integration hiện tại 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à response shape 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 bao phủ toàn cầu nhằm tối đa hóa conversion đồng thời đảm bảo compliance.

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

Để tối đa hóa conversion, 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 quá trình 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/mã bưu chính — chỉ ở những 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ố, tiểu bang) sẽ được bỏ qua, giúp rút ngắn đáng kể thời gian hoàn tất checkout.
Minimal address mode showing only country and ZIP/postal code fields on 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ề parameter 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 flags của checkout session.
require_phone_number: true yêu cầu allow_phone_number_collection: true. API sẽ từ chối các session khi 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.
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 một 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. Tính năng này hữu ích để thu thập dữ liệu như tên công ty, quy mô đội ngũ, nguồn giới thiệu hoặc bất kỳ thông tin nào khác đặc thù 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 sẽ tự động được đưa vào webhook payloads (payment.succeeded, subscription.active) và API responses 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 phản hồi.

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:
  • Các liên kết Privacy PolicyBuyer Terms được hiển thị rõ ràng trên checkout
  • Khách hàng phải xác nhận rõ ràng các nội dung này trước khi hoàn tất thanh toán
Đ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.

Collection Checkout

Product Collections mang đến trải nghiệm checkout thống nhất, trong đó khách hàng có thể xem và chọn từ nhiều sản phẩm liên quan (ví dụ: các gói Starter, Pro, Enterprise) trong cùng một checkout.

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 sẵn 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ỉ chọn một sản phẩm: Sau khi chọn sản phẩm, checkout tiếp tục theo quy trình thanh toán tiêu chuẩn

Tạo Collection Checkout

Khi sử dụng product_collection_id, hãy truyền một mảng product_cart rỗ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 collections để mang đến 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 parameters đượ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 sessions.

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 parameter customization.theme_config khi tạo checkout session thông qua API. Cấu hình màu sắc, font, border radius và nội dung nút cho cả chế độ sáng và tối.
Custom themed checkout page

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 trình bày 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).

Các 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 đề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ị theme mặc định.
Lần sửa đổi cuối 26 tháng 8, 2026