PayPal 決済サービス
決済モジュール運用マニュアル

作成日：2020年12月21日
更新日：2024年8月7日
株式会社Welcart

PayPal for Welcart

目次
目次
更新履歴
特徴
新しい PayPal 決済サービス
決済の接続方式
決済処理連携コンバージョンのトラッキング
継続課金
定期購入
クレジットカード決済
クレジットカード情報の保存
注意点
サーバー要件SSL仕様
使用不可プラグイン
継続課金の移行について
会員の退会について
定期購入
継続課金
その他の注意点
エクスプレスチェックアウトからの切り替え
ウェブペイメントプラスからの切り替え
申込方法
従量課金の申込み
クレジットカード決済の申込み
設定方法
クレジット決済設定
クレジット決済代行会社の選択
PayPal アカウントの接続
PayPal 決済の設定
基本設定
PayPal ボタンのカスタマイズ
利用条件の同意PayPal 決済 の設定の更新
基本設定
支払方法の登録
システム設定PayPal ボタンの言語について

1
3
4
4
4
4
4
5
6
6
7
8
8
8
9
9
10
10
10
10
11
11
12
12
12
13
13
13
14
16
16
18
19
19
20
20
22
22
1

Copyright © 2024 Welcart Inc.

PayPal for Welcart
クレジットカード決済を利用するための手順
クレジットカード決済を利用するまでの流れ
PayPal をまだ Welcart に連携していない場合（新規ユーザーの場合）
PayPal と Welcart を既に連携している場合（既存ユーザーの場合）クレジットカード情報の保存機能の注意点
テスト環境（Sandbox）をご利用時の設定
接続テスト
実施手順
決済情報の連携（PayPal Commerce Platform ・ クレジットカード決済共通）
売上計上
処理区分「売上計上（CAPTURE）」の場合
処理区分「与信（AUTHORIZE）」の場合
減額
決済状況が「与信」の場合決済状況が「売上計上」の場合
増額取消
決済状況が「与信」の場合決済状況が「売上計上」の場合
再決済
保留中
予期せぬエラーの対処方法
留意点
運用上の注意点
決済エラーログ
受注の取りこぼし発生時の対応
クレジットカード情報の保存を利用する場合の注意
マイページからの削除方法
管理画面からの削除方法
よくあるお問い合わせ

23
23
23
23
24
25
27
27
28
28
28
28
29
29
30
31
32
32
33
34
34
35
35
36
36
36
38
38
38
39

2
Copyright © 2024 Welcart Inc.

PayPal for Welcart

更新履歴

ウェブペイメントプラスの解約方法を追加

P9

2021.1.20

PayPal スマートペイメントボタンの案内を追加

P9

2021.1.20

PayPal ボタンの言語について

P17

2021.1.20

PayPal への「従量課金」のお申し込み方法の記載内容を変更

P5,P282021.5.17「請求処理規約ID」の記載を追加

P5,P6,
P31

2021.7.30

クレジットカード決済実装

2022.1.26「従量課金」「クレジットカード決済」お申し込みのリンク先変更

2022.6.2

クレジットカード決済の3Dセキュア実装

P6,16

接続テストについて追記

2023.5.16
2023.5.25

クレジットカード情報の保存について追記

P7

2023.9.7

クレジットカード情報の保存機能の注意点を追記

P24

2023.9.26

与信後の売上計上可能期間について追記

P282024.1.23

PayPalアカウントに登録できる金融機関について追記

P6,7

2024.8.7

3
Copyright © 2024 Welcart Inc.

PayPal for Welcart

特徴
新しい PayPal 決済サービス

Welcart の PayPal 決済APIが大幅リニューアルし、PayPal エクスプレスチェックアウトと PayPal ウェブペイメ
ントプラスが新しく PayPal Commerce Platform に変わります。
Welcart 2.1 にアップグレードすると、強制的に PayPal エクスプレスチェックアウトと PayPal ウェブペイメン
トプラスが利用できなくなります。
PayPal 決済サービスを利用し続ける場合は、PayPal Commerce Platform の設定を行ってください。
Welcart 2.5 より、決済種別にクレジットカード決済が追加されました。

決済の接続方式
内容確認画面にて PayPal のチェックアウトボタンをクリックすると PayPal 決済のミニブラウザがポップアッ
プ表示されて決済を完結します。デザインの統一性が保て、スムーズなチェックアウトが可能で、かご落
ちしにくいと言われています。
Welcart 2.5 より、決済種別にクレジットカード決済が追加されました。

決済処理連携与信から売上計上への変更や与信取消・返金が、売り手アカウントにログインすることなく、Welcartの管理画面から操作することができます。

コンバージョンのトラッキング
コンバージョンのトラッキングが可能です。

4
Copyright © 2024 Welcart Inc.

PayPal for Welcart

