コンテンツにスキップ

ZenCart

はじめに

本モジュールはZenCartからアナザーレーンの決済システムへの接続を可能にするものです。

デフォルトの機能に対応するよう作られているため、カスタマイズされたZenCartでは正常に動作しない可能性があります。 あらかじめご了承下さい。
携帯版にも対応しておりません。 言語としては日本語のみに対応しております。

こちらからモジュールをダウンロードし、以下の手順で手動にてインストールを行ってください。

ZenCart_1.3.zip

ファイルの確認

ダウンロードした圧縮ファイルを解凍しできたフォルダの中に、以下のファイルがあることをご確認ください。

・はじめにお読み下さい.txt
・rusult.php
・checkout_alij.php
・includes/modules/payment/alij.php
・includes/languages/japanese/rusult.php
・includes/languages/japanese/modules/payment/alij.php

includes/modules/checkout_process.phpの変更

最終行の近くに以下のような記述があります。

<?php

    //send email notifications
    $order->send_order_email($insert_id, 2);
    $zco_notifier->notify('NOTIFY_CHECKOUT_PROCESS_AFTER_SEND_ORDER_EMAIL');

これを下記のように前後に行を追加してください。

<?php

    if($_SESSION['payment'] != "alij"){  //←追加行
      //send email notifications
      $order->send_order_email($insert_id, 2);
      $zco_notifier->notify('NOTIFY_CHECKOUT_PROCESS_AFTER_SEND_ORDER_EMAIL');
    }                                   //←追加行

ファイルアップロード

・rusult.php
・checkout_alij.php
・includes/modules/checkout_process.php(修正済みのもの)
・includes/modules/payment/alij.php
・includes/languages/japanese/rusult.php
・includes/languages/japanese/modules/payment/alij.php

これらのファイルを全てアップロードしてください。
(ファイル名(***.php)より左側がアップロード先のディレクトリの位置 を表しています。)

Warning

ファイルのアップロードを行う際、checkout_process.phpが上書きされます。 サーバ上のファイルをリネームするなどして、バックアップをとってからアップロードを行ってください。
また、そのほかのファイルに関しても同名のものがすでに存在していないかどうかよく確認した後、アップロードを行ってください。

管理画面からのモジュールインストール

上記の手順が正しく完了していると、管理画面の支払いモジュールに「ALIJクレジットカード決済」が追加されます。
ステータスを有効にするか、インストールボタンを押すと、使用できるようになりますので、設定を行ってください。

インストール プラグイン設定

  • クレジットカード決済を有効にする
    「True」を選択してください。 アナザーレーンでの決済を一時的に中断したい場合は「False」にしてください。

  • サイトID
    当社よりお伝えしましたサイトIDを、8桁の半角数字で入力してください。

  • サイトPASS
    当社よりお伝えしましたパスワードを入力してください。

  • サーバーIP
    Callbackの送信元IPアドレスと設定値が一致しているかのチェックが行われます。 不正の場合、オーダーは処理されず、送信元IPアドレスがログに出力されます。 「59.106.8.27」を設定してください。チェックを行わない場合は、「0.0.0.0」で設定してください。 設定後に必ずテスト決済を行ってください。

  • 適用地域
    アナザーレーンクレジット決済モジュールの使用を許可する地域を設定します。
    設定した結果、ユーザーが決済方法を選択するときに、画面にアナザーレーンクレジット決済モジュールが表示されなくなるなどした場合は、 「--なし--」を選択してください。

  • テスト環境を使用する
    「有効」にすると、テスト決済システムへ接続され、テスト決済が行えます。 ※テスト決済をご希望の際は弊社までご連絡ください。

  • 決済結果を顧客にメール通知
    「True」を選ぶとZenCartから決済の結果が顧客にメールで送られます。
    メールには注文の詳細が確認できるページのURLなども載っています。「False」にするとメールは送信されません。
    ここでの選択にかかわらず、アナザーレーンからも決済結果通知メールが送られます。

  • 初期注文ステータス / 決済成功ステータス / 決済失敗ステータス
    データベースに登録されているステータスが表示されます。
    どれを選んで頂いても結構ですが、決済成功時のステータスと決済失敗ステータスは 必ず異なるステータスを設定してください。

    例)初期注文ステータス -> 処理待ち
    　　決済成功ステータス -> 発送済み
    　　決済失敗ステータス -> 処理中

    なお、インストール時にアナザーレーン専用のステータスとして

    ・未清算状態です
