Testing Process

Kiểm thử tích hợp của bạn với thẻ kiểm thử, UPI ID, dữ liệu BNPL và ví điện tử. Mô phỏng thanh toán, hoàn tiền và lỗi mà không phát sinh khoản phí thực tế.

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.

Successful Payments

Khu vực	Thương hiệu	Số thẻ	Ngày hết hạn	CVV
US	Visa	4242424242424242	06/32	123
US	Mastercard	5555555555554444	06/32	123
India	Visa	4576238912771450	06/32	123
India	Mastercard	5409162669381034	06/32	123

Declined Payments

Khu vực	Thương hiệu	Số thẻ	Tình huống	Mã lỗi
US	Visa	4000000000000002	Từ chối chung	GENERIC_DECLINE
US	Visa	4000000000009995	Không đủ tiền	INSUFFICIENT_FUNDS
India	Visa	4706131211212123	Từ chối chung	GENERIC_DECLINE
India	Mastercard	5105105105105100	Từ chối chung	GENERIC_DECLINE

Khi một thẻ kiểm thử bị từ chối, error_code và error_message của khoản thanh toán sẽ phản ánh tình huống ở trên. Tra cứu bất kỳ mã nào trong tài liệu tham khảo Transaction Failures để biết ý nghĩa và hành động được đề xuất. Xem Xử lý lỗi thanh toán để biết cách xử lý các khoản bị từ chối trong tích hợp của bạn.

Subscription Renewal Failures

Số thẻ	Ngày hết hạn	CVV
4000000000000341	12/34	123

Sử dụng thẻ này để kiểm thử các lỗi gia hạn, nâng cấp và hạ cấp subscription. Subscription sử dụng thẻ này sẽ bị từ chối ở lần tính phí tiếp theo, cho phép bạn kiểm thử các lần thử lại, thông báo cho khách hàng và cách xử lý lỗi.

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

   PATCH /subscriptions/{subscription_id}
   {
     "next_billing_date": "2026-05-03T00:00:00Z"
   }
   

   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.

Trạng thái	UPI ID
Thành công	success@upi
Thất bại	failure@upi

​

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.

Trường	Giá trị kiểm thử
CPF	00000000000 (11 số 0)

​

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:

Trường	Được chấp thuận	Bị từ chối
Ngày sinh	07-10-1970	07-10-1970
Tên	Test	Test
Họ	Person-us	Person-us
Email	[e-mail]	[e-mail]
Đường phố	Amsterdam Ave	Amsterdam Ave
Số nhà	509	509
Thành phố	New York	New York
Bang	New York	New York
Mã bưu chính	10024-3941	10024-3941
Điện thoại	[phone]	[phone]

Trong các checkout bằng USD, 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 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.

Trong các checkout bằng USD, 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 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:

Account Number	Hành vi
000123456789	Khoản thanh toán thành công.
000222222227	Khoản thanh toán thất bại do không đủ tiền.
000111111113	Khoản thanh toán thất bại vì tài khoản đã đóng.
000555555559	Khoản thanh toán thành công, sau đó phát sinh tranh chấp.
000000000009	Khoản thanh toán tiếp tục ở trạng thái đang xử lý vô thời hạn.

Để 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.

Multibanco hiển thị voucher thay vì luồng ngân hàng. Xem Test Multibanco.

1. Enable test mode

   Tắt nút chuyển Live Mode trong thanh bên của dashboard và sử dụng API keys được tạo ở 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 payment method:

   • NL cho iDEAL
   • BE cho Bancontact
   • AT cho EPS
   • PT cho Multibanco
3. Set currency

   Các payment method ở châu Âu yêu cầu currency EUR.

4. Complete test flow

   Thực hiện theo simulated bank authentication flow trong môi trường test.

​

Test Multibanco

Sử dụng EUR và địa chỉ thanh toán PT. Sau khi bạn nhấp Pay, checkout sẽ hiển thị voucher Multibanco. Trong test mode, email bạn nhập sẽ quyết định kết quả:

