ドキュメンテーション
印刷ページ

支払いプロバイダの設定

SuperSaaSは予約やショップでの支払いを処理するために、いくつかの支払いプロバイダをサポートしています。
デフォルトでPayPalは支払いプロバイダとして使用されます。
特別な設定なく利用できますが、管理者のメールアドレスとPayPalアカウントが同じであることを前提としています

PayPal利用をやめて、別の支払いゲートウェイを追加することができます。
[支払い設定]の「ショップページのトップに表示するメッセージ」に$gatewayを入れることで行えます。

PayPalのゲートウェイを変更

PayPalのゲートウェイはデフォルトで有効になっています。
別のゲートウェイを使用する場合は、以下のコードでデフォルトのPayPalゲートウェイのスイッチをオフにすることもできます。

$gateway{nopaypal}

デフォルトではシステム管理者のメールアドレスがPayPalアカウンが同じ前提としています。
以下のコードを追加することで、別のPayPalアカウントを使用するようことも可能です。

$gateway{paypal email@example.com}

複数の$gatewayコマンドを追加することにより、複数のゲートウェイを有効にすることができます。
支払いゲートウェイが複数の場合、利用するユーザーが選択することができます。

ペイメントゲートウェイ「Stripe」を設

Stripeに関する詳細はStripe support pageで確認ください。

Stripeは各国の企業でも採用され、で100以上の通貨での支払いをサポートしています。
「支払い設定」画面で通貨設定でチャージして使用することができます。

すでにStripeアカウントをお持ちの場合は、お使いのStripeのダッシュボードにナビゲートして、「アカウント設定」を開きます。
「APIキー」セクションでは、4つのキーがあります。
テストキーは、実際の送金せずに支払いをシミュレートするために使用できます。
ライブキーがユーザーをチャージするために用いられます。

SuperSaaSは、下のコードでアカウントを使えば、簡単にストライプを使用して起動することができます。

$gateway{stripe sk_test_1234 pk_test_1234 sk_live_1234 pk_live_1234}

上記のAPIキー部分をお持ちのAPIキーと差し替えてStripeのチェックアウト画面上の支払いオプションを表示できます。

Stripe APIキー

「支払いの設定」で「テストモード」に切り替えることでStripeをテストすることが可能です。
「テストモード」に設定すると、現在設定されている支払いプロバイダの支払い処理がテスト状態となりますのでご注意ください。
テストの支払いを行った後、「テストモード」での支払い処理を、Stripeのダッシュボードで確認することができます。
「支払い」セクションで支払いの確認ができましたら、「テストモード」をオフに切り替えて、実際にStripeの使用を開始することができます。

ペイメントゲートウェイ「ePay」を設定

ePayに関する詳細はDanish versionで確認ください。

ePayは、デンマークの支払プロバイダでDankortを含む様々な支払方法をサポートしています。
ePayアカウントを持っている場合は、次のコードでePayゲートウェイを有効にすることができます。

$gateway{epay 123456}

上のコードの「123456」箇所をePayのマーチャントIDにして使用してください。
利用にはePay管理者の設定でスケジュールのドメインを追加する必要があります。
"Settings" → "Payment system" → "Domains created for relay-script"
ドメインが登録されていない場合、エラー・メッセージが表示されます。

SuperSaaSのドメインを設定ください。SSLを有効にした場合、ドメイン名は常に「supersaas.com」になります。
もしユーザー処理後のリダイレクトされることを設定した場合、そのページのドメインも追加する必要があります。
複数のドメインを追加するには、ePayサポートに連絡する必要があります。
ePayは登録されたドメインのサブドメインの登録はできませんのでご注意ください。 移動先がサブドメインなどで登録困難である場合、スケジュールのほうをサブドメインに合わせることも考慮されます。

秘密鍵「MD5」の利用

秘密鍵を使用してアカウントにMD5ハッシュチェック(暗号化)を有効にすることを推奨します。
秘密鍵が存在しない場合、ハッカーによる偽装操作などの恐れがあります。
MD5ハッシュチェックをオンにするには、次のコードを使用します。

$gateway{epay 123456 secret}

「secret」部分を任意の文字列に置き換えて、ePay管理画面でも同じ文字列を設定します。
"Settings" → "Payment system" → "Settings for the payment system" → "MD5 key"。

設定した秘密鍵の文字列が一致しない場合、 たとえ支払い処理が成立しても「Fraud check failed」とメッセージされます。

ePay利用の制限

クレジットショップを利用している場合、「Settings for the payment system」の「Unique orderID」を「Not using Unique orderID」に切り替える必要があります。
プロダクトIDは、注文IDとして使用されているので、ユニークIDのまま使用した場合、商品は1つづつしか販売できません。
ePayを使用した場合顧客が自分の数量を入力できるようにするこの設定にご注意してください。

高度な設定

複数の目的のために同じePayアカウントを使用する場合は、個別の「window」を作成したいかもしれません。
ロゴなど、独自のカスタマイズが考えられます。
下の構文で別のウィンドウを使用するように設定できます。
$gateway{epay 123456 secret 2}
(図2は、ウィンドウのID)

「instant capture」に切り替えた場合の支払いは、自動的に適切な認証ステップの後にキャプチャされます。
下のように第四パラメータとして「1」を追加することにより、瞬時にキャプチャを有効にすることができます。

$gateway{epay 123456 secret 1 1}

暗号鍵MD5は、ウィンドウIDを設定を有効にする必要があります。
また、ウィンドウIDは、インスタントキャプチャを有効にするために必要です。
ウィンドウのIDが不明の場合は、単に「1」とすることができます。

ペイメントゲートウェイ「Mollie」を設定

Logo iDeal, Mister Cash and Bitcoin Mollieは、オランダの理想的な決済システムとベルギーのMister Cashシステムを介して決済処理ができるオランダの支払いプロバイダです。
また、Bitcoin とドイツで人気のSofort Bankingシステムもサポートしています。
Mollieアカウントをお持ちの場合は、下のコードでゲートウェイを有効にすることができます。

$gateway {mollie test_abc123xyz live_abc123xyz}

Mollieアカウントの「Website profiles」ページにAPIキーがありますので置き換えて利用ください。
Mollieボタンはインラインフレームの内側では動作しません。
iFrame内のSuperSaaSを実行したい場合は、ボタンがブラウザがフレームから「escape」できるようにJavaScriptを追加する必要があります。
独自にJavaScriptを構築しても良いですが、ボタンスニペット(< >)も利用できます。
このボタンは、スケジュールの「レイアウト」タブの「支払いの設定」ページにあります。

<script> if (window != top) top.location.href = location.href </script>