下列 XML 程式碼是 WebSphere Commerce 中針對 Cassette for VisaNet 所提供的標準 Cashier 設定檔。這個 Cashier 設定檔用以指定卡匣所支援的選用訂購卡資料。訂購卡方法可將其它的訂購卡資料傳給收單機構。卡匣只支援一小組 「訂購卡資料層次 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 Cashier 設定檔
這個設定檔會指定 Cassette 所支援的選用訂購卡資料。
目前,Cassette 只支援訂購卡層次 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>
<!-- 下面兩個參數是選用的。其中任何一個參數都可用來將
買方訂購單號碼傳遞給 Payment Manager。第一個參數只到
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>
<!-- ==================================================================
卡匣的選用參數
================================================================== -->
<!-- 有些付款卡會連同驗證碼一起發出。驗證碼
是由發卡銀行產生,可供銀行驗證用。
帳戶號碼加上後面的 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">
<!-- ==================================================================
Payment Manager 的 DEPOSIT 指令所需要的參數
================================================================== -->
<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 只支援傳送一個課稅金額,因此,同時傳送 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 是您在建立案例期間於架構管理程式之案例畫面的「案例根路徑」欄位中指定的路徑。 預設路徑為 /QIBM/UserData/WebCommerce/instances/instance_name/。
PAYMENTTYPE 參數用以指定此設定檔卡匣的名稱。
WebSphere Commerce 不會使用 Cashier 設定檔的 <BuyPageInformation> 元素。 付款原則的 attrPageName 內容能夠提供足以相較的功能。
重要事項:這個設定檔含有卡匣所需要的 ACCOUNTNUMBER 參數的固定值 1。 這個數字必須符合 Payment Manager 使用者介面中 VisaNet 的 商家帳戶設定畫面之帳戶號碼欄位的值。 這是唯一需要這個參數的卡匣。 如果您在架構商店的 VisaNet 帳戶時,帳戶號碼欄位使用不同的值,您也必須更新這個設定檔。 如果要簡化商店的設定,建議您在架構商店的商家帳戶時,使用相同的帳戶號碼。
有關 Cassette for VisaNet 所需參數的進一步資訊,請參閱 IBM WebSphere Payment Manager for Multiplatforms, Cassette for VisaNet Supplement, Version 3.1。
![]() |