지원되는 카드 네트워크
Dodo Payments는 글로벌 네트워크와 여러 지역 네트워크를 지원합니다.글로벌 네트워크
지역 네트워크
구성
카드는allowed_payment_method_types에서 두 가지 값을 사용합니다:
이 세션에서는 카드 결제만 제공됩니다:
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: 고객이 제한 시간 내에 응답하지 않았습니다.
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를 참고하세요.- Successful Payments
- Declined Payments
보안 및 규정 준수
Dodo Payments는 카드 결제에 다음과 같은 보호 기능을 적용합니다:모범 사례
Accept all major networks
Accept all major networks
필요하지 않다면 카드 유형을 제한하지 마세요. 고객은 선호하는 카드가 작동하기를 기대합니다.
Display card logos
Display card logos
신뢰를 구축할 수 있도록 사이트에 Visa, Mastercard 및 Amex 로고를 표시하세요.
Handle declines gracefully
Handle declines gracefully
명확한 오류 메시지를 표시하세요. 고객에게 원시 오류 code를 표시하지 마세요.
Enable saved cards for returning customers
Enable saved cards for returning customers
저장된 결제 수단을 사용하면 재방문 고객의 반복 구매가 더 빨라집니다.
문제 해결
Card declined
Card declined
원인: 잔액 부족, 만료된 카드, 잘못된 CVV 또는 은행의 사기 방지 기능입니다.해결 방법: 고객에게 정보를 확인하거나 다른 카드를 사용하도록 요청하세요. Transaction Failures reference에서 decline의 error code와 권장 조치를 확인하세요. code에서 decline을 처리하는 방법은 Handle Payment Failures를 참고하세요.
3DS authentication failed
3DS authentication failed
원인: 고객이 challenge를 중단했거나, 은행 시스템을 사용할 수 없었거나, challenge 시간이 초과되었습니다.해결 방법: 다시 시도하거나 고객에게 은행에 문의하도록 요청하세요. 관련 payment states와 decline codes는 Handling Authentication Failures를 참고하세요.
Card not supported
Card not supported
원인: 지역 네트워크가 지원되지 않거나 카드가 사용 제한된 prepaid card입니다.해결 방법: 고객에게 주요 네트워크의 카드를 사용해 보도록 요청하세요.
관련 페이지
Payment Methods Overview
지원되는 모든 결제 수단입니다.
Upsells & Downsells
저장된 카드로 원클릭 구매를 진행합니다.
Testing Process
모든 결제 수단에 대한 테스트 데이터입니다.
Subscriptions
카드를 사용한 recurring billing입니다.