お知らせ:当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の
英語版を参照してください。
購入先として Razorpay を選択している場合、OAuth 認証を使用して Razorpay のリソースにアクセスできるよう、Zoho Forms アカウントを認証する必要があります。
OAuth 認証を使用すると、キー ID やキーシークレットの代わりに安全なアクセストークンを使ってフォームと Razorpay を接続でき、トークンベース認証により Razorpay リソースへ安全にアクセスできます。
支払い項目でRazorpay を設定するには、
- OAuth 認証を設定している場合は、初めて Razorpay を設定します。
- すでにキー ID とキーシークレットを使用してフォームと Razorpay を連携している場合は、OAuth 認証に切り替えることができます。
フォームで Razorpay を初めて設定する場合は、
-
Zoho Forms が Razorpay アカウントに接続できるようアクセスを許可するには、Authenticate をクリックします。
-
ポップアップで、OAuth 名を入力し、認証の方法としてテスト環境または本番環境 (Production) のいずれかを選択します。
メモ: わかりやすい OAuth 名を入力することをおすすめします。この名前は、どの OAuth 設定かを識別するための参照として使用されます。
-
続ける をクリックします。
- Razorpay の画面にリダイレクトされます。Razorpay アカウント担当者のログイン情報を使用して OAuth 認証を行い、特定の購入先 ID に接続します。Zoho Forms が支払い処理中に読み取り/書き込み操作を安全に実行できるようにするには、認証 をクリックして Razorpay アカウントへのアクセスを許可します。
- 認証が完了すると、Zoho Forms の支払い項目設定内のOAuth 認証済みドロップダウンに、認証済みの Razorpay 取引先の一覧が表示されます。
- 新しい Razorpay アカウントを認証するには、ドロップダウンで+ 新規 Connection をクリックします。

- 支払い金額を入力します。支払いの固定金額を設定するか、フォーム項目の値から支払い金額を自動入力することができます。
- 事前入力情報 (Prefill Information)では、フォーム項目からメールと電話番号を含めることができます。この情報は購入先サイトに事前入力されます。
- 決済ページ表示設定で、Razorpay 決済スタイルを適用 を有効にすると、Razorpay ダッシュボードで設定したブランド名と背景色の決済スタイルが決済ページに適用されます。詳細はこちら
- モバイル決済アプリ経由で Razorpay による支払いが行われた場合など、一部のケースで支払いステータスを取得するには、Webhook 設定で Webhook を設定します。
- 完了 をクリックします。
決済ページ表示設定の構成
Razorpay の決済スタイリングで設定したブランド名と任意の背景色を決済ページに反映するには、次の操作を行います。
Razorpay ダッシュボード:
- Razorpay ダッシュボードで、アカウント & 設定 > 決済設定 > 決済スタイリング に移動します。
- Background color で標準の背景色を設定し、ブランド名 and ロゴ でブランド名を設定します。
- すべての変更を保存します。

