Cashier-Profil für die Kassette für VisaNet mit Daten für den Einkauf per Kundenkarte (Business Edition)

Der folgende XML-Code ist das Standard-Cashier-Profil, das in WebSphere Commerce für die Verwendung mit der Kassette für VisaNet bereitgestellt wird. Dieses Cashier-Profil enthält einige der von der Kassette unterstützten optionalen Daten für den Einkauf per Kundenkarte. Die Kundenkartenmethode wird verwendet, um zusätzliche Kundenkartendaten an das übernehmende Geldinstitut zu senden. Die Kassette unterstützt nur eine Untergruppe von Purchasing Card Level II Data. Weitere Informationen zu Purchasing Cards enthält IBM WebSphere Payment Manager for Multiplatforms, Cassette for VisaNet Supplement, Version 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.
//*
//*================================================================== -->

<!-- ==================================================================
This is the sample WC 5.1 cashier profile for the Payment Manager Cassette for VisaNet

This Profile specifies the optional Purchase Card Data supported by the Cassette.
Currently, only a subset of Purchase Card Level II Data is supported by the Cassette.

Note: If you change the DEPOSITFLAG parameter of the Profile to "1" you must move the 
$PCARD.* parameters to the <CollectPayment> section of the Profile.
================================================================== --> 

<Profile useWallet="false" enableTrace="true">

<CollectPayment>

<!-- ==================================================================
Parameters required by 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>

<!-- ==================================================================
Optional parameters for Payment Manager
================================================================== -->

<!-- Indicates how automatic approval of the order should be attempted
Supported values are: 
0 - no automatic approval
1 - synchronous automatic approval - Payment Manager attempts approval as
part of order creation operation
2 - asynchronous automatic approval - Payment Manager schedules an approval
operations after order is created
The default value is 0.
-->
<Parameter name="APPROVEFLAG"><CharacterText>2</CharacterText></Parameter>

<!-- The amount which should be used when approving an order. Usually
this will be the same as the order amount. This field is required
if the APPROVEFLAG is set to 1 or 2. -->
<Parameter name="PAYMENTAMOUNT"><CharacterText>{approval_amount}</CharacterText></Parameter>

<!-- The payment number which should be used when approving an order.
Usually this will be 1. This field is required if the APPROVEFLAG
is set to 1 or 2. -->
<Parameter name="PAYMENTNUMBER"><CharacterText>1</CharacterText></Parameter>

<!-- Indicates whether the deposit should be attempted automatically. 
This flag is only valid if APPROVEFLAG is set to 1 or 2.
Supported values are:
0 - Funds should not be automatically deposited. 
1 - Funds should be automatically deposited. 
The default value is 0.

Note: If you change the DEPOSITFLAG parameter to "1" you must move all the 
optional Purchase Card Data parameters from the <Command name="DEPOSIT">
element to this section of the profile for the parameters to be sent.
-->
<Parameter name="DEPOSITFLAG"><CharacterText></CharacterText></Parameter>


<!-- The following two parameters are optional. Either one could be used to pass the 
Buyer Purchase Order number to the Payment Manager. The first Parameter takes only 
ASCII Text. If Buyer Purchase Order numbers on your system may contain non-ASCII 
Strings, use parameter ORDERDATA2 instead. 
-->
<Parameter name="TRANSACTIONID" maxBytes="128" encoding="ASCII"><CharacterText>{PONumber}</CharacterText></Parameter>
<Parameter name="ORDERDATA2"><CharacterText></CharacterText></Parameter>

<!-- ==================================================================
Parameters required by the cassette
================================================================== -->

<!-- The credit card number -->
<Parameter name="$PAN" sensitive="true"><CharacterText>{card_number}</CharacterText></Parameter>

<!-- The expiry date in format YYYYMM -->
<Parameter name="$EXPIRY"><CharacterText>{card_expiry}</CharacterText></Parameter>

<!-- Note that the AccountNumber parameter is hardcoded to "1" here. 
This must match the number used to configure the VisaNet Merchant AccountNumber for the Store. 
-->
<Parameter name="$ACCOUNTNUMBER"><CharacterText>1</CharacterText></Parameter>

<!-- The cardholder's street address -->
<Parameter name="$AVS.STREETADDRESS" maxBytes="24" encoding="ASCII"><CharacterText>{billto_address1}</CharacterText></Parameter>