継続課金
雑誌の定期購読やオンライン教室のレッスン料の徴収など、ダウンロード商品・サービス商品の継続課
金を行うことができます。
継続課金を行う場合は、Welcart 会員システムは必ず「利用する」に設定してください。
PayPal エクスプレスチェックアウトでは、Welcart 専用拡張プラグイン「WCEX DL Seller」と PayPal の「定期支払い」を利用して継続課金を実現していました。
Welcart の継続課金データと PayPal の定期支払いデータは連動しておらず、返金や課金取消などはそれぞれ操作を行う必要がありました。
PayPal Commerce Platform では、課金日の設定・変更や返金・課金取消などが Welcart の管理画面上で行えるようになります。
PayPal Commerce Platform で継続課金を行うには、Welcart 専用拡張プラグイン「WCEX DL Seller（ver3.1.1以降）」の導入が必要になります。
継続課金商品の初回購入時に、PayPal から「請求処理規約ID」が発行されます。
Welcart ではこの「請求処理規約ID」を紐付けており、サンキューメールおよびWelcart の継続課金会員
情報画面に「請求処理規約ID」が表示されます。（Welcart 2.2.5 以降）
また、[管理画面 > Welcart Management > 継続課金会員リスト]の操作フィールドから「請求処理規約ID」
で検索することができます。
※継続課金を行う場合は、ペイパルへの「従量課金」の利用申請・審査が必要となります。利用申請については下記の内容をご確認の上お申し込み下さい。
1. 新規のお申し込みの場合、こちらのフォームからお申し込み下さい。
「お問い合わせ内容を具体的にご記入ください」の欄に、Welcartにて継続課金機能の利用を希望の旨ご記入ください。
2. 既存の売り手アカウントをお持ちの方は、こちらのページの「その他のお問い合わせ方法」の下にある「メッセージを送る」からお申し込み下さい。
メッセージボックスに「WelcartにてReference Transactionを利用するための審査・設定をしてほしい」旨をご記入ください。
※PayPal エクスプレスチェックアウトで「定期支払い」で行っていた継続課金は、Welcart 2.1 以降にアップデートしても引き継げず、Welcart の管理画面上で課金日の設定・変更などが行えません。詳しくは「注意点 継続課金の移行について」を参照してください。
※Welcart 2.5 より、決済種別にクレジットカード決済が追加されましたが、継続課金商品の場合は支払方法として選択できません。
（通常課金商品の場合は、支払方法として選択できます。）
継続課金商品を扱う場合は、今まで通り PayPal Commerce Platform を支払方法に設定してください。

5
Copyright © 2024 Welcart Inc.

PayPal for Welcart
2024年6月、PayPal アカウントに登録できる金融機関が増えましたが、銀行によっては継続課金商品での口座振替が利用できないため、PayPal アカウントでの決済ができない場合があります。
ユーザーからお問い合わせがあったら、PayPalアカウントにクレジットカードを登録してもらうようご案内してください。

6
Copyright © 2024 Welcart Inc.

PayPal for Welcart

定期購入
PayPal Commerce Platform では定期購入に対応しています。
定期購入を行うには、Welcart 専用拡張プラグイン「WCEX Auto Delivery（ver1.2.1 以降）」の導入が必要になります。
定期購入を行う場合は、Welcart 会員システムは必ず「利用する」に設定してください。
定期購入商品の初回購入時に、PayPal から「請求処理規約ID」が発行されます。
Welcart ではこの「請求処理規約ID」を紐付けており、サンキューメールおよびWelcart の定期購入データ
編集画面に「請求処理規約ID」が表示されます。（Welcart 2.2.5 以降）※定期購入を行う場合は、ペイパルへの「従量課金」の利用申請・審査が必要となります。利用申請については下記の内容をご確認の上お申し込み下さい。
1. 新規のお申し込みの場合、こちらのフォームからお申し込み下さい。
「お問い合わせ内容を具体的にご記入ください」の欄に、Welcartにて定期購入機能の利用を希望の旨ご記入ください。
2. 既存の売り手アカウントをお持ちの方は、こちらのページの「その他のお問い合わせ方法」の下にある「メッセージを送る」からお申し込み下さい。
メッセージボックスに「WelcartにてReference Transactionを利用するための審査・設定をしてほしい」旨をご記入ください。
※Welcart 2.5 より、決済種別にクレジットカード決済が追加されましたが、定期購入商品の場合は支払方法として選択できません。
（通常課金商品の場合は、支払方法として選択できます。）
定期購入商品を扱う場合は、今まで通り PayPal Commerce Platform を支払方法に設定してください。
2024年6月、PayPal アカウントに登録できる金融機関が増えましたが、銀行によっては定期購入商品での口座振替が利用できないため、PayPal アカウントでの決済ができない場合があります。
ユーザーからお問い合わせがあったら、PayPalアカウントにクレジットカードを登録してもらうようご案内してください。

7
Copyright © 2024 Welcart Inc.

PayPal for Welcart

クレジットカード決済
Welcart 2.5 より、決済種別にクレジットカード決済が追加されました。
クレジットカード決済では、購入者が買い手アカウントを持っていなくてもクレジットカードやデビットカード
で決済を行うことができます。
※クレジットカード決済のご利用には別途 PayPal へのお申込みと審査が必要です。
お申し込み方法はこちらをご確認ください。
クレジットカード決済を利用するための手順はこちらをご確認ください。
※継続課金商品・定期購入商品にはクレジットカード決済は対応していません。
Welcart 2.8.18 より、3Dセキュアに対応しました。

8
Copyright © 2024 Welcart Inc.

PayPal for Welcart

クレジットカード情報の保存
お客様が Welcart の会員システムにログインして購入した場合、次回の購入からはカード番号を入力せずにチェックアウトできます。
これは、Welcart の会員情報と PayPal の情報を紐付けるもので、Welcart のデータベースにカード番号を保存するものではありません。
また、クレジットカード情報はマイページから登録・変更・削除することができ、管理画面からはクレジット
カード情報の削除のみできます。
※カード情報の保存機能を利用する場合は、ペイパルアカウントは複数サイトで共有しないようにしてください。共有している他サイトの会員のカード情報も共有されます。
※Welcart の会員システムの利用が必要です。
（Welcart の基本設定で会員システムを「利用する」に設定する必要があります。）

フロント > マイページ

フロント > マイページ > クレジットカード登録（更新）画面

上図のように入力値が緑色の場合は、入力形式が適切です。
赤色の場合は入力形式に誤りがあります。（桁数が多い、年月が適切でない等）

9
Copyright © 2024 Welcart Inc.

PayPal for Welcart

注意点
サーバー要件
クレジットカード決済を導入する場合、決済サービスの種類ごとに気を付けなくてはいけないことがありますが、どの決済サービスにも共通して言えることはサーバースペックです。
スペックの低いサーバーでは、ほとんど必ずと言っていいほど、早い段階で不具合が発生し始めます。
【クレジット決済を行う場合のサーバーの注意事項】
https://www.welcart.com/archives/tips/credit_payment