Zoho Forms 支払いゲートウェイ:
- フォームで、Razorpay 支払いゲートウェイの設定画面に移動します。
- 決済ページ表示設定で、Razorpay 決済スタイルを適用 を有効にします。
これにより、Razorpay の決済スタイリングで設定した背景色とブランド名が、決済ページに適用されます。
メモ:
ブランドロゴ、枠線スタイル、フォント、スライドバー画像、Razorpay の信頼バッジなど、その他の決済スタイル要素は、決済ページ表示設定での選択にかかわらず、Razorpay の決済スタイリングでの設定に従って決済ページに表示されます。
OAuth 認証に切り替える
すでにキー ID とキーシークレットを使用してフォームと Razorpay を連携しており、OAuth 認証を使用して Zoho Forms に Razorpay アカウントへのアクセスを許可したい場合は、
-
支払いゲートウェイの設定画面右上にある
Authenticate OAuthをクリックします。
-
ポップアップで、OAuth 名を入力し、認証モードとしてテスト環境または本番環境 (Production)のいずれかを選択します。
メモ: 後から OAuth を識別しやすいように、意味のあるOAuth 名を入力することをおすすめします。この名前は OAuth を特定するための参照用です。
-
続けるをクリックします。
-
Razorpay の画面にリダイレクトされます。Razorpay アカウント担当者のログイン情報を使用して OAuth 認証を行い、特定のマーチャント ID に接続します。Zoho Forms が支払い処理中に Razorpay アカウントへ安全に読み取り/書き込みアクセスできるようにするには、認証をクリックします。
-
認証が完了すると、Zoho Forms の支払いフィールド設定内のOAuth 認証先ドロップダウンに、認証済みの Razorpay マーチャント一覧が表示されます。
-
新しい Razorpay アカウントを認証するには、ドロップダウン内の
+ 新規 Connectionをクリックします。
-
支払い金額を入力します。支払いの固定金額を設定するか、フォームフィールドの値から支払い金額を自動入力することができます。
-
事前入力情報では、フォームフィールドからメールと電話番号を含めることができます。この情報は支払い時にマーチャントサイトの入力欄に自動入力されます。
-
チェックアウトページ表示設定で、
Razorpay チェックアウトスタイルを適用を有効にすると、Razorpay ダッシュボードで設定したブランド名と背景色のチェックアウトスタイルを、チェックアウトページに適用できます。
詳細はこちら
- モバイル決済アプリ経由で Razorpay により支払いが行われた際に、支払い後に自動でブラウザーへリダイレクトされない場合の支払いステータスを取得するには、Webhook 設定で Webhook を設定します。
-
完了をクリックします。
- 各認証モード(テスト環境 / 本番環境)ごとに、最大 3 件の Razorpay マーチャントを認証できます。
- カスタムドメインを使用している場合は、支払いを受け取る前に、そのドメインについて Razorpay で KYC 確認プロセスを完了する必要があります。詳細を読む
- フォームの所有者が別のユーザーに変更された場合は、Razorpay OAuth 認証を再設定する必要があります。
- INR 以外の通貨で支払いを受け取りたい場合は、Razorpay ダッシュボードで海外支払いを有効にする必要があります。
Razorpay Webhook の設定
モバイル決済アプリ経由で Razorpay により支払いが行われた場合、支払い後にユーザーが自動的にブラウザーへリダイレクトされない可能性があります。このようなケース(認証が遅延した支払い、失敗した支払い、完了した支払い)の支払いステータスを取得するには、Razorpay をマーチャントアカウントとして使用して支払いフィールドを設定する際に Webhook を設定します。
Webhook URL の生成
支払いステータスを取得するには、次の操作を行います。
- Webhook Configuration で Capture ステータス via Webhook を選択します。
- シークレットの欄に、任意のシークレットキーを入力します。キーは 5 文字以上である必要があります。
-
Webhook の
URLが自動生成されます。
- 保存をクリックします。
- 表示されたポップアップで Webhook のURLをコピーします。
Webhook URL の設定が完了したら、Razorpay の設定画面に移動し、以下の手順に従います。
Razorpay 設定での Webhook 設定
- Razorpay アカウントのダッシュボードに移動し、設定に進みます。
- Webhookタブで、有効な Webhook を設定をクリックします。
- コピーしたWebhook URLをテキストボックスに貼り付け、有効を選択します。
- シークレットキーを入力します。これはフォームビルダーの支払い設定で設定したキーと同じものです。
- 有効イベントで、payment.failed と order.paid イベントを選択します。
- 保存をクリックします。
メモ: 有効イベントで複数のイベントを有効にすると、Zoho Forms は Razorpay から不要な支払い関連リクエストを受信することになります。
支払いが行われると、すべてのエントリー > 支払いステータスで各レコードの支払いステータスを確認できます。
- Webhook が有効である限り、Webhook 経由の支払いステータスは更新されます。
- 入力されたシークレットキーが一致しない場合、支払いステータスは更新されません。
- Webhook を設定すると、マーチャントアカウントが支払いを受け取るたびに(Razorpay 経由の支払いに使用しているサービスに関係なく)、Razorpay から Zoho Forms へ Webhook が送信されます。
支払いゲートウェイを設定する際、シークレットキーやトークンなどの機密情報は、データベースに保存される前に暗号化され、他のサードパーティアプリに公開されることはありません。
OAuth アクセストークンの取り消し
Razorpay アカウントと Zoho Forms アカウントの連携を解除するには、コントロールパネルから OAuth アクセストークンを削除します。
その手順は次のとおりです。
- 左上のホームアイコンをクリックして、コントロールパネルにアクセスします。
-
コントロールパネルで、開発者向け情報の下にあるAccess Tokensをクリックします。
- Razorpay にカーソルを合わせ、削除アイコンをクリックします。