以下の XML コードは、WebSphere Commerce が提供する、Cassette for VisaNet の標準キャッシャー・プロファイルです。 このキャッシャー・プロファイルでは、カセットでサポートされている任意指定の購入カード・データを指定します。 購入カード・メソッドは、追加の購入カード・データを決済機関に送ります。 カセットでは、購入カード・レベル II データのサブセットだけがサポートされています。 購入カードの詳細は、IBM WebSphere Payment Manager for Multiplatforms Cassette for VisaNet 補足 バージョン 3.1 を参照してください。
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE Profile SYSTEM "../../../../xml/PaymentManager/profile.dtd">
<!--
//*==================================================================
//* Licensed Materials - Property of IBM
//*
//* 5724-A18
//*
//* (c) Copyright IBM Corp. 2001
//*
//* US Government Users Restricted Rights - Use, duplication or
//* disclosure restricted by GSA ADP Schedule Contract with IBM Corp.
//*
//*================================================================== -->
<!-- ==================================================================
これは、Payment Manager Cassette for VisaNet のサンプル WC 5.1 キャッシャー・プロファイルです。
このプロファイルでは、カセットでサポートされている任意指定の購入カード・データを指定します。
現在のところ、カセットでは、購入カード・レベル II データのサブセットだけがサポートされています。
注: プロファイルの DEPOSITFLAG パラメーターを "1" に変更する場合、
$PCARD.* パラメーターをプロファイルの <CollectPayment> セクションに移動する必要があります。
================================================================== -->
<Profile useWallet="false" enableTrace="true">
<CollectPayment>
<!-- ==================================================================
必要な Payment Manager のパラメーター
================================================================== -->
<Parameter name="PAYMENTTYPE"><CharacterText>VisaNet</CharacterText></Parameter>
<Parameter name="MERCHANTNUMBER"><CharacterText>{storeId}</CharacterText></Parameter>
<Parameter name="ORDERNUMBER"><CharacterText>{orderId}</CharacterText></Parameter>
<Parameter name="AMOUNT"><CharacterText>{AMOUNT}</CharacterText></Parameter>
<Parameter name="CURRENCY"><CharacterText>{CURRENCY}</CharacterText></Parameter>
<Parameter name="AMOUNTEXP10"><CharacterText>{AMOUNTEXP10}</CharacterText></Parameter>
<!-- ==================================================================
Payment Manager のオプション・パラメーター
================================================================== -->
<!-- オーダーの自動承認を試みる方法を指示します。
サポート値:
0 - 自動承認なし
1 - 同期自動承認 - Payment Manager がオーダー作成操作の一部として
承認をおこなう。 2 - 非同期自動承認 - Payment Manager がオーダー作成後の承認操作を
スケジュールする。 デフォルト値は 0 です。
-->
<Parameter name="APPROVEFLAG"><CharacterText>2</CharacterText></Parameter>
<!-- オーダー承認の際に使用される金額です。 通常
これはオーダー金額と同じです。 このフィールドは、APPROVEFLAG が 1 または 2 に
設定されている場合には必須です。 -->
<Parameter name="PAYMENTAMOUNT"><CharacterText>{approval_amount}</CharacterText></Parameter>
<!-- オーダー承認の際に使用する必要がある決済番号です。
通常これは 1 になります。 このフィールドは、APPROVEFLAG が 1 または 2 に
設定されている場合には必須です。 -->
<Parameter name="PAYMENTNUMBER"><CharacterText>1</CharacterText></Parameter>
<!-- デポジットが自動的に行われるかどうかを指示します。
このフラグは APPROVEFLAG が 1 または 2 に設定されている場合だけ有効です。
サポート値:
0 - 自動デポジットを行う。
1 - 自動デポジットを行わない。
デフォルト値は 0 です。
注: DEPOSITFLAG パラメーターを "1" に変更する場合、すべての任意指定の購入カード・データ・パラメーターを
<Command name="DEPOSIT"> エレメントから、 送信するパラメーターのプロファイルのこのセクション
へ移動する必要があります。
-->
<Parameter name="DEPOSITFLAG"><CharacterText></CharacterText></Parameter>
<!-- 以下の 2 つのパラメーターはオプションです。 いずれか 1 つを使用して
バイヤー購入オーダー番号 を Payment Manager へ渡すことができます。 1 番目のパラメーターに使用できるのは
ASCII テキストのみです。 システムのバイヤー購入オーダー番号に ASCII 以外が含まれていることがある場合は
パラメーター ORDERDATA2 を使用してください。
-->
<Parameter name="TRANSACTIONID" maxBytes="128" encoding="ASCII"><CharacterText>{PONumber}</CharacterText></Parameter>
<Parameter name="ORDERDATA2"><CharacterText></CharacterText></Parameter>
<!-- ==================================================================
カセットに必要なパラメーター
================================================================== -->
<!-- クレジット・カード番号 -->
<Parameter name="$PAN" sensitive="true"><CharacterText>{card_number}</CharacterText></Parameter>
<!-- 形式 YYYYMM の有効期限日付 -->
<Parameter name="$EXPIRY"><CharacterText>{card_expiry}</CharacterText></Parameter>
<!-- AccountNumber パラメーターは、ここでは "1" にハードコーディングされていることに注意してください。
これは、ストアの VisaNet Merchant AccountNumber を構成するのに使用した番号と一致していなければなりません。
-->
<Parameter name="$ACCOUNTNUMBER"><CharacterText>1</CharacterText></Parameter>
<!-- カード所有者の番地 -->
<Parameter name="$AVS.STREETADDRESS" maxBytes="24" encoding="ASCII"><CharacterText>{billto_address1}</CharacterText></Parameter>
<!-- カード所有者の郵便番号 -->
<Parameter name="$AVS.POSTALCODE" maxBytes="9" encoding="ASCII"><CharacterText>{billto_zipcode}</CharacterText></Parameter>
<!-- ==================================================================
カセットのオプション・パラメーター
================================================================== -->
<!-- 同じ支払いカードは 1 つの検証コードで発行されます。 検証コードは
発行した銀行によって生成され、その銀行で検証されます。
3 または 4 桁の検証コードが続くアカウント番号が
カードの署名パネルに印刷されます。 値は 3 または 4 桁の
数字ストリングでなければなりません。 例: 1234 または 321 -->
<Parameter name="$CARDVERIFYCODE"><CharacterText>{cardVerificationCode}</CharacterText></Parameter>
<!-- このオーダーと関連した購入オーダー番号 -->
<Parameter name="$PURCHORDERNUM"><CharacterText></CharacterText></Parameter>
<!-- このオーダーに許可されている最大支払い回数 -->
<Parameter name="$NUMPAYMENTS"><CharacterText>1</CharacterText></Parameter>
</CollectPayment>
<Command name="DEPOSIT">
<!-- ==================================================================
DEPOSIT コマンドに必要な Payment Manager のパラメーター
================================================================== -->
<Parameter name="MERCHANTNUMBER"><CharacterText>{storeId}</CharacterText></Parameter>
<Parameter name="ORDERNUMBER"><CharacterText>{orderId}</CharacterText></Parameter>
<Parameter name="PAYMENTNUMBER"><CharacterText>{payment_number}</CharacterText></Parameter>
<Parameter name="AMOUNT"><CharacterText>{AMOUNT}</CharacterText></Parameter>
<!-- ==================================================================
購入カード・データのオプション $PCARD パラメーター
注: 上記の <CollectPayment> セクションの DEPOSITFLAG パラメーターを "1" に変更する場合、
$PCARD.* パラメーターを、そのセクションへ移動して、有効にする必要があります。
================================================================== -->
<Parameter name="$PCARD.LOCALTAXAMOUNT"><CharacterText>{total_tax_amount}</CharacterText></Parameter>
<!-- VisaNet は、1 回の税金額の送信だけをサポートしているため、NationalTaxAmount と LocalTaxAmount の
両方を送信することは無効です。 -->
<Parameter name="$PCARD.NATIONALTAXAMOUNT"><CharacterText></CharacterText></Parameter>
<!-- 指定する場合、オーダーの課税と免税の別を明示します。 サポート値:
0 - オーダーに課税することを示します
1 - オーダーが免税であることを示します -->
<Parameter name="$PCARD.TAXEXEMPTINDICATOR"><CharacterText>0</CharacterText></Parameter>
<Parameter name="$PCARD.CUSTOMERREFERENCENUMBER"><CharacterText></CharacterText></Parameter>
</Command>
</Profile>
WC51_VisaNet_PCard.profile は次の場所にあります。
drive:\WebSphere\CommerceServer\instances\instance_name\xml\payment\
drive:\Program
Files\WebSphere\CommerceServer\instances\instance_name\xml\payment\
/usr/WebSphere/CommerceServer/instances/instance_name/xml/payment/
/opt/WebSphere/CommerceServer/instances/instance_name/xml/payment/
instance root
path/xml/payment/
instance root path は、インスタンス作成時に、
構成マネージャーの「インスタンス」パネルにある「Instance Root Path (インスタンスのルート・パス)」フィールドで指定したパスです。 デフォルト・パスは
/QIBM/UserData/WebCommerce/instances/instance_name/ です。
PAYMENTTYPE パラメーターは、このプロファイルのカセットの名前を指定します。
WebSphere Commerce では、 キャッシャー・プロファイルの <BuyPageInformation> エレメントは使用しません。 それと同等の機能が、支払いポリシーの attrPageName プロパティーとして提供されています。
重要: このプロファイルでは、カセットで必要な $ACCOUNTNUMBER パラメーターに、固定値の 1 が入ります。 この番号は、Payment Manager ユーザー・インターフェースの VisaNet 用 「Merchant Account Settings (マーチャント・アカウントの設定)」画面にある、 「Account Number (アカウント番号)」フィールドの値と一致していなければなりません。 これは、このパラメーターを必要とするカセットだけに適用されます。 ストアの VisaNet アカウントを構成するときに、 「Account Number (アカウント番号)」フィールドに別の値を使用する場合、 このプロファイルも更新する必要があります。 ストアのセットアップを単純化するために、 ストアのマーチャント・アカウントを構成するときと同じアカウント番号を使用することをお勧めします。
VisaNet のカセットで必要となるパラメーターの詳細については、 IBM WebSphere Payment Manager for Multiplatforms, Cassette for VisaNet Supplement, Version 3.1 を参照してください。
![]() |