コンテンツにスキップ

osCommerce

はじめに

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

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

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

osCommerceモジュール.zip

ファイルの確認

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

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

こちらの仕様書では、以下のような環境を想定して書かれています。

□osCommerce
　　　│
　　　├□admin　管理画面に関するファイルを含むディレクトリ
　　　│　:
　　　├□includes　ユーザー画面のモジュールなどを含むディレクトリ
　　　│　:
　　　├□temp
　　　│
　　　├■account.php
　　　│　:
　　　├■index.php または default.php　TOPページになるファイル
　　　│　:

(□：ディレクトリ / ■：ファイル)

アナザーレーンクレジット決済モジュールのインストールでアップロード するファイルは、全てエンドユーザー向けの機能に関するものです。 adminディレクトリにアップロードするファイルはありません。

catalogディレクトリがadminと同じ階層に位置しているような環境の場合、

　　・catalog/rusult.php
　　・catalog/includes/modules/payment/alij.php

などに置き換えてお読みください。

checkout_process.phpの変更

<?php

  tep_mail($order->customer['firstname'] . ' ' . $order->customer['lastname'], $order->customer['email_address'], EMAIL_TEXT_SUBJECT, $email_order, STORE_OWNER, STORE_OWNER_EMAIL_ADDRESS);

  // send emails to other people
  if (SEND_EXTRA_ORDER_EMAILS_TO != '') {
    tep_mail('', SEND_EXTRA_ORDER_EMAILS_TO, EMAIL_TEXT_SUBJECT, $email_order, STORE_OWNER, STORE_OWNER_EMAIL_ADDRESS);
  }

または

<?php

  tep_mail(tep_get_fullname($order->customer['firstname'],$order->customer['lastname']), $order->customer['email_address'], EMAIL_TEXT_SUBJECT, nl2br($email_order), STORE_OWNER, STORE_OWNER_EMAIL_ADDRESS, '');

  // send emails to other people
  if (SEND_EXTRA_ORDER_EMAILS_TO != '') {
    tep_mail('', SEND_EXTRA_ORDER_EMAILS_TO, EMAIL_TEXT_SUBJECT, nl2br($email_order), STORE_OWNER, STORE_OWNER_EMAIL_ADDRESS, '');
  }

という記述がおよそ250行目以降にあります。
場所と記述はバージョンによって若干の違いがございますので 「if (SEND_EXTRA_ORDER_EMAILS_TO != '')」などで検索して位置を探されることをお薦めいたします。

この記述の前後に以下のような記述を書き足してください。

<?php

  //ALIJモジュール用追加ここから
  if($payment!='alij'){
  //ALIJモジュール用追加ここまで

  //※ここからはお使いのバージョンによって多少異なります
  tep_mail($order->customer['firstname'] . ' ' . $order->customer['lastname'], $order->customer['email_address'], EMAIL_TEXT_SUBJECT, $email_order, STORE_OWNER, STORE_OWNER_EMAIL_ADDRESS);

  // send emails to other people 
  if (SEND_EXTRA_ORDER_EMAILS_TO != '') {
    tep_mail('', SEND_EXTRA_ORDER_EMAILS_TO, EMAIL_TEXT_SUBJECT, $email_order, STORE_OWNER, STORE_OWNER_EMAIL_ADDRESS);
  }//※ここまではお使いのバージョンによって多少異なります

  //ALIJモジュール用追加ここから
  }
  //ALIJモジュール用追加ここまで

ファイルアップロード

・rusult.php
・checkout_alij.php
・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
    当社よりお伝えしましたパスワードを入力してください。

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

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

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

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

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

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

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

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

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

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

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

動作説明

osCommerceの画面内で、

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

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

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

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

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

Note

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

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

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


弊社側での設定項目

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

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

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

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

  • 決済キャンセル時URL 　　https://your_url.com/result.php

Info

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

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

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

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

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