Tính năng Thanh toán - Dodo Payments Documentation

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.

Tiền tệ Thích ứng

Tiền tệ Thích ứng cho phép khách hàng thanh toán bằng đồng tiền địa phương mà họ ưa thích, cải thiện độ tin cậy và tỷ lệ chuyển đổi.

Cách Hoạt Động

Kích hoạt: Bật Tiền tệ Thích ứng từ Cài đặt → Doanh nghiệp
Chọn: Khách hàng có thể chuyển đổi tiền tệ trực tiếp khi thanh toán
Chuyển đổi: Giá được chuyển đổi động sử dụng tỷ giá hối đoái thực
Hiển thị: Số tiền cuối cùng phải trả được hiển thị minh bạch trước khi thanh toán

Adaptive Currency

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

Thanh toán Đa ngôn ngữ

Dodo Payments hỗ trợ nhiều ngôn ngữ trên trang thanh toán, 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.

Điểm Nổi Bật

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

Các Ngôn ngữ Hỗ trợ

Trang thanh toán hỗ trợ 21 ngôn ngữ:

Ngôn ngữ	Mã
Ả Rập	`ar`
Catalan	`ca`
Tiếng Trung	`zh`
Tiếng Hà Lan	`nl`
Tiếng Anh	`en`
Tiếng Pháp	`fr`
Tiếng Đức	`de`
Tiếng Do Thái	`he`
Tiếng Indonesia	`id`
Tiếng Ý	`it`
Tiếng Nhật	`ja`
Tiếng Hàn	`ko`
Tiếng Mã Lai	`ms`
Tiếng Ba Lan	`pl`
Tiếng Bồ Đào Nha	`pt`
Tiếng Romania	`ro`
Tiếng Nga	`ru`
Tiếng Tây Ban Nha	`es`
Tiếng Thụy Điển	`sv`
Tiếng Thái	`th`
Tiếng Thổ Nhĩ Kỳ	`tr`

Bạn có thể ép một ngôn ngữ cụ thể trên trang thanh toán bằng cách đặt tham số force_language khi tạo phiên thanh toán. Xem Checkout Sessions API để biết chi tiết.

Tính Thuế Tự Động

Thuế được tính tự động dựa trên vị trí 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à thuế bán hàng mà không cần cài đặt thủ công.

Cách hoạt động của việc tính thuế

Location Detection

Các 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ó).

Dynamic Updates

Số tiền thuế cập nhật tự động khi:

Thay đổi quốc gia
Cập nhật địa chỉ

Transparent Display

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ế hoàn toàn tự động. Không cần cấu hình thủ công cho hàng hóa kỹ thuật số tiêu chuẩn và sản phẩm SaaS.

Hỗ trợ Mã số Thuế Doanh nghiệp

Đối với doanh nghiệp đã đăng ký, trang thanh toán 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 hợp lệ thuế được xác thực theo thời gian thực
Áp dụng các miễn giảm thuế hoặc quy tắc thuế ngược thích hợp
Số tiền thuế cập nhật ngay lập tức trên trang thanh toán

Nhập mã số thuế doanh nghiệp khi thanh toán

Điều này đặc biệt hữu ích cho SaaS B2B và dịch vụ kỹ thuật số, nơi khách hàng doanh nghiệp có thể đủ điều kiện miễn thuế.

Mã Giảm Giá

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

Trải nghiệm thanh toán

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

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á:

const session = await client.checkoutSessions.create({
  product_cart: [
    { product_id: 'prod_abc', quantity: 1 }
  ],
  discount_codes: ['WELCOME20'], // Pre-apply one or more codes (max 20, applied in order)
  feature_flags: {
    allow_discount_code: true // Show discount input field
  },
  return_url: 'https://yoursite.com/return'
});

discount_codes chấp nhận một mảng tối đa 20 mã xếp chồng lần lượt. Trường đơn discount_code đã lỗi thời nhưng vẫn hoạt động — các tích hợp hiện tại không cần thay đổi ngay lập tức. Di chuyển sang discount_codes khi thuận tiện để sử dụng xếp chồng và hình thức phản hồi 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 giảm giá bằng cách sử dụng tên mã.

