Skip to main content
Sử dụng thông tin xác thực kiểm thử trên trang này để mô phỏng các khoản thanh toán thành công, bị từ chối và thất bại trong test mode. Không có khoản tiền nào được chuyển và không có tài khoản thực nào bị tính phí. Để xem một khoản thanh toán kiểm thử hoàn chỉnh, hãy xem video này.

Full API Access

Mọi API endpoint đều khả dụng trong test mode.

Webhook Testing

Webhook được kích hoạt cho các giao dịch kiểm thử giống như trong môi trường production.
Thông tin xác thực kiểm thử chỉ hoạt động trong test mode. Trong live mode, thanh toán được thực hiện bằng thông tin xác thực kiểm thử sẽ thất bại.

​
Thẻ kiểm thử

Sử dụng các số thẻ này để mô phỏng thanh toán thành công và bị từ chối ở nhiều khu vực khác nhau.
Với mọi thẻ kiểm thử, hãy sử dụng ngày hết hạn 06/32 (hoặc 12/34) và CVV 123.

​
Kiểm thử lỗi gia hạn

1

Create a test subscription

Tạo subscription bằng API key kiểm thử của bạn và một thẻ kiểm thử thành công (ví dụ: 4242424242424242). Khoản tính phí ban đầu phải thành công và subscription phải chuyển sang trạng thái active.
2

Update the payment method

Mở Customer Portal, tìm subscription và nhấp Update Payment Method. Nhập thẻ kiểm thử lỗi 4000000000000341 (Expiry: 12/34, CVV: 123), sau đó lưu.
3

Advance the next billing date (optional)

Để kích hoạt gia hạn ngay lập tức thay vì chờ chu kỳ tính phí tự nhiên, hãy sử dụng Update Subscription API để đặt next_billing_date thành thời gian UTC hiện tại, thay thế giá trị ví dụ bên dưới. Giá trị phải là timestamp UTC theo ISO 8601 / RFC 3339 (bắt buộc có hậu tố Z).
Xem tài liệu tham khảo Update Subscription API để biết chi tiết.
4

Verify the failure

Trong lần thử tính phí tiếp theo:
  • Khoản tính phí gia hạn bị từ chối trên thẻ lỗi
  • Subscription trước tiên chuyển sang Past Due (thời gian gia hạn; webhook subscription.past_due mang theo past_due_ends_at), sau đó chuyển sang On-Hold khi thời gian gia hạn kết thúc
  • Một sự kiện webhook payment.failed được gửi
  • Khách hàng có thể quay lại Customer Portal để cập nhật phương thức thanh toán và thử lại

​
Kiểm thử UPI

Kiểm thử UPI sử dụng các mã định danh VPA (Virtual Payment Address) đặc biệt để mô phỏng nhiều kết quả thanh toán khác nhau.

​
Yêu cầu kiểm thử UPI

  • Quốc gia thanh toán phải được đặt thành IN
  • Currency phải là INR
  • Đối với merchant không ở Ấn Độ: phải bật Adaptive Currency
Để xem tài liệu UPI đầy đủ, bao gồm kiểm thử RBI mandate cho subscription, hãy xem trang Phương thức thanh toán tại Ấn Độ.

​
Kiểm thử Pix

Kiểm thử Pix sử dụng CPF kiểm thử (mã số thuế Brazil) để mô phỏng quy trình QR code.

​
Yêu cầu kiểm thử Pix

  • Quốc gia thanh toán phải được đặt thành BR
  • Currency phải là BRL
Nhập CPF kiểm thử khi được yêu cầu tại checkout. Một QR code kiểm thử sẽ được tạo — quét mã bằng camera thông thường trên điện thoại (không cần ứng dụng Pix), sau đó bạn sẽ được chuyển hướng đến một trang kiểm thử, nơi có thể mô phỏng giao dịch thành công hoặc thất bại. Để xem tài liệu Pix đầy đủ, hãy xem trang Pix.

​
Kiểm thử BNPL

Các nhà cung cấp Buy Now Pay Later có những yêu cầu dữ liệu kiểm thử cụ thể.

​
Dữ liệu kiểm thử Klarna

