SET のカセットのキャッシャー・プロファイル - ウォレット

以下の 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}&amp;orderId={orderId}&amp;langId={buyer_language_id}</CharacterText></Parameter>
<Parameter name="$FAILUREURL"><CharacterText>http://{WCHostName}{WebPath}/PayResetPM?storeId={storeId}&amp;orderId={orderId}&amp;fail=1&amp;langId={buyer_language_id}&amp;URL=PayFailureView</CharacterText></Parameter>
<Parameter name="$CANCELURL" ><CharacterText>http://{WCHostName}{WebPath}/PayResetPM?storeId={storeId}&amp;orderId={orderId}&amp;cancel=1&amp;langId={buyer_language_id}&amp;URL=PayCancelView</CharacterText></Parameter>
<Parameter name="$SERVICEURL"><CharacterText>http://{WCHostName}{WebPath}/PayServiceView?storeId={storeId}&amp;orderId={orderId}&amp;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 を参照してください。

関連概念 (1275 バイト)

関連参照 (1275 バイト)

IBM 著作権