메인 콘텐츠로 건너뛰기
한국 고객들은 국제 결제 방식보다 로컬 지갑과 국내 카드를 선호합니다. Dodo Payments는 주요 한국 지갑인 PAYCO, 네이버페이, 카카오페이와 함께 한국 로컬 카드 및 국제 카드를 KRW(한국 원화)로 청구합니다.

​
한국 결제 방법이 중요한 이유

Wallet-First Market

한국 소비자들은 카드 정보를 입력하기보다 카카오페이와 네이버페이 같은 로컬 지갑으로 결제하는 경우가 많습니다.

Domestic Card Networks

많은 한국 카드들이 로컬 네트워크에서 운영됩니다. 한국 로컬 카드 지원은 국제 결제망에서 처리할 수 없는 카드의 결제 실패를 방지합니다.

Higher Conversion

익숙한 로컬 방법을 제공하면 한국 고객의 결제 과정에서의 마찰과 포기를 줄일 수 있습니다.

​
지원되는 방법

방법유형구독최소 금액
카카오페이지갑예~$1.00
네이버페이지갑예~$1.00
PAYCO지갑아니요~$1.00
한국 로컬 카드카드예~$1.00
신용 및 직불 카드카드 (국제)예~$1.00
지갑 가용성은 거래 유형에 따라 다릅니다. 카카오페이와 네이버페이는 구독에, PAYCO는 일회성 결제에 제공됩니다. 모두 KRW 청구 통화가 필요합니다.

​
설정

​
API 방법 유형

유형설명
kakao_pay카카오페이 지갑
naver_pay네이버페이 지갑
paycoPAYCO 지갑
credit신용카드, 한국 로컬 카드 포함
debit직불카드, 한국 로컬 카드 포함

​
예제: 한국 중심의 체크아웃

const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'prod_123', quantity: 1 }],
  allowed_payment_method_types: [
    'kakao_pay',
    'naver_pay',
    'payco',
    'credit',
    'debit'
  ],
  billing_currency: 'KRW',
  billing_address: {
    country: 'KR',
    zipcode: '06236'
  },
  return_url: 'https://example.com/success'
});

​
요구 사항

한국 결제 방법이 체크아웃에 나타나려면:
  1. 청구 국가가 대한민국 (KR)
  2. 통화가 KRW
  3. 다른 통화로 가격 책정된 상인: Adaptive Currency가 활성화되어 고객이 KRW로 청구됨
다른 통화로 가격을 책정하고 Adaptive Currency가 활성화되어 있지 않으면 한국 고객은 KRW로 청구되지 않으며 한국 지갑은 사용할 수 없습니다.
KRW는 소수 단위가 없는 통화입니다. 금액은 전체 원 단위로 표시되며 100으로 나누지 않고 전체 숫자 값으로 전송하고 읽어야 합니다.

​
모범 사례

한국 고객을 위해 로컬 지갑을 주 옵션으로 제공해야 합니다. 카카오페이와 네이버페이는 대부분의 한국 쇼핑객에게 가장 익숙한 체크아웃 방법입니다.
항상 credit 및 debit를 포함하여 선호하는 지갑이 없는 고객과 한국 로컬 카드로 결제하는 고객도 체크아웃을 완료할 수 있도록 합니다.
한국 결제 방법에는 KRW가 필요합니다. 카탈로그가 다른 통화로 가격이 설정된 경우, Adaptive Currency를 활성화하여 한국 고객이 KRW로 견적 및 청구되도록 합니다.
구독에는 카카오페이와 네이버페이를 사용하고, 일회성 결제에는 PAYCO를 사용합니다. 모든 세 가지를 포함하면 Dodo가 체크아웃 상황에 따라 적절한 옵션을 제공할 수 있습니다.

​
문제 해결

확인:
  1. 청구 국가가 KR로 설정되었는가?
  2. 통화가 KRW로 설정되었는가?
  3. 다른 통화로 가격이 책정된 경우, Adaptive Currency가 활성화되었는가?
  4. 지갑 (kakao_pay, naver_pay 또는 payco)가 allowed_payment_method_types에 포함되어 있는가?
해결책: 청구 주소에 country: "KR" 및 billing_currency: "KRW"가 있는지 확인하십시오.
원인: PAYCO는 일회성 결제에만 제공됩니다. 반복 청구의 경우 카카오페이 또는 네이버페이를 사용하십시오.해결책: 구독 체크아웃에 kakao_pay 및 naver_pay를 allowed_payment_method_types에 포함하십시오.
원인: 일부 한국 카드들은 국제 결제망에서 처리할 수 없는 국내 네트워크에서 운영됩니다.해결책: 한국 로컬 카드가 올바르게 라우팅되도록 credit 및 debit를 활성화 상태로 유지하십시오.

​
관련 페이지

Payment Methods Overview

모든 지원 결제 방법을 참조하세요.

Credit & Debit Cards

카드 네트워크, 한국 로컬 카드 포함.

Adaptive Currency

고객에게 로컬 통화로 청구, KRW 포함.

Testing Process

테스트 데이터 및 체크아웃 테스트 가이드.
마지막 수정일 2026년 6월 18일