공식 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
전체 모바일 결제 흐름에서 어떻게 연동되는지 확인하세요.
SFSafariViewController를, Android에서는 Chrome Custom Tab을 열며, API key를 보유하지 않고 Dodo API를 직접 호출하지도 않습니다. 모든 checkout 로직은 브라우저에서 실행되며, SDK는 뷰 lifecycle을 관리하고 return URL을 캡처하기만 합니다.
설치
1
Install the Package
- Android
- iOS
- Expo
패키지는 autolink되며 Maven에서 추가 설정은 필요하지 않습니다. 네이티브 dependency가 자동으로 resolve됩니다.
com.dodopayments.api:checkout-android를 가져옵니다.2
Register a Callback URL Scheme
앱은 checkout에서 반환되는 return URL을 수신할 수 있도록 URL scheme을 등록해야 합니다.
- Android (Gradle)
- iOS (Info.plist)
- Expo (both platforms)
android/app/build.gradle에서:android/app/build.gradle
"myapp"를 앱의 scheme으로 바꿉니다.사용법
반환 URL 전달
Linking listener는 iOS의 반환 URL 처리에 필요합니다. Android에서는 handleOpenURL가 아무 작업도 하지 않고 false를 resolve합니다. Android core가 redirect를 네이티브로 처리하기 때문입니다. 두 플랫폼 모두에서 listener를 무조건 등록해도 안전합니다.
결과의 의미
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.comsession 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 예제입니다.