メインコンテンツへスキップ

React Native SDKの統合

Dodo PaymentsのReact Native SDKを使用すると、ネイティブのAndroidおよびiOSアプリで安全な決済体験を構築できます。私たちのSDKは、決済情報を収集するためのカスタマイズ可能なUIコンポーネントと画面を提供します。
  • 📦 NPMからSDKをインストール
  • 📚 完全な実装例については、デモリポジトリをご覧ください
  • 🎥 Dodo Payments SDKの動作を確認するには、デモ動画をご覧ください

機能

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をインストールします:
2

Platform-specific setup

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
スタイリング、エラーハンドリング、およびカスタマイズオプションを含む完全な例については、デモリポジトリをご覧ください:

設定オプション

セッションパラメータ

clientSecret
string
必須
ワンタイム決済またはサブスクリプションAPIから取得した支払いインテントのクライアントシークレット。
mode
string
必須
決済セッションのモード(テストまたはライブ)。
configuration.appearance
object
決済シートの外観に関するカスタマイズオプション
configuration.appearance.themes
string
テーマモード: 'light'または'dark'

外観のカスタマイズ

アプリのデザインに合わせてReact Native Unified Checkoutをカスタマイズするには、initPaymentSession()の呼び出し時にappearanceパラメータを通じて色やフォントなどを調整します。

色のカスタマイズ

各カラーカテゴリはUI内の1つ以上のコンポーネントの色を決定します。たとえば、primaryはPayボタンの色を定義します。 ライトモードとダークモードのサポートを含む例の設定:

形状のカスタマイズ

決済インターフェース全体で使用されるボーダー半径、ボーダー幅、およびシャドウをカスタマイズできます:

コンポーネント固有のカスタマイズ

プライマリボタン(Payボタン)などの特定のUIコンポーネントをカスタマイズできます。これらの設定は、グローバルな外観設定よりも優先されます:
これらのカスタマイズを適用するには、決済セッションの設定に含めてください:

エラーハンドリング

チェックアウト関数内でさまざまな決済状態を処理します:
  • Network connectivity issues: 安定したインターネット接続を確保してください
  • Invalid client secret: バックエンドが有効な支払いインテントを生成していることを確認してください
  • Missing peer dependencies: 必要な依存関係をすべてインストールしてください
  • Platform-specific setup: iOSおよびAndroidの構成手順を完了してください
  • API errors: 詳しいエラーハンドリングについてはError Codes Referenceを確認してください
  • 開発環境でデバッグログを有効化
  • バックエンドへのネットワークリクエストを確認
  • APIキーが正しく設定されているか確認
  • iOSとAndroidの両方のプラットフォームでテスト
  • 共通の問題については技術的FAQを参照
  • テストモードとライブモードを適切に使用

テスト決済方法

開発ではテストカード番号を使って実際の決済処理を行わずに統合を確認してください。テストプロセスと利用可能なテスト環境の詳細についてはtesting processをご覧ください。
最終更新日 2026年5月28日