<!-- The cardholder's zip code -->
<Parameter name="$AVS.POSTALCODE" maxBytes="9" encoding="ASCII"><CharacterText>{billto_zipcode}</CharacterText></Parameter>


<!-- ==================================================================
Optional parameters for the cassette
================================================================== -->

<!-- Some payment cards are issued with a verification code. The verification
code is generated by the issuing bank and can be verified by the bank. 
The account number followed by the three or four digit verification code 
is printed on the signature panel of the card. The value must be a 3 or 4 
character numeric string. Example values: 1234 or 321. -->
<Parameter name="$CARDVERIFYCODE"><CharacterText>{cardVerificationCode}</CharacterText></Parameter>

<!-- A purchase order number to be associated with this order -->
<Parameter name="$PURCHORDERNUM"><CharacterText></CharacterText></Parameter>

<!-- The maximum number of payments to be allowed for this order -->
<Parameter name="$NUMPAYMENTS"><CharacterText>1</CharacterText></Parameter>

</CollectPayment>


<Command name="DEPOSIT">
<!-- ==================================================================
Parameters required by Payment Manager for DEPOSIT Command
================================================================== -->
<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>

<!-- ==================================================================
Optional $PCARD Parameters for Purchase Card Data 
Note: If you change the DEPOSITFLAG parameter in the <CollectPayment> section above to "1" 
you must move the $PCARD.* parameters to that section for these to have an effect.
================================================================== -->
<Parameter name="$PCARD.LOCALTAXAMOUNT"><CharacterText>{total_tax_amount}</CharacterText></Parameter>

<!-- VisaNet only supports sending one tax amount, thus it is not valid sending both a NationalTaxAmount
and a LocalTaxAmount. -->
<Parameter name="$PCARD.NATIONALTAXAMOUNT"><CharacterText></CharacterText></Parameter>

<!-- If specified, indicates if order is tax exempt. Supported values are: 
0 - indicates that the order is not tax exempt
1 - indicates that the order is tax exempt --> 
<Parameter name="$PCARD.TAXEXEMPTINDICATOR"><CharacterText>0</CharacterText></Parameter>
<Parameter name="$PCARD.CUSTOMERREFERENCENUMBER"><CharacterText></CharacterText></Parameter>


</Command>



</Profile>

Die Datei WC51_VisaNet_PCard.profile befindet sich in:
laufwerk:\WebSphere\CommerceServer\instances\exemplarname\xml\payment\
laufwerk:\Programme\WebSphere\CommerceServer\instances\exemplarname\xml\payment\
/usr/WebSphere/CommerceServer/instances/exemplarname/xml/payment/
/opt/WebSphere/CommerceServer/instances/exemplarname/xml/payment/
root_pfad_des_exemplars/xml/payment/

Hierbei ist root_pfad_des_exemplars der Pfad, den Sie während der Erstellung des Exemplars im Feld Root-Pfad des Exemplars auf der Seite Exemplar im Konfigurationsmanager angegeben haben. Der Standardpfad lautet: /QIBM/UserData/WebCommerce/instances/exemplarname/.

Der Parameter PAYMENTTYPE gibt den Namen der Kassette dieses Profils an. 

WebSphere Commerce verwendet das Element <BuyPageInformation> des Cashier-Profils nicht. Eine vergleichbare Funktionalität wird durch die Eigenschaft attrPageName der Zahlungsrichtlinie erreicht.

Wichtig: Dieses Profil enthält den festen Wert 1 für den Parameter $ACCOUNTNUMBER, der von der Kassette benötigt wird. Diese Zahl muss mit dem Wert im Feld Account Number der Anzeige Merchant Account Settings für VisaNet in der Benutzerschnittstelle von Payment Manager übereinstimmen. Dies ist die einzige Kassette, für die dieser Parameter benötigt wird. Wenn Sie beim Konfigurieren des VisaNet-Kontos für Ihr Geschäft im Feld Account Number einen anderen Wert eingeben, müssen Sie dieses Profil ebenfalls aktualisieren. Zur Vereinfachung der Geschäftskonfiguration wird empfohlen, dass Sie beim Konfigurieren des Händlerkontos für Ihr Geschäft dieselbe Kontonummer verwenden.

Weitere Informationen zu den für die Kassette für VisaNet erforderlichen Parametern enthält IBM WebSphere Payment Manager for Multiplatforms, Cassette for VisaNet, Version 3.1.

Verwandte Konzepte (1275 Byte)

Verwandte Referenzen (1292 Byte)

IBM Copyright