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は、フォーム送信時に独自のポップアップで支払い詳細を収集します。
次に、フォームビルダーのPayments » Paystackに移動し、Enable Paystack paymentsトグルをオンにします。
次に、このフォームの支払い設定を入力します。
- 支払い説明: 商品名やサービス名など、支払いの簡単な説明です。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はフォームの通知メールを保留します。また、ユーザー登録アドオンで作成されたアカウントのアクティベートや、クーポンの使用回数をカウントするのを待ちます。Paystackが支払いを確認すると、WPFormsは完了とマークし、これらのステップを終了します。Webフックが設定されていれば、通常は数秒で完了します。設定されていない場合は、最大30分かかることがあります。
Webhookを設定する必要がありますか？
推奨します。Webフックがない場合、WPFormsは15分ごとにPaystackとチェックし、まだ待機中の支払いを更新するため、銀行振込やモバイルマネーの支払いは完了します。カード払いは、そのチェックが完了とマークするまで最大30分間処理中として残ります。ただし、Paystackダッシュボードで行った返金はWPFormsに同期されません。
WPFormsは、これらのチェックを通じてのみ支払いが更新されていることを検出した場合、Paystackダッシュボードで使用しているモードのWebhook URLフィールドに、WPForms » 設定 » 支払いからWebhookエンドポイントURLをコピーして修正するように求める通知をWordPress管理画面に表示します。
フォームに「現在、支払いが利用できません」と表示されるのはなぜですか？
このメッセージは、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アドオンを通じて、カード、銀行振込、モバイルマネーでの支払いを受け付けることができます。
次に、フォームを通じて行われる支払いにもっと注意を払いたいですか？支払い詳細、ステータス、および払い戻しについて学ぶには、支払いを表示および管理するガイドをご覧ください。