Thu Thập Địa Chỉ Thông Minh

Quy trình thanh toán hỗ trợ nhập địa chỉ linh hoạt để hoàn thành nhanh hơn.

Các Tùy Chọn Khả Dụng

Tùy Chọn	Mô tả
Google Address Autofill	Lựa chọn nhanh với tính năng tự động điền
Nhập Thủ Công	Kiểm soát hoàn toàn cho địa chỉ đầy đủ
Lựa Chọn Quốc Gia	Điều khiển logic thuế và tuân thủ

Thu thập địa chỉ cân bằng tốc độ, độ chính xác và phủ sóng toàn cầu để tối đa hóa chuyển đổi trong khi đảm bảo tuân thủ.

Thu Thập Số Điện Thoại

Kiểm soát xem trường số điện thoại có xuất hiện trong quá trình thanh toán hay không — và liệu nó có cần thiết hay không — bằng cách sử dụng các cờ tính năng phiên thanh toán.

Cờ	Mặc định	Hành vi
`allow_phone_number_collection`	`true`	Hiển thị trường số điện thoại trên mẫu thanh toán
`require_phone_number`	`false`	Làm cho trường số điện thoại bắt buộc (xác thực biểu mẫu buộc giá trị không rỗng)

const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'prod_abc', quantity: 1 }],
  feature_flags: {
    allow_phone_number_collection: true,
    require_phone_number: true
  },
  return_url: 'https://yoursite.com/return'
});

require_phone_number: true yêu cầu allow_phone_number_collection: true. API từ chối các phiên mà thu thập điện thoại bị vô hiệu hóa trong khi vẫn yêu cầu số điện thoại.

Sử dụng require_phone_number cho B2B SaaS, các ngành công nghiệp được quản lý, hoặc bất kỳ quy trình nào mà bạn cần một kênh liên hệ xác minh cho hỗ trợ, đánh giá gian lận, hoặc tuân thủ.

Trường Tùy Chỉnh

Thu thập thêm thông tin từ khách hàng trong quá trình thanh toán bằng cách xác định các trường biểu mẫu tùy chỉnh. Điều này hữu ích cho việc thu thập dữ liệu như tên công ty, quy mô đội nhóm, nguồn giới thiệu, hoặc bất kỳ thông tin đặc thù kinh doanh nào khác.

Loại Trường Khả Dụng

Loại	Mô tả
`text`	Nhập văn bản dòng đơn
`number`	Nhập số
`email`	Địa chỉ email với xác thực
`url`	URL với xác thực
`date`	Trình chọn ngày
`dropdown`	Chọn từ các tùy chọn được xác định trước
`boolean`	Chuyển đổi Có/Không

Ví Dụ

const session = await client.checkoutSessions.create({
  product_cart: [
    { product_id: 'prod_abc', quantity: 1 }
  ],
  custom_fields: [
    {
      key: 'company_name',
      label: 'Company Name',
      field_type: 'text',
      required: true
    },
    {
      key: 'team_size',
      label: 'Team Size',
      field_type: 'dropdown',
      required: true,
      options: ['1-10', '11-50', '51-200', '200+']
    }
  ],
  return_url: 'https://yoursite.com/return'
});

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

Custom Fields Guide

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

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

Để đảm bảo minh bạch về pháp lý và tuân thủ:

Liên kết Chính sách quyền riêng tư và Điều khoản người mua được hiển thị rõ ràng trong quá trình thanh toán
Khách hàng xác nhận rõ ràng những điều 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 bảo vệ người tiêu dùng toàn cầu và quyền riêng tư dữ liệu bao gồm cả tuân thủ GDPR.

Thanh Toán Bộ Sưu Tập

Bộ sưu tập sản phẩm cho phép trải nghiệm thanh toán hợp nhất nơi khách hàng có thể xem và chọn từ nhiều sản phẩm liên quan (ví dụ: gói Starter, Pro, Enterprise) trong một lần thanh toán.

Cách Thức Hoạt Động