SSL仕様
●

SSLの導入は必須

Welcart を利用する場合は、サイトをSSL化するプラグインを使用しないでください。
常時SSL化にする場合は、一般設定画面にて「WordPressアドレス（URL）」と「サイトアドレス（URL）」を、
https:// と入力するだけで常時SSL化にすることができます。
常時SSL化にした場合は、管理画面 [ Welcart Shop ] ＞ [ システム設定 ] にて「SSLを使用する」のチェックを外してください。
ホスティングサービスに用意されている共有SSLは利用できない場合があります。
できるだけ、独自ドメインによるSSLをご利用ください。
【常時SSL化の設定方法】
https://www.welcart.com/archives/tips/tips-20180105-3

10Copyright © 2024 Welcart Inc.

PayPal for Welcart

使用不可プラグイン
以下のようなプラグインは併用しない事をおすすめいたします。
●

キャッシュプラグインは、いずれも個人情報の漏洩が懸念されます。
十分にキャッシュに対する知識がない場合は使用しないでください。

●

サイトをHTTPS化するプラグインの使用は、決済エラーを起こす可能性があるため推奨いたしま
せん。

●

JavaScript や CSS を最適化するプラグインを使用すると、様々な動作がエラーとなる可能性が高まります。
特に決済エラーを起こす可能性が高いため推奨いたしません。

●

バイリンガルプラグインは併用できません。

他にも併用できないプラグインがあると考えられますので、不具合が出た場合は、まず Welcart 関連以
外のプラグインを停止して動作確認してみてください。

継続課金の移行について
PayPal エクスプレスチェックアウトで「定期支払い」で行っていた継続課金は、PayPal Commerce Platformに移行しても引き継げません。移行する場合は、ユーザーに商品をあらためて購入してもらう必要があります。
継続課金を移行する場合は、以下のような手順をとっていただくとスムーズに移行できるかと思います。
1. 継続課金の移行連絡
ユーザーに対して、あらためて商品を購入し直して欲しい旨を連絡します。
2. 受注データのキャンセル
管理画面 [ Welcart Management ] > [ 受注リスト ] から、該当ユーザーの受注データを確認します。
古いほうの受注データを「キャンセル」処理を行ってください。
この時点で、PayPal の定期支払いは停止にはなりません。
3. 定期支払いの停止
買い手アカウントで商品を購入し直してくれたユーザーの定期支払いを停止します。

11
Copyright © 2024 Welcart Inc.

PayPal for Welcart

会員の退会について
定期購入「WCEX Auto Delivery」を利用している場合、以下の条件を満たしているお客様はマイページ（会員ページ）から退会ができなくなります。
●

お客様が定期購入商品を購入している●管理画面 [ Welcart Management ] > [ 定期購入リスト ] で、お客様の契約が「継続中」 になっている

管理画面 [ Welcart Management ] > [ 会員リスト ] > [ 会員データ編集画面 ] では、定期購入商品の契約が「継続中」状態のものが残っていると下図のように表示されます。

継続課金「WCEX DL Seller」を利用している場合、以下の条件を満たしているお客様はマイページ（会員ページ）から退会ができなくなります。
●

ダウンロードもしくはサービスの継続課金商品を購入している●管理画面 [ Welcart Management ] > [ 継続課金会員リスト ] で、該当のお客様の契約が「継続中」 になっている

管理画面 [ Welcart Management ] > [ 会員リスト ] > [ 会員データ編集画面 ] では、継続課金商品の契約が「継続中」状態のものが残っていると下図のように表示されます。

その他の注意点
マルチサイトには対応していません。

12
Copyright © 2024 Welcart Inc.

PayPal for Welcart

エクスプレスチェックアウトからの切り替え
エクスプレスチェックアウトとウェブペイメントプラスは、Welcart 2.1 にアップグレードした時点で利用できなくなります。
以下の手順に従って、PayPal Commerce Platform の設定をしてください。
1. [Welcart Shop] > [クレジット決済設定]
クレジット決済モジュール選択で「PayPal 決済」を選択し、「利用するモジュールを更新」する。
「PayPal(CP)」の設定画面で PayPal 決済を「利用する」を選択する。
「PayPal アカウントに接続」をクリックして、設定を更新する。
2. [Welcart Shop] > [基本設定]
決済種別「PayPal(CP)」の支払方法を追加する。
エクスプレスチェックアウトで自動継続課金を利用していた場合は、PayPal Commerce Platform では新たにペイパルと「従量課金」サービスの契約が必要になります。
詳しくはペイパルにお問い合わせください。
https://www.paypal.com/jp/webapps/mpp/corporate/contact

ウェブペイメントプラスからの切り替え
支払方法の切り替えの手順は、エクスプレスチェックアウトと同じです。
ウェブペイメントプラスでは、買い手アカウントを持たなくてもクレジットカードで決済できるようになっていましたが、PayPal Commerce Platform の「スマートペイメントボタン」では「デビットまたはクレジットカード」のボタンを押すとそのまま買い手アカウント作成なしでカード決済が可能です。
また、こちらの機能は月額無料でご利用いただけます。

PayPal Commerce Platform に切り替えたら、ウェブペイメントプラスを解約していただく必要があります。
売り手アカウントの設定セクションで請求処理規約をキャンセルするか、PayPal カスタマーサービスに解約の意向をお伝えください。
PayPal カスタマーサービスによりメールで解約が確定されます。

13
Copyright © 2024 Welcart Inc.

PayPal for Welcart

申込方法
法人・個人ともに契約が可能です。
初期費用・月額利用料・手数料などは下記サイトを参照してください。
https://www.paypal.com/jp/webapps/mpp/merchant/paypal-seller-fees

