개요
테스트 모드를 사용하면 실제 거래를 처리하지 않고 결제를 시뮬레이션할 수 있습니다. 모든 테스트 자격 증명은 테스트 모드에서만 작동하므로 프로덕션에서는 절대 사용하지 마세요.No Real Charges
테스트 거래는 실제 결제를 처리하지 않으며 실제 계정에 영향을 주지 않습니다.
Full API Access
모든 API endpoint는 테스트 모드와 live 모드에서 동일하게 작동합니다.
Webhook Testing
테스트 거래에서도 프로덕션과 마찬가지로 웹훅이 발생합니다.
테스트 카드
이 카드 번호를 사용하여 여러 지역에서 승인 및 거절된 결제를 시뮬레이션하세요.- Successful Payments
- Declined Payments
- Subscription Failure Testing (Renewal/Upgrade/Downgrade)
모든 테스트 카드에는 만료일 06/32(또는 12/34)와 CVV 123을 사용하세요.
갱신 실패 테스트 방법
1
Create a test subscription
성공 테스트 카드(예:
4242 4242 4242 4242)를 사용하여 테스트 API 키로 subscription을 생성하세요. 초기 청구가 성공하고 subscription이 active 상태가 되어야 합니다.2
Swap in the failure card via Customer Portal
Customer Portal을 열고 방금 생성한 subscription을 찾은 다음 Update Payment Method를 클릭하세요. 실패 테스트 카드
4000 0000 0000 0341(만료일: 12/34, CVC: 123)를 입력하고 subscription의 결제 수단으로 저장하세요.3
Advance the next billing date (optional)
자연스러운 billing cycle을 기다리는 대신 즉시 갱신을 트리거하려면 Update Subscription API를 사용하여 자세한 내용은 Update Subscription API reference를 참조하세요.
next_billing_date을 현재 UTC 시간으로 설정하세요. 값은 ISO 8601 / RFC 3339 UTC timestamp여야 합니다(Z suffix가 필요함).4
Verify the failure
다음 billing 시도에서:
- 갱신 청구가 실패 카드에서 거절됩니다
- subscription이 On-Hold 상태로 전환됩니다
payment.failed웹훅 event가 전달됩니다- 고객은 Customer Portal로 돌아가 결제 수단을 업데이트하고 재시도할 수 있습니다
테스트 UPI
UPI 테스트에서는 서로 다른 결제 결과를 시뮬레이션하는 특수 VPA(Virtual Payment Address) 식별자를 사용합니다.UPI 테스트 요구 사항
- Billing country는
IN로 설정해야 합니다 - Currency는
INR여야 합니다 - 인도 외 merchant의 경우: Adaptive Currency을 활성화해야 합니다
테스트 BNPL
Buy Now Pay Later provider에는 특정 테스트 데이터 요구 사항이 있습니다.Klarna 테스트 데이터
테스트 모드에서 Klarna 결제를 시뮬레이션하려면 다음 정보를 사용하세요:Klarna가 결제 옵션으로 표시되려면 최소 거래 금액이 $50.01이어야 합니다.
Afterpay 테스트
1
Select Afterpay
checkout에서 Afterpay를 결제 수단으로 선택하고 Pay를 클릭하세요.
2
Test successful payment
성공한 결제에는 유효한 이메일 주소와 배송 주소를 사용하세요.
3
Test failed authentication
실패를 시뮬레이션하려면 리디렉션 페이지에서 Afterpay 모달 창을 닫습니다. 결제가
requires_customer_action에서 requires_payment_method로 전환됩니다.Afterpay가 결제 옵션으로 표시되려면 최소 거래 금액이 $50.01이어야 합니다.
Digital Wallet 테스트
Apple Pay
1
Enable test mode
Dodo Payments 테스트 API keys를 사용하세요.
2
Add a card to Apple Wallet
실제 카드를 Apple Wallet에 추가하세요. 테스트 모드에서는 카드에 요금이 청구되지 않습니다.
3
Complete test purchase
Apple device에서 checkout을 열고 Apple Pay flow를 완료하세요.
Google Pay
1
Join the test card group
테스트 카드가 wallet에 자동으로 추가되도록 Google Pay 테스트 카드 그룹에 참여하세요.
2
Enable test mode
Dodo Payments 테스트 API keys를 사용하세요.
3
Complete test purchase
거래를 완료하려면 Google Pay에서 테스트 카드 중 하나를 선택하세요.
Amazon Pay, Cash App Pay 및 RevolutPay
테스트 API keys를 사용하고 표준 checkout flow를 따르세요. 테스트 거래는 실제 청구 없이 시뮬레이션됩니다. Apple Pay의 domain verification을 포함한 전체 digital wallet 문서는 Digital Wallets 페이지를 참조하세요.ACH Direct Debit 테스트
ACH Direct Debit은 결제 시 테스트 은행 정보를 입력하여 Test Mode에서 테스트할 수 있습니다.1
Enable test mode
Dodo Payments 테스트 API keys를 사용하세요.
2
Set currency and billing address
청구 통화를
USD로 설정하고 청구 주소 국가는 US로 설정하세요. 이 조합 외에서는 ACH를 사용할 수 없습니다.3
Use a one-time payment
구독 결제에서는 ACH를 사용할 수 없으므로 일회성 결제로 테스트하세요.
4
Enter the test bank details
아래의 테스트 라우팅 번호와 계좌 번호 조합 중 하나를 입력한 다음, webhook handler가 최종 결제 상태를 수신하는지 확인하세요. ACH 결제는 결제 시점이 아니라 비동기 방식으로 확정됩니다.
테스트 은행 계좌
라우팅 번호110000000를 다음 계좌 번호 중 하나와 함께 사용하세요:
테스트 계좌의 전체 목록은 ACH Direct Debit 페이지를 참조하세요.
유럽 결제 수단 테스트
유럽 결제 수단(iDEAL, Bancontact, EPS, Multibanco)은 Test Mode에서 테스트할 수 있습니다.1
Enable test mode
Dodo Payments 테스트 API 키를 사용하세요.
2
Set billing address
청구 주소 국가를 결제 수단에 맞게 설정하세요:
NL(iDEAL)BE(Bancontact)AT(EPS)PT(Multibanco)
3
Set currency
유럽 결제 수단에는 EUR 통화가 필요합니다.
4
Complete test flow
테스트 환경에서 시뮬레이션된 은행 인증 흐름을 따르세요.
테스트 SEPA Direct Debit IBAN
SEPA Direct Debit에는 EUR과 유로존 청구 주소가 필요합니다. 특정 결과를 강제로 발생시키려면 다음 테스트 IBAN을 사용하세요:
국가별 값이 포함된 테스트 IBAN의 전체 목록은 Europe 페이지를 참조하세요.
유럽 결제 수단에 대한 전체 문서는 Europe 페이지를 참조하세요.
테스트 모범 사례
Test all payment scenarios
Test all payment scenarios
성공한 결제만 테스트하지 마세요. 결제 거부, 취소, 잔액 부족과 같은 예외 상황도 테스트하세요.
Verify webhook handling
Verify webhook handling
webhook endpoint가 모든 event type, 특히
payment.succeeded, payment.failed 및 subscription event를 올바르게 처리하는지 확인하세요.Dodo Payments CLI를 사용하여 webhook을 로컬에서 테스트하세요:dodo wh listen는 실제 테스트 webhook을 로컬 서버로 전달합니다.dodo wh trigger는 지원되는 모든 webhook event type에 대한 mock payload를 전송합니다.
Test on real devices
Test on real devices
Apple Pay와 Google Pay는 실제 iOS 및 Android 기기에서 테스트하세요. 시뮬레이터는 wallet 동작을 완전히 재현하지 못합니다.
Test regional methods with correct addresses
Test regional methods with correct addresses
지역별 결제 수단(UPI, iDEAL 등)은 일치하는 청구 주소가 필요합니다. 미국 청구 주소를 사용하면 iDEAL이 표시되지 않습니다.
Verify minimum amounts
Verify minimum amounts
BNPL 결제 수단에는 $50.01의 최소 금액이 필요합니다. 장바구니 총액에 따라 해당 수단이 올바르게 표시되거나 숨겨지는지 테스트하세요.
관련 페이지
Cards
카드 테스트, 3D Secure 및 저장된 결제 수단입니다.
Digital Wallets
Apple Pay, Google Pay, Amazon Pay 테스트입니다.
BNPL
Klarna, Afterpay 및 Billie 테스트입니다.
India
UPI 및 RBI mandate 테스트입니다.
Europe
iDEAL, Bancontact, EPS, Multibanco 테스트입니다.
Webhooks
테스트 event에 대한 webhook을 설정합니다.
CLI Webhook Testing
Dodo Payments CLI를 사용하여 webhook을 로컬에서 테스트합니다.