Sử dụng các thông tin sau để mô phỏng thanh toán Klarna trong test mode:
Klarna yêu cầu số tiền giao dịch tối thiểu là $50.01 để xuất hiện dưới dạng một tùy chọn thanh toán.

​
Kiểm thử Afterpay

1

Select Afterpay

Chọn Afterpay làm phương thức thanh toán trong checkout và nhấp Pay.
2

Test successful payment

Sử dụng bất kỳ địa chỉ email và địa chỉ giao hàng hợp lệ nào cho các khoản thanh toán thành công.
3

Test failed authentication

Để mô phỏng lỗi, hãy đóng cửa sổ modal Afterpay trên trang chuyển hướng. Khoản thanh toán chuyển từ requires_customer_action sang requires_payment_method.
Afterpay yêu cầu số tiền giao dịch tối thiểu là $50.01 để xuất hiện dưới dạng một tùy chọn thanh toán.
Để xem tài liệu BNPL đầy đủ, bao gồm kiểm thử Billie B2B, hãy xem trang Buy Now Pay Later.

​
Kiểm thử ví điện tử

​
Apple Pay

1

Enable test mode

Tắt công tắc Live Mode trong thanh bên dashboard và sử dụng API key được tạo trong test mode. Xem Test Mode vs Live Mode.
2

Add a card to Apple Wallet

Thêm một thẻ thật vào Apple Wallet. Trong test mode, thẻ sẽ không bị tính phí.
3

Complete test purchase

Mở checkout trên thiết bị Apple và hoàn tất quy trình Apple Pay.
Apple Pay yêu cầu HTTPS. Apple Pay sẽ không xuất hiện trên localhost nếu chưa thiết lập SSL đúng cách. Việc xác minh domain cũng phải hoàn tất.

​
Google Pay

1

Join the test card group

Tham gia nhóm thẻ kiểm thử Google Pay để tự động thêm thẻ kiểm thử vào wallet.
2

Enable test mode

Tắt công tắc Live Mode trong thanh bên dashboard và sử dụng API key được tạo trong test mode. Xem Test Mode vs Live Mode.
3

Complete test purchase

Chọn một trong các thẻ kiểm thử trong Google Pay để hoàn tất giao dịch.

​
Amazon Pay, Cash App Pay và RevolutPay

Sử dụng API key kiểm thử và thực hiện quy trình checkout tiêu chuẩn. Các giao dịch kiểm thử được mô phỏng mà không phát sinh khoản phí thực tế. Để xem tài liệu ví điện tử đầy đủ, bao gồm xác minh domain cho Apple Pay, hãy xem trang Ví điện tử.

​
Kiểm thử ACH Direct Debit

ACH Direct Debit có thể được kiểm thử trong test mode bằng cách nhập thông tin ngân hàng kiểm thử tại checkout.
1

Enable test mode

Tắt công tắc Live Mode trong thanh bên dashboard và sử dụng API key được tạo trong test mode. Xem Test Mode vs Live Mode.
2

Set currency and billing address

Đặt currency thanh toán thành USD và quốc gia của địa chỉ thanh toán thành US. ACH không được cung cấp ngoài tổ hợp này.
3

Use a one-time payment

ACH không khả dụng trên checkout subscription, vì vậy hãy kiểm thử bằng một khoản thanh toán một lần.
4

Enter the test bank details

Nhập một trong các cặp routing number và account number kiểm thử bên dưới, sau đó xác nhận webhook handler nhận được trạng thái thanh toán cuối cùng — thanh toán ACH được xác nhận không đồng bộ thay vì tại checkout.

​
Tài khoản ngân hàng kiểm thử

Sử dụng routing number 110000000 với bất kỳ account number nào sau đây: Để xem danh sách đầy đủ các tài khoản kiểm thử, hãy xem trang ACH Direct Debit.

​
Kiểm thử phương thức thanh toán châu Âu

Các phương thức thanh toán châu Âu (iDEAL, Bancontact, EPS, Multibanco) có thể được kiểm thử trong test mode.
1

Enable test mode

Tắt công tắc Live Mode trong thanh bên dashboard và sử dụng API key được tạo trong test mode. Xem Test Mode vs Live Mode.
2

