Le code XML ci-dessous correspond au profil de caissier standard fourni dans WebSphere Commerce pour la cassette pour SET.
<?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.
//*
//*================================================================== -->
<!-- ==================================================================
Profil de caissier WC 5.1 standard pour la cassette Payment Manager
pour SET
================================================================== -->
<Profile useWallet="true" enableTrace="true" >
<CollectPayment>
<!-- ==================================================================
Paramètres requis par Payment Manager pour la création d'une commande
================================================================== -->
<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>
<!-- ==================================================================
Paramètres facultatifs pour Payment Manager
================================================================== -->
<!-- Indique le mode d'approbation automatique de la commande
Les valeurs admises sont les suivantes :
0 - pas d'approbation automatique ;
1 - approbation automatique synchrone - Payment Manager tente l'approbation dans
le cadre de l'opération de création de commande ;
2 - approbation automatique asynchrone - Payment Manager planifie les opérations
d'approbation après la création de la commande.
La valeur par défaut est 0.
Etant donné qu'une application de portefeuille est utilisée, le gestionnaire de paiements doit renvoyer un
message d'initialisation à WC à l'attention du client. Cela a pour effet de mettre fin à l'instruction DoPayment.
Si la valeur 1 est spécifiée pour APPROVEFLAG, l'application de portefeuille recevra
la réponse d'achat du gestionnaire de paiements après
réception de la réponse d'autorisation de la part de la passerelle de paiement.
-->
<Parameter name="APPROVEFLAG"><CharacterText>1</CharacterText></Parameter>
<!-- Montant qui doit être utilisé lors de l'approbation d'une commande. Généralement
il est identique au montant de la commande. Cette zone est obligatoire
si APPROVEFLAG est défini sur 1 ou 2. -->
<Parameter name="PAYMENTAMOUNT"><CharacterText>{approval_amount}</CharacterText></Parameter>
<!-- Numéro de paiement à utiliser lors de l'approbation d'une commande.
Généralement, ce numéro est 1. Cette zone est obligatoire si APPROVEFLAG
est défini sur 1 ou 2. -->
<Parameter name="PAYMENTNUMBER"><CharacterText>1</CharacterText></Parameter>
<!-- Indique si le versement de l'acompte doit être automatiquement tenté.
Cet indicateur n'est valide que si APPROVEFLAG a la valeur 1 ou 2.
Les valeurs admises sont les suivantes :
0 - Les fonds ne doivent pas être automatiquement versés ;
1 - Les fonds doivent être automatiquement versés.
La valeur par défaut est 0.
-->
<Parameter name="DEPOSITFLAG"><CharacterText></CharacterText></Parameter>
<!-- Les deux paramètres suivants sont facultatifs. L'un ou l'autre peut être utilisé pour transmettre le
numéro de bon de commande au gestionnaire de paiements. Le premier paramètre prend en charge
le texte au format ASCII uniquement. Si les numéros de bon de commande dans votre système contiennent
des chaînes de caractères qui ne sont pas au format ASCII, utilisez le paramètre ORDERDATA2.
-->
<Parameter name="TRANSACTIONID" maxBytes="128" encoding="ASCII"><CharacterText>{PONumber}</CharacterText></Parameter>
<Parameter name="ORDERDATA2"><CharacterText></CharacterText></Parameter>
<!-- ==================================================================
Paramètres requis par la cassette
================================================================== -->
<Parameter name="$SUCCESSURL"><CharacterText>http://{WCHostName}{WebPath}/PaySuccessView?storeId={storeId}&orderId={orderId}&langId={buyer_language_id}</CharacterText></Parameter>
<Parameter name="$FAILUREURL"><CharacterText>http://{WCHostName}{WebPath}/PayResetPM?storeId={storeId}&orderId={orderId}&fail=1&langId={buyer_language_id}&URL=PayFailureView</CharacterText></Parameter>
<Parameter name="$CANCELURL" ><CharacterText>http://{WCHostName}{WebPath}/PayResetPM?storeId={storeId}&orderId={orderId}&cancel=1&langId={buyer_language_id}&URL=PayCancelView</CharacterText></Parameter>
<Parameter name="$SERVICEURL"><CharacterText>http://{WCHostName}{WebPath}/PayServiceView?storeId={storeId}&orderId={orderId}&langId={buyer_language_id}</CharacterText></Parameter>
<!-- L'attribut de codage indique au caissier que les octets de la valeur
OrderDescription peuvent être obtenus à partir de la chaîne de caractères renvoyée à l'aide du codage de caractères 8859_1
car il s'agit du codage utilisé par la classe GenericExtension pour coder
les octets. Les octets obtenus sont dans la langue du demandeur. -->
<Parameter name="$ORDERDESCRIPTION" encoding="8859_1" >
<ExtensionValue name="com.ibm.commerce.payment.extensions.GenericExtension" />
</Parameter>
<!-- ==================================================================
Paramètres facultatifs pour la cassette
================================================================== -->
<!-- Adresse du porteur de carte. Entre 1 et 128 caractères ASCII. -->
<Parameter name="$AVS.STREETADDRESS" maxBytes="128" encoding="ASCII"><CharacterText>{billto_address1}</CharacterText></Parameter>
<!-- Ville du porteur de carte. Entre 1 et 50 caractères ASCII. -->
<Parameter name="$AVS.CITY" maxBytes="50" encoding="ASCII"><CharacterText>{billto_city}</CharacterText></Parameter>
<!-- Etat ou province du porteur de carte. Entre 1 et 50 caractères ASCII. -->
<Parameter name="$AVS.STATEPROVINCE" maxBytes="50" encoding="ASCII"><CharacterText>{billto_state}</CharacterText></Parameter>
<!-- Code postal du porteur de carte. Entre 1 et 14 caractères ASCII. -->
<Parameter name="$AVS.POSTALCODE" maxBytes="14" encoding="ASCII"><CharacterText>{billto_zipcode}</CharacterText></Parameter>
<!-- Code pays ISO 3166 (3 chiffres) du porteur de carte. Cette zone est
obligatoire si d'autres données AVS sont transmises. -->
<Parameter name="$AVS.COUNTRYCODE"><CharacterText>{billto_country_code}</CharacterText></Parameter>
<!-- Identificateur que le commerçant utilise pour spécifier l'un de ses sites.
Cette valeur est spécifiée sous la forme d'une chaîne. Entre 1 et 10 caractères ASCII. -->
<Parameter name="$AVS.LOCATIONID" maxBytes="10" encoding="ASCII"><CharacterText></CharacterText></Parameter>
<!-- Indique le type de contenu et le jeu de caractères du paramètre $ORDERDESCRIPTION.
Certains portefeuilles peuvent demander l'en-tête de type contenu du
message d'initialisation de paiement pour inclure les spécifications du jeu de caractères.
Dans ce cas, spécifiez "text/plain; charset={language_encoding}"
sans les guillemets pour définir la valeur du paramètre $CHARSET.
-->
<Parameter name="$CHARSET"><CharacterText></CharacterText></Parameter>
<!-- Une des deux zones de la structure merchData. Lorsqu'elle est spécifiée,
la cassette l'utilise. Cette valeur doit être une chaîne numérique de 4 caractères.
Remarque : l'obligation d'utiliser cette zone viendra de l'acquéreur. -->
<Parameter name="$MERCHCATCODE"><CharacterText></CharacterText></Parameter>
<!-- Une des deux zones de la structure merchData. Lorsqu'elle est spécifiée,
la cassette l'utilise. La valeur doit être une chaîne numérique entre
"1" et "8". La sémantique des valeurs possibles est décrite dans les spécifications
de SET. Remarque : l'obligation d'utiliser cette zone viendra
de l'acquéreur. -->
<Parameter name="$MERCHGROUP"><CharacterText></CharacterText></Parameter>
<!-- La zone MerOrderNum fait partie de la structure SaleDetail des messages CapReq
et AuthReq (avec enregistrement). La valeur doit être une chaîne de caractères
d'une longueur maximale de 24 caractères. -->
<Parameter name="$MERORDERNUM"><CharacterText></CharacterText></Parameter>
<!-- Indique si un commerçant peut ou non approuver des expéditions supplémentaires.
Les valeurs admises sont les suivantes :
0-Indique qu'il s'agit du paiement final de la commande ;
1-Indique que le commerçant peut accepter des paiements fractionnés
supplémentaires pour la commande. -->
<Parameter name="$SPLITALLOWED"><CharacterText>1</CharacterText></Parameter>
<!-- Sert à indiquer qu'une demande d'achat entrante d'un portefeuille doit contenir
un certificat de porteur de carte. Si ce mot clé est omis, les achats sans
certificat sont autorisés. Les valeurs admises sont :
0: Indique que les certificats de porteurs de cartes ne sont pas nécessaires ;
1: Indique que les certificats de porteurs de carte sont obligatoires.
-->
<Parameter name="$REQUIRECARDCERT"><CharacterText>1</CharacterText></Parameter>
</CollectPayment>
<Command name="DEPOSIT">
<!-- ==================================================================
Paramètres requis par Payment Manager pour l'instruction 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>
WC51_SET_Wallet.profile se trouve dans :
unité:\WebSphere\CommerceServer\instances\nom_instance\xml\payment\
unité:\Program Files\WebSphere\CommerceServer\instances\nom_instance\xml\payment\
/usr/WebSphere/CommerceServer/instances/nom_instance/xml/payment/
/opt/WebSphere/CommerceServer/instances/nom_instance/xml/payment/
chemin_root_
instance/xml/payment/
où chemin_root_instance représente le chemin que vous avez indiqué dans la zone
Chemin root de l'instance dans l'écran Instance du gestionnaire de configuration,
lors de la création de l'instance. Le chemin par défaut est
/QIBM/UserData/WebCommerce/instances/nom_instance/.
Le paramètre PAYMENTTYPE indique le nom de la cassette du profil.
WebSphere Commerce n'utilise pas l'élément <BuyPageInformation> du profil de caissier. Une fonction comparable est fournie avec la propriété attrPageName de la stratégie de paiement.
Le profil utilise la classe GenericExtension pour obtenir la valeur du paramètre $ORDERDESCRIPTION, qui est requis pour générer le message d'initialisation du paiement du portefeuille, en appelant l'instruction d'activité GetOrderDescCmd. Ceci permet à des magasins distincts de disposer de plusieurs implémentations de l'instruction GetOrderDescCmd et de toujours utiliser le même profil de caissier pour tous les magasins.
Ce profil définit les vues PaySuccessView, PayFailureView, PayCancelView et PayServiceView pour les paramètres $SUCCESSURL, $FAILUREURL, $CANCELURL et $SERVICEURL. Vous remarquerez également l'utilisation de l'instruction PayResetPM pour les paramètres $FAILUREURL et $CANCELURL. fail=1 et cancel=1 sont des paramètres du modèle de fichier JSP par défaut, PayStatusPM.jsp, utilisé par les vues PayFailureView et PayCancelView. Ce paramètre entraîne l'affichage par le fichier JSP de divers messages au client en fonction du paramètre défini.
Pour plus de détails sur les vues PaySuccessView, PayFailureView, PayCancelView et PayServiceView, reportez-vous aux fichiers JSP de paiement personnalisés.
Pour plus d'informations sur les paramètres requis par la cassette pour SET, consultez le manuel IBM WebSphere Payment Manager for Multiplatforms, Cassette for SET Supplement, Version 3.1.
![]() |