Skip to main content
공식 Dodo Payments React Native checkout SDK인 @dodopayments/react-native-checkout입니다. 이 SDK는 네이티브 브라우저 뷰에서 Dodo의 호스팅 checkout을 열고 typed result를 반환합니다. 참고: 이와 관련이 없는 이전 패키지 dodopayments-react-native-sdk (unscoped)가 존재하며, API가 완전히 다릅니다. 이 페이지에서는 현재 공식 scoped package만 설명합니다.

Checkout Sessions API

백엔드에서 이 SDK가 열 checkout_url을 생성합니다.

Mobile Integration Guide

전체 모바일 결제 흐름에서 어떻게 연동되는지 확인하세요.
React Native SDK는 동일한 네이티브 Swift 및 Kotlin 코어를 감싸는 얇은 Turbo Module wrapper입니다. iOS에서는 SFSafariViewController를, Android에서는 Chrome Custom Tab을 열며, API key를 보유하지 않고 Dodo API를 직접 호출하지도 않습니다. 모든 checkout 로직은 브라우저에서 실행되며, SDK는 뷰 lifecycle을 관리하고 return URL을 캡처하기만 합니다.
이 SDK는 New Architecture만 지원하며, React Native 0.76+, iOS 16+, Android minSdk 24가 필요합니다.

설치

1

Install the Package

패키지는 autolink되며 Maven에서 com.dodopayments.api:checkout-android를 가져옵니다.
추가 설정은 필요하지 않습니다. 네이티브 dependency가 자동으로 resolve됩니다.
2

Register a Callback URL Scheme

앱은 checkout에서 반환되는 return URL을 수신할 수 있도록 URL scheme을 등록해야 합니다.
android/app/build.gradle에서:
android/app/build.gradle
"myapp"를 앱의 scheme으로 바꿉니다.

사용법

반환 URL 전달

Linking listener는 iOS의 반환 URL 처리에 필요합니다. Android에서는 handleOpenURL가 아무 작업도 하지 않고 false를 resolve합니다. Android core가 redirect를 네이티브로 처리하기 때문입니다. 두 플랫폼 모두에서 listener를 무조건 등록해도 안전합니다.

결과의 의미

result.status는 UI 힌트일 뿐, 결제가 완료되었다는 증거가 아닙니다. payment.succeeded / subscription.active webhook을 통해 모든 결제를 backend에서 확인하세요.
CheckoutStatus
필수
succeeded, failed, cancelled, pending, expired 중 하나입니다.
string
반환 URL에 해당 값이 포함된 경우 설정됩니다. UI에 표시하되 액세스 권한을 부여하는 데 사용하지 마세요. 자세한 내용은 아래의 결제 확인을 참조하세요.
string
subscription checkout에 대해 설정됩니다.
string[]
checkout에 license key product가 포함된 경우 설정됩니다.
string
checkout에서 이메일을 수집하는 경우 설정됩니다.
Record<string, string>
반환 URL의 모든 query parameter를 원문 그대로 포함합니다.

결제 확인

Webhooks

결제가 성공하거나 subscription이 활성화되면 Dodo Payments가 backend를 호출합니다.

Get Payment Detail

secret key를 사용해 paymentId를 조회하여 상태를 직접 확인합니다.
이 중 하나가 결제를 확인한 후에만 액세스 권한을 부여하고, result.status만으로 부여하지 마세요.

오류

start는 잘못된 사용이나 platform failure가 발생한 경우에만 CheckoutError와 함께 reject됩니다. 결제 취소 또는 거절은 항상 예외가 아닌 결과로 반환됩니다.
  • INVALID_CHECKOUT_URL: checkout.dodopayments.com session URL이 아닙니다.
  • INVALID_RETURN_URL: 유효한 absolute URL이 아닙니다.
  • ALREADY_IN_PROGRESS: checkout이 이미 실행 중입니다.
  • PLATFORM_ERROR: 예기치 않은 platform failure입니다.

중단된 세션

checkout 도중 앱 또는 JS bundle이 종료되면 promise는 사라지지만 native layer에는 session이 유지됩니다. 다음 mount 시 이를 복구하고 backend와 대조하여 처리하세요.

관련 문서

Mobile Integration Guide

Android, iOS, Flutter에 동일하게 적용되는 contract입니다.

Expo Boilerplate

checkout integration이 포함된 완전한 Expo 예제입니다.
마지막 수정일 2026년 8월 6일