Perfil de cajero del casete para BankServACH

El código XML siguiente es el perfil de cajero estándar que se proporciona en WebSphere Commerce para el casete para BankServACH:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE Profile SYSTEM "../../../../xml/PaymentManager/profile.dtd">

<!--
//*==================================================================
//* Material bajo licencia - Propiedad de IBM
//*
//* 5724-A18
//*
//* (c) Copyright IBM Corp. 2001
//*
//* Derechos restringidos de los usuarios del Gobierno de EE.UU. - Utilización,
//* duplicación o divulgación restringida por el GSA ADP Schedule Contract con IBM Corp.
//*
//*================================================================== -->

<!-- ==================================================================
Este es el perfil de cajero WebSphere Commerce estándar para el Casete ACH para BankServ de Payment Manager. (Este casete es sólo para EE.UU.)
================================================================== -->

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

<CollectPayment>

<!-- ==================================================================
Los parámetros que necesita Payment Manager para la creación de pedidos
================================================================== -->

<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 cómo se debe intentar la aprobación automática del pedido
Los valores soportados son: 
0 - sin aprobación automática
1 - aprobación automática síncrona - Payment Manager intenta la aprobación
como parte de la operación de creación de pedidos
2 - aprobación automática asíncrona - Payment Manager planifica una operación
de aprobación una vez creado el pedido

WCS funciona mejor si APPROVEFLAG se establece en 2. Cuando APPROVEFLAG se establece en 1, el 
mandato DoPayment de WCS se bloquea hasta que Payment Manager finaliza la aprobación del pedido. 
Hasta que no finaliza la aprobación, los mandatos que deseen leer/actualizar los mismos 
registros de inventario modificados por el mandato DoPayment permanecerán bloqueados. Esto
afectará el rendimiento del resto de los mandatos.
-->
<Parameter name="APPROVEFLAG"><CharacterText>2</CharacterText></Parameter>

<!-- El importe que debe utilizarse cuando se aprueba un pedido. Generalmente,
será igual al importe del pedido. Este campo es necesario
si el parámetro APPROVEFLAG se establece en 1 ó 2. -->
<Parameter name="PAYMENTAMOUNT"><CharacterText>{approval_amount}</CharacterText></Parameter>

<!-- El número de pago que se ha de utilizar al aprobar un pedido.
Generalmente será 1. Este campo es obligatorio si APPROVEFLAG
se establece en 1 ó 2. -->
<Parameter name="PAYMENTNUMBER"><CharacterText>1</CharacterText></Parameter>

<!-- Indica si el depósito debe intentarse automáticamente. 
Este distintivo sólo es válido si APPROVEFLAG se establece en 1 ó 2.
Los valores soportados son:
0 - Los fondos no deben depositarse automáticamente. 
1 - Los fondos deben depositarse automáticamente. 
El valor por omisión es 0.
-->
<Parameter name="DEPOSITFLAG"><CharacterText></CharacterText></Parameter>

<!-- ==================================================================
Parámetros opcionales para Payment Manager
================================================================== -->

<!-- Los dos parámetros siguientes son opcionales. Puede utilizarse cualquiera de 
los dos para pasar el número de orden de compra del comprador a Payment Manager. El 
primer parámetro sólo acepta texto ASCII. Si los números de orden de compra de su 
sistema pueden contener series no ASCII, utilice entonces el parámetro ORDERDATA2. 
-->
<Parameter name="TRANSACTIONID" maxBytes="128" encoding="ASCII"><CharacterText>{PONumber}</CharacterText></Parameter>
<Parameter name="ORDERDATA2"><CharacterText></CharacterText></Parameter>

<!-- ==================================================================
Los parámetros que necesita el casete
================================================================== -->
<!-- El número de cuenta corriente -->
<Parameter name="$CHECKINGACCOUNTNUMBER"><CharacterText>{checkingAccountNumber}</CharacterText></Parameter>

<!-- El número de identificación del banco -->
<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>

<!-- El casete sólo acepta los Códigos de estado de EE.UU. de 2 caracteres en mayúsculas (por 
ejemplo, AL para Alabama, AK para Alaska, etc.) La clase BankServACHCashierExtension se utiliza 
para localizar el código de estado de 2 caracteres en la tabla STATEPROV de WebSphere Commerce
utilizando el valor especificado en la variable de entorno {billto_state} como el Nombre del
estado. La clase CashierExtension devuelve nulo si no se encuentra ningún código de estado para 
el nombre de estado especificado. Por motivos de compatibilidad, la clase CashierExtension 
devuelve el valor de la variable de entorno {billto_state} como el código de estado si el valor 
tiene una longitud de dos caracteres.
-->
<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>

<!-- ==================================================================
Parámetros opcionales para el casete 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">
<!-- ==================================================================
Los parámetros que necesita Payment Manager para el mandato 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>

Este perfil, WC51_BankServACH.profile, puede encontrarlo en:
unidad:\WebSphere\CommerceServer\instances\nombre_instancia\xml\payment\
unidad:\Archivos de programa\WebSphere\CommerceServer\instances\nombre_instancia\xml\payment\
/usr/WebSphere/CommerceServer/instances/nombre_instancia/xml/payment/
/opt/WebSphere/CommerceServer/instances/nombre_instancia/xml/payment/
vía de acceso raíz de instancia/xml/payment/

donde vía de acceso raíz de instancia es la vía de acceso que ha especificado en el campo Vía de acceso raíz de la instancia del panel Instancia del Gestor de configuración durante la creación de la instancia. La vía de acceso por omisión es /QIBM/UserData/WebCommerce/instances/nombre_instancia/.

El parámetro PAYMENTTYPE especifica el nombre del casete de este perfil.

WebSphere Commerce no utiliza el elemento <BuyPageInformation> del perfil de cajero. Se proporciona una función equiparable con la propiedad attrPageName de la política de pago.

Este perfil de cajero utiliza la clase BankServACHCashierExtension para obtener el código de estado de 2 caracteres para el parámetro obligatorio $STATEPROVINCE. Esta clase busca el código de estado en la tabla STATEPROV utilizando el valor especificado en la variable de entorno {billto_state} como el nombre de estado. La clase devuelve nulo si no se puede encontrar un código de estado para el nombre de estado especificado. Por motivos de compatibilidad, la clase CashierExtension devuelve el valor de la variable de entorno {billto_state} como el código de estado, si el valor tiene una longitud de dos caracteres.

La variable de entorno {billto_state} y las otras variables de entorno {billto_*} son algunas de las parejas nombre-valor que se pasan al Cajero como parámetros para la llamada collectPayment del Cajero. Los valores para estas variables se obtienen de las columnas correspondientes de la tabla ADDRESS.

Alternativamente, podría utilizar un valor de base de datos (DatabaseValue) para el parámetro $STATEPROVINCE si sabe que la columna STATE de su tabla ADDRESS sólo contendrá nombres de estado válidos como valores. Para utilizar el valor de base de datos, consulte las siguientes instrucciones.

Para obtener más información sobre los parámetros que necesita el Casete para BankServACH, consulte la publicación IBM WebSphere Payment Manager for Multiplatforms, Cassette for BankServACH Supplement, Version 3.1 .

Conceptos relacionados (1275 bytes)

Conceptos relacionados (1275 bytes)

IBM copyright