印刷ページ

決済プロバイダの設定

SuperSaaSは予約時やショップでの支払いを処理するために、いくつかの決済プロバイダをサポートしています。
SuperSaaS予約スケジュールにはオンライン課金設定としてデフォルトでPayPalが簡単に利用可能です。
PayPalの利用は特別な設定なく簡単に利用開始できますが、管理者のメールアドレスとPayPalビジネスアカウントが同じであることを前提としています。

PayPal利用をやめて、別の決済ゲートウェイを追加することも可能ですが、高い技術力が必要なため自己設定、解決出来る方のみ利用推奨します。
[支払い設定]の「ショップページのトップに表示するメッセージ」に$gatewayを入れることで実行可能です。
Payment Gatewayサービスの利用は、そのサービスを十分に理解した上で用いるように願います。
 このページのマニュアルは技術者向けであり、外部システムとの連携などが必要となる為SuperSaaSではサポート対象外となります。

Payment Gateway button location

PayPalのゲートウェイを変更

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

$gateway{nopaypal}

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

$gateway{paypal email@example.com}

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

Payment gateway 「Stripe」を設定

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

Stripeは100以上の通貨をサポートし、登録 countriesでは顧客にStripeを通して課金設定が可能です。
Stripeは"支払い設定"にて設定した通貨での課金が可能です。

欧州ベースの事業者へ

我々の最新のStripe integrationはEuropean PSD2 regulationに遵守しています。最新へ反映するには"Payment Gateways" ボタンよりStripe "v2"を選択して下さい。

StripeをSuperSaaSアカウントで開始する場合、"API keys"セクションにてrequired keysを確認します。
「APIキー」セクションでは、4つのキーがあります。

  • 新規"Restricted key"を作成、 "PaymentIntents" resourceにて、"write" permission
  • "Publishable key" 及び新規"Restricted key"をコピー
  • テストキーは、実際の送金せずに支払いをシミュレートするために使用できます。
  • これらの4つのキーをSuperSaaSに追加します。:
    $gateway{stripe pk_live_12example34 rk_live_12example34 pk_test_12example34 rk_test_12example34 intents}

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

Stripe API Keys

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

旧バージョンの利用

SuperSaaSはStripeの古いバージョンを利用する事も可能にしていますがv1-legacy versionであり、 European PSD2に適合していないので、new v2 versionの利用を推奨します。
Legacy versionの"Restricted" Stripe keyは"PaymentIntents" resourceの代わりに "Charges" resourceでの"write" permissionを要求します。

Secret key

"Restricted" Stripe keyの代わりに"Secret" keyを提供する事も可能ですが、"Restricted" keyよりセキュリティに劣る点に注意が必要です。

Payment gateway 「Mollie」を設定

Logo iDeal and Mister Cash Mollie 欧州にフォーカスした決済プロパイダーであり、European SOFORT payment system、及び the Dutch iDeal system、 the Belgian Mister Cash systemを介して料金を徴収可能です。 Mollieアカウントをお持ちの場合は、下のコードでゲートウェイを有効にすることができます。:

$gateway {mollie test_abc123xyz live_abc123xyz}

Mollieはインラインフレーム内では動作しません。

Payment gateway 「Square」を設定

Squareは、米国、カナダ、日本、オーストラリア、英国などでのクレジットカード支払いに対応したプロバイダーです。

Squareに関する詳細はSquareサポートを参照ください。

Square決済ゲートウェイを用いた決済設定は、現在ベータ版であり試験中です。
Squareを用いた決済システムの導入の希望やご意見は、support@supersaas.comまでご連絡ください。

設定に関して

Squareでは、アカウントの国設定に合わせた通貨で請求が行われます。(たとえば、米国設定のSquareアカウントはUSDでのみ取引処理されます。)
そのため、SuperSaaSアカウントの通貨設定をSquareの通貨と合わせる必要があります。
SuperSaaS側の通貨設定は管理メニューの「支払い設定」で確認できます。

APIキーの取得

SuperSaaSでSquareをセットアップするには、4つのキーが必要になります。プロダクションキーとなる「Application ID」、「Personal Access Token」と、そのテスト用のサンドボックスキーです。

  • Squareダッシュボードにログイン。
  • 「Apps」から「My Apps」に移動。
  • 「Go to Developer Dashboard」 をクリック。
  • 「New Application」をクリックして任意の名前を設定。
  • 「Create application」でテスト用のサンドボックスキーを取得。
  • プロダクションキーは「"Production Settings」で取得できます。
スーパーサースにキーを追加する 「ショップページの上部に表示するメッセージ」の下にある「支払いゲートウェイ」をクリックして、これらのキーをSuperSaaSアカウントに追加します。 または、次のテキストを手動でフィールドに入力できます(例のキーを独自のキーに置き換えることを忘れないでください)。

SuperSaaS側の設定

「ショップページのトップに表示するメッセージ:」の「Payment Gateways」をクリックして、Squareで取得した4つのキーを設定してください。

$gateway{square sq123-12-application_id-45 EAAAE123-personal_access_token-456
sandbox-sq123-12-sandbox_app_id-45 EAAAE123-sandbox_personal_access_token-456}

テストモード

Squareをテストする場合、SuperSaaS管理メニューの[支払い設定]で「テストモード」にチェックを入れてください。
「テストモード」をオンにすると、現在設定されているすべての支払いプロバイダーが「テストモード」に切り替わります。
テストによる支払い処理は、Squareの「Default Test Account」のダッシュボードで確認できます。

Payment gateway 「ePay」を設定

ePayに関する詳細はDanish version

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

$gateway{epay 123456}

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

SuperSaaSをカスタムドメインで使用していない場合は単純に"supersaas.dk" と入力。 更に、予約完了後にリダイレクトを設定している場合は、そのページのドメインも同様にePay’sシステムに設定します。 複数のドメインを追加するには、ePayサポートに連絡する必要があります。

MD5 secret key

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

$gateway{epay 123456 secret}

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

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

ePay利用の制限

ポイントを利用している場合、「Settings for the payment system」の「Unique orderID」を「Not using Unique orderID」に切り替える必要があります。
プロダクトIDは、注文IDとして使用されているので、ユニークIDのまま使用した場合、商品は1つづつしか販売できません。
ePay利用時は顧客自身で数量を入力することはできません。

高度なePay設定

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

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

$gateway{epay 123456 secret 1 1}

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

Payment gateway PayUを設定

PayU はPolandとCzech Republicの決済プロパイダーです。PayUアカウントをお持ちであれば 以下のsyntaxを利用してgatewayを設定可能です。:

$gateway {payu 123456 second_key EUR}

PayUアカウント登録時に割り当てられたPOS IDを "123456" に対して入れ替える必要があります。また"second_key"も同様です。 SuperSaaSの支払い設定とPayUで利用する通貨を等しく設定します。