Profilo Cassiere per la cassetta per SET - Portafoglio

Il seguente codice XML è il profilo Cassiere standard fornito in WebSphere Commerce da utilizzare con la cassetta per SET.

<?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 WC 5.1 per Payment Manager 
Cassetta per SET 
================================================================== -->

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

<CollectPayment>

<!-- ==================================================================
Parametri richiesti da Payment Manager per la creazione degli ordini
================================================================== -->
<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>

<!-- ==================================================================
Parametri facoltativi per Payment Manager
================================================================== -->

<!-- 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
Il valore predefinito è 0.

Dal momento che viene utilizzata un'applicazione Portafoglio, Payment Manager deve restituire un messaggio di avvio
a WC da inviare all'acquirente. Questa operazione completa il comando DoPayment.
La specifica di APPROVEFLAG di 1 significa che l'applicazione Portafoglio riceve il messaggio 
Purchase Response da Payment Manager dopo che il messaggio Authorization response 
è stato ricevuto da Payment Gateway.
-->
<Parameter name="APPROVEFLAG"><CharacterText>1</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 da utilizzare 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>

<!-- 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
================================================================== -->
<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>

<!-- L'attributo di codifica indica al Cassiere che i byte per 
OrderDescription possono essere rilevati dalla stringa restituita mediante la codifica dei caratteri 8859_1 
in quanto questo è il metodo di codifica della classe GenericExtension 
dei byte. I byte risultanti sono nella lingua del richiedente. -->
<Parameter name="$ORDERDESCRIPTION" encoding="8859_1" >
<ExtensionValue name="com.ibm.commerce.payment.extensions.GenericExtension" />
</Parameter>


<!-- ==================================================================
Parametri facoltativi per la cassetta
================================================================== -->

<!-- L'indirizzo del titolare della carta. Da 1 a 128 caratteri ASCII. -->
<Parameter name="$AVS.STREETADDRESS" maxBytes="128" encoding="ASCII"><CharacterText>{billto_address1}</CharacterText></Parameter>

<!-- La città del titolare della carta. Da 1 a 50 caratteri ASCII. -->
<Parameter name="$AVS.CITY" maxBytes="50" encoding="ASCII"><CharacterText>{billto_city}</CharacterText></Parameter>

<!-- Lo stato o la provincia del titolare della carta. Da 1 a 50 caratteri ASCII. -->
<Parameter name="$AVS.STATEPROVINCE" maxBytes="50" encoding="ASCII"><CharacterText>{billto_state}</CharacterText></Parameter>

<!-- Il codice postale del titolare della carta . Da 1 a 14 caratteri ASCII. -->
<Parameter name="$AVS.POSTALCODE" maxBytes="14" encoding="ASCII"><CharacterText>{billto_zipcode}</CharacterText></Parameter>

<!-- Il codice di paese ISO 3166 del titolare della carta (3 cifre). Questo campo è
necessario se vengono trasferiti altri dati AVS. -->
<Parameter name="$AVS.COUNTRYCODE"><CharacterText>{billto_country_code}</CharacterText></Parameter>

<!-- Un identificativo che il venditore utilizza per specificare una delle sue posizioni. 
Il valore è specificato come una stringa. Da 1 a 10 caratteri ASCII. -->
<Parameter name="$AVS.LOCATIONID" maxBytes="10" encoding="ASCII"><CharacterText></CharacterText></Parameter>


<!-- Indica il tipo di contenuto e il set di caratteri del parametro $ORDERDESCRIPTION 
. Alcuni portafogli potrebbero richiedere l'intestazione del tipo di contenuto del 
messaggio di Payment Initiation per includere la specifica charset. 
In questo caso, specificare "text/plain; charset={language_encoding}"
senza le virgolette come valore del parametro $CHARSET.
-->
<Parameter name="$CHARSET"><CharacterText></CharacterText></Parameter> 

<!-- Uno dei due campi della struttura merchData; quando viene specificato, la 
cassetta lo utilizza. Il valore deve essere una stringa numerica di 4 caratteri. 
Nota: Il requisito per utilizzare questo campo deriva dall'acquirente. -->
<Parameter name="$MERCHCATCODE"><CharacterText></CharacterText></Parameter> 

<!-- Uno dei due campi della struttura merchData; quando viene specificato, 
la cassetta lo utilizza. Il valore deve essere una stringa numerica tra 
"1" e "8". Le semantiche per i possibili valori sono descritte nella specifica SET
. Nota: Il requisito per utilizzare questo campo deriva 
dall'acquirente. -->
<Parameter name="$MERCHGROUP"><CharacterText></CharacterText></Parameter> 

<!-- Il campo MerOrderNum è la struttura SaleDetail dei messaggi CapReq e 
AuthReq (con cattura). Il valore deve essere una stringa di caratteri 
con una lunghezza massima di 24 caratteri. -->
<Parameter name="$MERORDERNUM"><CharacterText></CharacterText></Parameter> 

<!-- Indica se un venditore può approvare le spedizioni aggiuntive. 
I valori supportati sono: 
0-Indica che questo è il pagamento finale per l'ordine.
1-Indica che il venditore può approvare i pagamenti suddivisi aggiuntivi 
per l'ordine. -->
<Parameter name="$SPLITALLOWED"><CharacterText>1</CharacterText></Parameter> 

<!-- Utilizzato per indicare che una richiesta di acquisto in entrata da un Portafoglio deve contenere
un certificato di titolare di carta. Se questa parola chiave manca, sono consentiti acquisti senza 
certificati. I valori validi sono: 
0: Indica che i certificati di titolare di carta non sono necessari. 
1: Indica che i certificati di titolare di carta sono necessari. 
-->
<Parameter name="$REQUIRECARDCERT"><CharacterText>1</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>

Il profilo WC51_SET_Wallet.profile si trova 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.

Il profilo utilizza la classe GenericExtension per ottenere il valore per il parametro $ORDERDESCRIPTION (necessario per generare il messaggio di iniziazione pagamento per il portafogli) richiamando il comando di attività GetOrderDescCmd. Ciò consente a diversi negozi di disporre di diverse implementazioni del comando GetOrderDescCmd e di continuare ad utilizzare lo stesso profilo Cassiere per tutti i negozi.

Questo profilo inoltre, specifica l'utilizzo dei comandi PaySuccessView, PayFailureView, PayCancelView e PayServiceView per i parametri $SUCCESSURL, $FAILUREURL, $CANCELURL e $SERVICEURL. Si osservi anche il comando PayResetPM per $FAILUREURL e $CANCELURL. I parametri fail=1 e cancel=1 sono i parametri per il file JSP di esempio predefinito, PayStatusPM.jsp, utilizzato da PayFailureView e da PayCancelView. Il parametro indirizza il file JSP per visualizzare messaggi diversi al cliente a seconda del parametro impostato.

Per ulteriori informazioni su PaySuccessView, PayFailureView, PayCancelView e PayServiceView, consultare File JSP dei pagamenti personalizzabili.

Per ulteriori informazioni sui parametri richiesti da Cassette for SET, fare riferimento a IBM WebSphere Payment Manager for Multiplatforms, Cassette for SET Supplement, Versione 3.1.

Argomenti correlati (1275 byte)

Riferimenti correlati (1275 byte)

IBM copyright