・決済が完了しました
・済が失敗しました

    の三つが自動生成されます。

    初期注文ステータス -> 未清算状態です
    決済成功ステータス -> 決済が完了しました
    決済失敗ステータス -> 決済が失敗しました

以上のように設定して頂くとわかりやすくお使い頂けます。

ただしこのステータスは、日本語のみで稼動しているZenCartに対しては有効ですが、多言語環境ではお使いいただけません。 ステータスの文言を変更したい場合は includes/modules/payment/alij.php の install() 内で設定されていますので、インストール前に変更し、サーバにアップロードしてください。

  • 表示の整列順
    表示の整列順を設定できます。数字が小さいほど上位に表示されます。

動作説明

ZenCartの画面内で、

　　1.カート
　　　↓
　　2.届け先と配送方法の選択
　　　↓
　　3.支払い方法の選択(ここでアナザーレーンを選択)
　　　↓
　　4.注文内容を確認

と進みます。
4で注文実行ボタンを押すと、アナザーレーンの決済ページに遷移します。この際、管理画面の注文管理画面に注文内容が登録されます。 ステータスは初期注文ステータスで選択したステータスになります。

この後、顧客がアナザーレーンで決済を行うと、自動的にステータスが変更されます。 決済が成功すると、決済成功ステータスで選択したステータスに変更され、決済が失敗すると、決済失敗ステータスで選択したステータスに変 更されます。 成功時も失敗時も、決済結果を顧客にメール通知をTrueにしていると、メールが送信されます。

顧客がアナザーレーンで決済を完了させず、アナザーレーンの決済画面内にある「戻る」ボタンでZenCartに戻った場合は、注文管理画面にあっ た注文内容は自動的に消去され、在庫の数が注文前のものに戻ります。決済が一度失敗したも状態で「戻る」ボタンでページ移動を行った場合も、 同じように注文管理画面から消去され、在庫がもとに戻ります。

アナザーレーンの決済ページ内の「戻る」ボタンを押さず、ブラウザの「戻る」でページ移動を行ったり、 ブラウザを閉じるなどして決済が中断された場合は、初期注文ステータスのままで注文管理画面に残ることになります。

Note

注文管理画面でステータスの最終的な状況から以下のように判断することが出来ます。

  • __初期注文ステータス__になっている場合
    アナザーレーン決済ページに移動したものの、特に何もせずブラウザで戻るか、 ブラウザで閉じるかしたため、在庫をもとに戻す必要があります。
  • __決済成功ステータス__になっている場合
    アナザーレーンで決済が成功しています。清算済みの状態です。
  • __決済失敗ステータス__になっている場合
    アナザーレーンで決済が失敗し、その後ブラウザで戻るか、 ブラウザを閉じるかしたため、在庫をもとに戻す必要があります。

注文管理画面で「在庫数を元に戻す」にチェックを入れて削除することで、在庫を戻すことが出来ます。


弊社側での設定項目

弊社決済システムから決済結果を受け取りZenCartに反映させるため、Callback先URLの設定が必要になります。
弊社決済画面にて決済完了後、「戻る」ボタンを押して注文完了画面に遷移するため、 また、決済完了前に「戻る」ボタンを押して注文前画面に戻るため、戻り先URLの設定が必要になります。
以下を担当営業にお伝えください。

  • 決済成功時戻り先 　　https://your_url.com/checkout_alij.php

  • 決済キャンセル時戻り先 　　https://your_url.com/checkout_alij.php

  • 決済成功時Callback先URL 　　https://your_url.com/result.php

  • 決済失敗時Callback先URL 　　https://your_url.com/result.php

Info

上の例ではトップがhttps://your_url.com/index.phpというURLになるようZenCartを稼動させているものとします。 ご使用の環境に合わせて、置き換えてお読みください。

使用する上で確認していただくこと

【許諾内容】
弊社の許可無く、他社や関係者以外に開示、告知、漏洩することを禁止いたします。 また、弊社の許可無く、転写・複製等の一切のコピーも禁止いたします。 これらの禁止事項をよくご理解の上、ご使用ください。

【免責事項】
本モジュールをお使いいただくことにより生じたいかなる損害についても一切責任を負いません。 自己責任のもとに、ご利用ください。

【著作権】
本モジュールの著作権はアナザーレーン株式会社にあります。