Full API Access
모든 API endpoint는 테스트 모드에서 사용할 수 있습니다.
Webhook Testing
Webhooks는 production과 동일한 방식으로 테스트 거래에 대해 실행됩니다.
테스트 카드
다양한 지역에서 성공 및 거부된 결제를 시뮬레이션하려면 다음 카드 번호를 사용하세요.- Successful Payments
- Declined Payments
- Subscription Renewal Failures
갱신 실패 테스트
1
Create a test subscription
success 테스트 카드(예:
4242424242424242)를 사용하여 테스트 API keys로 subscription을 생성하세요. 초기 청구는 성공하고 subscription은 active 상태가 되어야 합니다.2
Update the payment method
Customer Portal을 열고 subscription을 찾아 Update Payment Method를 클릭하세요. failure 테스트 카드
4000000000000341(만료일: 12/34, CVV: 123)를 입력하고 저장하세요.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 시도에서:
- 갱신 청구가 failure 카드에서 거부됩니다
- subscription이 먼저 Past Due(grace period;
subscription.past_duewebhook에past_due_ends_at가 포함됨) 상태로 이동한 다음 grace period가 끝나면 On-Hold 상태로 이동합니다 payment.failedwebhook event가 전달됩니다- customer는 Customer Portal로 돌아가 payment method를 업데이트하고 retry할 수 있습니다
테스트 UPI
UPI testing에서는 서로 다른 결제 결과를 시뮬레이션하는 특수 VPA(Virtual Payment Address) 식별자를 사용합니다.UPI Testing 요구 사항
- Billing country는
IN로 설정해야 합니다 - Currency는
INR여야 합니다 - 인도 외부의 merchant: Adaptive Currency를 활성화해야 합니다
테스트 Pix
Pix testing에서는 QR code flow를 시뮬레이션하기 위해 테스트 CPF(Brazilian tax ID)를 사용합니다.Pix Testing 요구 사항
- Billing country는
BR로 설정해야 합니다 - Currency는
BRL여야 합니다
테스트 BNPL
Buy Now Pay Later provider에는 특정 테스트 데이터 요구 사항이 있습니다.Klarna 테스트 데이터
test mode에서 Klarna payment를 시뮬레이션하려면 다음 정보를 사용하세요:Klarna가 payment option으로 표시되려면 최소 transaction amount가 $50.01이어야 합니다.
Afterpay Testing
1
Select Afterpay
checkout에서 Afterpay를 payment method로 선택하고 Pay를 클릭하세요.
2
Test successful payment
성공적인 payment에는 유효한 email address와 shipping address를 사용하세요.
3
Test failed authentication
실패를 시뮬레이션하려면 redirect page에서 Afterpay modal window를 닫으세요. payment가
requires_customer_action에서 requires_payment_method로 전환됩니다.Afterpay가 payment option으로 표시되려면 최소 transaction amount가 $50.01이어야 합니다.
디지털 지갑 테스트
Apple Pay
1
Enable test mode
dashboard sidebar에서 Live Mode switch를 끄고 test mode에서 생성한 API keys를 사용하세요. Test Mode vs Live Mode를 참조하세요.
2
Add a card to Apple Wallet
실제 카드를 Apple Wallet에 추가하세요. test mode에서는 카드에 요금이 청구되지 않습니다.
3
Complete test purchase
Apple device에서 checkout을 열고 Apple Pay flow를 완료하세요.
Google Pay
1
Join the test card group
테스트 카드가 wallet에 자동으로 추가되도록 Google Pay test card group에 참여하세요.
2
Enable test mode
dashboard sidebar에서 Live Mode switch를 끄고 test mode에서 생성한 API keys를 사용하세요. Test Mode vs Live Mode를 참조하세요.
3
Complete test purchase
Google Pay에서 테스트 카드 중 하나를 선택하여 transaction을 완료하세요.
Amazon Pay, Cash App Pay 및 RevolutPay
테스트 API keys를 사용하고 standard checkout flow를 따르세요. 테스트 transaction은 실제 청구 없이 시뮬레이션됩니다. Apple Pay의 domain verification을 포함한 전체 digital wallet documentation은 Digital Wallets 페이지를 참조하세요.테스트 ACH Direct Debit
ACH Direct Debit은 checkout에서 테스트 bank details를 입력하여 test mode에서 테스트할 수 있습니다.1
Enable test mode
dashboard sidebar에서 Live Mode switch를 끄고 test mode에서 생성한 API keys를 사용하세요. Test Mode vs Live Mode를 참조하세요.
2
Set currency and billing address
billing currency를
USD로, billing address country를 US로 설정하세요. 이 조합 외에서는 ACH가 제공되지 않습니다.3
Use a one-time payment
ACH는 subscription checkout에서 사용할 수 없으므로 one-time payment로 테스트하세요.
4
Enter the test bank details
아래의 테스트 routing 및 account number pair 중 하나를 입력한 다음 webhook handler가 최종 payment status를 수신하는지 확인하세요. ACH payment는 checkout 시점이 아니라 비동기적으로 확정됩니다.
테스트 은행 계정
routing number110000000를 다음 account number 중 하나와 함께 사용하세요:
전체 테스트 계정 목록은 ACH Direct Debit 페이지를 참조하세요.
유럽 결제 수단 테스트
유럽 payment method(iDEAL, Bancontact, EPS, Multibanco)는 test mode에서 테스트할 수 있습니다.1
Enable test mode
dashboard sidebar에서 Live Mode switch를 끄고 test mode에서 생성한 API keys를 사용하세요. Test Mode vs Live Mode를 참조하세요.
2
Set billing address
billing address country를 payment method에 맞게 설정하세요:
- iDEAL의 경우
NL - Bancontact의 경우
BE - EPS의 경우
AT - Multibanco의 경우
PT
3
Set currency
유럽 payment method에는 EUR currency가 필요합니다.
4
Complete test flow
test environment에서 simulated bank authentication flow를 따르세요.
테스트 SEPA Direct Debit IBAN
SEPA Direct Debit에는 EUR와 Eurozone billing address가 필요합니다. 특정 결과를 강제하려면 다음 테스트 IBAN을 사용하세요:
국가별 값을 포함한 전체 테스트 IBAN 목록은 Europe 페이지를 참조하세요.
전체 유럽 payment method documentation은 Europe 페이지를 참조하세요.
아시아 태평양 지갑 테스트
GCash, Alipay HK, FPS 및 Touch ‘n Go는 billing country와 currency가 일치할 때만 표시되는 QR code payment입니다.1
Enable test mode
dashboard sidebar에서 Live Mode switch를 끄고 test mode에서 생성한 API keys를 사용하세요. Test Mode vs Live Mode를 참조하세요.
2
Set billing country and currency
일치하는 pair로 one-time checkout을 생성하세요:
3
Select the method and confirm
수단을 선택하고 Pay를 클릭하세요. QR code가 full-screen overlay로 열리고 checkout은 payment를 기다립니다.
4
Verify the checkout behavior
일치하는 country와 currency에서만 method가 표시되고 QR code가 렌더링되는지 확인하세요.
test-mode QR code는 wallet provider의 test environment에서 발급되며 live payment와 다르게 작동할 수 있습니다.
테스트 모범 사례
Test all payment scenarios
Test all payment scenarios
성공적인 payment만 테스트하지 마세요. 거부, 취소 및 잔액 부족과 같은 edge case도 테스트하세요.
Verify webhook handling
Verify webhook handling
webhook endpoint가 모든 event type, 특히
payment.succeeded, payment.failed 및 subscription event를 올바르게 처리하는지 확인하세요.Dodo Payments CLI를 사용하여 webhooks를 로컬에서 테스트하세요:dodo wh listen는 live test webhook을 local server로 전달합니다dodo wh trigger는 지원되는 모든 webhook event type에 대한 mock payload를 전송합니다
Test on real devices
Test on real devices
Apple Pay와 Google Pay는 실제 iOS 및 Android device에서 테스트하세요. Simulator는 wallet 동작을 완전히 재현하지 못합니다.
Test regional methods with correct addresses
Test regional methods with correct addresses
지역 payment method(UPI, iDEAL 등)에는 일치하는 billing address가 필요합니다. US billing address로는 iDEAL이 표시되지 않습니다.
Verify minimum amounts
Verify minimum amounts
BNPL method에는 $50.01 minimum이 필요합니다. cart total에 따라 올바르게 표시되거나 숨겨지는지 테스트하세요.
관련 페이지
Cards
카드 테스트, 3D Secure 및 저장된 payment method.
Digital Wallets
Apple Pay, Google Pay, Amazon Pay testing.
BNPL
Klarna, Afterpay 및 Billie testing.
India
UPI 및 RBI mandate testing.
Pix
테스트 CPF를 사용한 Pix testing.
Europe
iDEAL, Bancontact, EPS, Multibanco testing.
Asia-Pacific
GCash, Alipay HK, FPS 및 Touch ‘n Go testing.
Webhooks
테스트 event를 위한 webhooks 설정.
CLI Webhook Testing
Dodo Payments CLI로 webhooks를 로컬에서 테스트.