Email	Result
[e-mail]	Thanh toán thành công trong vài giây.
[e-mail]	Thanh toán thất bại trong vài giây.

Để xem trang thành công, sử dụng [e-mail], đợi vài giây rồi nhấn Done.

Để xem danh sách đầy đủ các email test, hãy xem trang Europe.

​

Test SEPA Direct Debit IBANs

SEPA Direct Debit yêu cầu EUR và địa chỉ thanh toán thuộc Eurozone. Sử dụng các IBAN test này để buộc một kết quả cụ thể:

Test IBAN	Behavior
DE89370400440532013000	Thanh toán thành công.
DE62370400440532013001	Thanh toán thất bại.
DE35370400440532013002	Thanh toán thành công, sau đó ngay lập tức bị dispute.
DE65370400440002222227	Thanh toán thất bại do không đủ tiền.

Để xem danh sách đầy đủ các IBAN test, 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 payment method ở châu Âu, hãy xem trang Europe.

​

Test Asia-Pacific Wallets

GCash, Alipay HK, FPS và Touch ‘n Go là các khoản thanh toán bằng mã QR chỉ xuất hiện khi quốc gia thanh toán và currency khớp nhau.

1. Enable test mode

   Tắt nút chuyển Live Mode trong thanh bên của dashboard và sử dụng API keys được tạo ở 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 tương ứng:

   Method	Billing Country	Billing Currency	Method Type
   GCash	PH	PHP	gcash
   Alipay HK	HK	HKD	ali_pay_hk
   FPS	HK	HKD hoặc CNY	fps
   Touch ‘n Go	MY	MYR	touch_n_go

3. Select the method and confirm

   Chọn method rồi nhấp Pay. Mã QR sẽ mở trong lớp phủ toàn màn hình và checkout sẽ chờ thanh toán.

4. Verify the checkout behavior

   Xác nhận rằng method chỉ xuất hiện với quốc gia và currency tương ứng, đồng thời mã QR được hiển thị.

Mã QR trong test mode được wallet provider phát hành từ test environment và có thể hoạt động khác với thanh toán live.

Để xem tài liệu đầy đủ, hãy xem trang Asia-Pacific.

​

Testing Best Practices

Test all payment scenarios

Đừng chỉ test các khoản thanh toán thành công. Hãy test cả các trường hợp bị từ chối, hủy và các trường hợp đặc biệt như không đủ tiền.

Verify webhook handling

Đảm bảo các webhook endpoint của bạn xử lý chính xác tất cả event type, đặc biệt là payment.succeeded, payment.failed và các subscription event.

Sử dụng Dodo Payments CLI để test webhook trên local:

• dodo wh listen chuyển tiếp live test webhook đến local server của bạn
• dodo wh trigger gửi mock payload cho tất cả webhook event type được hỗ trợ

Test on real devices

Đối với Apple Pay và Google Pay, hãy test trên thiết bị iOS và Android thực tế. Simulator không mô phỏng đầy đủ cách wallet hoạt động.

Test regional methods with correct addresses

Các payment method 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 Hoa Kỳ sẽ không hiển thị iDEAL.

Verify minimum amounts

Klarna và Afterpay yêu cầu mức tối thiểu $50.01 đối với checkout bằng USD. Hãy test để đảm bảo chúng xuất hiện hoặc bị ẩn chính xác dựa trên tổng tiền trong giỏ hàng.

​

Related Pages

Cards

Test card, 3D Secure và saved payment method.

Digital Wallets

Test Apple Pay, Google Pay và Amazon Pay.

BNPL

Test Klarna, Afterpay và Billie.

India

Test UPI và RBI mandate.

Pix

Test Pix với test CPF.

Europe

Test iDEAL, Bancontact, EPS và Multibanco.

Asia-Pacific

Test GCash, Alipay HK, FPS và Touch ‘n Go.

Webhooks

Thiết lập webhook cho các test event.

CLI Webhook Testing

Test webhook trên local bằng Dodo Payments CLI.