従量課金の申込み
PayPal への「従量課金」の申請については、下記の内容をご確認の上お申し込み下さい。
1. 新規のお申し込みの場合、こちらのフォームからお申し込み下さい。
「お問い合わせ内容を具体的にご記入ください」の欄に、Welcartにて継続課金機能もしくは、定期購入機能の利用を希望の旨ご記入ください。
2. 既存の売り手アカウントをお持ちの方は、こちらのページの「その他のお問い合わせ方法」の下にある「メッセージを送る」からお申し込み下さい。
メッセージボックスに「WelcartにてReference Transactionを利用するための審査・設定をしてほしい」旨をご記入ください。

クレジットカード決済の申込み
PayPal への「クレジットカード決済」の利用申請については、下記の内容をご確認の上、こちらのフォームからお申込み下さい。
1. 「お問い合わせ内容を具体的にご記入ください（任意）」の欄に、Welcart にてクレジットカード決済の利用を希望の旨ご記入ください。
2. ページ上部に「新規お申し込み専用窓口」と記載がありますが、クレジットカード決済の利用申請については既存の売り手アカウントをお持ちの方でもこちらからお申し込みいただけます。
クレジットカード決済を利用するための手順はこちらをご確認ください。

14
Copyright © 2024 Welcart Inc.

PayPal for Welcart

設定方法
クレジット決済設定を行った後、基本設定から支払方法を登録します。

クレジット決済設定
クレジット決済代行会社の選択
管理画面 [ Welcart Shop ] > [ クレジット決済設定 ] に移動します。
クレジット決済モジュール選択タブ内で、「利用中のクレジット決済代行会社」のエリアに「PayPal 決済」を
ドラッグ＆ドロップします。
「利用するモジュールを更新する」をクリックして更新すると、「PayPal (CP)」のクレジット決済設定タブが表示され、設定が行えるようになります。

15
Copyright © 2024 Welcart Inc.

PayPal for Welcart

PayPal アカウントの接続「PayPal アカウントに接続」ボタンをクリックするとダイアログが表示されます。

ダイアログ上で「Email（売り手アカウント）」を入力し、「Country or
region」で「Japan」を選択してください。

入力された「Email（売り手アカウント）」が存在しなかった場合は、新しく売り手アカウントを登録する画面に遷移します。
画面に従って会員登録を行ってください。
※「テスト環境（Sandbox）」の情報はこの画面から作成することはできません。
Sandbox 用の売り手アカウントが必要な場合は PayPal
Developer にアクセスして作成してください。

16
Copyright © 2024 Welcart Inc.

PayPal for Welcart

入力された「Email（売り手アカウント）」がすでに登録されている
場合は、ログイン画面が表示されます。
「Email（売り手アカウント）」「Password」を入力してログインしてください。

ログインが成功すると接続許可するかどうかの確認が表示されます。「同意して接続する」をクリックしてください。

登録完了画面が表示され、「Client ID」「Secret」が自動的に挿入されます。
ダイアログの右上の ×（閉じる）をクリックしてダイアログを終了してください。

17
Copyright © 2024 Welcart Inc.

PayPal for Welcart

PayPal 決済の設定
PayPal から提供された情報をもとに、設定を行います。

基本設定●

PayPal 決済
PayPal Commerce Platform を利用する場合は「利用する」を選択してください。
初期値：利用しない●

クレジットカード決済
クレジットカード決済を利用する場合は「利用する」を選択してください。
※クレジットカード決済を利用するには、PayPal に申請・審査を受ける必要があります。
お申し込み方法はこちらをご確認ください。
クレジットカード決済を利用するための手順はこちらをご確認ください。
初期値：利用しない●

クレジットカード情報の保存「保存する」を選択すると、会員がログインして決済を行った場合、次回の決済からはカード番号を入力する必要がなくなりま す。別のカードで購入したい場合は、「別のカードで支払う」を選択します。
※Welcart の会員システムの利用が必要です。
初期値：利用しない●

3Dセキュア
クレジットカード決済で3Dセキュアを利用する場合は「利用する」を選択してください。（
Welcart2.8.18～）3Dセキュアを利用するのに、PayPal への申請は不要です。
初期値：利用しない●

動作環境「本番環境」「テスト環境（Sandbox）」のいずれかを選択してください。
PayPal アカウントの接続についてはこちらを参照してください。
初期値：テスト環境（Sandbox）●

Client ID
PayPal アカウントの接続を行うと自動で入力されます。
動作環境で「テスト環境（Sandbox）」を選択している場合は、Sandbox用に作成したClientID を手動で入力してください。
初期値：空白●SecretPayPal アカウントの接続を行うと自動で入力されます。
動作環境で「テスト環境（Sandbox）」を選択している場合は、Sandbox用に作成したSecretを手動で入力してください。
初期値：空白18
Copyright © 2024 Welcart Inc.

PayPal for Welcart●

処理区分「与信 (AUTHORIZE)」は仮売上となります。
最初から実売上にしたい場合は「売上計上 (CAPTURE)」を選択します。
「与信 (AUTHORIZE)」の受注は、Welcart の受注データ編集画面から「売上計上 (CAPTURE)」に更新することが可能です。
なお、「WCEX DL Seller」を利用して自動継続課金商品を購入するとき、その商品の「課金日」が「受注日」でない時、処理区分を「売上計上 (CAPTURE)」に設定していても、「与信 (AUTHORIZE)」で決済されます。
これは、次回課金日まで料金を徴収しないということになります。
初期値：売上計上●

自動継続課金処理区分
自動継続課金決済時の処理区分を設定できます。
このオプションは「WCEX DL Seller」が有効化されているときのみ利用できます。
初期値：売上計上●

自動継続課金完了メール
自動継続課金決済時に、課金完了メールを契約者に送信するか否かを選択します。
メール送信時間（自動継続課金実施時間）は、ダウンロード販売設定画面の「自動処理の実行時間」になります。
このオプションは「WCEX DL Seller」が有効化されているときのみ利用できます。
初期値：送信する19
Copyright © 2024 Welcart Inc.