Tất cả sản phẩm được hiển thị: Khách hàng thấy mọi sản phẩm đang hoạt động trong bộ sưu tập
Sản phẩm đầu tiên được chọn trước: Sản phẩm đầu tiên trong bộ sưu tập được tự động chọn
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
Chọn đơn lẻ: Sau khi chọn sản phẩm, thanh toán sẽ tiếp tục theo luồng thanh toán tiêu chuẩn

Tạo Thanh Toán Bộ Sưu Tập

const session = await client.checkoutSessions.create({
  product_collection_id: 'pdc_abc123',
  product_cart: [], // Required: pass an empty array for collection checkout
  return_url: 'https://yoursite.com/return'
});

Khi sử dụng product_collection_id, truyền một mảng product_cart rỗng. Mã giảm giá không thể được áp dụng trước khi tạo phiên.

Product Collections

Tìm hiểu cách tạo và quản lý bộ sưu tập sản phẩm để có trải nghiệm thanh toán hợp nhất.

Cấu Hình Phiên Thanh Toán

Kiểm soát hành vi thanh toán bằng cách sử dụng Checkout Sessions API:

const session = await client.checkoutSessions.create({
  product_cart: [
    { product_id: 'prod_abc', quantity: 1 }
  ],
  customer: {
    email: 'customer@example.com',
    name: 'Jane Doe'
  },
  billing_currency: 'EUR', // Set specific currency
  discount_codes: ['PROMO10'],
  feature_flags: {
    allow_discount_code: true
  },
  return_url: 'https://yoursite.com/return',
  cancel_url: 'https://yoursite.com/pricing', // Optional: where to redirect on cancel
  metadata: {
    order_ref: 'ORD-12345'
  }
});

Sau khi thanh toán, khách hàng sẽ được chuyển hướng đến return_url của bạn với các tham số truy vấn đượ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

Hoàn thành tài liệu tham khảo API cho các phiên thanh toán.

Checkout Integration Guide

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

Tùy Chỉnh Giao Diện Thanh Toán

Tùy chỉnh giao diện trang thanh toán để khớp với thương hiệu của bạn bằng cách sử dụng tham số customization.theme_config khi tạo một phiên thanh toán qua API. Cấu hình màu sắc, phông chữ, bán kính viền và văn bản nút cho cả chế độ sáng và tối.

Design & Theme Customization

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

Phần này bao gồm cấu hình chủ đề API phía máy chủ sử dụng customization.theme_config. Nếu bạn đang sử dụng Checkout SDK (thanh toán lớp phủ hoặc thanh toán nội tuyến), hãy xem các phần tùy chỉnh chủ đề trong Overlay Checkout hoặc Inline Checkout sử dụng các thuộc tính camelCase (ví dụ, bgPrimary thay vì bg_primary).

Tùy Chọn Cấu Hình Chủ Đề

Thuộc Tính	Mô tả
`light`	Cấu hình màu cho chế độ sáng
`dark`	Cấu hình màu cho chế độ tối
`font_primary_url`	URL cho phông chính
`font_secondary_url`	URL cho phông phụ
`font_size`	Kích thước phông: `xs`, `sm`, `md`, `lg`, `xl`, `2xl`
`font_weight`	Trọng lượng phông: `normal`, `medium`, `bold`, `extraBold`
`radius`	Bán kính viền cho các yếu tố giao diện người dùng (ví dụ, `4px`, `0.5rem`, `8px`)
`pay_button_text`	Văn bản tùy chỉnh cho nút thanh toán (ví dụ, “Hoàn tất Mua hàng”, “Đăng ký Ngay”)

Cấu Hình Màu Sắc (Chế Độ Sáng/Tối)

Mỗi chế độ (light và dark) hỗ trợ các thuộc tính màu sắc sau đây:

Thuộc Tính	Mô tả
`bg_primary`	Màu nền chính
`bg_secondary`	Màu nền phụ
`text_primary`	Màu văn bản chính
`text_secondary`	Màu văn bản phụ
`text_placeholder`	Màu văn bản giả
`text_error`	Màu văn bản lỗi
`text_success`	Màu văn bản thành công
`border_primary`	Màu viền chính
`border_secondary`	Màu viền phụ
`button_primary`	Màu nền nút chính
`button_primary_hover`	Màu nút chính khi di chuột
`button_secondary`	Màu nền nút phụ
`button_secondary_hover`	Màu nút phụ khi di chuột
`button_text_primary`	Màu văn bản nút chính
`button_text_secondary`	Màu văn bản nút phụ
`input_focus_border`	Màu viền tiêu điểm đầu vào

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 tên: red, blue, transparent

