Il seguente codice XML è il profilo Cassiere standard fornito in WebSphere Commerce per la Cassetta per BankServACH:
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE Profile SYSTEM "../../../../xml/PaymentManager/profile.dtd">
<!--
//*==================================================================
//* Materiale su licenza - Proprietà della IBM
//*
//* 5724-A18
//*
//* (c) Copyright IBM Corp. 2001
//*
//* Limitazioni previste per gli utenti degli Stati Uniti - L'utilizzo, la riproduzione o
//* la divulgazione sono regolati dal Contratto GSA ADP con l'IBM Corp.
//*
//*================================================================== -->
<!-- ==================================================================
Questo è il profilo Cassiere standard WebSphere Commerce per Payment Manager ACH Cassette per BankServ. (Questa cassetta è soltanto per gli Stati Uniti.)
================================================================== -->
<Profile useWallet="false" enableTrace="true" >
<CollectPayment>
<!-- ==================================================================
Parametri richiesti da Payment Manager per la creazione degli ordini
================================================================== -->
<Parameter name="PAYMENTTYPE"><CharacterText>BankServACH</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>
<!-- Indica come deve essere tentata l'approvazione automatica dell'ordine
I valori supportati sono:
0 - nessuna approvazione automatica
1 - approvazione automatica sincrona - Payment Manager tenta l'approvazione come
parte dell'operazione di creazione degli ordini
2 - approvazione automatica asincrona - Payment Manager pianifica un'operazione di approvazione
dopo la creazione dell'ordine
WCS funziona meglio con APPROVEFLAG impostato su 2. Quando APPROVEFLAG è impostato su 1, il comando WCS
DoPayment viene bloccato fino a quando Payment Manager non completa l'approvazione dell'ordine.
Fino al completamento dell'approvazione, qualsiasi comando per la lettura/aggiornamento degli stessi record di inventario
modificati dal comando DoPayment verrà bloccato. Questo compromette la velocità di trasmissione
degli altri comandi.
-->
<Parameter name="APPROVEFLAG"><CharacterText>2</CharacterText></Parameter>
<!-- La quantità che deve essere utilizzata quando si approva un ordine. In genere
corrisponde alla quantità dell'ordine. Questo campo è obbligatorio
se APPROVEFLAG è impostato su 1 o 2. -->
<Parameter name="PAYMENTAMOUNT"><CharacterText>{approval_amount}</CharacterText></Parameter>
<!-- Il numero di pagamento utilizzato in genere quando si approva un ordine.
Solitamente è 1. Questo campo è obbligatorio se APPROVEFLAG
è impostato su 1 o 2. -->
<Parameter name="PAYMENTNUMBER"><CharacterText>1</CharacterText></Parameter>
<!-- Indica se il deposito deve essere tentato automaticamente.
Questo flag è valido solo se APPROVEFLAG è impostati su 1 o 2.
I valori supportati sono:
0 - I fondi non devono essere depositati automaticamente.
1 - I fondi devono essere depositati automaticamente.
Il valore predefinito è 0.
-->
<Parameter name="DEPOSITFLAG"><CharacterText></CharacterText></Parameter>
<!-- ==================================================================
Parametri facoltativi per Payment Manager
================================================================== -->
<!-- I seguenti due parametri sono facoltativi. Entrambi possono essere utilizzati per trasferire il
numero dell'ordine di acquisto dell'acquirente a Payment Manager. Il primo parametro richiede soltanto
testo ASCII. Se il numero di ordine dell'acquirente sul sistema contiene delle
stringhe non ASCII, utilizzare il parametro ORDERDATA2.
-->
<Parameter name="TRANSACTIONID" maxBytes="128" encoding="ASCII"><CharacterText>{PONumber}</CharacterText></Parameter>
<Parameter name="ORDERDATA2"><CharacterText></CharacterText></Parameter>
<!-- ==================================================================
Parametri richiesti dalla cassetta
================================================================== -->
<!-- Il numero di conto bancario -->
<Parameter name="$CHECKINGACCOUNTNUMBER"><CharacterText>{checkingAccountNumber}</CharacterText></Parameter>
<!-- Il numero di serie dell'assegno -->
<Parameter name="$CHECKROUTINGNUMBER"><CharacterText>{checkRoutingNumber}</CharacterText></Parameter>
<Parameter name="$BUYERNAME" maxBytes="80" encoding="ASCII"><CharacterText>{billto_firstname} {billto_lastname}</CharacterText></Parameter>
<Parameter name="$STREETADDRESS" maxBytes="50" encoding="ASCII"><CharacterText>{billto_address1}</CharacterText></Parameter>
<Parameter name="$CITY" maxBytes="50" encoding="ASCII"><CharacterText>{billto_city}</CharacterText></Parameter>
<!-- Solo i codici di stato US a 2 caratteri in maiuscolo (ad esempio AL per Alabama, AK per Alaska, etc.)
sono accettati dalla Cassetta. La classe Estensione Cassiere BankServACH viene utilizzata per localizzare
i codici di stato a 2 caratteri dalla tabella STATEPROV di WebSphere Commerce utilizzando il valore specificato
nella variabile d'ambiente {billto_state} come nome di Stato. L'Estensione Cassiere restituisce il valore null
se è impossibile trovare il codice di stato per il nome di stato specificato. Per compatibilità, la classe Extension
restituisce il valore della variabile d'ambiente {billto_state} come codice di stato, se il valore è
di due caratteri.
-->
<Parameter name="$STATEPROVINCE" maxBytes="2" encoding="ASCII">
<ExtensionValue name="com.ibm.commerce.payment.extensions.BankServACHCashierExtension" />
</Parameter>
<Parameter name="$POSTALCODE" maxBytes="9" encoding="ASCII"><CharacterText>{billto_zipcode}</CharacterText></Parameter>
<Parameter name="$COUNTRYCODE" maxBytes="2" encoding="ASCII"><CharacterText>US</CharacterText></Parameter>
<Parameter name="$PHONENUMBER" maxBytes="10" encoding="ASCII"><CharacterText>{billto_phone_number}</CharacterText></Parameter>
<!-- ==================================================================
Parametri facoltativi per la cassetta CustomOffline
================================================================== -->
<Parameter name="$STREETADDRESS2" maxBytes="50" encoding="ASCII"><CharacterText></CharacterText></Parameter>
<Parameter name="$EMAILADDRESS" maxBytes="49" encoding="ASCII"><CharacterText></CharacterText></Parameter>
</CollectPayment>
<Command name="DEPOSIT">
<!-- ==================================================================
Parametri richiesti da Payment Manager per il comando 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>
</Command>
</Profile>
E' possibile trovare il profilo WC51_BankServACH.profile in:
unità:\WebSphere\CommerceServer\instances\instance_name\xml\payment\
unità:\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/
dove instance root path è il percorso specificato dall'utente
nel campo Percorso principale istanza nel pannello Istanza
di Gestore configurazione quando è stata creata l'istanza. Il percorso predefinito è /QIBM/UserData/CommerceSuite5/instances/instance_name.
Il parametro PAYMENTTYPE specifica il nome della cassetta del profilo.
WebSphere Commerce non utilizza l'elemento <BuyPageInformation> del profilo Cassiere. Una funzione confrontabile viene fornita con la proprietà attrPageName del criterio di pagamento.
Questo profilo Cassiere utilizza la classe CashierExtension, denominata BankServACHCashierExtension, per ottenere il codice di stato a 2 caratteri per il parametro richiesto $STATEPROVINCE. Questa classe cerca il codice di stato nella tabella STATEPROV utilizzando il valore specificato nella variabile d'ambiente {billto_state} come il nome di stato. La classe restituisce il valore null se è impossibile trovare il codice di stato del nome di stato specificato. Per compatibilità, CashierExtension restituisce il valore della variabile d'ambiente {billto_state} come codice di stato, se il valore è di due caratteri.
La variabile d'ambiente {billto_state} ed altre variabili d'ambiente {billto_*} sono alcune delle coppie nome\valore trasmesse al Cassiere come parametri per la chiamata collectPayment del Cassiere. I valori per queste variabili si trovano nelle colonne corrispondenti nella tabella INDIRIZZI.
In alternativa, è possibile utilizzare un DatabaseValue per il parametro $STATEPROVINCE se si è a conoscenza che la colonna STATE nella tabella ADDRESS avrà come valori validi soltanto i nomi di stato. Per utilizzare il DatabaseValue, fare riferimento alle seguenti istruzioni.
Per ulteriori informazioni sui parametri richiesti da Cassette, fare riferimento a IBM WebSphere Payment Manager for Multiplatforms, Cassette for BankServACH, Versione 3.1.
![]() |