以下の XML コードは、WebSphere Commerce が提供する、 Cassette for BankServACH 標準キャッシャー・プロファイルです。
<?xml version="1.0" encoding="Shift_JIS"?>
<!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 ACH Cassette for BankServ の標準 WC 5.1 キャッシャー・プロファイル (このカセットは米国専用です)
================================================================== -->
<Profile useWallet="false" enableTrace="true">
<CollectPayment>
<!-- ==================================================================
オーダー作成のために必要な Payment Manager のパラメーター
================================================================== -->
<Parameter name="PAYMENTTYPE"><CharacterText>BankServACH</CharacterText></Parameter>
<Parameter name="MERCHANTNUMBER"><CharacterText>{storeId}</CharacterText></Parameter>
<Parameter name="ORDERNUMBER"><CharacterText>{orderId}</CharacterText></Parameter>
<Parameter name="CURRENCY"><CharacterText>{CURRENCY}</CharacterText></Parameter>
<Parameter name="AMOUNT"><CharacterText>{AMOUNT}</CharacterText></Parameter>
<Parameter name="AMOUNTEXP10"><CharacterText>{AMOUNTEXP10}</CharacterText></Parameter>
<!-- オーダーの自動承認を試みる方法を指示します。
サポート値:
0 - 自動承認なし
1 - 同期自動承認 - Payment Manager がオーダー作成操作の一部として
承認をおこなう。 2 - 非同期自動承認 - Payment Manager がオーダー作成後の承認操作を
スケジュールする。
WCS は APPROVEFLAG を 2 に設定すると最適に動作します。 APPROVEFLAG を 1 に設定すると、Payment Manager がオーダーの承認を完了するまで、WCS
DoPayment コマンドがブロックされます。
この承認が完了するまで、DoPayment コマンドによって変更される、
同じ在庫レコードの読み取りまたは更新を待機しているコマンドもブロックされます。
これは他のコマンドのスループットに影響を与えます。
-->
<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 です。
-->
<Parameter name="DEPOSITFLAG"><CharacterText></CharacterText></Parameter>
<!-- ==================================================================
Payment Manager のオプション・パラメーター
================================================================== -->
<!-- 以下の 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>
<!-- ==================================================================
カセットに必要なパラメーター
================================================================== -->
<!-- The checking account number -->
<Parameter name="$CHECKINGACCOUNTNUMBER"><CharacterText>{checkingAccountNumber}</CharacterText></Parameter>
<!-- The check routing number -->
<Parameter name="$CHECKROUTINGNUMBER"><CharacterText>{checkRoutingNumber}</CharacterText></Parameter>
<Parameter name="$BUYERNAME" maxBytes="80" encoding="ASCII"><CharacterText>{billto_firstname} {billto_lastname}</CharacterText></Parameter>
<Parameter name="$STREETADDRESS" maxBytes="50" encoding="ASCII"><CharacterText>{billto_address1}</CharacterText></Parameter>
<Parameter name="$CITY" maxBytes="50" encoding="ASCII"><CharacterText>{billto_city}</CharacterText></Parameter>
<!-- カセットでは、大文字で書かれた 2 文字の米国州コード (たとえば、Alabama は AL、Alaska は AK など)
だけが受け入れられます。 BankServACH キャッシャー拡張クラスは、{billto_state} 環境変数に
州名として指定した値を使用して、WebSphere Commerce STATEPROV テーブルから 2 文字の州コードを探し出すのに使用されます。
キャッシャー拡張機能は、指定した州名の州コードが見つからなければ、ヌルを戻します。
互換性を保つため、値が 2 の長さであれば、拡張クラスは、
{billto_state} 環境変数の値を州コードとして戻します。
-->
<Parameter name="$STATEPROVINCE" maxBytes="2" encoding="ASCII">
<ExtensionValue name="com.ibm.commerce.payment.extensions.BankServACHCashierExtension" />
</Parameter>
<Parameter name="$POSTALCODE" maxBytes="9" encoding="ASCII"><CharacterText>{billto_zipcode}</CharacterText></Parameter>
<Parameter name="$COUNTRYCODE" maxBytes="2" encoding="ASCII"><CharacterText>US</CharacterText></Parameter>
<Parameter name="$PHONENUMBER" maxBytes="10" encoding="ASCII"><CharacterText>{billto_phone_number}</CharacterText></Parameter>
<!-- ==================================================================
CustomOffline カセットのオプション・パラメーター
================================================================== -->
<Parameter name="$STREETADDRESS2" maxBytes="50" encoding="ASCII"><CharacterText></CharacterText></Parameter>
<Parameter name="$EMAILADDRESS" maxBytes="49" encoding="ASCII"><CharacterText></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>
</Command>
</Profile>
WC51_BankServACH.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 プロパティーとして提供されています。
このキャッシャー・プロファイルでは、BankServACHCashierExtension クラスを使用し、 必須の $STATEPROVINCE パラメーターのために、2 文字の州コードを入手します。 このクラスは、州名として {billto_state} 環境変数に指定した値を使用し、 STATEPROV テーブルの州コードを参照します。 このクラスは、指定した州名の州コードを見つけられない場合、ヌルを戻します。 互換性を保つため、CashierExtension は、値の長さが 2 文字であれば、 州コードとして {billto_state} 環境変数の値を戻します。
{billto_state} 環境変数および他の {billto_*} 環境変数は、名前と値のペアの一部で、 キャッシャーの collectPayment 呼び出しのパラメーターとしてキャッシャーに渡されます。 これらの変数の値は、ADDRESS テーブルの対応する列から取られます。
別の方法としては、ADDRESS テーブルの STATE 列に 値として有効な州名だけが入ることが分かっていれば、 $STATEPROVINCE パラメーターに DatabaseValue を使用できます。 DatabaseValue を使用するには、 以下の説明を参照してください。
BankServACH のカセットで必要となるパラメーターの詳細については、 IBM WebSphere Payment Manager for Multiplatforms, Cassette for BankServACH Supplement, Version 3.1 を参照してください。
![]() |