[GP]247
インストールをお任せしますか？
お客様のサーバーに導入・設定します。簡単な見積もりの後、固定価格でお受けします。
🌐 言語: 🇻🇳 Tiếng Việt · 🇬🇧 English · 🇯🇵 日本語（現在）
GP247/Shop のストアで PayPal による決済を受け付けます。お客様は PayPal アカウントで注文代金を直接支払えます。速く、安全で、サイトを離れる必要もありません。
| プラグイン | PaypalExpress |
| バージョン | 3.2.3 |
| 開発元 | GP247 |
| 要件 | GP247 Core 3.1+（ストア別設定、シークレットの保存時暗号化、支払いリクエスト）· パッケージ gp247/shop |
ご都合のよい方法を選んでください。
管理画面から
ZIP ファイルから
その後、プラグイン管理画面でプラグインを有効化します。
gp247 3.x 以降では、管理画面を開かずに、PaypalExpress を GP247 ライブラリからダウンロードしてコマンドラインでそのままインストールできます。サイトのルートフォルダーでターミナルを開き、次を実行します：
# 1) ウェブサイトごとに 1 回だけ：GP247 ライブラリに接続するための API License（無料）を登録
php artisan gp247:ext-register-license
# 2) ライブラリからプラグインをダウンロードしてインストール
php artisan gp247:ext-install --type=plugin --key=PaypalExpress
.env の APP_URL がサイトの実際のドメインになっていること（http://localhost のままでないこと）を確認してください。ライセンスはこのドメインに紐付けられます。gp247.json に宣言された条件（core のバージョン、composer パッケージ、依存プラグイン）を自動で確認します。不足があればコマンドは停止し、何が足りないかを明確に表示します。gp247/shop パッケージがインストールされている必要があります。不足している場合、コマンドは停止して通知します。app/GP247/Plugins/PaypalExpress フォルダーがすでにサーバー上にある場合（手動でコピーした、またはインストーラーに同梱されていた場合）、コマンドは再ダウンロードせずにその場でインストールします。php artisan gp247:ext-update --type=plugin --key=PaypalExpress を実行してください。--json を付けると、機械で読み取れる形式で結果を受け取れます（スクリプト／CI 用）。バージョン 3.1 以降、すべての設定は管理画面で行います。.env を編集する必要はありません。
Admin → Plugins → Paypal Express を開き、次の項目を入力します（ストアごと）：
| 項目 | 入力内容 |
|---|---|
| サンドボックスモード | オン = テスト環境 · オフ = 本番（live） |
| Client ID / Secret（サンドボックス） | テスト環境の認証情報 |
| Client ID / Secret（本番） | 本番環境の認証情報 |
| Webhook ID | PayPal Developer アカウントで取得した Webhook ID（下記の Webhook を参照） |
知っておきたいこと：
enc:v2:…）。平文で保存されることはありません。
.envを使う旧バージョンからアップグレードする場合は？ 以前のバージョンでは認証情報を.envに保存していました。3.1 にアップグレードすると、プラグインはそれらを一度だけ自動でデータベースに取り込み（シークレットは暗号化）、以降はデータベースのみを読み込みます。実行時に.envは使われなくなります。.envファイル自体は変更されず、取り込み後は削除しても構いません。サイトで
php artisan config:cacheを実行している場合、自動取り込みはスキップされます。管理画面で値を入力し直してください。
旧 .env 変数（上記の一度限りの移行にのみ使用）：
PAYPAL_SANDBOX=true
PAYPAL_CLIENT_ID_SANDBOX=your_sandbox_client_id
PAYPAL_CLIENT_SECRET_SANDBOX=your_sandbox_client_secret
PAYPAL_CLIENT_ID_LIVE=your_live_client_id
PAYPAL_CLIENT_SECRET_LIVE=your_live_client_secret
PAYPAL_WEBHOOK_ID=your_webhook_id
GP247 は多くの通貨に対応していますが、PayPal が受け付ける通貨は一部だけです：
3.2.0 以降、支払いリクエスト画面を備えた gp247/shop では、PayPal でカート以外の代金（注文の残額、売掛金、手付金など）も回収できます：
PayPal がリンクのページに表示されるのは、リクエストを所有するストアに Client ID / Secret が設定されている場合のみです。お客様がサイトに戻った直後にブラウザを閉じても入金が記録されるよう、Webhook イベント PAYMENT.CAPTURE.COMPLETED も登録しておくことをおすすめします。
プラグインは次の URL で PayPal からの通知を受け取ります：
https://your-domain.com/plugin/paypal-express/webhook
この URL を PayPal Developer アカウントに登録し、管理画面のプラグイン設定画面に Webhook ID を貼り付けてください（ストアごと）。
app/GP247/Shop/Controllers/ で ShopCartController を上書きしている場合、そのクラスを通して処理されるようになりました。独自の注文完了処理がスキップされなくなります。gp247_namespace() を備えた GP247 Core（3.1 以降）が必要です。gp247/shop の 支払いリクエスト（支払いリンク /pay/…）について、リクエストを所有するストアの PayPal アカウントで回収と返金ができるようになりました。これらのためにイベント PAYMENT.CAPTURE.COMPLETED も受け付けます。注文の決済フローは変わりません。この機能がない shop では、プラグインは 3.1.3 と同じように動作します。GP247 Core 3.1+ が必要です。.env から管理画面の設定画面に移し、ストアごとに設定できるようにしました。client secret は保存時に暗号化されます（enc:v2:…）。storeScope: store — root 管理者がストアごとに別の PayPal アカウントを設定できます。プラグインは store_scoped_segments を登録しないため、この画面を開けるのはサイトオーナー／マーケットプレイスのオーナーだけです（ベンダーは決して開けません）。.env は読み込まれなくなりました。 .env が残っている旧サイトでは、アップグレード時に一度だけ自動で取り込まれ（client secret は暗号化）、以降はデータベースのみが使われます。return_url/cancel_url は手動で設定する必要がなくなり、ルートとストアのドメインから自動生成されます。admin_config の行に保存されるため、設定済みの値はアップグレード後もそのまま保持されます。GP247 が開発 · 各ライセンスに基づいて配布されています。
Please sign in to write a review.
ログインNo reviews yet. Be the first to review this product.
![[InOut] 入荷・返品・入出金管理プラグイン](https://static.gp247.net/product/in-out.png)
