仕様書兼マニュアル - Principle

クラウドペイメント連携エクステンション仕様書
ベリテワークス株式会社
はじめに
本書はベリテワークス株式会社（以下、弊社）が開発した、株式会社クラウドペイメント様（以下、クラ
ウドペイメント）の決済サービスを Magento に連携するためのエクステンションの使用方法について説明
したものです。
なお、本書内で使用しているサービス・製品の名称およびそれらに付随する各種権利はそれぞれの権利所
有者に帰属するものとします。
エクステンションのインストール
エクステンションは tar.gz 形式で圧縮して配布しています。
インストール前に tar.gz 形式の書庫ファイルを処理できるユーティリティソフトウエアを使用して解凍し
てください。
解凍した書庫の中身をすべて、Magento のルートディレクトリにアップロードしてください。書庫の中に
は 2 つのディレクトリが入っています。
!
app
!
skin
これらのディレクトリをそのままアップロードしてください。
アップロードが完了したら、Magento の管理画面にある、キャッシュ管理機能で Magento のキャッシュ
をクリアしてください。自動的にエクステンションがインストールされます。
各決済方法の設定
設定を行うには
設定を行うためには、管理画面の「システム＞設定」の「支払方法」にアクセスします。
ここでは既にシステム上で利用できる決済方法がリストされています。
正常にエクステンションがインストールされている場合は、以下の決済方法が追加されています。
!
クラウドペイメントクレジットカード決済
!
クラウドペイメントワンタッチ課金
共通の設定
項目名
有効
説明
決済方法の有効無効を指定します。
値の例
Yes / No
Yes になっているものだけが利用可能です。
タイトル
購入画面や注文履歴などに表示される決済方法の名称
クレジットカード
を入力します。
ショップ ID
クラウドペイメントのショップ ID を入力します。
3D セキュア認証
3D セキュア認証を使用するかどうかを指定します。
Yes / No
Yes の場合は全ての与信取得通信が 3D セキュア用の
URL に送信されます。
自動注文クリーニング
3D セキュア認証実施時に、途中離脱した注文情報を定
を実行
期的に削除するかどうかを指定します。
Yes / No
Yes の場合は 5 分毎に 20 分以上経過した
Pending_Payment ステータスの注文を削除します。
※この設定項目は 3D セキュア認証の有効無効に連動し
て表示されます。
クレジットカード種別
利用できるクレジットカード種別を指定します。
実際の与信取得通信には使用しません。
セキュリティコード
セキュリティコードの入力を求めるか否かを設定しま
す。
ジョブタイプ
与信取得のみまたは与信売上同時の切り替えを行いま
す。
Yes / No
支払方法
一括払い・分割払い・リボ払いの指定を行います。
支払回数
分割払いの際の支払い回数を指定します。
利用可能注文ステータ
ワンタッチ課金で使用する注文番号を検索する対象の
ス
注文ステータスを指定します。
最小注文金額
決済方法で許可する最小の注文金額を指定します。
0
最大注文金額
決済方法で許可する最大の注文金額を指定します。
300,000
表示順
購入画面での決済方法の表示順を指定します。数字が小
1
さい順に表示します。
なお、これらの設定データは、データベースの「core_config_data」テーブルに、他の設定画面の項目と同
様に記録されます。
決済エラー時の対応について
決済エラー時は、メッセージとともにエラーコードが画面上に表示されます。
また、Magento 上の設定が適切になされている場合は、管理者にエラー発生タイミングでメールによる通
知が行われます。
エラーコードをエラーコード表に照らし合わせ、適切な対応を行ってください。
ワンタッチ課金における注意点
ワンタッチ課金は、過去に与信取得が成功した注文の番号を使用して再与信を行う機能です。
ただし、クラウドペイメント側の制約として、該当の注文番号に紐づく与信データが、クラウドペイメン
ト上でキャンセルされた場合、以後その注文番号では再与信ができなくなります。
実運用の際には、
「与信取得 → キャンセル → 再与信」という手続きはできないことに注意してくだ
さい。また、クラウドペイメントの管理画面上での与信データに対するステータス変更は極力行わないで
ください（Magento 側と連動しています）。
エクステンションの仕様について
ディレクトリ構成
本エクステンションのディレクトリ構成は以下のとおりです。
├── app
│
├── code
│
│
│
│
│
│
└── Cloudpayment
│
│
├── Block
│
│
│
├── Form
│
│
│
│
├── Cc.php
│
│
│
│
└── Re.php
│
│
│
└── Info
│
│
│
├── Cc.php
│
│
│
└── Re.php
│
│
├── Helper
│
│
│
│
│
├── Model
│
│
│
├── Connector
│
│
│
│
│
│
│
├── Cron.php
│
│
│
├── Method
│
│
│
│
├── Cc.php
│
│
│
│
└── Re.php
│
│
│
└── Source
│
│
│
├── Cctype.php
│
│
│
├── Paymentmode.php
│
│
│
├── Paymenttype.php
│
│
│
└── Splittype.php
│
│
├── controllers
│
│
│
│
│
└── etc
└── community
└── Verite
└── Data.php
└── Cc.php
└── CcController.php
│
│
├── config.xml
│
│
└── system.xml
│
├── design
│
│
├── adminhtml
│
│
│
│
│
│
│
│
│
│
│
│
│
│
│
├── form
│
│
│
│
├── cc.phtml
│
│
│
│
└── re.phtml
│
│
│
└── info
│
│
│
│
│
└── frontend
│
│
└── base
│
│
│
│
├── layout
│
│
│
│
│
└── template
│
│
│
│
├── form
│
│
│
├── cc.phtml
│
│
│
└── re.phtml
│
│
└── info
│
│
│
├── etc
│
│
│
│
│
└── locale
│
└── default
└── default
└── template
└── verite_cloudpayment
└── cc.phtml
└── default
└── verite_cloudpayment.xml
└── verite_cloudpayment
└── cc.phtml
└── modules
└── Verite_Cloudpayment.xml
└── ja_JP
└── Verite_Cloudpayment.csv
│
└── skin
└── frontend
└── base
└── default
└── verite_cloudpayment
├── creditly.css
└── creditly.js
本エクステンションのディレクトリ構成は Magento の標準的なディレクトリ構成に準拠しています。
接続方式
Zend_Http_Client を利用した HTTP プロトコルによる通信による API 接続をクラウドペイメント側サー
バーと行います。
curl 等の標準関数を使用する事もできますが、よりオブジェクト指向的かつ簡便な記述を行うために
ZendFramework が有する機能を使用しています。
利用ライブラリ
クレジットカード入力欄に対するアシスト機能として、Creditfy.js（https://github.com/wangjohn/creditly）
を使用しています。Creditfy.js のライセンス MIT ライセンスであり、商用・非商用を問わず利用でき、か
つ他のライブラリ・アプリケーション等へのライセンス波及もないため、安心して利用ができます。
ワンタッチ課金が利用できる条件
以下の条件を満たす注文データが過去にある場合、ワンタッチ課金が候補として表示されます。
1.
過去 2 年間に、設定で指定した注文ステータスかつクラウドペイメントクレジットカード決済で取
引された、同一顧客からの注文があること。
2.
（フロントエンドのみ）会員による購入で、１の条件を満たしていること。
3.
（管理画面のみ）注文編集で１の条件を満たしていること。
4.
（管理画面のみ）再注文で１の条件を満たしていること。

Download Report