AI要約
ナイジェリア、ガーナ、ケニア、または南アフリカのお客様からの支払いを受け付けたいですか？これらの国のバイヤーは、日常的に使用しているローカルカード、銀行振込、モバイルマネーなどの方法で支払うことを期待しています。
Paystackアドオンは、フォームとPaystackを接続するため、バイヤーはサイトを離れることなく安全なポップアップで支払いを完了できます。このチュートリアルでは、WPFormsでPaystackアドオンをインストールして使用する方法を説明します。
要件:
- Paystackアドオンにアクセスするには、Proライセンス以上が必要です。
- Paystackアドオンの最小必要バージョンを満たすために、WPFormsバージョン2.0.2.2以降がインストールされていることを確認してください。これは最小必要バージョンです。
- ナイジェリア、ガーナ、ケニア、または南アフリカに登録されたPaystackアカウントが必要です。
開始する前に、WordPressサイトにWPFormsをインストールして有効化してください。ライセンスを確認した後、Paystackアドオンをインストールして有効化できます。
Paystackをサイトに接続する
Paystackアドオンがインストールおよび有効化されたら、PaystackアカウントをWPFormsに接続する必要があります。これを行うには、PaystackダッシュボードからAPIキーをWPFormsの支払い設定にコピーします。以下に各ステップを説明します。
Paystack APIキーの取得
開始するには、Paystackダッシュボードにログインします。次に、左側のメニューの一番下にある[設定]をクリックします。
そこに表示されたら、[APIキーとWebhook]タブを開きます。
Paystackは、ダッシュボードが設定されているモードのキーを表示します。実際の支払いを受け付けるには、ライブキーが必要です。これは[API構成 – ライブモード]の下に表示されます。
注意: 新しいPaystackアカウントはテストモードで開始され、ライブキーはPaystackがビジネスをアクティブにした後にのみ利用可能になります。アクティブ化するには、Paystackダッシュボードの[コンプライアンス]ページを開き、各セクションを完了して[ビジネスをアクティブ化]をクリックします。Paystackが詳細を承認すると、ダッシュボードはライブモードに切り替わります。完全な手順については、Paystackのビジネスのアクティブ化ガイドを参照してください。
承認を待っている間、テストキーでアドオンを試すことができます。以下のPaystackの支払いをテストするセクションを参照してください。
次に、Live Secret Key の横にある目のアイコンをクリックします。Paystack はキーを表示する前にアカウントのパスワードを尋ねます。その後、キーをコピーします。
その後、その下のフィールドから Live Public Key をコピーします。
このページを開いたままにしておきます。次のステップで両方のキーを WPForms に貼り付け、Webhook URL を追加するためにここに再度戻ってきます。
WPFormsでの接続を完了する
WordPress 管理画面で、WPForms » 設定に移動し、支払いタブをクリックします。
まず、ページ上部の Currency 設定を確認します。これは、Paystack アカウントが登録されている国の通貨と一致している必要があります。たとえば、ケニアのアカウントにはケニア・シリング（KES）が必要です。
注意: 各 Paystack アカウントは、サインアップ時に選択した国によって設定された単一の通貨で支払いを処理します。WPForms の通貨が一致しない場合、支払い設定に警告が表示され、通貨が一致するまで支払いは行われません。
次に、下にスクロールして Paystack セクションに移動します。シークレットキーを Live Secret Key フィールドに貼り付けます。次に、パブリックキーを Live Public Key フィールドに貼り付けます。
完了したら、Save Settings をクリックします。
WPFormsはPaystackとシークレットキーを照合し、両方のキーが現在のモードに属しているかを確認します。キーが間違って入力されているか、別のモードに属している場合は、すぐにエラーが表示されます。ライブキーはsk_live_とpk_live_で始まり、テストキーはsk_test_とpk_test_で始まります。接続が機能すると、接続ステータスはライブモードでPaystackに接続済みと表示されます。
注意: テストモードとライブモードはそれぞれ独自のキーペアを使用します。実際の支払いを行う前にフォームの Paystack 統合をテストするには、下の「Paystack 支払いのテスト」セクションを参照してください。
Paystack Webhookの設定
Webhook は、顧客がフォームを送信した後に発生する支払い更新について、Paystack がサイトに通知する方法です。たとえば、Webhook を使用すると、WPForms は銀行振込が到着したときや、Paystack ダッシュボードから支払いに対して返金したときに通知を受け取ることができます。
Paystack は WPForms が Webhook を追加することを許可しないため、WPForms から 1 つの URL をコピーして、自分で Paystack ダッシュボードに貼り付ける必要があります。これには 1 分しかかからず、各モードで 1 回だけ行う必要があります。
キーを保存すると、Paystack セクションに 2 つの新しい設定が表示されます。Enable Webhooks をオンのままにします。次に、Webhooks Endpoint フィールドの横にあるコピーアイコンをクリックして、Webhook URL をコピーします。
次に、Paystack ダッシュボードの API Keys & Webhooks ページに戻ります。URL を Live Webhook URL フィールドに貼り付けます。次に、Save changes をクリックします。
WPForms はこれで Paystack からの支払い更新を受信します。
注意: Paystack はテストモードとライブモードで個別の Webhook 設定を保持しますが、WPForms は両方に同じ URL を使用します。最初にテストしている場合は、URL を Test Webhook URL フィールドに貼り付けます。両方のモードを使用する場合は、両方のフィールドに追加します。
フォームにPaystackを追加する
アカウントを接続したら、フォームで支払いを受け付ける準備が整います。まず、新しいフォームを作成するか、既存のフォームを編集してフォームビルダーを開きます。
フォームには、単一項目、複数項目、チェックボックス項目、またはドロップダウン項目など、金額を設定する支払いフィールドが少なくとも1つ必要です。また、Paystackは顧客のメールアドレスを必要とするため、メールフィールドも必要です。追加するPaystackフィールドは別途ありません。Paystackは、フォームが送信されるときに独自のポップアップで支払い詳細を収集します。
次に、フォームビルダーで支払い » Paystackに移動し、Paystack支払いを有効にするトグルをオンにします。
次に、このフォームの支払い設定を入力します。
- 支払い説明: 製品名やサービス名など、支払いに関する簡単な説明です。Paystackダッシュボードの支払い詳細に表示されます。
- 顧客のメールアドレス: 顧客のメールアドレスを保持するフォーム内のフィールドです。この設定は必須です。Paystackは支払いを作成するためにメールアドレスを必要とし、その領収書をこのアドレスに送信します。
- 顧客名: 顧客の名前を保持するフォーム内のフィールドです。Paystackダッシュボードの支払い詳細に表示されます。
フォームにすでにメールフィールドと名前フィールドがある場合、WPFormsが自動的に選択します。
注意: Paystackの支払いにはAJAXフォーム送信が必要です。これは新しいフォームではデフォルトでオンになっています。オフになっている場合、フォームを保存するときにWPFormsが通知します。オンに戻すには、設定 » 一般に移動し、詳細設定セクションを開き、AJAXフォーム送信を有効にするにチェックを入れます。
完了したら、フォームを保存します。これで支払いを受け付ける準備ができました。
顧客がPaystackで支払う方法
顧客がフォームを送信すると、Paystackのポップアップがページ上に表示されます。支払いが完了するまでフォームは送信されません。
ポップアップの支払いオプションは、Paystackアカウントの通貨によって異なります。
- ナイジェリア・ナイラ（NGN）: カードと銀行振込
- ガーナ・セディ（GHS）: カードとモバイルマネー
- ケニア・シリング（KES）: カードとモバイルマネー
- 南アフリカ・ランド（ZAR）: カード
支払いが成功すると、ポップアップが閉じ、顧客はフォームの確認メッセージを表示します。
Paystackの支払いをテストする
実際の支払いを開始する前に、自分でフォームを通じて支払いを通してみることをお勧めします。Paystackのテストモードを使用すると、お金を動かすことなく、すべてのフローを完了できます。
テストモードをオンにする
テスト中に実際の支払いが処理されないことを確認するには、WPForms » 設定に移動し、支払いタブをクリックします。
Paystackの下にあるテストモードトグルをオンにします。テスト秘密鍵とテスト公開鍵フィールドが、ライブのものに代わって表示されます。
注意: テストモードとライブモードは別々に設定されるため、ライブキーをすでに接続している場合でも、テストキーをここに追加する必要があります。WPFormsは、モードを切り替えるときにこれを通知します。
次に、PaystackダッシュボードのAPIキーとWebフックページに戻ります。ダッシュボードがライブモードの場合、ダッシュボードの右上にあるトグルを使用してテストモードに切り替えます。
テストシークレットキーをコピーし、WPFormsのテストシークレットキーフィールドに貼り付けます。次に、テスト公開鍵についても同様に行います。
設定の保存をクリックします。接続ステータスはテストモードでPaystackに接続済みと表示されます。
テスト中にWebhookを受信するには、PaystackダッシュボードのテストWebhook URLフィールドにWebhookエンドポイントURLも貼り付けます。
テスト支払いを実行する
次に、Paystackフォームが表示されているページを開き、顧客が行うように入力してフォームを送信し、Paystackポップアップを開きます。
テストモードでは、カードオプションはカードフィールドの代わりにテストシナリオを表示します。成功したテスト支払いを完了するには、成功を選択して支払いボタンをクリックします。フォームが支払い失敗をどのように処理するかを確認するには、代わりに拒否済みを選択します。
カードの詳細を自分で入力するには、別のカードを使用をクリックし、Paystackのテストカードのいずれかを使用します。たとえば、カード番号4084 0840 8408 4081、CVV408、および将来の有効期限は、支払い成功を完了します。同じページに、モバイルマネーと銀行振込のテスト番号も記載されています。
テスト支払いを確認する
テスト支払いを検索するには、WPForms » 支払いに移動し、テストデータトグルをオンにします。
支払いをクリックして詳細を表示します。そこから、Paystackで表示リンクをクリックすると、Paystackダッシュボードでトランザクションが開きます。
支払い詳細、ステータス、傾向の詳細については、支払い表示と管理ガイドをご覧ください。
条件付きロジックの設定（オプション）
条件付きロジックを使用すると、顧客がフォームで選択した内容に基づいて、Paystack請求を処理するタイミングを決定できます。たとえば、有料オプションを選択した顧客にのみ請求したい場合があります。
これを設定するには、フォームビルダーで支払い » Paystackに移動し、条件付きロジックを有効にするをオンにします。次に、請求を処理するタイミングを決定するルールを作成します。
その他の例については、条件付きロジックの使用に関するチュートリアルをご覧ください。
よくある質問
以下に、Paystackアドオンの使用に関して最もよくある質問のいくつかに回答します。
Paystackアドオンでは、どの国と通貨を使用できますか？
このアドオンは、ナイジェリア、ガーナ、ケニア、南アフリカに登録されたPaystackアカウントで動作します。各アカウントは、その国の通貨（ナイジェリアナイラ（NGN）、ガーナセディ（GHS）、ケニアシリング（KES）、または南アフリカランド（ZAR））で支払い処理を行います。WPForms » 設定 » 支払いで一致する通貨を設定します。
Paystackの支払いが保留中とマークされるのはなぜですか？
銀行振込とモバイルマネーの支払いは、カードの支払いよりも確認に時間がかかる場合があります。顧客がこれらのオプションのいずれかを選択し、Paystackが支払いを確認する前にポップアップを閉じた場合、WPFormsはエントリを保存し、支払いを保留中としてマークします。
支払いが確認されるまで、WPFormsはフォームの通知メールを保留します。また、User Registrationアドオンで作成されたアカウントの有効化と、クーポンの使用回数のカウントを待ちます。Paystackが支払いを確認すると、WPFormsはそれを完了としてマークし、これらの手順を完了します。Webフックが設定されていれば、通常は数秒で完了します。設定されていない場合は、最大30分かかることがあります。
Webhookを設定する必要がありますか？
推奨します。Webフックがない場合、WPFormsは15分ごとにPaystackとチェックし、まだ待機中の支払いを更新するため、銀行振込やモバイルマネーの支払いは完了します。カード払いは、そのチェックが完了とマークするまで最大30分間処理中として残ります。ただし、Paystackダッシュボードで行った返金はWPFormsに同期されません。
WPFormsがこれらのチェックを通じてのみ支払いが更新されていることに気づいた場合、WordPress管理画面にWebフックの設定を確認するように促す通知が表示されます。修正するには、WPForms » 設定 » 支払いからWebフックエンドポイントのURLを、Paystackダッシュボードで使用しているモードのWebフックURLフィールドにコピーしてください。
フォームに「現在、支払いが利用できません」と表示されるのはなぜですか？
このメッセージは、WPFormsがフォームでPaystackの支払い処理に失敗した場合に表示されます。最も一般的な原因とそれぞれの修正方法は次のとおりです。
- 現在のモードでPaystackが接続されていません: たとえば、テストモードがオンになっていますが、テストキーが保存されていません。WPForms » 設定 » 支払い に移動し、使用しているモードのキーを追加してください。
- 通貨が一致しません: Paystackはアカウントの通貨でのみ支払いを処理するため、WPFormsの通貨を変更すると支払いが一時停止します。Paystackアカウントに合わせて通貨を元に戻してください。
- AJAXフォーム送信が無効になっています: Paystackの支払いにはAJAXフォーム送信が必要ですが、一部のフォームテンプレート（ユーザー登録テンプレートを含む）ではデフォルトで無効になっています。有効にするには、フォームの設定 » 一般 を開き、詳細設定を展開して、AJAXフォーム送信を有効にする にチェックを入れてください。
「支払金額が許可される最小額を下回っています」と表示されるのはなぜですか？
Paystackは通貨ごとに最小金額を設定しており、WPFormsはポップアップを開く前に合計金額を確認します。最小金額はNGN 50、GHS 0.10、KES 3、ZAR 1です。フォームの合計金額がこの金額を下回る可能性がある場合は、価格を調整するか、条件付きロジックを使用してこれらの注文の請求をスキップしてください。
WPFormsはお客様のカード情報を保存しますか？
いいえ。PaystackポップアップはPaystackによってホストされているため、カード情報は直接Paystackに送信され、お客様のサイトに触れることはありません。WPFormsは、参照用に支払い記録と、カードブランドおよび下4桁のみを保存します。
これで完了です！WPForms Paystackアドオンを通じて、カード、銀行振込、モバイルマネーでの支払いを受け付けることができるようになりました。
次に、フォームを通じて行われる支払いにもっと注意を払いたいですか？支払い詳細、ステータス、払い戻しについて学ぶには、支払い表示と管理のガイドをご覧ください。