PayPal for Welcart

PayPal ボタンのカスタマイズ

内容確認ページに表示される PayPal ボタンのレイアウトを変更することができます。
●

ボタンの配置
カート遷移の内容確認ページにて、「PayPal」ボタンと「デビットまたはクレジットカード」ボタンの並べ方を選択します。
初期値：ボタンを縦に並べます※「ボタンを横に並べます」を選択しても、日本のマーチャントでは横に表示される対象が「PayPal」ボタンしかないために、結果として「PayPal」ボタンだけの表示となります。
海外では「Pay Later」ボタンなどの日本で通常表示されないボタンも表示されることがあるため、その場合は 「ボタンを横に並べます」 を選択すると、横に２つ（例えば「PayPal」ボタンと「Pay Later」ボタン）が表示されることになります。
また、「デビットまたはクレジットカード」ボタンは、横並びにするボタンの対象外となっています。
●

ボタンの色
PayPal ボタンの色を5色から選択します。
初期値：Gold●

ボタンの形
PayPal ボタンの形を2種類から選択します。
初期値：角型●

ボタンのラベル
PayPal ボタンのラベルを4種類から選択します。
初期値：PayPalのロゴが表示されます

20
Copyright © 2024 Welcart Inc.

PayPal for Welcart

利用条件の同意PayPal 決済の設定を更新する場合は「下記ご利用条件に同意する」にチェックをいれてから更新を行ってください。

PayPal 決済 の設定の更新[ PayPal決済 の設定を更新する ] ボタンをクリックした時、設定値にエラーがあると正常に更新できません。
管理画面 [ Welcart Shop ] > [ 基本設定 ]の支払方法に登録されていて「使用」になっていても、エラーがあると支払方法が「停止」になり、フロントに表示されなくなりますのでご注意ください。
エラーメッセージに従ってエラー項目を解決し、正常に更新できたら、利用する支払方法を「使用」に更新してください。
支払方法の変更についてはこちらをご覧ください。

設定値に不備があった時のエラーメッセージ

正常な値に更新された時のメッセージ

21
Copyright © 2024 Welcart Inc.

PayPal for Welcart

基本設定
支払方法の登録
管理画面 [ Welcart Shop ] > [ 基本設定 ] に移動します。
「支払方法」にて新しい支払方法登録を行います。
登録した支払方法は、左側の四角いブロックを掴んでドラッグ＆ドロップすることで表示順の変更ができます。
フロント画面には、管理画面の並びと同じ順序で表示されます。

●

支払い方法名フロントにて表示する支払い方法名を入力してください。
支払方法名は後で変更することができます。

●

説明
フロントにて表示される支払方法の説明文を入力してください。
HTML タグが使えますので、画像を表示させることも可能です。
PayPal 決済についての説明をいれておくといいでしょう。

●

決済種別「PayPal(CP)」を選択します。
ここに「PayPal(CP)」の選択項目がない場合は、クレジット決済設定を行ってください。
Welcart 2.5 より、決済種別にクレジットカード決済が追加されました。
クレジットカード決済を利用する場合は、「PayPal(CreditCard) 」を選択してください。
※クレジットカード決済を利用するには PayPal に申請・審査が必要です。
22

Copyright © 2024 Welcart Inc.

PayPal for Welcart
お申し込み方法はこちらをご確認ください。
クレジットカード決済を利用するための手順はこちらをご確認ください。
●

決済モジュール
必ず空白にしておいてください。

●

使用・停止
フロントに支払方法を表示する場合は「使用」、表示しない場合は「停止」を選択します。決済会
社を変更した時などは、削除をせずに「停止」にしておきます。

●

削除・更新
必要のない支払方法は削除します。
ただし、過去にこの支払方法で購入された受注がある場合、削除してしまうとその受注の支払方
法が分からなくなってしまいます。
このような場合は削除せずに「停止」で更新します。

23
Copyright © 2024 Welcart Inc.

PayPal for Welcart

システム設定PayPal ボタンの言語について
管理画面 [ Welcart Shop ] > [ システム設定 ] > [ 国・言語・通貨 ] タブで、「フロントエンドの言語」が「ja（日本語）」の場合、日本語になります。
日本語以外は英語になりますが、ご自身で Welcart の言語ファイルを作成し設置している場合、言語ファイルの言語コードが下記の PayPal の言語コード（Locales）と同じになっていれば、その言語で表示されるようにしています。
言語コードが合わなければ、英語で表示します。（※Welcart v2.1.1 より）
PayPal Developer SDK Locales

日本語

英語

24
Copyright © 2024 Welcart Inc.

PayPal for Welcart

クレジットカード決済を利用するための手順
Welcart 2.5 より、クレジットカード決済が利用できるようになりました。
利用するためには PayPal へのお申込みと PayPal 側の設定が別途必要です。
設定の詳細は PayPal にお問い合わせください。
https://www.paypal.com/jp/webapps/mpp/corporate/contact

クレジットカード決済を利用するまでの流れ
PayPal をまだ Welcart に連携していない場合（新規ユーザーの場合）
1. 売り手アカウントを開設、Welcart にてクレジット決済設定（アカウント連携）を行います。
クレジット決済設定の方法はこちらをご確認ください。
2. 並行して、PayPal へクレジットカード決済の利用申込みをします。
お申込み方法はこちらをご確認ください。
3. PayPal の審査完了後、Welcart のクレジットカード決済設定（PayPal 決済）でクレジットカード決済
を「利用する」を選択します。
設定方法はこちらをご確認ください。

PayPal と Welcart を既に連携している場合（既存ユーザーの場合）
1. PayPal へクレジットカード決済の利用申込みをします。
お申込み方法はこちらをご確認ください。
2. Welcart のクレジットカード決済設定（PayPal 決済）でクレジットカード決済を「利用する」を選択します。
設定方法はこちらをご確認ください。
※クレジットカード情報の保存機能を利用する場合は、以下の設定を行う必要があります。
3.
4.
5.
6.
7.
8.