Set billing address

Đặt quốc gia của địa chỉ thanh toán khớp với phương thức thanh toán:
  • NL cho iDEAL
  • BE cho Bancontact
  • AT cho EPS
  • PT cho Multibanco
3

Set currency

Các phương thức châu Âu yêu cầu currency EUR.
4

Complete test flow

Thực hiện quy trình xác thực ngân hàng mô phỏng trong môi trường kiểm thử.

​
IBAN kiểm thử cho SEPA Direct Debit

SEPA Direct Debit yêu cầu EUR và địa chỉ thanh toán thuộc Eurozone. Sử dụng các IBAN kiểm thử này để buộc một kết quả cụ thể: Để xem danh sách đầy đủ các IBAN kiểm thử, bao gồm giá trị theo từng quốc gia, hãy xem trang Europe. Để xem tài liệu đầy đủ về các phương thức thanh toán châu Âu, hãy xem trang Europe.

​
Kiểm thử ví khu vực châu Á - Thái Bình Dương

GCash, Alipay HK, FPS và Touch ‘n Go là các phương thức thanh toán bằng QR code chỉ xuất hiện khi quốc gia và currency thanh toán khớp nhau.
1

Enable test mode

Tắt công tắc Live Mode trong thanh bên dashboard và sử dụng API key được tạo trong test mode. Xem Test Mode vs Live Mode.
2

Set billing country and currency

Tạo checkout một lần với cặp thông tin tương ứng:
3

Select the method and confirm

Chọn phương thức và nhấp Pay. Một QR code mở trong lớp phủ toàn màn hình và checkout chờ thanh toán.
4

Verify the checkout behavior

Xác nhận phương thức chỉ xuất hiện với quốc gia và currency tương ứng, đồng thời QR code được hiển thị.
QR code trong test mode được nhà cung cấp wallet phát hành từ môi trường kiểm thử và có thể hoạt động khác với thanh toán live.
Để xem tài liệu đầy đủ, hãy xem trang Châu Á - Thái Bình Dương.

​
Quy trình kiểm thử tốt nhất

Đừng chỉ kiểm thử các khoản thanh toán thành công. Hãy kiểm thử cả việc từ chối, hủy và các trường hợp đặc biệt như không đủ tiền.
Đảm bảo các webhook endpoint của bạn xử lý chính xác mọi loại sự kiện, đặc biệt là payment.succeeded, payment.failed và các sự kiện subscription.Sử dụng Dodo Payments CLI để kiểm thử webhook trên local:
  • dodo wh listen chuyển tiếp webhook kiểm thử live đến server local của bạn
  • dodo wh trigger gửi payload giả lập cho tất cả loại sự kiện webhook được hỗ trợ
Đối với Apple Pay và Google Pay, hãy kiểm thử trên thiết bị iOS và Android thực tế. Trình mô phỏng không tái hiện đầy đủ hành vi của wallet.
Các phương thức thanh toán theo khu vực (UPI, iDEAL, v.v.) yêu cầu địa chỉ thanh toán tương ứng. Địa chỉ thanh toán tại US sẽ không hiển thị iDEAL.
Các phương thức BNPL yêu cầu tối thiểu $50.01. Hãy kiểm thử để đảm bảo chúng hiển thị hoặc ẩn chính xác dựa trên tổng giá trị giỏ hàng.

​
Trang liên quan

Cards

Kiểm thử thẻ, 3D Secure và phương thức thanh toán đã lưu.

Digital Wallets

Kiểm thử Apple Pay, Google Pay và Amazon Pay.

BNPL

Kiểm thử Klarna, Afterpay và Billie.

India

Kiểm thử UPI và RBI mandate.

Pix

Kiểm thử Pix với CPF kiểm thử.

Europe

Kiểm thử iDEAL, Bancontact, EPS và Multibanco.

Asia-Pacific

Kiểm thử GCash, Alipay HK, FPS và Touch ‘n Go.

Webhooks

Thiết lập webhook cho các sự kiện kiểm thử.

CLI Webhook Testing

Kiểm thử webhook trên local bằng Dodo Payments CLI.
Lần sửa đổi cuối 26 tháng 9, 2026