オンライン決済「Stripe」導入プラグイン
本プラグインを利用すると、オンライン決済 Stripeによるクレジットカード決済・コンビニ決済が利用できるようになります。
Stripeを利用して、SKELETON CARTの購入手続きの流れのままにクレジットカード決済・コンビニ決済を完了することが可能です。
Stripeの詳細はウェブサイトでご確認ください。
動作DEMOを用意しています。
こちらではダミーのクレジットカード番号等を使用して決済完了までをご確認いただけます。
クレジットカードのテスト番号は、Stripe公式ドキュメント「ブランド別のカード」をご参照ください。
コンビニ決済のエラー・成功の動作確認はStripe公式ドキュメント「組み込みをテストする」をご参照ください。
導入条件
- 本プラグインはSKELETON CART Version 2.1.11以上に対応しています。（試用版でも動作します）
- PHP version 7.4以上で動作します。
プラグインのダウンロード
本プラグインは以下よりダウンロードしてください。
プラグインの設定
ダウンロードしたzipファイルを解凍すると以下の関連ファイルが格納された「StripeSimple」フォルダができます。
Config.phpをテキストエディタ等で開き、以下の例にならってStripeのAPI キーほかを設定してください。
return array(
//
// Stripe APIキー
//
// 公開可能キー
'publicApiKey' => 'pk_test_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX',
// シークレットキー
'secretApiKey' => 'sk_test_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX',
// Webhookキー
'endpointSecret' => 'whsec_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX',
// init.phpで指定した、クレジットカード・コンビニ決済のpayment_wayのインデックス番号を設定します。
// 【注意】以下のインデックス番号部分のみinit.phpに合わせて変更してください。
'payment_way' => [
4 => 'card', // クレジットカード
6 => 'konbini', // コンビニ決済
],
//
// コンビニ決済
//
// 決済失敗時のメール件名
'email_subject_konbini_failed' => '【{{$order_id}}】コンビニ決済が期限切れになりました',
// 決済成功時のメール件名
'email_subject_konbini_succeeded' => '【{{$order_id}}】コンビニ決済が完了しました',
// 有効期限が切れるまでの日数
'expires_after_days' => 3,
);公開可能キー、シークレットキーの設定
Stripe開発者メニューの中にある「APIキー」を表示し、publicApiKeyには公開可能キーを、secretApiKeyにはシークレットキーをそれぞれ記載してください。
Webhookキーの設定
同じくStripe開発者メニューの中にある「Webhook」を表示し、SKELETON CART用のエンドポイントを追加してください。
エンドポイントの追加方法の詳細は、Stripe公式ドキュメント「Stripe で Webhook エンドポイントを登録する」をご確認願います。
SKELETON CARTを、/shop などにインストールした場合のエンドポイントURLは、以下になります。
https://www.example.com/shop/webhook/stripe
イベントは、payment_intent.payment_failedとpayment_intent.succeededを選択してください。
イベントを追加した後、「署名シークレット」をコピーして、endpointSecretに設定してください。
HTMLテンプレートファイルの修正
templatesフォルダ内の _regi.html と _regi_conf.html _regi_comp.html を参考にクレジットカード決済・コンビニ決済利用時の動作をテンプレート上でカスタマイズしてください。
なお、初期テンプレートをご利用の場合、上記のテンプレートへ差し替えることで、動作DEMO環境と同じステップでクレジットカード決済・コンビニ決済を完了することができます。
※情報入力部分のカスタマイズはできません。
クレジットカード決済の情報入力画面
コンビニ決済の情報入力画面
テンプレートカスタマイズについて
購入内容確認画面、購入手続き完了画面では、{if $payment_way == 'init.phpで指定したお支払い方法の番号'}を使用することでクレジットカード決済・コンビニ決済（init.phpで指定したお支払い方法）を選択している場合の表示内容をコントロールできます。
{if $payment_way == '4'}
クレジットカード決済を選択している場合にこの部分を表示
{/if}{if $payment_way != '6'}
コンビニ決済を選択していない場合にこの部分を表示
{else}
コンビニ決済を選択している場合にこの部分を表示
{/if}ファイルのアップロード
以下のように関連ファイルをアップロードしてください。
なお、_mail_konbini_failed.txt と _mail_konbini_succeeded.txt は、コンビニ決済利用時の「決済エラー」「決済成功」を通知するメールのテンプレートです。
必要に応じて、内容を修正してご利用ください。
- http://example.com/
- sample_item.html（商品ページ）
- shop（SKELETON CART設置ディレクトリ）
- ├ plugins / StripeSimple /
- ├ common / images / cvc.png
- ├ common / js / stripe_simple.js
- ├ templates / _regi.html
- ├ templates / _regi_comp.html
- ├ templates / _regi_conf.html
- ├ templates / _mail_konbini_failed.txt
- ├ templates / _mail_konbini_succeeded.txt
- ⋮
CVC説明画像のアップロード
購入手続き完了画面で、「CVC（セキュリティコード）について」をクリックした際、以下のように説明画像が表示されます。
なお、画像の保存先変更、画像の差替は自由に行っていただいて問題ありません。
以上で設置は完了です。
プラグインの動作をお確かめください。
ご留意事項
本プラグインのご利用にあたって、以下をご確認願います。
- 本プラグインの著作権は開発元のジャクスタポジションが保有します。
- SKELETON CARTライセンスユーザー様に限り、個人・法人を問わず無償でご利用いただけます。
- 本プラグインを利用したことで生じるあらゆる損害や不具合について、弊社では保証いたしません。
- 必ずご利用者様ご自身が動作テスト等を行ってからご利用願います。
- 本プラグインに関する設置サポート等はお受けしておりません。
- 本プラグインの二次著作物の配布等は有償・無償を問わずできません。
- プラグイン内に記載されている著作権表示等を削除しないでください。
その他ご不明な点があれば、お問い合せフォームよりご連絡ください。