Skip to main content
모든 지원 국가와 통화에서 Dodo Payments의 모든 결제 페이지에서 카드를 사용할 수 있습니다. Dodo Payments는 주요 카드 네트워크를 지원하고, 카드 번호를 토큰으로 대체하며, 카드 결제에 필요한 확인 절차를 실행하므로 원시 카드 데이터를 직접 처리할 필요가 없습니다.

지원되는 카드 네트워크

Dodo Payments는 글로벌 네트워크와 여러 지역 네트워크를 지원합니다.

글로벌 네트워크

지역 네트워크

구성

카드는 allowed_payment_method_types에서 두 가지 값을 사용합니다: 이 세션에서는 카드 결제만 제공됩니다:
특별히 하나를 제외해야 할 이유가 없다면 credit와 debit를 모두 포함하세요. 많은 고객이 직불 카드로 결제하는 것을 선호합니다.

3D Secure 인증

3D Secure (3DS)는 카드 소유자의 은행에 카드 소유자의 신원을 확인하도록 요청합니다. 예를 들어 일회용 코드, 생체 인증 또는 은행 앱에서의 승인 등을 사용할 수 있습니다. 이를 통해 사기와 차지백을 줄일 수 있습니다.

3DS가 실행되는 경우

Dodo Payments는 다음과 같은 경우 3DS를 요청합니다:
  • 카드 네트워크에서 요구하는 경우
  • 유럽의 PSD2와 같은 지역 규정에서 요구하는 경우
  • 거래가 고위험으로 표시된 경우

3DS 강제 적용

비즈니스의 모든 카드 결제에 3DS를 요구하려면 Settings → Pricing에서 3D Secure를 켜세요. 하나의 checkout session에 대해 이 설정을 재정의하려면 force_3ds를 전달하세요:
모든 거래에 3DS를 요구하면 사기를 줄일 수 있지만, 일부 고객이 인증 중 checkout을 중단하기 때문에 전환율이 낮아질 수 있습니다.

인증 실패 처리

결제에 3DS 인증이 필요한 경우, 결제가 성공하거나 실패하기 전에 중간 상태를 거칩니다: 인증이 완료되지 않으면 다음 decline code 중 하나와 함께 결제가 실패합니다:
  • AUTHENTICATION_FAILURE: 고객을 인증할 수 없습니다.
  • AUTHENTICATION_REQUIRED: 인증이 필요하지만 수행되지 않았습니다.
  • AUTHENTICATION_TIMEOUT: 고객이 제한 시간 내에 응답하지 않았습니다.
Transaction Failures reference에서 각 code에 권장되는 조치를 확인할 수 있습니다.

checkout 시점과 renewal 시점

  • checkout 시점(고객이 있는 경우): checkout 중에 3DS challenge가 표시됩니다. 실패하면 고객에게 다시 시도하거나 다른 카드를 사용하도록 요청하세요.
  • subscription renewal 시점(고객이 없는 경우): 3DS challenge를 실시간으로 표시할 수 없습니다. renewal에 인증이 필요하고 실패하면 subscription이 on_hold 상태로 이동합니다. grace period를 설정한 경우에는 먼저 past_due 상태로 이동합니다. 복구하려면 고객에게 다시 방문하여 결제 수단을 업데이트하도록 요청하세요. Handle Payment Failures 및 Subscription Dunning을 참고하세요.

저장된 결제 수단

재방문 고객은 이전 checkout에서 저장한 카드로 결제할 수 있습니다.

Tokenized

원본 카드 번호는 절대 저장되지 않습니다.

PCI Compliant

Dodo Payments가 PCI compliance를 처리합니다.

Customer-Scoped

저장된 각 카드는 하나의 고객에게 속합니다.

저장된 카드 활성화

재방문 고객의 저장된 카드를 checkout에 표시하려면 기존 customer_id와 함께 show_saved_payment_methods: true를 전달하세요. 기본값은 false입니다.

원클릭 구매

checkout을 표시하지 않고 저장된 카드에 요금을 청구하려면 confirm: true 및 기존 customer_id와 함께 해당 카드의 payment_method_id를 전달하세요. 세션은 카드에 직접 요금을 청구하고 checkout_url를 반환하지 않으므로, webhook을 사용하여 결제 결과를 확인하세요.

테스트

test mode에서 다음 카드를 사용하세요. 더 많은 테스트 데이터는 Testing Process를 참고하세요.
테스트 카드는 test mode에서만 작동합니다. live mode에서 테스트 카드로 결제하면 결제가 실패합니다.

보안 및 규정 준수

Dodo Payments는 카드 결제에 다음과 같은 보호 기능을 적용합니다:

모범 사례

필요하지 않다면 카드 유형을 제한하지 마세요. 고객은 선호하는 카드가 작동하기를 기대합니다.
신뢰를 구축할 수 있도록 사이트에 Visa, Mastercard 및 Amex 로고를 표시하세요.
명확한 오류 메시지를 표시하세요. 고객에게 원시 오류 code를 표시하지 마세요.
저장된 결제 수단을 사용하면 재방문 고객의 반복 구매가 더 빨라집니다.

문제 해결

원인: 잔액 부족, 만료된 카드, 잘못된 CVV 또는 은행의 사기 방지 기능입니다.해결 방법: 고객에게 정보를 확인하거나 다른 카드를 사용하도록 요청하세요. Transaction Failures reference에서 decline의 error code와 권장 조치를 확인하세요. code에서 decline을 처리하는 방법은 Handle Payment Failures를 참고하세요.
원인: 고객이 challenge를 중단했거나, 은행 시스템을 사용할 수 없었거나, challenge 시간이 초과되었습니다.해결 방법: 다시 시도하거나 고객에게 은행에 문의하도록 요청하세요. 관련 payment states와 decline codes는 Handling Authentication Failures를 참고하세요.
원인: 지역 네트워크가 지원되지 않거나 카드가 사용 제한된 prepaid card입니다.해결 방법: 고객에게 주요 네트워크의 카드를 사용해 보도록 요청하세요.

관련 페이지

Payment Methods Overview

지원되는 모든 결제 수단입니다.

Upsells & Downsells

저장된 카드로 원클릭 구매를 진행합니다.

Testing Process

모든 결제 수단에 대한 테스트 데이터입니다.

Subscriptions

카드를 사용한 recurring billing입니다.
마지막 수정일 2026년 9월 26일