以下の XML コードは、WebSphere Commerce が提供する、 Cassette for SET の標準キャッシャー・プロファイルです。
<?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 の標準 WC 5.1 キャッシャー・プロファイル
Cassette for SET
================================================================== -->
<Profile useWallet="true" enableTrace="true" >
<CollectPayment>
<!-- ==================================================================
オーダー作成のために必要な Payment Manager のパラメーター
================================================================== -->
<Parameter name="PAYMENTTYPE"><CharacterText>SET</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>
<!-- ==================================================================
Payment Manager のオプション・パラメーター
================================================================== -->
<!-- オーダーの自動承認を試みる方法を指示します。
サポート値:
0 - 自動承認なし
1 - 同期自動承認 - Payment Manager がオーダー作成操作の一部として
承認をおこなう。 2 - 非同期自動承認 - Payment Manager がオーダー作成後の承認操作を
スケジュールする。 デフォルト値は 0 です。
ウォレット・アプリケーションが使用されているので、Payment Manager はウェイクアップ・メッセージを
WC に戻して、ショッパーに送信しなければなりません。 これは DoPayment コマンドを完了します。
APPROVEFLAG を 1 に指定すると、ウォレット・アプリケーションは
Payment Gateway から与信応答が受信された後、Payment Manager から購入応答を受信します。
-->
<Parameter name="APPROVEFLAG"><CharacterText>1</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>
<!-- 以下の 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="$SUCCESSURL"><CharacterText>http://{WCHostName}{WebPath}/PaySuccessView?storeId={storeId}&orderId={orderId}&langId={buyer_language_id}</CharacterText></Parameter>
<Parameter name="$FAILUREURL"><CharacterText>http://{WCHostName}{WebPath}/PayResetPM?storeId={storeId}&orderId={orderId}&fail=1&langId={buyer_language_id}&URL=PayFailureView</CharacterText></Parameter>
<Parameter name="$CANCELURL" ><CharacterText>http://{WCHostName}{WebPath}/PayResetPM?storeId={storeId}&orderId={orderId}&cancel=1&langId={buyer_language_id}&URL=PayCancelView</CharacterText></Parameter>
<Parameter name="$SERVICEURL"><CharacterText>http://{WCHostName}{WebPath}/PayServiceView?storeId={storeId}&orderId={orderId}&langId={buyer_language_id}</CharacterText></Parameter>
<!-- このエンコード属性は
8859_1 文字エンコード方式が GenericExtension クラスがバイトをエンコードした方式であるため、
それを使用して戻されたストリングから
OrderDescription のバイトを取得できることをキャッシャーに示します。 結果のバイトは、リクエスターの言語で表されます。 -->
<Parameter name="$ORDERDESCRIPTION" encoding="8859_1" >
<ExtensionValue name="com.ibm.commerce.payment.extensions.GenericExtension" />
</Parameter>
<!-- ==================================================================
カセットのオプション・パラメーター
================================================================== -->
<!-- カード所有者の番地。 1 から 128 文字の ASCII 文字。 -->
<Parameter name="$AVS.STREETADDRESS" maxBytes="128" encoding="ASCII"><CharacterText>{billto_address1}</CharacterText></Parameter>
<!-- カード所有者の市区町村。 1 から 50 文字の ASCII 文字。 -->
<Parameter name="$AVS.CITY" maxBytes="50" encoding="ASCII"><CharacterText>{billto_city}</CharacterText></Parameter>
<!-- カード所有者の都道府県。 1 から 50 文字の ASCII 文字。 -->
<Parameter name="$AVS.STATEPROVINCE" maxBytes="50" encoding="ASCII"><CharacterText>{billto_state}</CharacterText></Parameter>
<!-- カード所有者の郵便番号。 1 から 14 文字の ASCII 文字。 -->
<Parameter name="$AVS.POSTALCODE" maxBytes="14" encoding="ASCII"><CharacterText>{billto_zipcode}</CharacterText></Parameter>
<!-- カード所有者の ISO 3166 (3 桁) 国別コード。 このフィールドは、
別の AVS データが渡される場合に必要です。 -->
<Parameter name="$AVS.COUNTRYCODE"><CharacterText>{billto_country_code}</CharacterText></Parameter>
<!-- その場所の 1 つを指定するためにマーチャントが使用する ID。
値はストリングとして指定されます。 1 から 10 文字の ASCII 文字。 -->
<Parameter name="$AVS.LOCATIONID" maxBytes="10" encoding="ASCII"><CharacterText></CharacterText></Parameter>
<!-- $ORDERDESCRIPTION パラメーターのコンテンツ・タイプおよび
文字セットを指示します。 ウォレットによっては、文字セットの指定を含めるために、
Payment Initiation メッセージのコンテンツ・タイプのヘッダーが必要な場合があります。
その場合、$CHARSET パラメーターの値として、引用符を外した
"text/plain; charset={language_encoding}" を指定してください。
-->
<Parameter name="$CHARSET"><CharacterText></CharacterText></Parameter>
<!-- merchData 構造の 2 つのフィールドの内の 1 つです。指定すると
カセットがこれを使用します。 値は 4-桁の数字ストリングです。
注: このフィールドは、決済機関からの必要事項に使用されます。 -->
<Parameter name="$MERCHCATCODE"><CharacterText></CharacterText></Parameter>
<!-- merchData 構造の 2 つのフィールドの内の 1 つです。指定すると
カセットがこれを使用します。 値は
"1" と "8" の間の数値ストリングでなければなりません。 可能な値のセマンティクスは SET 仕様に説明されています。
注: このフィールドの使用は、決済機関からの要件によるものです。
-->
<Parameter name="$MERCHGROUP"><CharacterText></CharacterText></Parameter>
<!-- MerOrderNum フィールドは、CapReq および AuthReq (現在、資金化状態) メッセージ
の SalesDetail 構造にあります。 値は、最大長 24 文字の文字ストリングでなければなりません。
-->
<Parameter name="$MERORDERNUM"><CharacterText></CharacterText></Parameter>
<!-- マーチャントが追加の配送を承認するかどうかを指示します。
サポート値:
0-これがオーダーの最終支払いであることを指示する。
1-マーチャントが、オーダーに対して追加の分割支払いを
可能にすることを指示する。 -->
<Parameter name="$SPLITALLOWED"><CharacterText>1</CharacterText></Parameter>
<!-- ウォレットから着信する購入要求は、カード所有者の証明書が必要であることを
指示するために使用されます。 このキーワードが省略されると、証明書なしでの購入が
許可されます。 有効値:
0: カード所有者の証明書が必要でないことを指示します。
1: カード所有者の証明書が必要であることを指示します。
-->
<Parameter name="$REQUIRECARDCERT"><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>
</Command>
</Profile>
WC51_SET_Wallet.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 プロパティーとして提供されています。
このプロファイルは GenericExtension クラスを使用して、$ORDERDESCRIPTION パラメーターの値 (そのウォレットの payment-initiation メッセージを生成するために必要) を入手します。 これによって、異なったストアで GetOrderDescCmd コマンドの異なったインプリメンテーションを行うことができ、 さらにすべてのストアで同じキャッシャー・プロファイルを使用することができます。
このプロファイルは、 $SUCCESSURL、$FAILUREURL、$CANCELURL、および $SERVICEURL パラメーターに、 PaySuccessView、PayFailureView、PayCancelView、および PayServiceView を指定します。 $FAILUREURL および $CANCELURL に対する PayResetPM コマンドにも注意してください。 fail=1 および cancel=1 は、 PayFailureView と PayCancelView の両方で使用される、デフォルトのサンプル JSP ファイル、PayStatusPM.jsp のパラメーターです。 このパラメーターは JSP ファイルを送信して、設定されているパラメーター応じて別のメッセージを顧客に表示します。
PaySuccessView、PayFailureView、PayCancelView および PayServiceView の詳細については、 カスタマイズ可能な支払い JSP ファイルを参照してください。
SET のカセットで必要となるパラメーターの詳細については、 IBM WebSphere Payment Manager for Multiplatforms Cassette for SET 補足 バージョン 3.1 を参照してください。
![]() |