Ví Dụ

const session = await client.checkoutSessions.create({
  product_cart: [
    { product_id: 'prod_abc', quantity: 1 }
  ],
  customization: {
    theme_config: {
      // Custom fonts
      font_primary_url: 'https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600&display=swap',
      font_size: 'md',
      font_weight: 'medium',
      radius: '8px',
      pay_button_text: 'Complete Purchase',
      
      // Light mode colors
      light: {
        bg_primary: '#ffffff',
        bg_secondary: '#f5f5f5',
        text_primary: '#1a1a1a',
        text_secondary: '#666666',
        button_primary: '#0066ff',
        button_primary_hover: '#0052cc',
        button_text_primary: '#ffffff',
        border_primary: '#e0e0e0'
      },
      
      // Dark mode colors
      dark: {
        bg_primary: '#1a1a1a',
        bg_secondary: '#2d2d2d',
        text_primary: '#ffffff',
        text_secondary: '#a0a0a0',
        button_primary: '#3385ff',
        button_primary_hover: '#4d99ff',
        button_text_primary: '#ffffff',
        border_primary: '#404040'
      }
    }
  },
  return_url: 'https://yoursite.com/return'
});

Bạn không cần phải chỉ định tất cả các thuộc tính màu. Bất kỳ thuộc tính nào không được chỉ định sẽ sử dụng các giá trị chủ đề mặc định.

Documentation Index

Checkout Sessions API

Preview Checkout

Payment Methods

​Tiền tệ Thích ứng

​Cách Hoạt Động

Adaptive Currency

​Thanh toán Đa ngôn ngữ

​Điểm Nổi Bật

​Các Ngôn ngữ Hỗ trợ

​Tính Thuế Tự Động

​Cách hoạt động của việc tính thuế

​Hỗ trợ Mã số Thuế Doanh nghiệp

​Điều gì xảy ra khi nhập Mã số Thuế

​Mã Giảm Giá

​Trải nghiệm thanh toán

​Tích hợp API

Discount Codes

Validate Discount by Code

​Thu Thập Địa Chỉ Thông Minh

​Các Tùy Chọn Khả Dụng

​Thu Thập Số Điện Thoại

​Trường Tùy Chỉnh

​Loại Trường Khả Dụng

​Ví Dụ

Custom Fields Guide

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

​Thanh Toán Bộ Sưu Tập

​Cách Thức Hoạt Động

​Tạo Thanh Toán Bộ Sưu Tập

Product Collections

​Cấu Hình Phiên Thanh Toán

Checkout Sessions API

Checkout Integration Guide

​Tùy Chỉnh Giao Diện Thanh Toán

Design & Theme Customization

​Tùy Chọn Cấu Hình Chủ Đề

​Cấu Hình Màu Sắc (Chế Độ Sáng/Tối)

​Ví Dụ

Tiền tệ Thích ứng

Cách Hoạt Động

Thanh toán Đa ngôn ngữ

Điểm Nổi Bật

Các Ngôn ngữ Hỗ trợ

Tính Thuế Tự Động

Cách hoạt động của việc tính thuế

Hỗ trợ Mã số Thuế Doanh nghiệp

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

Mã Giảm Giá

Trải nghiệm thanh toán

Tích hợp API

Thu Thập Địa Chỉ Thông Minh

Các Tùy Chọn Khả Dụng

Thu Thập Số Điện Thoại

Trường Tùy Chỉnh

Loại Trường Khả Dụng

Ví Dụ

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

Thanh Toán Bộ Sưu Tập

Cách Thức Hoạt Động

Tạo Thanh Toán Bộ Sưu Tập

Cấu Hình Phiên Thanh Toán

Tùy Chỉnh Giao Diện Thanh Toán

Tùy Chọn Cấu Hình Chủ Đề

Cấu Hình Màu Sắc (Chế Độ Sáng/Tối)

Ví Dụ