https://developer.paypal.com/ にログインします。
左側メニュー内の [Dashboard] – [My Apps and Credentials] をクリックします。
環境として Live を選択します。
表示されている App をクリックします。
下図の「Accept payments」の「Vault」にチェックを入れます。
Welcart のクレジットカード決済設定（PayPal 決済）でクレジットカード情報の保存を「保存する」を選択します。
設定方法はこちらをご確認ください。

25
Copyright © 2024 Welcart Inc.

PayPal for Welcart

クレジットカード情報の保存機能の注意点
クレジットカード決済で「クレジットカード情報の保存」を利用する場合は、注意が必要です。
ショップのひとつの PayPal アカウントで、複数のサイトで PayPal クレジットカード決済が利用できますが、「クレジットカード情報の保存」を「利用する」と、共有する別のサイトの会員番号が同じ会員のクレジット
カード情報が参照できてしまいます。
Welcart 2.8.23 より、PayPal でクレジットカード決済の「クレジットカード情報の保存」を利用したい場合、プレフィクスを設定できるようになりました。複数のサイトでひとつの PayPal アカウントを共有する場合に指定してご利用ください。プレフィックスは、半角英数大文字 1～4 桁の指定が可能です。
既にプレフィクス未設定で運用されているショップでは、新たにプレフィクスを追加しますと、既に保存されているカード情報を参照できなくなりますのでご注意ください。

26
Copyright © 2024 Welcart Inc.

PayPal for Welcart

テスト環境（Sandbox）をご利用時の設定※本番環境の審査完了を待つことなく Sandbox のテストは行えます。
１．Sandbox 用の売り手アカウントを作成
1.
2.
3.
4.
5.
6.
7.

https://developer.paypal.com/ にログインします。
DASHBOARD メニューで、 [Sandbox] – [Accounts] をクリックします。
[Create Account] ボタンをクリックし、表示される画面で [Business(Merchant Account)] を選択し、[Country/region] に Japan を選択して、[Create] ボタンをクリックします。
一覧表に、sb-xxxxxxxxxxxxx@business.example.com のように自動生成されたメールアドレスが表示されます。こちらが作成されたテスト用売り手アカウントになります。
その行の右端の[…]をクリックし、[View/Edit Account] をクリックします。
表示された画面の真ん中あたりにある [Upgrade to Pro] リンクをクリックします。
展開表示されたところにある [Enable] をクリックし、アップグレードされたら閉じます。
※Type が Business-Pro に切り替わっていることを確認してください。

27
Copyright © 2024 Welcart Inc.

PayPal for Welcart
２．Sandbox 用の APP を作成（APIを呼び出すための認証情報を作成）
1. 左側メニュー内の [Dashboard] – [My Apps and Credentials] をクリックします。
2. 環境は Sandbox を選択したままで、REST API apps の [Create App] をクリックします。
3. 表示される画面で、[App Name] に任意の名前、[Sandbox Business Account] に上記でアップグレードしたテスト用売り手アカウントを指定し、[Create App] ボタンをクリックします。
4. 表示される Client ID/Secret を確認します。
Secret は実装の際に必要となります。
※クレジットカード情報の保存機能を利用する場合は、以下の設定を行う必要があります。
5. 下図の「Accept payments」の「Vault」にチェックを入れます。
6. Welcart のクレジットカード決済設定（PayPal 決済）でクレジットカード情報の保存を「保存する」を選択します。
設定方法はこちらをご確認ください。

28
Copyright © 2024 Welcart Inc.

PayPal for Welcart

接続テスト
実施手順
1. 設定の確認
クレジット決済設定 および 支払方法の登録 が設定完了できているか確認します。
動作環境は「テスト環境（Sandbox）」にしてください。
2. テスト購入
発送・支払方法ページで PayPal 決済を選択し、内容確認ページにて 「PayPal」ボタンもしくは「デビットまたはクレジットカード」ボタンをクリックし購入します。
クレジットカード番号を入力する場合は、テスト用の買い手アカウントで作成したテストカード番号を使用します。3Dセキュア利用時は、PayPal が提供するテストカード番号を使用してください。
3. 取引情報の確認
売り手アカウントにログインし、取引履歴を確認してください。
テスト購入で決済完了した取引が反映されていることを確認してください。
4. 決済情報の動作確認
テスト購入が完了したら動作環境を「本番環境」に変更してください。

29
Copyright © 2024 Welcart Inc.

PayPal for Welcart

決済情報の連携（PayPal CP ・ クレジットカード決済共通）
売上計上
処理区分「売上計上」の場合クレジット決済設定で処理区分を「売上計上」に設定している場合、受注があった時点で売上計上されます。

処理区分「与信」の場合クレジット決済設定で処理区分を「与信」に設定している場合、受注があった時点では仮売上状態になっていますので、手動で売上計上する必要があります。
※与信を実行した日から売上計上処理ができる期間は、ウォレット決済の場合は 29 日間・クレジット
カード決済の場合は 60 日間です。この期間を過ぎると売上計上ができなくなりますのでご注意ください。
1. 管理画面 [ Welcart Management ] > [ 受注リスト ] にて「決済ID」項目を表示していた場合、決済ID横に決済状況が表示されます。

「与信」状態になっている受注の注文番号をクリックして受注編集画面に移動してください。
2. 中ほどにある「支払情報」項目の「決済情報」ボタンを押してください。

3. 表示されたダイアログ上で「決済金額」を確認後に「売上計上」ボタンを押してください。

30
Copyright © 2024 Welcart Inc.

PayPal for Welcart
4. 決済状況が「売上計上」に変更されます。

