React Native SDKの統合
Dodo PaymentsのReact Native SDKを使用すると、ネイティブのAndroidおよびiOSアプリで安全な決済体験を構築できます。私たちのSDKは、決済情報を収集するためのカスタマイズ可能なUIコンポーネントと画面を提供します。機能
Simplified Security
PCI準拠を維持しながら機密決済データを安全に収集します
Multiple 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
APIキーはDodo Paymentsダッシュボードで生成する必要があります。詳しい手順は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'外観のカスタマイズ
アプリのデザインに合わせてReact Native Unified Checkoutをカスタマイズするには、initPaymentSession()の呼び出し時にappearanceパラメータを通じて色やフォントなどを調整します。
色のカスタマイズ
各カラーカテゴリはUI内の1つ以上のコンポーネントの色を決定します。たとえば、primaryはPayボタンの色を定義します。
ライトモードとダークモードのサポートを含む例の設定:
形状のカスタマイズ
決済インターフェース全体で使用されるボーダー半径、ボーダー幅、およびシャドウをカスタマイズできます:コンポーネント固有のカスタマイズ
プライマリボタン(Payボタン)などの特定のUIコンポーネントをカスタマイズできます。これらの設定は、グローバルな外観設定よりも優先されます:エラーハンドリング
チェックアウト関数内でさまざまな決済状態を処理します:Common Error Scenarios
Common Error Scenarios
- Network connectivity issues: 安定したインターネット接続を確保してください
- Invalid client secret: バックエンドが有効な支払いインテントを生成していることを確認してください
- Missing peer dependencies: 必要な依存関係をすべてインストールしてください
- Platform-specific setup: iOSおよびAndroidの構成手順を完了してください
- API errors: 詳しいエラーハンドリングについてはError Codes Referenceを確認してください
Debugging Tips
Debugging Tips
- 開発環境でデバッグログを有効化
- バックエンドへのネットワークリクエストを確認
- APIキーが正しく設定されているか確認
- iOSとAndroidの両方のプラットフォームでテスト
- 共通の問題については技術的FAQを参照
- テストモードとライブモードを適切に使用