Digital Wallets

디지털 지갑을 사용하면 고객이 카드 정보를 입력하지 않고 기기나 계정에 이미 저장된 카드 또는 계정으로 결제할 수 있습니다. 지갑은 카드 번호 대신 토큰을 전송하며, 고객은 탭하거나 생체 인증으로 결제를 확인합니다.

Supported Wallets

Dodo Payments는 체크아웃이 해당 지갑의 국가, 통화 및 결제 유형과 일치할 때만 각 지갑을 표시합니다:

지갑	지원 범위	통화	구독	필요한 설정
Apple Pay	전 세계(인도 제외)	전체	예	인라인 체크아웃의 도메인 확인
Google Pay	전 세계(인도 제외)	전체	예	없음
Amazon Pay	전 세계(인도 제외)	USD, EUR, GBP, AUD, CHF, DKK, HKD, JPY, NOK, NZD, SEK, ZAR	아니요	없음
Cash App Pay	미국만	USD	예	없음
RevolutPay	전 세계	GBP	아니요	없음

PayPal은 신규 거래에 일시적으로 사용할 수 없습니다.

Apple Pay

Apple Pay를 사용하면 고객이 Apple Wallet에 저장된 카드로 결제하고 Face ID 또는 Touch ID로 확인할 수 있습니다.

Apple Pay는 무료 체험과 같이 첫 결제 금액이 $0인 경우에도 구독에 표시되므로 가입 시 결제 승인이 설정됩니다. 일회성 결제에서는 금액이 $0보다 클 때만 Apple Pay가 표시됩니다.

요구 사항

기기: iOS 17 이상, iPadOS 17 이상 또는 macOS의 Safari 17 이상.
프로토콜: 페이지는 HTTPS를 통해 로드되어야 합니다.
도메인: 인라인 체크아웃의 경우 도메인을 Apple에 확인해야 합니다.

도메인 확인

도메인 확인은 인라인(임베디드) 체크아웃에만 필요합니다. 호스팅 체크아웃과 결제 링크에서는 도메인 확인 없이 Apple Pay가 표시됩니다.

Apple Pay는 오버레이 체크아웃에서 사용할 수 없습니다. Apple Pay를 제공하려면 인라인 체크아웃, 호스팅 체크아웃 또는 결제 링크를 사용하세요.

인라인 체크아웃의 도메인을 확인하려면 대시보드에서 다음 단계를 따르세요:

Open Apple Pay Domains

Settings → Payment Methods로 이동합니다. Apple Pay 행에서 Manage domains를 클릭합니다.

Payment Methods 설정의 Apple Pay 행에 있는 Manage domains 버튼 — Open Apple Pay domains from the Apple Pay row

Download the Domain Association File

Apple Pay domains 패널에서 Download file을 클릭합니다.

Download file 버튼이 있는 Apple Pay domains 패널 — Download the Apple Pay domain association file

Register domain을 클릭하고 체크아웃을 임베드할 도메인(예: shop.example.com)을 입력한 다음 Continue를 클릭합니다.

도메인이 입력된 도메인 등록 양식 — Register the domain where you embed checkout

Host the File on Your Domain

다음 경로에 파일을 서버에 업로드합니다:

https://shop.example.com/.well-known/apple-developer-merchantid-domain-association

리디렉션 없이 HTTPS를 통해 파일을 제공하고, Content-Type: application/octet-stream 또는 text/plain을 사용합니다.

Verify the Domain

Verify domain을 클릭합니다. Dodo Payments가 호스팅된 파일을 확인하고 Apple에 도메인을 제출합니다.

연결 파일 호스트 경로와 Verify domain 버튼이 표시된 도메인 확인 화면 — Verify the hosted association file

Confirm It's Active

상태가 Active로 표시되면 해당 도메인에서 Apple Pay를 사용할 수 있습니다. 한 도메인의 Apple Pay를 켜거나 끄려면 해당 도메인의 Enabled 토글을 사용합니다.

Active 상태와 Enabled 토글이 표시된 Apple Pay 도메인 목록 — Verified domains show an Active status

Test the Integration