減額
決済状況が「与信」の場合
受注データの決済状況が「与信」の場合、減額しながら売上計上を行うことができます。
※与信状態を維持したまま減額はできません。
1. 管理画面 [ Welcart Management ] > [ 受注リスト ] にて「決済ID」項目を表示していた場合、決済ID横に決済状況が表示されます。

「与信」状態になっている受注の注文番号をクリックして受注編集画面に移動してください。
2. 中ほどにある「支払情報」項目の「決済情報」ボタンを押してください。

3. 減額したい金額を「返金額」に入力して「売上計上」ボタンを押してください。
※受注情報とは連動しないため、減額した金額で売上計上を行った場合受注情報も訂正するのを忘れずに行ってください。

4. 決済状況が「売上計上」に変更されます。「売上計上」後の減額については次ページを参照してください。

31
Copyright © 2024 Welcart Inc.

PayPal for Welcart

決済状況が「売上計上」の場合
受注データの決済状況が「売上計上」の場合、「返金額」が「取引金額」を超えない限り何回でも減額が可能です。
1. 管理画面 [ Welcart Management ] > [ 受注リスト ] にて「決済ID」項目を表示していた場合、決済ID横に決済状況が表示されます。

「売上計上」状態になっている受注の注文番号をクリックして受注編集画面に移動してください。
2. 中ほどにある「支払情報」項目の「決済情報」ボタンを押してください。

3. 減額したい金額を「返金額」に入力して「返金」ボタンを押してください。
※受注情報とは連動しないため、減額を行った場合受注情報も訂正するのを忘れずに行ってください。

増額
増額はできません。

32
Copyright © 2024 Welcart Inc.

PayPal for Welcart

取消
決済状況が「与信」の場合
受注データの決済状況が「与信」の場合、売上計上前に「与信取消」を行うことが可能です。
1. 管理画面 [ Welcart Management ] > [ 受注リスト ] にて「決済ID」項目を表示していた場合、決済ID横に決済状況が表示されます。

「与信」状態になっている受注の注文番号をクリックして受注編集画面に移動してください。
2. 中ほどにある「支払情報」項目の「決済情報」ボタンを押してください。

3. 「与信取消」ボタンを押してください。
※受注情報とは連動しないため、受注の対応状況を「キャンセル」に訂正するのを忘れずに行ってください。

4. 決済状況が「与信取消済」に変更されます。

33
Copyright © 2024 Welcart Inc.

PayPal for Welcart

決済状況が「売上計上」の場合
受注データの決済状況が「売上計上」の場合、取消ボタンは表示されません。取消を行う場合は、取引金額と同じ金額を「返金」する形になります。
1. 管理画面 [ Welcart Management ] > [ 受注リスト ] にて「決済ID」項目を表示していた場合、決済ID横に決済状況が表示されます。

「売上計上」状態になっている受注の注文番号をクリックして受注編集画面に移動してください。
2. 中ほどにある「支払情報」項目の「決済情報」ボタンを押してください。

3. 取引金額と同じ金額を「返金額」に入力して「返金」ボタンを押してください。
※受注情報とは連動しないため、受注の対応状況を「キャンセル」に訂正するのを忘れずに行ってください。

4. 決済状況が「返金済」に変更されます。

34
Copyright © 2024 Welcart Inc.

PayPal for Welcart

再決済
自動課金処理で決済エラーになっても、再決済が可能な場合のみ、「与信」もしくは「売上計上」ができます。
●「WCEX DL Seller」の継続課金商品の自動課金時に、何らかの理由で決済ができなかった時に継続
課金リストに表示されます。

●「WCEX Auto Delivery」の定期購入商品の自動受注時に、何らかの理由で決済ができなかった時に受注リストに表示されます。

「決済金額」に決済したい金額を入力して「与信」もしくは「売上計上」をしてください。「与信」と「売上計上」のボタンが表示されない場合は、再決済はできません。

保留中
受注データの決済状況が「与信」もしくは「売上計上」の場合、「【保留中】」と表示されることがあります。
PayPal上で支払いが保留（Pending）されている時に表示されます。
保留については PayPal のヘルプ を参照してください。

35
Copyright © 2024 Welcart Inc.

PayPal for Welcart

予期せぬエラーの対処方法
正常決済を行っているのにエラーとなってしまう場合は、以下の点を確認します。
●●●●

決済設定に間違いはないか
SSL証明書は正常か（SHA2は必須、TLS1.2のみ）
Basic認証やIPアドレスによるアクセス制限をしていないか
他のプラグイン（メンテナンスモードを含めて）を停止して動作確認してみる

留意点
●
●

SSLに関しましては、ご利用のサーバー会社にお問い合わせください。
独自にカスタマイズを加えている場合は、チェックアウト遷移画面で JavaScript エラーがないかを確認してください。JavaScript エラーがある場合、正常に決済できなくなる可能性があります。

36
Copyright © 2024 Welcart Inc.

PayPal for Welcart

運用上の注意点
決済エラーログ
決済エラーログを確認して、特に処置する必要がないものはログを削除してください。

受注の取りこぼし発生時の対応
売り手アカウントに決済が正常に登録されたにも関わらず、Welcartの受注データが記録されていない場
合、以下の方法で受注データの復旧ができます。
1. PayPal Commerce Platform では、決済直前ログの「リンクキー」とPayPal上の「取引ID」は連携されな
いため、決済された「取引情報」で判断を行うことになります。
「取引日時」「取引金額」「名前」などをメモしてください。
2. 管理画面 [ Welcart Management ] > [ 受注リスト ] にて「操作フィールド表示」をクリックして展開します。アクション項目にある「決済直前ログ一覧」ボタンをクリックします。
表示されたダイアログで、売り手アカウント上でメモした「取引情報」を元に対象のユーザーを探し「詳細」ボタンをクリックします。

3. 詳細ダイアログの内容を確認し「受注データ登録」ボタンを押すと、その内容で受注データが登録されます。その際、受注日時をログの登録された日時か、データ復旧を行った日時かを選択できます。

