Develop > Controller layer > Integrate with back-end systems and external applications > Customize WebSphere Commerce Payments > Cashier function in WebSphere Commerce Payments > Cashier profiles
Cashier profile for the Cassette for VisaNet with purchasing card data
The following XML code is the standard cashier profile provided in WebSphere Commerce for the Cassette for VisaNet. This Cashier profile specifies the optional purchasing card data supported by the cassette. The purchasing card method sends additional purchasing card data to the Acquirer. Only a subset of purchasing card level II data is supported by the cassette.
<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE Profile SYSTEM "profile.dtd"> <!-- ================================================================== This is the Standard WebSphere Commerce Cashier profile for the Cassette for VisaNet with Account number set to 1. 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" move the $PCARD.* parameters to the <CollectPayment> section of the Profile. ================================================================== --> <Profile useWallet="false" enableTrace="true"> <CollectPayment> <!-- ================================================================== Parameters required by WebSphere Commerce Payments ================================================================== --> <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 WebSphere Commerce Payments ================================================================== --> <!-- Indicates how automatic approval of the order should be attempted Supported values are: 0 - no automatic approval 1 - synchronous automatic approval - WebSphere Commerce Payments attempts approval as part of order creation operation 2 - asynchronous automatic approval - WebSphere Commerce Payments schedules an approval operations after order is created The default value is 0. WebSphere Commerce works best with APPROVEFLAG set to 2. When the APPROVEFLAG is set to 1, the DoPayment command is blocked until WebSphere Commerce Payments completes the approval of the order. Until this approval is complete, any commands wanting to read/update the same inventory records modified by the DoPayment command will be blocked. This will affect the throughput of the other commands. --> <Parameter name="APPROVEFLAG"><CharacterText>2</CharacterText></Parameter> <!-- The amount which should be used when approving an order. Typically 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. Typically 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" 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 WebSphere Commerce Payments. The first Parameter takes only ASCII Text. If Buyer Purchase Order numbers on the 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" maxBytes="4" encoding="ASCII"><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 WebSphere Commerce Payments for the 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" 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>
You can find the WC51_VisaNet_PCard.profile file in the following directory:
WC_EAR/xml/payment/
The PAYMENTTYPE parameter specifies the name of this profile's cassette.
WebSphere Commerce does not use the <BuyPageInformation> element of the Cashier profile. Comparable function is provided with the attrPageName property of the payment policy.
Important: This profile includes a fixed value of 1 for the $ACCOUNTNUMBER parameter required by the cassette. This number must match the value of the Account Number field on the Merchant Account Settings screen for VisaNet in the Commerce Payments user interface. This is the only cassette that requires this parameter. If you use a different value for the Account Number field when you configure the store's VisaNet account, update this profile as well.
To simplify store setup, we recommend that you use the same account number when you configure the Merchant Account for the store.
Related concepts
Related reference