Full API Access
Webhook Testing
테스트 카드
다양한 지역에서 성공 및 거부된 결제를 시뮬레이션하려면 다음 카드 번호를 사용하세요.- 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를 시뮬레이션하려면 다음 정보를 사용하세요:USD 체크아웃에서 Klarna가 결제 옵션으로 표시되려면 최소 거래 금액이 $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로 전환됩니다.USD 체크아웃에서 Afterpay가 결제 옵션으로 표시되려면 최소 거래 금액이 $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에서 테스트할 수 있습니다.Multibanco는 은행 flow 대신 voucher를 표시합니다. Test Multibanco를 참조하세요.
1
Enable test mode
대시보드 사이드바에서 Live Mode 스위치를 끄고 test mode에서 생성한 API keys를 사용하세요. Test Mode vs Live Mode를 참조하세요.
2
Set billing address
결제 수단에 맞게 billing address country를 설정하세요:
NL: iDEALBE: BancontactAT: EPSPT: Multibanco
3
Set currency
유럽 결제 수단에는 EUR 통화가 필요합니다.
4
Complete test flow
test environment에서 시뮬레이션된 은행 인증 flow를 따르세요.
Test Multibanco
EUR와PT billing address를 사용하세요. Pay를 클릭하면 checkout에 Multibanco voucher가 표시됩니다. test mode에서는 입력한 email에 따라 결과가 결정됩니다:
success page를 확인하려면
succeed_immediately@example.com를 사용하고 몇 초 기다린 다음 Done을 누르세요.
test email 전체 목록은 Europe 페이지를 참조하세요.
Test SEPA Direct Debit IBANs
SEPA Direct Debit에는 EUR와 Eurozone billing address가 필요합니다. 특정 결과를 강제하려면 다음 test IBANs를 사용하세요:
국가별 값을 포함한 test IBAN 전체 목록은 Europe 페이지를 참조하세요.
유럽 결제 수단에 대한 전체 문서는 Europe 페이지를 참조하세요.
Test Asia-Pacific Wallets
GCash, Alipay HK, FPS, Touch ‘n Go는 billing country와 currency가 일치할 때만 표시되는 QR code 결제입니다.1
Enable test mode
대시보드 사이드바에서 Live Mode 스위치를 끄고 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를 클릭하세요. 전체 화면 overlay에 QR code가 열리고 checkout은 결제를 기다립니다.
4
Verify the checkout behavior
일치하는 country와 currency에서만 결제 수단이 표시되고 QR code가 렌더링되는지 확인하세요.
test-mode QR codes는 wallet provider의 test environment에서 발급되며 live payment와 다르게 동작할 수 있습니다.
Testing Best Practices
Test all payment scenarios
Test all payment scenarios
성공한 결제만 테스트하지 마세요. declines, cancellations, 잔액 부족과 같은 edge cases를 테스트하세요.
Verify webhook handling
Verify webhook handling
webhook endpoints가 모든 event types, 특히
payment.succeeded, payment.failed 및 subscription events를 올바르게 처리하는지 확인하세요.webhooks를 로컬에서 테스트하려면 Dodo Payments CLI를 사용하세요:dodo wh listen는 live test webhooks를 로컬 서버로 전달합니다.dodo wh trigger는 지원되는 모든 webhook event types에 대한 mock payloads를 전송합니다.
Test on real devices
Test on real devices
Apple Pay와 Google Pay는 실제 iOS 및 Android devices에서 테스트하세요. Simulators는 wallet 동작을 완전히 재현하지 못합니다.
Test regional methods with correct addresses
Test regional methods with correct addresses
Regional payment methods(UPI, iDEAL 등)에는 일치하는 billing addresses가 필요합니다. US billing address에서는 iDEAL이 표시되지 않습니다.
Verify minimum amounts
Verify minimum amounts
Klarna와 Afterpay는 USD 체크아웃에서 $50.01 minimum이 필요합니다. cart total에 따라 올바르게 표시되거나 숨겨지는지 테스트하세요.