37
Copyright © 2024 Welcart Inc.

PayPal for Welcart

4. 受注リストに登録されたことを確認してください。

継続課金・定期購入の場合、受注データを復旧できても継続課金データ・定期購入データが復旧できな
いので、PayPal上で取引をキャンセルした後にユーザーにあらためて商品を購入していただく必要があります。
なお、受注の取りこぼしが頻繁に起こる場合は、ご利用のサーバーのスペックが低い可能性があります。サーバー移行をご検討ください。
また、決済直前ログから受注データ登録をされた場合、サンキューメールは自動送信されません。送信する必要がある場合は 、受注リストより手動で送信してください。

38
Copyright © 2024 Welcart Inc.

PayPal for Welcart

クレジットカード情報の保存を利用する場合の注意
登録したカードはマイページもしくは会員データ編集画面から削除ができます。
※クレジットカード情報の削除をしても、Welcart の管理画面から売上計上・与信取消（与信の場合）・返金（売上計上の場合）は行うことができます。

マイページからの削除方法
マイページの「クレジットカード変更はこちら」をクリックし、「クレジットカード更新」画面から削除を行います。

フロント > マイページ

フロント > マイページ > クレジットカード更新画面

39
Copyright © 2024 Welcart Inc.

PayPal for Welcart

管理画面からの削除方法
管理画面 [ Welcart Management ] > [ 会員リスト ] から対象の会員データを選択します。
画面右側に「クレジットカード削除」のチェック項目がありますので、チェックを入れて会員情報を更新し
ます。

削除前

削除後

40
Copyright © 2024 Welcart Inc.

PayPal for Welcart

よくあるお問い合わせQ

継続課金には利用できますか？

Aはい、PayPal Commerce Platform では可能です。
「WCEX DL Seller（ver3.1.1 以降）」を導入することで利用できます。
「WCEX DL Seller」は「WCEX AutoDelivery」と同時利用はできません。
継続課金を行う場合は、ペイパルへの「従量課金」の利用申請・審査が必要となります。
利用申請については、下記の内容をご確認の上、こちらのフォームからお申込み下さい。
1. 「お問い合わせ内容を具体的にご記入ください」の欄に、Welcartにて継続課金機能の利用を希望の旨ご記入ください。
2. ページ上に「新規お申し込み専用窓口」と記載がありますが、従量課金の申請については既存の売り手アカウントをお持ちの方でもこちらからお申し込み頂けます。

Q

定期購入商品には利用できますか？

Aはい、PayPal Commerce Platform では可能です。
「WCEX AutoDelivery（ver1.2.1 以降）」を導入することで利用できます。
「WCEX AutoDelivery」は「WCEX DL Seller」と同時利用はできません。
定期購入を行う場合は、ペイパルへの「従量課金」の利用申請・審査が必要となります。
利用申請については、下記の内容をご確認の上、こちらのフォームからお申込み下さい。
1. 「お問い合わせ内容を具体的にご記入ください」の欄に、Welcartにて定期購入機能の利用を希望の旨ご記入ください。
2. ページ上に「新規お申し込み専用窓口」と記載がありますが、従量課金の申請については既
存売り手アカウントをお持ちの方でもこちらからお申し込み頂けます。

Q

決済購入操作を行ってみたいのですがデモサイトはありませんか？

A

こちらのデモサイトは、PayPal Commerce Platform を 動作環境をテスト環境（Sandbox）に設定しています。テスト購入するにはSandboxの買い手アカウントが必要です。
https://demo.welcart.info/paypal/wordpress/

Q

使ってはいけないプラグイン等はありますか？

A

以下のようなプラグインは併用しないことをお勧めいたします。
また、他にも併用できないプラグインがあると考えられますので、不具合が出た場合は、まずWelcart 関連以外のプラグインを停止して動作確認してみてください。
● キャッシュプラグインは、いずれも個人情報の漏洩が懸念されます。
キャッシュに対する知識が十分にない場合は使用しないでください。
● HTTPS プラグインを使用していると、決済エラーとなる場合があります。
● JavaScript を最適化するプラグインは、様々な動作がエラーとなる可能性が高まります。
● 他の決済モジュールプラグインと併用できるかは、検証していません。

41
Copyright © 2024 Welcart Inc.

PayPal for Welcart
Q

ユーザーから退会できないと問い合わせがあったのですがどうしてですか？

A

継続課金商品もしくは定期購入商品を購入したお客様は退会することができません。
詳しくは「会員の退会について」を参照してください。

Q

PayPal から件名：「請求処理規約の取り消しの確認」のメールが届きましたが、どの継続課金データかを調べることができますか？

A

メールに記載されている「請求処理規約ID」を使って、[管理画面 > [Welcart Management]> [継続課金会員リスト] の操作フィールドから検索することができます。
継続課金会員リストに「請求処理規約ID」の列が表示されない場合は、表示オプションの「請求処理規約ID」のチェックボックスにチェックを入れて下さい。

Q

内容確認ページの「PayPal」ボタンをクリックしても、ダイアログがすぐに閉じてしまい決済に進むことができません。

A

要因として下記のことが挙げられますので、ご確認ください。
● 住所や電話番号などで不適切な数字（000-00-0000等）を入力している。
● Client ID と Secret の値を間違えて設定している。
テスト環境（SandBox）と本番環境では、Client ID と Secret の値が異なります。

Q

お客様から「10円」の決済がされていると問い合わせが来ましたが、これは何の分ですか？

A

マイページからクレジットカード情報を登録・変更した際に、与信で10円の決済を立てています。
基本的にはすぐに削除されるのですが、残っている場合でも特に何か処理をしていただく必要はなく、そのままの状態で問題ありません。（与信のため、売上計上されることはありません。）

42
Copyright © 2024 Welcart Inc.