리액트 네이티브 SDK 통합
Dodo Payments 리액트 네이티브 SDK를 사용하면 네이티브 Android 및 iOS 앱에서 안전한 결제 경험을 구축할 수 있습니다. 우리의 SDK는 결제 세부 정보를 수집하기 위한 사용자 정의 가능한 UI 구성 요소와 화면을 제공합니다.기능
Simplified Security
PCI 규정을 준수하면서 민감한 결제 정보를 안전하게 수집하세요
Multiple Payment Methods
글로벌 범위를 확대하려면 다양한 payment methods를 수락하세요
Native UI
Android 및 iOS용 네이티브 화면과 요소
현재 React Native SDK는 Apple Pay, Google Pay, Cash App, UPI를 지원하지 않습니다. 향후 릴리스에서 이러한 결제 수단을 추가하기 위해 적극적으로 작업 중입니다.
설치
1
Install the SDK
선호하는 패키지 관리자를 사용하여 Dodo Payments SDK를 설치하세요:
- npm
- yarn
2
Platform-specific setup
- iOS
- Android
iOS 폴더에서 pod install을 실행하세요:
클라이언트 측 설정
1
Get Publishable Key
Dodo Payments 대시보드에서 게시 가능한 키를 가져오세요. (테스트 및 라이브 모드 각각 별도)
https://app.dodopayments.com/developer/others
2
Setup Payment Provider
앱을
DodoPaymentProvider로 감싸세요:App.tsx
Dodo Payments 대시보드에서 API 키를 생성해야 합니다. 자세한 지침은 API key generation guide를 확인하세요.
3
Create payment utility function
백엔드 API에서 결제 매개변수를 가져오는 유틸리티 함수를 만드세요:
utils/fetchPaymentParams.ts
이 함수는 결제 인텐트를 생성하고 클라이언트 시크릿을 반환하는 백엔드 API 엔드포인트가 있다고 가정합니다. 결제 생성을 처리할 수 있도록 백엔드가 적절하게 구성되어 있는지 확인하세요. 백엔드 설정 예시는 API Integration Tutorial를 참조하세요.
4
Implement the payment screen
useCheckout 훅을 사용하여 결제 화면을 만드세요. 전체 구현은 다음과 같습니다:PaymentScreen.tsx
스타일링, 오류 처리, 사용자화 옵션이 포함된 전체 예제는 다음 데모 리포지토리를 확인하세요:
구성 옵션
세션 매개변수
일회성 결제 또는 구독 API에서 얻은 결제 인텐트의 클라이언트 시크릿입니다.
결제 세션의 모드(테스트 또는 라이브).
결제 시트 외형에 대한 사용자화 옵션
테마 모드:
'light' 또는 'dark'외관 사용자 정의
You can customize the React Native Unified Checkout to match your app’s design by modifying colors, fonts, and more through the appearance parameter when callinginitPaymentSession().
색상 사용자 정의
각 색상 카테고리는 UI의 하나 이상의 구성 요소 색상을 결정합니다. 예를 들어,primary은 Pay 버튼의 색상을 정의합니다.
라이트 및 다크 모드 지원이 포함된 예제 구성:
모양 사용자 정의
결제 인터페이스 전반에 걸쳐 사용되는 테두리 반경, 테두리 너비 및 그림자를 사용자 정의할 수 있습니다:구성 요소별 사용자 정의
기본 버튼(결제 버튼)과 같은 특정 UI 구성 요소를 사용자 정의할 수 있습니다. 이러한 설정은 전역 외관 설정보다 우선합니다:오류 처리
체크아웃 함수에서 다양한 결제 상태를 처리하세요:Common Error Scenarios
Common Error Scenarios
- 네트워크 연결 문제: 안정적인 인터넷 연결을 확보하세요
- 유효하지 않은 클라이언트 시크릿: 백엔드가 유효한 결제 인텐트를 생성하는지 확인하세요
- 누락된 피어 종속성: 필요한 모든 종속성을 설치하세요
- 플랫폼별 설정: iOS 및 Android 구성 단계를 완료하세요
- API 오류: 자세한 오류 처리를 위해 오류 코드 참조를 확인하세요
Debugging Tips
Debugging Tips
- 개발 중 디버그 로깅 활성화
- 백엔드로의 네트워크 요청 확인
- API 키가 올바르게 구성되었는지 확인
- iOS 및 Android 플랫폼에서 테스트
- 일반적인 문제에 대한 기술 FAQ 검토
- 테스트 모드와 라이브 모드를 적절히 사용