Apple 기기에서 체크아웃을 엽니다.
Apple Pay 버튼이 표시되는지 확인합니다.
테스트 거래를 완료합니다.

구성

체크아웃 세션을 Apple Pay와 카드로 제한하려면 allowed_payment_method_types을 전달합니다:

// `client` is an initialized DodoPayments client.
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_123', quantity: 1 }],
  allowed_payment_method_types: ['apple_pay', 'credit', 'debit'],
  return_url: 'https://example.com/success'
});

Google Pay

Google Pay를 사용하면 고객이 Google 계정에 저장된 카드로 결제할 수 있습니다.

요구 사항

브라우저: 데스크톱 및 Android의 Chrome, 데스크톱의 Firefox. Safari 또는 iOS의 모든 브라우저에서는 Checkout에 Google Pay가 표시되지 않습니다. 이러한 브라우저에서는 고객이 Apple Pay 또는 카드로 결제할 수 있습니다.
기기: Google Pay 앱이 설치된 Android 기기.
설정: Chrome에서 저장된 결제 수단이 있는지 사이트에서 확인하도록 허용이 켜져 있어야 합니다.

구성

체크아웃 세션을 Google Pay와 카드로 제한하려면 allowed_payment_method_types을 전달합니다:

// `client` is an initialized DodoPayments client.
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_123', quantity: 1 }],
  allowed_payment_method_types: ['google_pay', 'credit', 'debit'],
  return_url: 'https://example.com/success'
});

Google Pay에는 도메인 확인이 필요하지 않습니다.

Amazon Pay

Amazon Pay를 사용하면 고객이 Amazon 계정에 저장된 결제 수단으로 체크아웃할 수 있습니다.

지원 범위

지역: 인도를 제외한 전 세계.
통화: USD, EUR, GBP, AUD, CHF, DKK, HKD, JPY, NOK, NZD, SEK, ZAR. 체크아웃에서 제공하는 통화는 해당 체크아웃을 처리하는 processor에 따라 달라집니다.
구독: 지원되지 않습니다.

구성

체크아웃 세션을 Amazon Pay와 카드로 제한하려면 allowed_payment_method_types을 전달합니다:

// `client` is an initialized DodoPayments client.
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_123', quantity: 1 }],
  allowed_payment_method_types: ['amazon_pay', 'credit', 'debit'],
  return_url: 'https://example.com/success'
});

Cash App Pay

Cash App Pay를 사용하면 미국 고객이 Cash App 계정에서 결제할 수 있습니다.

지원 범위

지역: 미국만 해당. 청구 국가가 미국이어야 합니다.
통화: USD만 지원.
구독: 지원됩니다.

구성

체크아웃 세션을 Cash App Pay와 카드로 제한하려면 allowed_payment_method_types을 전달합니다:

// `client` is an initialized DodoPayments client.
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_123', quantity: 1 }],
  allowed_payment_method_types: ['cashapp', 'credit', 'debit'],
  return_url: 'https://example.com/success'
});

RevolutPay

RevolutPay를 사용하면 Revolut 사용자가 Revolut 계정 잔액 또는 연결된 카드로 결제할 수 있습니다.

지원 범위

지역: 전 세계.
통화: GBP만 지원.
구독: 지원되지 않습니다.

구성

체크아웃 세션을 RevolutPay와 카드로 제한하려면 allowed_payment_method_types을 전달합니다:

// `client` is an initialized DodoPayments client.
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_123', quantity: 1 }],
  allowed_payment_method_types: ['revolut_pay', 'credit', 'debit'],
  return_url: 'https://example.com/success'
});

테스트

테스트 모드에서는 실제 자금의 이동 없이 지갑 결제가 동일한 체크아웃 흐름으로 진행됩니다.

Apple Pay 테스트

Use Test Mode

대시보드 사이드바에서 Live Mode 스위치를 끄고 테스트 모드에서 생성한 API 키를 사용합니다.

Add a Card to Apple Wallet

실제 카드를 Apple Wallet에 추가합니다. 테스트 모드에서는 카드에 요금이 청구되지 않습니다.

