Le code XML ci-après correspond au profil de caissier standard fourni dans WebSphere Commerce pour la cassette pour BankServACH :
<?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 WebSphere Commerce standard pour la cassette Payment Manager pour BankServACH. (Cette cassette est destinée aux Etats-Unis uniquement.)
================================================================== -->
<Profile useWallet="false" enableTrace="true" >
<CollectPayment>
<!-- ==================================================================
Paramètres requis par Payment Manager pour la création d'une commande
================================================================== -->
<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>
<!-- 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.
WCS fonctionne mieux lorsque la valeur d'APPROVEFLAG est 2. Lorsque la valeur d'APPROVEFLAG est 1, l'instruction WCS
DoPayment est bloquée jusqu'à ce que Payment Manager termine l'approbation de la commande.
Tant que l'approbation n'est pas terminée, toutes les instructions qui veulent lire ou mettre à jour les
enregistrements de stock modifiés par l'instruction DoPayment sont bloquées. Cela se répercute sur le débit
des autres instructions.
-->
<Parameter name="APPROVEFLAG"><CharacterText>2</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>
<!-- ==================================================================
Paramètres facultatifs pour Payment Manager
================================================================== -->
<!-- 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 sur 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
================================================================== -->
<!-- Vérification du numéro de compte -->
<Parameter name="$CHECKINGACCOUNTNUMBER"><CharacterText>{checkingAccountNumber}</CharacterText></Parameter>
<!-- Vérification du numéro d'acheminement -->
<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>
<!-- Seuls les codes d'état américain à deux caractères en majuscules (AL pour Alabama, AK pour Alaska, etc.)
sont acceptés par la cassette. La classe BankServACH Cashier Extension est utilisée pour localiser
le code d'état à deux caractères dans la table STATEPROV de WebSphere Commerce à l'aide de la valeur spécifiée
comme nom d'état dans la variable d'environnement {billto_state}. La classe Cashier Extension renvoie la valeur
null si aucun code d'état n'est trouvé pour le nom d'état spécifié. A des fins de compatibilité, la classe
Extension renvoie la valeur de la variable d'environnement {billto_state} comme code d'état si cette valeur
a une longueur de deux caractères.
-->
<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>
<!-- ==================================================================
Paramètres facultatifs de la cassette 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">
<!-- ==================================================================
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>
Le profil WC51_BankServACH.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
d'accès par défaut est /QIBM/UserData/WebCommerce/instances/nom_instance/.
Le paramètre PAYMENTTYPE indique le nom de la cassette de ce 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.
Ce profil de caissier utilise la classe CashierExtension BankServACHCashierExtension pour obtenir le code d'état à deux caractères à indiquer pour le paramètre obligatoire $STATEPROVINCE. Cette classe identifie le code d'état à partir de la table STATEPROV, en utilisant la valeur définie comme nom d'état dans la variable d'environnement {billto_state}. La classe renvoie alors la valeur null si aucun code d'état n'est trouvé pour le nom d'état indiqué. A des fins de compatibilité, CashierExtension renvoie la valeur de la variable d'environnement {billto_state} comme code d'état si cette valeur a une longueur de deux caractères.
La variable d'environnement {billto_state} et les autres variables d'environnement {billto_*} font partie des paires nom-valeur transmises au caissier comme paramètres pour l'appel de Cashier collectPayment. Les valeurs de ces variables sont extraites des colonnes correspondantes de la table ADDRESS.
Vous pouvez également utiliser une valeur DatabaseValue pour le paramètre $STATEPROVINCE si vous savez que la colonne STATE de la table ADDRESS ne contient que des noms d'état valides. Pour utiliser la valeur DatabaseValue, reportez-vous aux instructions suivantes.
Pour plus d'informations sur les paramètres requis par la cassette pour BankServACH, reportez-vous au manuel IBM WebSphere Payment Manager for Multiplatforms, Cassette for BankServACH Supplement, Version 3.1.
![]() |