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

​
概要

WooCommerceの決済ゲートウェイプラグインとしてZAFA PAYを導入できます。ホスト型チェックアウトを使用するため、カード情報をサイト側で扱う必要はありません。

​
ダウンロード

ZAFA PAY Gateway for WooCommerce v1.0.0

プラグインをダウンロード（ZIP）

​
要件

  • WordPress 5.0以上
  • WooCommerce 5.0以上
  • PHP 7.4以上
  • ZAFA PAYのマーチャントアカウント

​
導入フロー

1

プラグインのインストール

ダウンロードしたZIPファイルを WordPress管理画面の プラグイン → 新規追加 → プラグインのアップロード からインストールして有効化します
2

WooCommerce設定

WooCommerce → 設定 → 決済 → ZAFA PAY でAPIトークンとWebhookシークレットを設定します
3

ZAFA PAYダッシュボード設定

Webhook URLとリダイレクトURLを設定します
4

テスト決済

サンドボックスモードでテスト決済を行い、動作を確認します

​
プラグイン設定

WooCommerce管理画面（WooCommerce → 設定 → 決済 → ZAFA PAY）で以下を設定します。
項目説明
有効/無効ZAFA PAYゲートウェイの有効化
タイトルチェックアウト画面に表示される決済方法名
説明チェックアウト画面に表示される説明文
サンドボックスモードテスト環境（sandbox）と本番環境の切り替え
APIトークンZAFA PAYダッシュボードのMerchant Settingsから取得
WebhookシークレットZAFA PAYダッシュボードでWebhook登録時に発行されるシークレット
Flow ID特定の決済フローを使用する場合に入力（任意）
サンドボックスと本番ではAPIトークンが異なります。環境を切り替える際はトークンも変更してください。

​
ZAFA PAYダッシュボード設定

​
Webhook URL

ZAFA PAYダッシュボードのWebhooksタブで以下のURLを登録してください。 
https://your-domain.com/wc-api/zafapay_webhook
受信するイベント:
  • payment.succeeded
  • payment.failed
  • payment.canceled
  • payment.refunded
  • payment.chargeback

​
リダイレクトURL

ZAFA PAYダッシュボードのリダイレクトURL設定に以下を登録してください。
項目URL
成功時リダイレクトURLhttps://your-domain.com/wc-api/zafapay_callback
失敗時リダイレクトURLhttps://your-domain.com/wc-api/zafapay_callback
キャンセルURLhttps://your-domain.com/checkout/
成功と失敗は同じURLです。ZAFA PAYがリダイレクト時に付与する status パラメータでプラグインが自動判別します。

​
決済フロー

​
返金

WooCommerce管理画面から返金を実行できます。
  1. WooCommerce → 注文 から対象の注文を開く
  2. 「払戻額」 ボタンをクリック
  3. 商品行の金額欄に返金額を入力
  4. 「ZAFA PAY によって返金します」 ボタンをクリック
部分返金と全額返金の両方に対応しています。

​
対応する注文ステータス

イベントWooCommerceステータス
決済成功処理中
決済失敗失敗
キャンセルキャンセル
返金返金済み（注文メモに記録）
チャージバック保留中
オーソリ済み（manual capture）保留中

​
API環境

環境API URL
サンドボックスhttps://api.sandbox.zafapay.com
本番https://api.zafapay.com