Skip to main content
Thẻ khả dụng trên mọi trang thanh toán của Dodo Payments, tại mọi quốc gia và loại tiền tệ được hỗ trợ. Dodo Payments chấp nhận các mạng thẻ lớn, thay thế số thẻ bằng token và thực hiện các bước kiểm tra cần thiết cho thanh toán bằng thẻ, vì vậy bạn không phải xử lý dữ liệu thẻ thô.

Mạng lưới thẻ được hỗ trợ

Dodo Payments chấp nhận các mạng lưới toàn cầu và một số mạng lưới khu vực.

Mạng lưới toàn cầu

Các mạng lưới khu vực

Cấu hình

Thẻ sử dụng hai giá trị trong allowed_payment_method_types: Phiên này chỉ cung cấp thanh toán bằng thẻ:
Bao gồm cả credit và debit trừ khi bạn có lý do cụ thể để loại trừ một giá trị. Nhiều khách hàng thích thanh toán bằng thẻ ghi nợ.

Xác thực 3D Secure

3D Secure (3DS) yêu cầu ngân hàng của chủ thẻ xác nhận danh tính của chủ thẻ, chẳng hạn bằng mã dùng một lần, kiểm tra sinh trắc học hoặc phê duyệt trong ứng dụng ngân hàng. Điều này giúp giảm gian lận và các khoản bồi hoàn.

Khi 3DS được kích hoạt

Dodo Payments yêu cầu 3DS khi:
  • Mạng lưới thẻ yêu cầu.
  • Quy định khu vực yêu cầu, chẳng hạn như PSD2 tại châu Âu.
  • Giao dịch được đánh dấu là có rủi ro cao.

Bắt buộc 3DS

Để yêu cầu 3DS cho mọi khoản thanh toán bằng thẻ của doanh nghiệp, hãy bật 3D Secure trong Settings → Pricing. Để ghi đè cài đặt đó cho một phiên thanh toán, hãy truyền force_3ds:
Việc yêu cầu 3DS cho mọi giao dịch giúp giảm gian lận nhưng có thể làm giảm tỷ lệ chuyển đổi, vì một số khách hàng rời khỏi quy trình thanh toán trong lúc xác thực.

Xử lý lỗi xác thực

Khi một khoản thanh toán cần xác thực 3DS, khoản thanh toán sẽ chuyển qua các trạng thái trung gian trước khi thành công hoặc thất bại: Nếu quá trình xác thực không hoàn tất, khoản thanh toán sẽ thất bại với một trong các mã từ chối sau:
  • AUTHENTICATION_FAILURE: không thể xác thực khách hàng.
  • AUTHENTICATION_REQUIRED: yêu cầu xác thực nhưng chưa được thực hiện.
  • AUTHENTICATION_TIMEOUT: khách hàng không phản hồi kịp thời.
Tài liệu tham khảo Lỗi giao dịch liệt kê hành động được khuyến nghị cho từng mã.

Khi thanh toán so với khi gia hạn

  • Khi thanh toán (khách hàng có mặt): Thử thách 3DS xuất hiện trong quá trình thanh toán. Nếu thất bại, hãy yêu cầu khách hàng thử lại hoặc sử dụng thẻ khác.
  • Khi gia hạn subscription (khách hàng không có mặt): Không thể hiển thị thử thách 3DS theo thời gian thực. Nếu việc gia hạn yêu cầu xác thực và thất bại, subscription sẽ chuyển sang on_hold hoặc trước tiên chuyển sang past_due nếu bạn đã thiết lập thời gian gia hạn. Để khôi phục, hãy yêu cầu khách hàng quay lại và cập nhật phương thức thanh toán. Xem Xử lý lỗi thanh toán và Nhắc nợ subscription.

Phương thức thanh toán đã lưu

Khách hàng quay lại có thể thanh toán bằng thẻ đã lưu từ một lần thanh toán trước đó.

Tokenized

Số thẻ gốc không bao giờ được lưu trữ.

PCI Compliant

Dodo Payments xử lý việc tuân thủ PCI.

Customer-Scoped

Mỗi thẻ đã lưu thuộc về một khách hàng.

Bật thẻ đã lưu

Để hiển thị thẻ đã lưu của khách hàng quay lại tại bước thanh toán, hãy truyền show_saved_payment_methods: true cùng với customer_id hiện có. Giá trị mặc định là false.

Mua hàng bằng một cú nhấp

Để tính phí thẻ đã lưu mà không hiển thị bước thanh toán, hãy truyền payment_method_id cùng với confirm: true và customer_id hiện có. Phiên sẽ tính phí trực tiếp vào thẻ và không trả về checkout_url, vì vậy hãy sử dụng webhooks để biết kết quả thanh toán.

Kiểm thử

Sử dụng các thẻ này trong test mode. Để biết thêm dữ liệu kiểm thử, hãy xem Quy trình kiểm thử.
Thẻ kiểm thử chỉ hoạt động trong test mode. Trong live mode, khoản thanh toán được thực hiện bằng thẻ kiểm thử sẽ thất bại.

Bảo mật & tuân thủ

Dodo Payments áp dụng các biện pháp bảo vệ sau cho thanh toán bằng thẻ:

Phương pháp hay nhất

Không hạn chế loại thẻ trừ khi cần thiết. Khách hàng mong muốn thẻ ưa thích của họ hoạt động.
Hiển thị logo Visa, Mastercard và Amex trên trang web để tạo dựng niềm tin.
Hiển thị thông báo lỗi rõ ràng. Không hiển thị mã lỗi thô cho khách hàng.
Phương thức thanh toán đã lưu giúp khách hàng quay lại mua hàng nhanh hơn.

Khắc phục sự cố

Nguyên nhân: Không đủ tiền, thẻ đã hết hạn, CVV không chính xác hoặc cơ chế bảo vệ chống gian lận của ngân hàng.Giải pháp: Yêu cầu khách hàng kiểm tra thông tin hoặc thử thẻ khác. Tra cứu mã lỗi của lần từ chối và hành động được khuyến nghị tương ứng trong tài liệu tham khảo Lỗi giao dịch. Xem Xử lý lỗi thanh toán để xử lý các lần từ chối trong code.
Nguyên nhân: Khách hàng đã bỏ qua thử thách, hệ thống của ngân hàng không khả dụng hoặc thử thách đã hết thời gian.Giải pháp: Thử lại hoặc yêu cầu khách hàng liên hệ với ngân hàng. Xem Xử lý lỗi xác thực để biết các trạng thái thanh toán và mã từ chối liên quan.
Nguyên nhân: Mạng lưới khu vực không được hỗ trợ hoặc thẻ là thẻ trả trước bị hạn chế.Giải pháp: Yêu cầu khách hàng thử thẻ từ một mạng lưới lớn.

Các trang liên quan

Payment Methods Overview

Tất cả phương thức thanh toán được hỗ trợ.

Upsells & Downsells

Mua hàng bằng một cú nhấp với thẻ đã lưu.

Testing Process

Dữ liệu kiểm thử cho mọi phương thức thanh toán.

Subscriptions

Thanh toán định kỳ bằng thẻ.
Lần sửa đổi cuối 28 tháng 9, 2026