Complete a Test Purchase

Apple 기기에서 체크아웃을 열고 Apple Pay 흐름을 완료합니다.

Apple Pay에는 HTTPS가 필요합니다. 페이지가 HTTPS로 제공되지 않으면 localhost에 표시되지 않습니다.

Google Pay 테스트

Join the Test Card Group

Google Pay 테스트 카드 그룹에 가입하여 지갑에 테스트 카드를 추가합니다.

Enable Test Mode

테스트 모드에서 생성한 API 키를 사용합니다.

Complete a Test Purchase

Google Pay에서 테스트 카드 중 하나를 선택하여 거래를 완료합니다.

Amazon Pay 및 Cash App Pay

테스트 모드 API 키를 사용하고 표준 체크아웃 흐름을 따릅니다. 테스트 거래는 시뮬레이션되며 실제 요금이 청구되지 않습니다.

SDK 지원

지갑 지원 여부는 체크아웃을 표시하는 방식에 따라 달라집니다.

Web SDK

디지털 지갑은 다음에서 작동합니다:

Apple Pay를 제외한 오버레이 체크아웃.
인라인 체크아웃. Apple Pay에는 도메인 확인이 필요합니다.
호스팅 체크아웃과 직접 API 통합.

모바일 SDK(체크아웃)

Android, iOS, React Native 및 Flutter 체크아웃 SDK는 WebView가 아닌 플랫폼의 시스템 브라우저(iOS에서는 SFSafariViewController, Android에서는 Chrome Custom Tabs)에서 Dodo Payments 호스팅 체크아웃을 엽니다. Apple Pay와 Google Pay는 웹에서와 동일한 방식으로 작동합니다. 설정 방법은 모바일 통합 가이드를 참조하세요.

모범 사례

Prioritize wallets on mobile

모바일 고객은 Apple Pay와 Google Pay를 기대합니다. 모바일 체크아웃에서 이러한 옵션을 눈에 잘 띄게 표시하세요.

Complete domain verification early

인라인 체크아웃을 사용하는 경우 출시 당일이 아니라 개발 중에 Apple Pay용 도메인을 확인하세요.

Always include card fallbacks

모든 고객이 디지털 지갑을 사용하는 것은 아닙니다. allowed_payment_method_types에 credit 및 debit을 포함하세요.

Test on real devices

시뮬레이터는 지갑 동작을 완전히 재현하지 못합니다. 출시 전에 실제 iOS 및 Android 기기에서 테스트하세요.

Handle wallet unavailability

지원되지 않는 기기에서는 또는 고객에게 저장된 카드가 없을 때 지갑이 표시되지 않습니다. 이러한 고객에게는 다른 결제 수단을 계속 표시하세요.

문제 해결

Apple Pay button not appearing

확인:

인라인 체크아웃의 경우 Manage domains에서 도메인이 확인되었나요?
페이지가 HTTPS를 통해 로드되나요?
기기가 iOS 17, iPadOS 17 또는 Safari 17 이상인가요?
고객에게 Apple Wallet에 저장된 카드가 있나요?
apple_pay이 allowed_payment_method_types에 포함되어 있나요?
체크아웃이 오버레이인가요? 오버레이 체크아웃에서는 Apple Pay를 사용할 수 없습니다.

해결 방법: 도메인 확인을 완료하고 HTTPS를 통해 페이지를 제공하세요. 실제 Apple 기기에서 테스트하세요.

Apple Pay domain stuck on Pending

Verify domain을 클릭하면 Dodo Payments가 도메인에서 연결 파일을 가져와 Apple에 도메인을 제출합니다. 도메인이 Pending 상태로 유지되는 경우는 대개 Dodo Payments가 파일을 예상대로 가져오지 못했기 때문입니다.확인:

파일이 https://<your-domain>/.well-known/apple-developer-merchantid-domain-association에서 접근 가능한가요?
유효한 인증서를 사용해 HTTPS로 제공되나요?
리디렉션 없이 확인되나요? www, 다른 호스트 또는 오류 페이지로 리디렉션되면 확인에 실패합니다.
text/html가 아니라 Content-Type: application/octet-stream 또는 text/plain으로 제공되나요?
다른 계정이나 provider에서 재사용한 파일이 아니라 이 business의 Manage domains에서 다운로드한 파일인가요?

