【Swift入門】PayUmoneyをiOSアプリに統合する手順をわかりやすく解説

PayUmoneyは、インドのオンライン市場で広く利用されている決済ゲートウェイです。本記事では、Swiftを使ってiOSアプリにPayUmoneyを統合するための手順を詳しく解説します。統合作業では手順の抜けや漏れがトラブルの原因になるため、以下のステップを一つずつ確実に進めることが重要です。

1. PayUmoneyへのサインアップ

まず、PayUmoneyの公式サイトからアカウント登録（サインアップ）を行います。これが統合の出発点となります。

2. キー・ソルト・マーチャントIDの確認

サインアップが完了すると、「key」「salt」「merchant ID」が自動的に発行されます。これらは、PayUmoneyアカウントにログイン後、ダッシュボードから確認できます。後の設定で必須となるため、忘れずに控えておきましょう。

3. SDKのクローン

次に、ターミナルアプリを開き、以下のコマンドを実行してPayUmoneyのSDKをクローンします。

$ git clone --recursive https://github.com/payu-intrepos/PayUMoney-IOS-SDK.git

注意：この作業を手動で行う場合、ブリッジングヘッダーの作成など追加の手順が必要になることがあります。git cloneコマンドを利用する方法が最も簡単で確実です。

4. PlugNPlayフォルダのプロジェクトへの追加

クローンしたリポジトリ内にある「PlugNPlay」フォルダを、Xcodeプロジェクトにドラッグ＆ドロップして追加します。

5. フレームワークの組み込み確認

続いて、アプリのターゲット設定を開きます。「Build Phases」のバイナリ関連セクションで、「PlugNPlay.framework」が含まれているかどうかを確認してください。含まれていない場合は、ここへ追加しておきましょう。この設定漏れはビルドエラーの典型的な原因です。

6. ブリッジングヘッダーへの追加

ブリッジングヘッダーファイルに「PayUServiceHelper.h」を追記します。Objective-C製のSDKをSwiftから扱うために、この設定は必須となります。

7. 認証情報の置き換え

「PayUServiceHelper.h」ファイル内に記載されているマーチャントID・キー・ソルト・環境（environment）の値を、手順2で控えたダッシュボード上の実際の値に置き換えます。テスト環境と本番環境で値が異なる点にも注意してください。

8. 決済メソッドの呼び出し

以上の設定が完了すれば、任意のViewControllerから決済用のメソッドを自由に呼び出せるようになります。ボタンのアクションなど、決済フローを開始したい箇所に実装しましょう。

まとめ

PayUmoneyをiOSアプリに統合する流れは、「サインアップ → 認証情報の取得 → SDKの導入 → 設定の書き換え」という順序で進めます。特にブリッジングヘッダーやフレームワークの設定漏れはエラーにつながりやすいため、各ステップを丁寧に確認しながら作業することをおすすめします。