파일에 공개적으로 접근할 수 있는지 확인하려면 비공개 브라우징 창과 같이 자체 네트워크 외부에서 URL을 요청하세요. 스테이징 비밀번호, 인증 화면 및 방화벽 규칙으로 인해 본인은 요청에 성공하지만 Dodo Payments는 실패하는 경우가 많습니다.해결 방법: 호스팅 문제를 해결한 다음 Verify domain을 다시 클릭합니다. 확인에 성공한 후에도 도메인이 Active가 되지 않으면 도메인 이름과 함께 support@dodopayments.com으로 문의하세요.

Google Pay button not appearing

확인:

고객이 지원되는 브라우저를 사용하고 있나요? Safari 또는 iOS의 모든 브라우저에서는 Google Pay가 표시되지 않습니다.
고객이 Google Pay에 카드를 등록했나요?
Chrome 설정에서 저장된 결제 수단이 있는지 사이트에서 확인하도록 허용이 켜져 있나요?
google_pay가 allowed_payment_method_types에 포함되어 있나요?

해결 방법: 브라우저와 고객의 Google Pay 설정을 확인하세요.

Wallet payment failed

일반적인 원인:

지갑의 카드가 만료되었거나 유효하지 않습니다.
은행에서 거래를 거부했습니다.
네트워크 연결 문제로 결제가 중단되었습니다.

해결 방법: 고객에게 지갑의 카드를 확인하거나 다른 결제 수단을 사용하도록 안내하세요.

Wrong device type

디지털 지갑은 호환되는 기기에서만 표시됩니다:

Apple Pay: Apple 기기만 지원.
Google Pay: Chrome 또는 Android 기기.

해결 방법: 이는 정상적인 동작입니다. 대체 수단으로 카드 결제를 사용할 수 있도록 유지하세요.

Payment Methods Overview

지원되는 모든 결제 수단.

Overlay Checkout

페이지에서 오버레이로 체크아웃을 엽니다.

Testing Process

모든 결제 수단의 테스트 데이터.

Mobile Integration Guide

웹에서와 같이 Apple Pay와 Google Pay가 작동하는 시스템 브라우저에서 호스팅 체크아웃을 엽니다.

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Supported Wallets

Apple Pay

요구 사항

도메인 확인

구성

Google Pay

요구 사항

구성

Amazon Pay

지원 범위

구성

Cash App Pay

지원 범위

구성

RevolutPay

지원 범위

구성

테스트

Apple Pay 테스트

Google Pay 테스트

Amazon Pay 및 Cash App Pay

SDK 지원

Web SDK

모바일 SDK(체크아웃)

모범 사례

문제 해결

관련 페이지

Payment Methods Overview

Overlay Checkout

Testing Process

Mobile Integration Guide

​Supported Wallets

​Apple Pay

​요구 사항

​도메인 확인

​구성

​Google Pay

​요구 사항

​구성

​Amazon Pay

​지원 범위

​구성

​Cash App Pay

​지원 범위

​구성

​RevolutPay

​지원 범위

​구성

​테스트

​Apple Pay 테스트

​Google Pay 테스트

​Amazon Pay 및 Cash App Pay

​SDK 지원

​Web SDK

​모바일 SDK(체크아웃)

​모범 사례

​문제 해결

​관련 페이지

Payment Methods Overview

Overlay Checkout

Testing Process

Mobile Integration Guide

Supported Wallets

Apple Pay

요구 사항

도메인 확인

구성

Google Pay

요구 사항

구성

Amazon Pay

지원 범위

구성

Cash App Pay

지원 범위

구성

RevolutPay

지원 범위

구성

테스트

Apple Pay 테스트

Google Pay 테스트

Amazon Pay 및 Cash App Pay

SDK 지원

Web SDK

모바일 SDK(체크아웃)

모범 사례

문제 해결

관련 페이지