HSBC Secure Epayments

Secure ePayments
Manual de Producto
The worlds local bank
Bienvenido a Secure ePayments

Secure ePayments, servicio provisto por HSBC en forma exclusiva en el mercado
bancario, es un servicio que permite autorizar en forma On-line operaciones de compra
y/o pago con tarjetas de crdito sobre el/los producto/s y/o servicio/s que se ofrezcan a
travs de un sitio en Internet, en forma totalmente segura y en tiempo real.
Este sistema es el equivalente a las terminales que se utilizan en un negocio fsico para
procesar las tarjetas de crdito, transmitiendo sus datos, para luego realizar la
verificacin y el pago.
En que plataformas puedo Implementar Secure ePayments?
Secure ePayments es un servicio orientado a empresas y se adapta perfectamente a
cada plataforma en al que operan (Windows, Linux, etc.) brindando informacin precisa
para los niveles gerenciales, administrativos, operativos y sistemas.
La interfaz de Secure ePayments es amigable, el orden de la informacin es lgica,
matiene standars intenacionales que favorecen el uso intuitivo del servicio.
Es realmente muy fcil implementarlo en su sitio web.
1. Nuestro sitio www.epayments.hsbc.com.ar

El sitio de Secure ePayments cuenta con informacin institucional y principalmente es el
acceso al administrador, para dar de alta el servicio, administrar las ventas y realizar
cambios que la empresa adherida necesite.
Como doy de alta el servicio?

Este botn, permite registrarse para conocer el
servicio y ser contactado o simplemente para
registrarse y empezar a realizar el alta definitiva del
servicio.
Una vez que tenga el alta puede realizar todo tipo

de operaciones: consultas, reportes, modificaiones,
configuraciones, conciliaciones, etc.
2. Alta del servicio

Para dar de alta el servicio, se debe acceder al sitio de Secure ePayments y all ingresar
en la seccin Conozca Secure ePayments On Line o directamente en la url de ingreso
de datos https://www.epayments.hsbc.com.ar/Public/Ssl/RegisterMerchant.aspx,
completando el formulario en todos sus campos correspndientes1.
El Id deber tener un mnimo de 7 digitos, pudiendo ser alfanumericos.

La Contrasea deber tener un mnimo de 8 digitos, pudiendo ser alfanumericos,
pero no debe poseer suceciones lgicas (por ejemplo: 111, 1234, AAA, etc.).
Una vez completado correctamente el formulario, un ejecutivo de cuentas se contactara

con usted a fin de comenzar la implementacion y configuracion del servicio, una vez
aprobada su peticion.
El registro y alta del usuario es a la vez, el alta de un grupo de administrador (ver Grupo de
administdor)
3. Implementacion del servicio

La implementacin tecnolgica es muy sencilla y es soportado por cualquier tipo de
plataforma en la que opere su empresa (por ejemplo: Linux, Wndows, etc.).
El proceso de Implementacion entre un sitio y Secure ePayments, varia de acuerdo al
proceso de intercambio de informacion elegido por su empresa y se realiza utilizando el
mtodo POST del protocolo http como transporte.
Los tipos de intercambio son:
a) Formulario con campos Hidden
Si lo que desea es implementar un sistema en forma rpida, agl y muy econmico, sta
es la opcin correcta.
Solo debe pegar el cdigo HTML en el lugar que desee, dentro de su pagina web,
interconectando ese cdigo, con su carrito de compra, formulario de pedido, etc.
Esta interconexin entre su sitio y el formulario Hidden de Secure ePayments, lograr
enviar los datos necesarios de la compra para que se pueda efectuar el pago.
b) Estructuras de lenguaje XML
Este mecanismo basado en el intercambio de mensajes sobre estructuras XML , pero
implica un procedimiento mucho ms robusto a la hora de implementar el servicio.
Para ello, las estructuras debern ser encriptadas tanto por el comercio adherido como
por Secure ePayments, utilizando un algoritmo de encriptacin simtrico.
Cada empresa tendr asigando un cdigo identificacin el cual es asociado a la clave
utilizada por el algoritmo de encriptacin. Cuando la empresa realiza una transaccin con
Secure ePayments, enva como parmetros del POST el documento XML encriptado y su
shop_id.
A partir del shop_id, Secure ePayments identifica al comercio y obtiene su clave
correspondiente para desencriptar el documento XML.
La encriptacin se realiza con una API provista por Secure ePayments, y posee como
caracterstica que el cdigo encriptado se genera en cdigos ASCII representables. Esta
API es distribuida en varias versiones, una para plataforma WinNT (en formato COM),
para la plataforma Linux y otra para .NET.
4. Alta del sitio web

Ya registrada la empresa y elegido el metodo de intermabio, podemos comenzar a
configurar el servicio dentro de Secure ePayments.
Debera ingresar a www.epayments.hsbc.com.ar , (aqu de ahora adelante debera
ingresar para consultar sus transacciones, realizar modificaciones en la parametria,
creacion de nuevos sitios, medios de pago, etc.) para acceder se solicitara el nombre de
usuario y contrasea(Ver Fig. siguiente) estos fueron elegidos por usted en el momento
de la registracion.
Una vez logueado se encuentra en el MENU PRINCIPAL
Debemos dar de alta el/los sitios relacionados2 con la empresa o comercio adherido.
Ingresando desde el menu principal en SITIOS, podra crear el/los sitio que
transaccionara, para lo cual debera clickear el boton NUEVO.
Dependiendo del esquema contratado una empresa o comercio puede tener uno o ms sitios, por ejemplo:
esquema Multicomercio (ver Multicomercio)
Nota: el comercio ya fue dado de alta automaticamente en el proceso de registracin de

usuario y lleva el nombre descripto en Nombre del Comercio. Adems ser el nombre
del Grupo administrador.
Una vez ingresado se pedira que complete codigo, descripcion y e e-mail.
El cdigo ser el identificador por parte de la empresa y servir a Secure ePayments

para identificar en todo el procedimiento de intercambio de mensajes.SHOPCODE
La descripcin es para poder identificar varios sitios del mismo comercio por
ejemplo: en el caso de sucursales SUC001, ALMAGRO, etc.
El email es la casilla de correo en donde Secure ePayments enviar toda clase de
notificaciones.
Una vez cargado el SITIO, el personal de Secure ePayments dar el alta a
esta peticin. Hasta tanto no figure la misma aparecer el icono fuera de
lnea.
Luego de confirmada la carga, el personal de Secure ePayments pasar a
el nuevo sitio al estado de PRUEBAS.
A partir de ahora solo resta dar de alta los correspondientes MEDIOS DE COBRO con los
nmeros de comercio o establecimiento y terminal provistas por las tarjetas de credito,
con el objetivo de probar el sistema correctamente
5. Medios de Cobro
Definimos Medios de Cobro a las tarjetas que se utilizaran en el/los SITIO/S.
correspondiente/s a un COMERCIO.
El alta se realiza desde el MENU PRINCIPAL en la opcin COMERCIOS.

Luego desde el cono TARJETAS de credito.
Debera ahora seleccionar el comercio al cual queire aplicar este medio de cobro, para
ello, se deplegara un listado de los comercios disponibles (En el caso que huebiese
cargado mas de uno).
Una vez elegido dicho comercio simplemente puede empezar a cargar los datos del
formulario.
El cdigo de comercio, es el nmero de comercio en el caso de Mastercard y

Amex., y nro. de establecimiento para Visa. Los mismos, son generados por la
administradora a travs de la adhesin realizada por personal HSBC.
El cdigo de terminal, nmero asociado al nmero de comercio.
Una vez cargado el primer medio de cobro, quedar en fuera de linea hasta que
personal de Secure ePayments confirme que los datos ingresados por el comercio
sean los correctos.
Igualemente puede esperar la aceptacin, cargar uno nuevo o simplemente modificar lo

ingresado.
Por cada cargao modificacion debera solicitar, el cambio de estado, para poner operativo
el medio de pago.
Descripcion de Iconos:
Esperando la aceptacin de Secure ePayments.
Confirmado, activo.
Modificar los datos del medio de cobro.
Historial de cambios de estado del medio de cobro.
Una vez aprobada la peticin del medio de cobro, el COMERCIO estar listo para
asociarlo al SITIO en donde utilizaremos este medio de pago.
Para ello debera volver al MENU PRINCIPAL, seleccionar SITIOS, luego el icono
TARJETAS, alli visualizara el icono de las marcas de tarjeta que cargo con un signo de
suma sobre ella, si lo oprime y confima esta peticion el SITIO ya tiene dicho medio de
cobro asociado.
Ideas y usos 1
El sistema preve el funcionameinto de multiple variantes para la utilizacuin de Secure
ePayments
Es decir, pueden coexistir en un mismo comercio, varios sitios con iguales medios de
cobro, como as tambien un comercio con varios sitios con diferentes medios de cobro
para cada sitio y otras combinaciones.
Ejemplo 1:
Tushop tiene varias sucursales pero la empresa que factura y administra las
operaciones es la misma, pero al solo efecto de administrar lo que vende cada sucursal
tiene dos sitios diferentes pero administrados en una nica cuenta, con sus
correspondientes nros. Iguales de comercio:
COMERCIO
Tushop S.A.
SITIOS
TushopSUC1.com
TushopSUC2.com
TushopSUC1.com
TushopSUC2.com
Medios de Cobro
N Comercio
Visa
00133333
MasterCard
99001333
Ejemplo 2:
Puede darse que la misma empresa tenga por cada sucursal diferentes nros. de
comercio y/o terminal, por lo que el ejemplo quedara as:
COMERCIO
Tushop S.A.
SITIOS
TushopSUC1.com
TushopSUC1.com
TushopSUC2.com
TushopSUC2.com
Medios de Cobro
Visa
MasterCard
Visa
MasterCard
N Comercio
00133333
99001333
00144444
99001444
6. Grupos de Administracin
Una vez dado el alta del sitio en Secure ePayments como explica en el punto 2. Alta del
servicio, usted habr creado un grupo de administracin.
Qu es un grupo de administracin?
Se denomina Grupo de Administracin, a la/las personas que tienen acceso al a la
administracion de Secure ePayments, pudiendo segn su perfil, parametrizar
tcnicamente al comercio, realizar captura, anulacin, consultas sobre las
transacciones, etc.
Qu perfiles pueden tener los administradores?
Segn las necesidades de la empresa, puede dar de alta distintos niveles de usuarios
segn la tarea y/o la responsabilidad que tiene sobre las transacciones y parametria del
comercio o sitio.
ADMINISTRADOR GENERAL
Este perfil es creado por Secure ePayments en el momento que se da el alta al sitio.
Es el perfil para el responsable del comercio (Dueo, Gerente Gral., Gerente Comercial,
etc.)
Permisos: Tiene acceso a todas las funciones del sitio Administrador.
Restricciones: No tiene.
OPERADOR
Este perfil, permite realizar todas las operaciones que requiere el comercio en cuanto a
las transacciones. Es el perfil del personal administrativo.
Permisos: El operador puede, consultar, capturar, anular transacciones, como as
tambin exportar listados de transacciones, listados de conciliacin. Restricciones:
Restricciones: El operador no puede, consultar ni modificar la parametria del comercio o
sitio, no puede modificar, dar de alta o baja medios de cobro, ni usuarios.
CONFIGURADOR
Este perfil permite realizar las modificaciones en cuanto a la parametria tcnica del
comercio. Es el perfil de un webmaster.
Permisos: El Configurador puede
Restricciones:
SOLO CONSULTAS
Este perfil permite realizar las consultas de las ordenes y sus estados. Es el perfil para
un consultor externo, un controller o un empleado administrativo que realice
conciliaciones.
Permisos: Solo podr ver transacciones en sus distintos estados y listados de
conciliaciones
Restricciones: No podr realizar ninguna operacin de cambios de estado de las
transacciones, ni vera parametria del comercio.
Cmo doy de alta un usuario?

(Esta atribucin solo la posee el Administrador general del Comercio)
En www.epayments.hsbc.com.ar y luego de loguearse y desde el MENU PRINCIPAL
deber clickear el botn usuarios, le permitir acceder al formulario para la creacin de
un nuevo usuario dentro del grupo de administracin, para lo cual deber elegir el perfil
que le otorgara a dicho usuario deber colocar un nombre de usuario y una contrasea,
esta ultima dos veces para realizar la verificacin, a continuacin deber oprimir el botn
Aceptar, y ya a creado un nuevo usuario.
Cmo consulto los usuarios que estn vigentes?

En www.epayments.hsbc.com.ar y luego de loguearse deber clickear el botn usuarios,
esto le permitir acceder al formulario para la Consulta de usuarios existentes dentro del
grupo de administracin, all podr visualizar la lista de usuarios y el perfil
correspondiente a los mismos.
Cmo doy de baja un usuario?

En www.epayments.hsbc.com.ar y luego de loguearse debera clickear el botn usuarios,
(Fig.1) esto le permitir acceder al formulario para realizar la baja de un usuario dentro
del grupo de administracin, (Fig.4) para lo cual deber seleccionar el nombre del
usuario que desea eliminar y oprimir el boton Eliminar (Fig.5)
Cmo blanqueo o reseteo la password de un usuario?
Es posible, pero no lo puede realizar desde el administrador, solo podr pedir por correo
a su ejecutivo de cuentas o al Call Centre.
Si tengo mas de un comercio puedo tener el mismo usuario en ambos?
Si, es posible, pero no lo puede realizar desde el administrador, solo podr pedir la
vinculacin de uno o ms usuarios a los distintos grupos de administracin que posea
por correo a su ejecutivo de cuentas o al Call Centre.
Si tengo mas de un sitio puedo tener el mismo usuario en ambos?
Si, es posible, pero no lo puede realizar desde el administrador, solo podr pedir la
vinculacin de uno o ms usuarios a los distintos sitios que posea por correo a su
ejecutivo de cuentas o al Call Centre.
Multicomercio
El servicio Secure ePayments preve la existencia de diferentes formatos de negocios de
las empresas adheridas.
Para dar solucion a estas empresas se creo el concepto de multicomercio,, este
servicio contituye una verdadera herramienta para las emrpesas que tienen la
administracin total de los sitios de la cadena de distribucin de productos/servicios,
franquicias o simplemente empresas que de alguna manera se realacionan a la
empresa madre o mancomunadora.
El concepto general es el de shopping, donde un administrador o comercio dispone de
la cantidad de sitios que desee, propios o tercerizados por otras empresas para su
administracion.
7. Parametria del SITIO

Ultimo paso tecnico antes de comernzar a operar, debera parametrizar el comercio
ingresando desde el MENU PRINCIPAL a SITIOS y desde alli ingresar en el icono de
parametria.
(Si, posee mas de un sitio debera ingresar a la parametria del que necesite actualizar,
modificar o crear)
Una vez elegido dicho SITIO simplemente puede empezar a cargar los datos del
formulario.
Campos obligatorios:
Version de formato: en este caso se establece la forma de comunicacin elegida
anteriormente Formulario con campos Hidden o XML de compatibilidad con PU 3.0
Clave de encriptacion (solo para version 3.0 XML): consta de 48 caracteres

alfabeticos que seran necesarios para la encriptacion en el posteo de datos hacia
Secure ePayments y para la recepcion de los mensajes hacia el sitio. En el manual
implementacion tecnica con XML se describe la funcion para programadores.
Respuesta online de xito / Error: Se deberan cargar dos URLs para las respuestas
enviadas desde Secure ePayments una con xito y otra para cuando la respuesta es
error.
Segn el formato de comunicacin Secure ePayments enviara un mensaje que se
describe a continuacion.
Campos que se informan en la respuesta online de exito - Formato 'Formulario con
campos Hidden'
OrderId
OrderCode
Quotas
MessageDescrip
TransferMethodType
UserDocId
UserDocNumber
UserFirstName
UserLastName
Campos que se informan en la respuesta online de error - Formato 'Formulario con
campos Hidden'
ErrorId
ErrorDescrip
OrderCode
Ademas es la URL que visualizara el cliente cuando desde Secure ePayments retorne a
su pagina.
Nota: Las URLs deberan estar cargadas con el prefijo http:// o https:// segn
corresponda.
Campos de decisin comercial:

Estos campos no son obligatorios pero parametrizarlos lo ayudaran con la
administracion y la comunicacin con su cliente:
Desea enviar un mail al comprador notificando la recepcion del carrito?
Este check box si esta tildado realiza el envio via e-mail de un link con la informacion
para que el comprador pueda retornar una compra fallida.
Desea utilizar Captura Automtica?

Este check box si esta tildada CAPTURARA todas las transacciones que autoricen las
marcas de tarjetas en forma automatica. Para utilizar este tambin deber estar
parametrizado en el formulario posteado.
Tiempo para Capt. Automtica en minutos (5 a 1440): En el box podra colocar cual
es el retardo expresado en minutos para que se realice la CAPTURA automatica.
Utiliza Not. Asincrnica?

En este caso debera elegir si desea recibir la notificacion de la transaccion a una URL o
e-mail, prefijados, en tiempo real cuando se autoriza la transaccion, de esta manera se
estaria informando antes que el comprador.
Direccin url: Debera ingresar la direccion URL con http//: donde desea recibir la
informacion.
Versin de formato: Debera elegir el mismo formato que los anterios en envio de la
informacion.
Notificacion asincronica por e-mail
Desea que le enviemos las notificaciones?
Se le enviara la notificacion a la casilla que elija.
Desea enviar un e-mail al Comprador por cada autorizacin?
Si tilda este check box se le enviara un e-mail al comprador indicando la autorizacion y
el importe de la misma.
Desea mostrar el ticket de pago en cada autorizacin?

Si tilda este check box el cliente luego de una transaccion exitosa vera el ticket que se
adjunta en la imagen a continuacion durante 15 segundos antes de dirigirlo a la Url de
respuesta OK.
Administracion de ordenes de Pago

Administrar las ordenes de pago, es de vital importancia para su empresa, por ello este
capitulo esta dedicado enteramente a la comprension total de la utilizacion y poder
extraer el mejor resultado para su empresa.
Desde el MENU PRINCIPAL, luego de loguaerse, debera ingresar por ORDENES,

desde alli podra consultar el historial de transacciones o filtrar las ordenes con distintos
criterios, utilizando el siguiente menu, clickeando en la opcion que desee.
Comercio: Filtro utilizado cuando posee mas de un comercio o sitio.

Medio de Pago: Podra listar las ordenes que se realizaron segn la marca de tarjeta
que se utilizo.
Fecha: Es el filtro mas utilizado, lista un periodo entre dos fechas con dia, mes y ao.
Orden: Da la posibilidad de listar una orden ingresando su numero.
Estado: Lista las ordenes segn su estado, capturadas, ingresadas, etc.
Usuario: Lista las ordenes de un mismo usuario ingresando el numero de su
documento.
Estado del Medio de Pago: Este criterio generara un listado filtrando por el estado de
la segunda validacion de la tarjeta.
Filtros convinados: Tiene la posibilidad de establecer varios filtros, para una misma
busqueda.
Una vez establecido el criterio de busqueda se listaran las ordenes, se visualizara el
listados de las ordenes solicitadas, obteniendo la siguiente informacion:.
Autorizacion: Fecha dia/mes/ao de la transaccion.

Orden: Es el codigo que le asigno el comercio a la orden ordercode.
Importe: Muestra el valor cobrado al cliente.
Med. De pago: Marca de la tarjeta que utilizo el cliente.
Sitio: Nombre del sitio donde se realizo el pago.

Comercio: Nombre del comercio donde se realizo el pago.
Est. Orden: Con 5 iconos identificatorios muestra el estado que tiene una orden. (Ver
estados de la orden).
Doc.: Tipo y Numero de documento del cliente.
Nombre Apellido: Solicitado por SeP en el momento del pago.
Domicilio: Declarado en SeP, como domicilio de recepcion de resumen de tarjeta.
Estado Tarjeta: Resultado de la segunda validacion (off-line) de la tarjeta, tiene 4
estados posibles:
Validada: Se corroboraron los datos en forma sactifactoria.

Erronea: No se corroboraron los datos en forma sactifactoria.
Extranjera: Tarjeta emitida en el exterior, no se realiza validacion alfabetica.
Pendiente: Esta en proceso de segunda validacion.
Nota: En la segunda validacion se corroboran los datos alfabeticos del cliente, direccion
de recepcion del resumen, Nombre y Apellido, este dato no determina la compra sino
que es un dato para que el comercio tome la eleccion de seguir adelante con la venta o
anular la transaccion.
Seleccionar: Elige transacciones para exportarlas.
Capturar: Selecciona los pagos que acepta y comienza el proceso de pago.
Iconos:
Da un resumen de la orden.
Historial de estados por los que paso una orden.
Aviso de las notificaciones asincronicas enviadas.
Da un resumen de la orden
Estados de la orden
Las ordenes tienen distintos estados:
Ingresada : Es el estado que recibe una transaccion en cuanto es recibido los datos
desde el comercio.
Autorizada: Luego de viajar los datos a la marca de tarjetas y ser verificada, si es
exitosa dicha verificacion recibe este estado, la orden podra tener el estado capturada
hasta quince dias, luego el estado sera expirada y no se podra realizar la captura.
Capturada: Es el estado que recibe una orden luego que recibio el OK desde el
comercio a ese OK lo denominamos CAPTURA, una captura genera que comience el
proceso de pago, solo se pueden capturar ordenes autorizadas.
Nota: Existe la posibilidad de realizar capturas automaticas ( ver parametria del sitio)
Anulada: Este estado es el que recibe una orden cuando el comercio realiza la
devolucion del dinero a un usuario.
Expirada: Es el estado que recibe una orden cuando se excedio el tiempo (15 Dias) de
captura o cuando es rechazada por la marca de tarjetas.
Exportar un listado de ordenes
Para exportar un listado, debera seleccionar las ordenes a exportar tildando el checkbox
para tal fin.
Luego oprimir el boton exportar, podra elegir el formato ASCII o Excel, se dara la opcion
de guardar el archivo que desee.
La informacion sera iquivalente a la que esta visualizando en el administrador, salvo los
iconos, estos pasaran a tener una leyenda alfabetica y se podra visualizar en este caso
tambien el numero de LOTE que integra una orden.
Captura y cierre de Lotes:

Ya se describio brevemente este proceso, en parrafo anterior, vale aclarar igualmente
porque una orden debe ser capturada y que es un cierre de lote.
Cuando un usuario realiza un pago, se genera una reserva del limite de compra o
credito de esa tarjeta a favor de una empresa/comercio, la tarea continua cuando el
comercio acepta ese dinero comprometiendose a entregar el producto o brindar el
servicio.
El tiempo para aceptar una transaccion es de 15 dias corridos como se menciono
anteriormente.
A esta aceptacion por parte del comercio es lo que tecnicamente llamammos captura.
Esta la posibilidad que esta captura se realice automaticamente y la posibilidad de
retardar el tiempo de la captura automatica. (ver parametria del sitio).
Todas las ordenes capturadas en un mismo dia integran un lote, la marca de tarjetas
tomara un lote como venta diaria y pagara el total de ese monto previs deducciones.
Como veo que ordenes integran un lote?
Ingresando desde el MENU PRINCIPAL en el boton Comercios, deben ingresar en el
icono identificado como una hoja como se ve en la imagen a continuacion.
Luego deberan colocar la/las fechas de los lotes que desean visualizar y la marca de
tarjeta y oprimir buscar.
Encontrara el listado de las ordenes que componen cada lote.
Implementacion tecnica (Formulario con campos Hidden)

Se adjuntan los ejemplos que debera integrar a la programacion del carrito (plataforma de
e-commerce)
Ejemplo 1:
Este formularios es el que contiene la minima cantidad de datos para poder transaccionar.
<html>
<head>
<script language="javascript">
function Submit()
{document.form1.submit();}
</script>
</head>
<body onload="Submit();">
<form action="https://www.epayments.hsbc.com.ar/Public/Ssl/Routing.aspx"
method="post" id="form1" name="form1">
<input type=hidden id="Hidden2" name="OrderCode" value=" COD0001">
<input type=hidden id="Hidden3" name="ShopCode" value="susitio">
<input type=hidden id="Hidden4" name="OrderAmount" value="40.35">
<input type=hidden id="Hidden5" name="Currency" value="ARS">
<input type=hidden id="Hidden6" name="AutomaticCapture" value="1">
<input type=hidden id="Hidden8" name="UserDocId" value="DNI">
<input type=hidden id="Hidden8" name="UserDocNumber" value="12345678">
<input type=hidden id="Hidden8" name="UserEmail" value="mbalbuena@bnl.com.ar">
<input type=hidden id="Hidden8" name="UserFirstName" value="Marcelo">
<input type=hidden id="Hidden8" name="UserLastName" value="Balbuena">
</form>
</body>
</html>
Descripcion de los campos a completar:
"OrderCode" Codigo de orden, debera ser un valor alfanumerico de hasta 16 caracteres y
nunca se debe repetir.
"ShopCode" Nombre que eligio cuando creo el SITIO.
"OrderAmount" Precio Total de la orden, decimales separados por punto.
"Currency" Tipo de moneda para Pesos valor ARS , tener en cuenta que en Argentina
desde el ao 2001 por ley solo se puede utilizar la moneda Pesos.
"AutomaticCapture" 0 para captura manual 1 para automatica
"UserDocId" Tipo de documento (ver cuadro de valores en Pag.38)
"UserDocNumber" Valor Numero de documento
"UserEmail" E-mail del cliente
"UserFirstName" Valor Nombre
"UserLastName" Valor Apellido
Ejemplo 2:
Este formularios es Full, se debera utilizar en el caso de realizar un pago en cuotas.
<html>
<head>
<script language="javascript">
function Submit()
{document.form1.submit();}
</script>
</head>
<body onload="Submit();">
<form action="https://www.epayments.hsbc.com.ar/Public/Ssl/Routing.aspx"
method="post" id="form1" name="form1">
<input type=hidden id="Hidden1" name="OrderCode" value="COD0001">
<input type=hidden id="Hidden2" name="ShopCode" value="susitio">
<input type=hidden id="Hidden3" name="OrderAmount" value="10.5">
<input type=hidden id="Hidden4" name="Currency" value="ARS">
<input type=hidden id="Hidden5" name="AutomaticCapture" value="1">
<input type=hidden id="Hidden6" name="ExpirationHours" value="1">
<input type=hidden id="Hidden7" name="PlanQuotas" value="2">
<input type=hidden id="Hidden8" name="PlanPaymentType" value="VISA">
<input type=hidden id="Hidden9" name="UserDocId" value="DNI">
<input type=hidden id="Hidden10" name="UserDocNumber" value="12345678">
<input type=hidden id="Hidden11" name="UserEmail"
value="mbalbuena@bnl.com.ar">
<input type=hidden id="Hidden12" name="UserFirstName" value="Marcelo">
<input type=hidden id="Hidden13" name="UserLastName" value="Balbuena">
<input type=hidden id="Hidden14" name="UserPhonecountry" value="054">
<input type=hidden id="Hidden15" name="UserPhoneArea" value="011">
<input type=hidden id="Hidden16" name="UserPhoneLocalNumber" value="43091111">
<input type=hidden id="Hidden17" name="UserPhoneExtension" value="1111">
<input type=hidden id="Hidden18" name="AddressStreet" value="Calle">
<input type=hidden id="Hidden19" name="AddressNumber" value="Nro23">
<input type=hidden id="Hidden20" name="AddressFloor" value="Piso 1">
<input type=hidden id="Hidden21" name="AddressCity" value="Cap.Fed.">
<input type=hidden id="Hidden22" name="AddressPostalCode" value="1234">
<input type=hidden id="Hidden23" name="AddressCountryId" value="AR">
</form>
</body>
</html>
Descripcion de cada campo adicional al ejemplo 1.

"PlanQuotas" Cantidad de cuotas valores: 2,6,9,12,18,24.
"PlanPaymentType" Marca de la tarjeta (ver cuadro de valores en Pag.38)
Lineas opcionales:
"ExpirationHours" Valor numerico en horas que transcurriran hasta que una transaccion
quede caduca.
"UserPhonecountry" Valor numerico, codigo de pais.
"UserPhoneArea" Valor numerico, codigo de ciudad.
"UserPhoneLocalNumber" Valor numerico, telefono local
"UserPhoneExtension" Valor numerico, interno o extencion
"AddressStreet" nombre de la calle
"AddressNumber" Numero de puerta
"AddressFloor" Piso
"AddressCity" Ciudad
"AddressPostalCode" Codigo Postal
"AddressCountryId" Codigo de nombre de pais. (ver cuadro de valores en Pag.33)
Implementacion tecnica (Programacion XML)

Circuito de Pagos Simplificados
Transaccin de pago
El circuito simplificado de pagos no requiere la autenticacin del usuario comprador en
Secure ePayments, esto implica que todo el proceso de pago realizado dentro de
Secure ePayments consiste en 1 slo formulario o pantalla completar por el usuario.
El funcionamiento de este circuito de pago es similar al circuito normal de pagos,
es decir, el usuario luego de haber llenado los datos propios del carrito de compra en el
sitio del comercio elije pagar con Secure ePayments y es redirijido directamente al
formulario de pago, en el cual visualizar algunos datos pre-cargados en el caso que el
sitio del comecio enve el nodo User y/o el nodo Addresses a Secure ePayments (de no
venir estos nodos en el XML quedarn en blanco en el formulario y los deber llenar el
usuario). Seguidamente el usuario confirmar el pago y ser cursada la transaccin de
compra hacia las marcas.
Cabe sealar que un comercio no puede utilizar los dos circuitos de pago (el
normal y el simplificado) simultneamente, sino que previamente a la puesta en
produccin el comercio tiene que haber informado a Secure ePayments cual de los dos
circuitos de pagos utilizar, y para el caso puntual del circuito de pagos simplificado, las
ordenes de compra enviadas por el comercio a Secure ePayments deben venir
marcadas como no entregables (Ver XPU_PayOrder.biz del Anexo 1)
Formulario de pago
Sobre sta pantalla el usuario deber seleccionar el medio de pago a utilizar, cargar los
datos necesarios (Ej. Nmero de tarjeta y cdigo de seguridad), y confirmar la compra;
evento que disparar la transaccin de pago contra los medios.
El resultado de la transaccin ser informado en un documento XML a devolver por PU
cuyos datos se especifican en la siguiente lista cuyo esquema es
XPU_RPayOrderResponse.biz (ver anexo 1):
datos de la orden de compra
ID otorgado por el comercio
ID otorgado por PU
Medio de pago utilizado
datos de los articulos
ID otorgado por el comerciante
ID otorgado por PU
DATOS DE MENSAJES DE LA TRANSACCION

Cdigo del mensaje
Descripcin del mensaje
Ensobrado de las transacciones

Todo intercambio de mensajes entre Secure ePayments y el comercio adherido, se
realizar a traves de lo que se denomina sobre.
El Sobre en si, ser otro documento XML con un formato estandar, que incluir un
cabezal para especificar la transaccin a procesar y un cuerpo en el cual incluir a el
documento XML perteneciente a dicha transaccin.
Basicamente se podra decir, que el mismo cumple con una funcionalidad similar a la de
un sobre de correo.
El uso del sobre es obligatorio, y se rechazarn todas las transacciones que no vengan
acompaadas del mismo.
En el anexo 7, se especifica el formato de dicho documento.
Anexo 1: esquemas XML
Requerimientos de los campos en los documentos XML
R: Valor requerido
O: Valor opcional. Nota: Si en el esquema el campo figura como obligatorio, el mismo
debe existir pero con un valor nulo o vaco.
C: Valor condicional Requerido o no de acuerdo al valor de otros campos.
XPU_PayOrder.biz
<XPU_PayOrder>
<Order>
<Id>89900594</Id>
<CurrencyId>ARS</CurrencyId>
<SubTotal>500</SubTotal>
<Shipping>0</Shipping>
<Discount>0</Discount>
<Taxes>0</Taxes>
<Total>500</Total>
<Deliverable>1</Deliverable>
<OneShipment>1</OneShipment>
<DeliveryDate/>
<ShipToMultAddresses>1</ShipToMultAddresses>
<AddressId/>
<ReceiverId/>
<AvailableDays/>
<ExpirationHours>1</ExpirationHours>
<AllowAutomaticCapture>1</AllowAutomaticCapture>
<Items>
<Item Id="PS" Descrip="Discman Sonyo" Units="1" Price="200"
UnitPrice="200" DeliveryDate="2001-09-09" AddressId="1" ReceiverId="1"
AvailableDays="4444444"/>
<Item Id="CBT" Descrip="PleyStation" Units="1" Price="300"
UnitPrice="300" DeliveryDate="2001-09-09" AddressId="1" ReceiverId="1"
AvailableDays="4444444"/>
</Items>
<Plans>
<Plan PaymentId="VISA" CurrencyId="ARS" BankCode="001"
QuotasFrom="6" QuotasTo="6" FinancialRate="4" QuotaValue="" IsDefault="1"
PreferentialOrder="1"/>
</Plans>
</Order>
<Addresses>
<Address>
<AddressId>1</AddressId>
<Street>Alberdi</Street>
<No>141</No>
<Level/>
<Division/>
<CountryId>AR</CountryId>
<StateId>AR_CF</StateId>
<StateDescrip/>
<City>BsAs</City>
<PhoneNo>4444-5555</PhoneNo>
<PostalCode>1426</PostalCode>
<Comment>Nada</Comment>
<AddressNick>Mi Casa</AddressNick>
</Address>
</Addresses>
<Receivers>
<Receiver>
<Id>1</Id>
<DocId>DNI</DocId>
<DocNo>21477998</DocNo>
<FirstName>Ernesto</FirstName>
<LastName>Garca</LastName>
<ReferenceTitle>Sr</ReferenceTitle>
</Receiver>
</Receivers>
<User>
<FirstName>Aroldo</FirstName>
<LastName>Pisanno</LastName>
<DocId>PS</DocId>
<IvaId/>
<Email>aroldo@arnet.com.ar</Email>
<CourtTitleId/>
<OccupationId/>
<MobileNo>555-6666</MobileNo>
<FaxNo/>
<BirthDay>1955-11-12</BirthDay>
<AddToEmailList>0</AddToEmailList>
</User>
</XPU_PayOrder>
Ejemplo para el Circuito de Pagos Simplificado
<XPU_PayOrder>
<Order>
<Id>414349874</Id>
<CurrencyId>ARS</CurrencyId>
<SubTotal>30</SubTotal>
<Shipping>0</Shipping>
<Discount>0</Discount>
<Taxes>0</Taxes>
<Total>30</Total>
<Deliverable>0</Deliverable>
<OneShipment>1</OneShipment>
<DeliveryDate>2003-03-04</DeliveryDate>
<ShipToMultAddresses>0</ShipToMultAddresses>
<AddressId/>
<ReceiverId/>
<AvailableDays/>
<Items>
<Item Id="1" Descrip="Mesa" Units="1"
UnitPrice="20" Price="20" AddressId="" ReceiverId="" AvailableDays=""/>
<Item Id="2" Descrip="Silla" Units="1"
UnitPrice="10" Price="10" AddressId="" ReceiverId="" AvailableDays=""/>
</Items>
</Order>
<Addresses/>
<Receivers/>
<User>
<FirstName/>
<LastName/>
<DocId>PS</DocId>
<Email>aroldo@arnet.com.ar</Email>
<CourtTitleId/>
<OccupationId/>
<MobileNo/>
<FaxNo/>
<BirthDay/>
<CountryId/>
<AddToEmailList/>
</User>
</XPU_PayOrder>
Nodo/Elemento-Atributo
Order/Id
Order/CurrencyId
Order/Modify
Order/SubTotal
Order/Shipping
Order/Discount
Order/Taxes
Order/Total
Order/Deliverable
Order/OneShipment
Order/DeliveryDate
Order/ShipToMultAddresse
s
Order/AddressId
Descripcin
Largo
Cdigo nico de identificacin de la orden de 20
compra (asignado por el comercio).
Cdigo identificatorio del tipo de moneda.
(Ver anexo 2).
Valor booleano que indica si la orden de
compra es una modificacin de una anterior.
Subtotal de la orden de compra (Artculos, sin
gastos de envo, impuestos y descuentos).
Importe correspondiente a los gastos de
envo.
Importe correspondiente a los descuentos.
Importe correspondiente a los impuestos.
Total de la orden de compra (Artculos +
gastos de envo + Impuestos - descuentos).
Valor lgico que indica si la orden es
entregable o no. Su valor debe ser 0 si el
comercio opera con el Circuito Simplificado
de Pagos
Valor lgico que indica si todos los artculos
de la orden se enviarn juntos o no.
Fecha estimada de entrega.
Su valor debe ser nulo si la entrega a multiple
domicilios (ShipToMultAddresses = 1) o la
orden no es entregable (Deliverable = 0) .
Nota: La fecha de cumplir con la norma ISO
8601.
Ej: Fecha vlida: 2002-01-01
Fecha invlida: 2002-1-1
Valor lgico que indica si los artculos sern
destinados a varios domicilios o no. Si la
orden no es entregable (Deliverable = 0) su
valor debe ser 0.
Cdigo identificatorio de domicilio.
Su valor debe ser nulo si la orden se entrega
en mltiples domicilios (ShipToMultAddress =
R
R
O
R
R
R
R
R
R
R
O
Order/ReceiverId
Order/AvalableDays
Order/ExpirationHours
Order/AllowAutomaticCaptu
re
Order/Items/Item/Id
Order/Items/Item/Descrip
Order/Items/Item/Units
Order/Items/Item/Price
Order/Items/Item/UnitPrice
Order/Items/Item/DeliveryD
ate
Order/Items/Item/AddressId
Order/Items/Item/ReceiverId
1) o la orden no es entregable (Deliverable =

0).
Si la orden no se entrega a un unico
domicilio (ShipToMultAddresses = 0) , su
valor se debe corresponder al domicilio
definido en Addresses).
Cdigo identificatorio de receptor.
en mltiples domicilios
(ShipToMultAddresses = 1) o la orden nos
es entregable (Deliverable = 0).
Si la orden se entrega a un nico domicilio
(ShipToMultAddresses = 0) su valor se debe
corresponder al receptor definido en
Receivers.
Mscara utilizada para identificar los das y
horarios disponibles para la entrega por parte
del receptor (nulo si la entrega es a mltiples
domicilios o la orden no es entregable ver
anexo 3).
Cantidad de horas que la orden permanecer
activa en PU, hasta que el usuario realice el
pago de la misma. En caso de que dicho
perodo se cumpla, la orden ser cancelada
automticamente. (Nulo si la orden no expira
nunca)
Valor booleano que indica si Secure
ePauments est autorizado a realizar la
captura automtica de la orden.
Cdigo nico de identificacin del artculo
(asignado por el comercio).
Descripcin del artculo.
Cantidad de unidades.
Precio Total (Precio Unitario x Cantidad de
Unidades).
Precio Unitario.
Fecha estimada de entrega.
Se puede omitir su inclusin en el documento
si la entrega es a mltiples domicilios
(ShipToMultAddresses = 1) o la orden no es
entregable (Deliverable = 0) .
8601.
Cdigo identificatorio de domicilio.
a un unico domicilio (ShipToMultAddress = 0)
o la orden no es entregable (Deliverable = 0).
Si la orden se entrega a multiples domicilios
(ShipToMultAddresses = 1) , su valor se
debe corresponder al domicilio definido en
Addresses).
Cdigo identificatorio de receptor.
a un nico domicilio (ShipToMultAddresses =
20
255
R
R
R
R
C
Order/Items/Item/AvalaibleD
ays
Order/Plans/Plan/PaymentI
d
Order/Plans/Plan/CurrencyI
d
Order/Plans/Plan/BankCode
Order/Plans/Plan/QuotasFr
om
Order/Plans/Plan/QuotasTo
Order/Plans/Plan/Financial
Rate
Order/Plans/Plan/QuotaVal
ue
Order/Plans/Plan/IsDefault
Order/Plans/Plan/Preferenti
alOrder
User/FirstName
User/LastName
User/DocId
User/DocNo
User/IvaId
User/Email
User/CourtTitleId
User/OccupationId
User/PhoneNo
User/MobileNo
User/FaxNo
User/BirthDay
0) o la orden nos es entregable (Deliverable

= 0).
Si la orden se entrega a multiples domicilios
(ShipToMultAddresses = 1) su valor se debe
corresponder al receptor definido en
Receivers.
Mascara utilizada para identificar los das y
horarios disponibles para la entrega por parte
del receptor (nulo si la entrega es a un nico
domicilio o la orden no es entregable ver
anexo 3).
Cdigo identificatorio de tipo de tarjeta (Nulo,
si abarca todos los tipos). (Ver anexo 2).
Cdigo identificatorio de moneda (Nulo, si
abarca todas los tarjetas). (Ver anexo 2).
Cdigo identificatorio de banco (Nulo, si
abarca todos los bancos). (Ver anexo 2).
Cuotas desde la que abarca el plan.
Cuotas hasta la que abarca el plan.
Tasa de financiacin del plan.
Este valor debe indicarse en caso que
QuotasFrom sea diferente a QuotasTo. En el
caso que las cuotas sean iguales, este valor
podr indicarse como omitirse.
Nota: El comercio deber optar por enviar
este valor o lo que se indique en QuotaValue.
(Ver Anexo 6 Cdigo de Error 15281).
Valor de la cuota del plan.
Este valor solamente podr venir en caso
que QuotasFrom sea igual a QuotasTo.
Nota: El comercio deber optar por enviar
este valor o lo que se indique en
FinancialRate. (Ver Anexo 6 Cdigo de Error
15281).
Flag que indica si el plan es el que aparecer
seleccionado por default.
Valor que indica el orden en que se
mostrarn las opciones.
Nombre del usuario.
Apellido del usuario.
Cdigo de identificatorio del tipo de
documento. (Ver anexo 2).
Nmero de documento.
Cdigo identificatorio del tipo de impuesto a
los valores agregados (Ver anexo 2).
Direccin de correo electrnico del usuario.
Cdigo identificatorio del tipo de cortesa
utilizado por el usuario. (Ver anexo 2).
Cdigo identificatorio del tipo de empleo. (Ver
anexo 2) .
Nmero de telfono particular.
Nmero de telfono mvil.
Nmero de fax.
Fecha de nacimiento.
O
O
O
R
R
C
R
R
50
50
R
R
R
20
R
O
50
R
O
O
30
20
20
O
O
O
R
User/CountryId
User/AddToEmailList
Addresses/Address/Addres
sId
Addresses/Address/Street
Addresses/Address/No
Addresses/Address/Level
Addresses/Address/Division
Addresses/Address/Country
Id
Addresses/Address/StateId
Addresses/Address/StateDe
scrip
Addresses/Address/City
Addresses/Address/PhoneN
o
Addresses/Address/PostalC
ode
Addresses/Address/Comme
nt
sNick
Receivers/Receiver/Id
Receivers/Receiver/DocId
Receivers/Receiver/DocNo
Receivers/Receiver/FirstNa
me
Receivers/Receiver/LastNa
me
Receivers/Receiver/Referen
ceTitle
Order/Id
Order/PuId

8601.
Cdigo identificatorio de pas - Nacionalidad
del usuario. (Ver anexo 2).
Valor lgico que identifica si el usuario desea
recibir correo con informacin relacionada a
nuevos beneficios brindados por PU
(eventuales ofertas, nuevos comercios
adheridos al sistema, etc.).
Cdigo nico de identificacin del domicilio
Nombre de la calle.
Nmero de la calle.
Nmero de piso.
Nmero de departamento.
Cdigo identificatorio de pas. (Ver anexo 2).
Cdigo identificatorio de provincia. (Nulo, si la
provincia no figura en la tabla de provincias).
(Ver anexo 2).
Nombre de la provincia (En caso de que la
misma no figure en la tabla de provincias).
Nombre de la ciudad.
Nmero de telfono perteneciente al
domicilio.
Cdigo postal.
R
R
R
50
10
10
10
R
R
O
O
R
O
30
50
30
R
O
10
Comentarios o algn dato de inters

adicional.
Alias del domicilio, el mismo ser visualizado
en la seleccin de domicilios en el momento
de realizar una compra.
Cdigo nico de identificacin del receptor
Cdigo identificatorio del tipo de documento
(Ver anexo 2).
Nmero de documento.
Nombre del receptor.
50
50
20
50
R
R
Apellido del receptor.
50
Descripcin del ttulo de cortesa.
50
R
R
Descripcin
Cdigo nico de identificacin de la orden de compra
Cdigo nico de identificacion de la orden de compra
(asignado por PU).
Order/PaymentId
Order/Quotas
Order/ReceiverId
Order/AvalaibleDays
Order/Items/Item/Id
Order/Items/Item/PUId
Order/Items/Item/ReceiverI
d
Order/Items/Item/Avalaible
Days
Receivers/Receiver/Id
Receivers/Receiver/DocId
Receivers/Receiver/FirstNa
me
Receivers/Receiver/LastNa
me
Receivers/Receiver/Refere
nceTitle
Messages/Messge/Id
Messages/Messge/Descrip
User/FirstName
User/LastName
User/DocId
User/DocNo
Cdigo identificatorio de medio de pago. (Ver anexo 2).

Cantidad de cuotas en que se realiz el pago.
Cdigo identificatorio de receptor (nulo en caso de que la
orden se entregue en mltiples domicilios o la orden no
sea entregable. Si la misma se entregar a un nico
domicilio, su valor se debe corresponder al receptor
definido en Receivers).
Mascara utilizada para identificar los das y horarios
disponibles para la entrega por parte del receptor (nulo si
la entrega es a mltiples domicilios o la orden no es
entregable ver anexo 3).
Cdigo nico de identificacin del artculo (asignado por
el comercio).
Cdigo nico de identificacin del artculo (asignado por
PU).
Cdigo identificatorio de receptor (nulo en caso de que la
orden se entregue a un nico domicilio o la orden no sea
entregable. Si la misma fuera entregable a multiples
domicilios su valor se debe corresponder al receptor
definido en Receivers).
Mscara utilizada para identificar los das y horarios
disponibles para la entrega por parte del receptor (nulo si
la entrega es a un nico domicilio o la orden no es
entregable ver anexo 3).
Cdigo nico de identificacion del receptor (asignado por
el comercio).
Cdigo identificatorio del tipo de documento (Ver anexo
2).
Nombre del receptor.
Apellido del receptor.
Descripcin del ttulo de cortesa.
Cdigo nico de identificacin de mensaje (Asignado por
PU).
Descripcin del mensaje.
Nombre del Usuario.
Apellido del Usuario.
Tipo de Documento del Usuario.
Nmero de Documento del Usuario.
XPU_RegisterUser.biz
<?xml-stylesheet href="http://schemas.biztalk.org/BizTalk/g9boxjl2.xsl" type="text/xsl"?>
<Schema name="Untitled-schema" xmlns="urn:schemas-microsoft-com:xml-data"
xmlns:dt="urn:schemas-microsoft-com:datatypes">
<ElementType name="AddToEmailList" model="closed" content="textOnly"
dt:type="boolean"/>
<ElementType name="Address" model="open" content="eltOnly" order="seq">
<element type="AddressId" minOccurs="1" maxOccurs="1"/>
<element type="Street" minOccurs="1" maxOccurs="1"/>
<element type="No" minOccurs="1" maxOccurs="1"/>
<element type="Level" minOccurs="1" maxOccurs="1"/>
<element type="Division" minOccurs="1" maxOccurs="1"/>
<element type="PhoneNo" minOccurs="1" maxOccurs="1"/>
<element type="CountryId" minOccurs="1" maxOccurs="1"/>
<element type="StateId" minOccurs="1" maxOccurs="1"/>

<element type="StateDescrip" minOccurs="1" maxOccurs="1"/>
<element type="City" minOccurs="1" maxOccurs="1"/>
<element type="PostalCode" minOccurs="1" maxOccurs="1"/>
<element type="Comment" minOccurs="1" maxOccurs="1"/>
<element type="AddressNick" minOccurs="1" maxOccurs="1"/>
</ElementType>
<ElementType name="AddressId" model="closed" content="textOnly"
dt:type="i4"/>
<ElementType name="AddressNick" model="closed" content="textOnly"
dt:type="string"/>
<ElementType name="Addresses" model="closed" content="eltOnly"
order="seq">
<element type="Address" minOccurs="0" maxOccurs="1"/>
</ElementType>
<ElementType name="BirthDay" model="closed" content="textOnly"
dt:type="date"/>
<ElementType name="City" model="closed" content="textOnly" dt:type="string"/>
<ElementType name="Comment" model="closed" content="textOnly"
dt:type="string"/>
<ElementType name="CountryId" model="closed" content="textOnly"
dt:type="string"/>
<ElementType name="CourtTitleId" model="closed" content="textOnly"
dt:type="string"/>
<ElementType name="Division" model="closed" content="textOnly"
dt:type="string"/>
<ElementType name="DocId" model="closed" content="textOnly"
dt:type="string"/>
<ElementType name="DocNo" model="closed" content="textOnly"
dt:type="string"/>
<ElementType name="Email" model="closed" content="textOnly"
dt:type="string"/>
<ElementType name="FaxNo" model="closed" content="textOnly"
dt:type="string"/>
<ElementType name="FirstName" model="closed" content="textOnly"
dt:type="string"/>
<ElementType name="IvaId" model="closed" content="textOnly"
dt:type="string"/>
<ElementType name="LastName" model="closed" content="textOnly"
dt:type="string"/>
<ElementType name="Level" model="closed" content="textOnly"
dt:type="string"/>
<ElementType name="MobileNo" model="closed" content="textOnly"
dt:type="string"/>
<ElementType name="No" model="closed" content="textOnly" dt:type="string"/>
<ElementType name="OccupationId" model="closed" content="textOnly"
dt:type="string"/>
<ElementType name="PhoneNo" model="closed" content="textOnly"
dt:type="string"/>
<ElementType name="PmtMethodAddressId" model="closed" content="textOnly"
dt:type="i4"/>
<ElementType name="PmtMethodId" model="closed" content="textOnly"
dt:type="string"/>
<ElementType name="PostalCode" model="closed" content="textOnly"
dt:type="string"/>
<ElementType name="StateDescrip" model="closed" content="textOnly"
dt:type="string"/>
<ElementType name="StateId" model="closed" content="textOnly"

dt:type="string"/>
<ElementType name="Street" model="closed" content="textOnly"
dt:type="string"/>
<ElementType name="User" model="open" content="eltOnly" order="seq">
<element type="FirstName" minOccurs="1" maxOccurs="1"/>
<element type="LastName" minOccurs="1" maxOccurs="1"/>
<element type="DocId" minOccurs="1" maxOccurs="1"/>
<element type="DocNo" minOccurs="1" maxOccurs="1"/>
<element type="IvaId" minOccurs="1" maxOccurs="1"/>
<element type="Email" minOccurs="1" maxOccurs="1"/>
<element type="CourtTitleId" minOccurs="1" maxOccurs="1"/>
<element type="OccupationId" minOccurs="1" maxOccurs="1"/>
<element type="PhoneNo" minOccurs="1" maxOccurs="1"/>
<element type="MobileNo" minOccurs="1" maxOccurs="1"/>
<element type="FaxNo" minOccurs="1" maxOccurs="1"/>
<element type="BirthDay" minOccurs="1" maxOccurs="1"/>
<element type="CountryId" minOccurs="1" maxOccurs="1"/>
<element type="AddToEmailList" minOccurs="1" maxOccurs="1"/>
<element type="PmtMethodId" minOccurs="0" maxOccurs="1"/>
<element type="PmtMethodAddressId" minOccurs="0" maxOccurs="1"/>
</ElementType>
<ElementType name="XPU_RegisterUser" model="closed" content="eltOnly"
order="seq">
<AttributeType name="xmlns" dt:type="string"/>
<attribute type="xmlns"/>
<element type="User" minOccurs="1" maxOccurs="1"/>
<element type="Addresses" minOccurs="1" maxOccurs="1"/>
</ElementType>
</Schema>
Ejemplo
<XPU_RegisterUser>
<User>
<FirstName>Marcelo</FirstName>
<LastName>Gomez</LastName>
<DocId>DNI</DocId>
<IvaId>AR_F</IvaId>
<Email>mgomez@yahoo.com.ar</Email>
<CourtTitleId>ESP_SR</CourtTitleId>
<OccupationId>ESP_ANSIS</OccupationId>
<MobileNo>15-4555-5353</MobileNo>
<FaxNo>4323-4800</FaxNo>
<BirthDay>1977-04-17</BirthDay>
<AddToEmailList>1</AddToEmailList>
</User>
<Addresses>
<Address>
<AddressId>11134</AddressId>
<Street>Santa F</Street>
<No>2718</No>
<Level>11</Level>
<Division>D</Division>
<StateId>AR_CF</StateId>
<StateDescrip>Capital Federal</StateDescrip>
<City>Buenos Aires</City>
<PostalCode>1426</PostalCode>
<Comment>Nada</Comment>
<AddressNick>Mi casa</AddressNick>
</Address>
</Addresses>
</XPU_RegisterUser>
User/FirstName
User/LastName
User/DocID
Descripcin
Nombre del usuario.
Apellido del usuario.
Cdigo de identificatorio del tipo de
documento. (Ver anexo 2).
User/DocNo
Nmero de documento.
User/IvaId
Cdigo identificatorio del tipo de impuesto a
los valores agregados (Ver anexo 2).
User/Email
Direccin de correo electrnico del usuario.
User/CourtTitleId
Cdigo identificatorio del tipo de cortesa
utilizado por el usuario. (Ver anexo 2).
User/OccupationId
Cdigo identificatorio del tipo de empleo. (Ver
anexo 2) .
User/PhoneNo
Nmero de telfono particular.
User/MobileNo
Nmero de telfono mvil.
User/FaxNo
Nmero de fax.
User/BirthDay
Fecha de nacimiento.
8601.
User/CountryId
Cdigo identificatorio de pas - Nacionalidad
del usuario. (Ver anexo 2).
User/AddToEmailList
Valor lgico que identifica si el usuario desea
recibir correo con informacin relacionada a
nuevos beneficios brindados por PU
(eventuales ofertas, nuevos comercios
adheridos al sistema, etc.).
Addresses/Address/Addres Cdigo nico de identificacion del domicilio
sId
Addresses/Address/Street Nombre de la calle.
Addresses/Address/No
Nmero de la calle.
Addresses/Address/Level
Nmero de piso.
Addresses/Address/Divisio Nmero de departamento.
n
Addresses/Address/Countr Cdigo identificatorio de pas. (Ver anexo 2).
yId
Addresses/Address/StateId Cdigo identificatorio de provincia. (Nulo, si la
provincia no figura en la tabla de provincias).
(Ver anexo 2).
Addresses/Address/StateD Nombre de la provincia (En caso de que la
escrip
misma no figure en la tabla de provincias).
Addresses/Address/City
Nombre de la ciudad.
R
R
R
R
O
R
O
O
O
O
O
R
R
R
R
R
R
O
O
O
O
O
R
Addresses/Address/Phone
No
Addresses/Address/Postal
Code
Addresses/Address/Comm
ent
sNick
Nmero de telfono perteneciente al domicilio.
Cdigo postal.
Comentarios o algn dato de inters adicional.
Alias del domicilio, el mismo ser visualizado

en la seleccin de domicilios en el momento
de realizar una compra.
XPU_RRegisterUserResponse.biz
<?xml version="1.0" encoding="UTF-8"?>
<?xml-stylesheet href="http://schemas.biztalk.org/BizTalk/g9boxjl2.xsl" type="text/xsl"?>
<ElementType name="AuthInfo" model="closed" content="eltOnly" order="seq">
<element type="UserId" minOccurs="1" maxOccurs="1"/>
</ElementType>
<ElementType name="UserId" model="closed" content="textOnly"
dt:type="string"/>
<ElementType name="XPU_RRegisterUserResponse" model="closed"
content="eltOnly" order="seq">
<element type="AuthInfo" minOccurs="1" maxOccurs="1"/>
</ElementType>
</Schema>
Ejemplo
<XPU_RRegisterUserResponse>
<AuthInfo>
<UserId>mgomez</UserId>
</AuthInfo>
</XPU_RRegisterUserResponse>
Monedas Currencies
Cdigo
ARS
Descripcin
Pesos
Pases Countrys
Cdigo
AD
AE
AF
AG
AI
AL
AM
AN
AO
AQ
AR
AS
AT
Descripcin
Andorra
United Arab Emirates
Afganistn
Antigua And Barbuda
Anguilla
Albania
Armenia
Netherlands Antilles
Angola
Antarctica
Repblica Argentina
American Samoa
Austria
AU
AW
AZ
BA
BB
BD
BE
BF
BG
BH
BI
BJ
BM
BN
BO
BR
BS
BT
BV
BW
BY
BZ
CA
CC
CD
CF
CG
CH
CI
CK
CL
CM
CN
CO
CR
CU
CV
CX
CY
CZ
DE
DJ
DK
DM
DO
DZ
EC
EE
EG
EH
ER
ES
ET
FI
Australia
Aruba
Azerbaijan
Bosnia And Herzegovina
Barbados
Bangladesh
Belgium
Burkina Faso
Bulgaria
Bahrain
Burundi
Benin
Bermuda
Brunei Darussalam
Bolivia
Brasil
Bahamas
Bhutan
Bouvet Island
Botswana
Belarus
Belize
Canada
Cocos (Keeling) Islands
The Democratic Republic Of The Congo
Central African Republic
Congo
Switzerland
Cte D'ivoire
Cook Islands
Chile
Cameroon
China
Colombia
Costa Rica
Cuba
Cape Verde
Christmas Island
Cyprus
Czech Republic
Germany
Djibouti
Denmark
Dominica
Dominican Republic
Algeria
Ecuador
Estonia
Egypt
Western Sahara
Eritrea
Spain
Ethiopia
Finland
FJ
FK
FM
FO
FR
GA
GB
GD
GE
GF
GH
GI
GL
GM
GN
GP
GQ
GR
GS
GT
GU
GW
GY
HK
HM
HN
HR
HT
HU
ID
IE
IL
IN
IO
IQ
IR
IS
IT
JM
JO
JP
KE
KG
KH
KI
KM
KN
KP
KR
KW
KY
KZ
LA
LB
Fiji
Falkland Islands (Malvinas)
Federated States Of Micronesia
Faroe Islands
France
Gabon
United Kingdom
Grenada
Georgia
French Guiana
Ghana
Gibraltar
Greenland
Gambia
Guinea
Guadeloupe
Equatorial Guinea
Greece
South Georgia And The South Sandwich Islands
Guatemala
Guam
Guinea-Bissau
Guyana
Hong Kong
Heard Island And Mcdonald Islands
Honduras
Croatia
Haiti
Hungary
Indonesia
Ireland
Israel
India
British Indian Ocean Territory
Iraq
Islamic Republic Of Iran
Iceland
Italy
Jamaica
Jordan
Japan
Kenya
Kyrgyzstan
Cambodia
Kiribati
Comoros
Saint Kitts And Nevis
Democratic People's Republic Of Korea
Republic Of Korea
Kuwait
Cayman Islands
Kazakstan
Lao People's Democratic Republic
Lebanon
LC
LI
LK
LR
LS
LT
LU
LV
LY
MA
MC
MD
MG
MH
MK
ML
MM
MN
MO
MP
MQ
MR
MS
MT
MU
MV
MW
MX
MY
MZ
NA
NC
NE
NF
NG
NI
NL
NO
NP
NR
NU
NZ
OM
PA
PE
PF
PG
PH
PK
PL
PM
PN
PR
PS
Saint Lucia
Liechtenstein
Sri Lanka
Liberia
Lesotho
Lithuania
Luxembourg
Latvia
Libyan Arab Jamahiriya
Morocco
Monaco
Republic Of Moldova
Madagascar
Marshall Islands
The Former Yugoslav Republic Of Macedonia
Mali
Myanmar
Mongolia
Macau
Northern Mariana Islands
Martinique
Mauritania
Montserrat
Malta
Mauritius
Maldives
Malawi
Mexico
Malaysia
Mozambique
Namibia
New Caledonia
Niger
Norfolk Island
Nigeria
Nicaragua
Netherlands
Norway
Nepal
Nauru
Niue
New Zealand
Oman
Panama
Peru
French Polynesia
Papua New Guinea
Philippines
Pakistan
Poland
Saint Pierre And Miquelon
Pitcairn
Puerto Rico
Occupied Palestinian Territory
PT
PW
PY
QA
RE
RO
RU
RW
SA
SB
SC
SD
SE
SG
SH
SI
SJ
SK
SL
SM
SN
SO
SR
ST
SV
SY
SZ
TC
TD
TF
TG
TH
TJ
TK
TM
TN
TO
TP
TR
TT
TV
TW
TZ
UA
UG
UM
US
UY
UZ
VA
VC
VE
VG
VI
Portugal
Palau
Paraguay
Qatar
Runion
Romania
Russian Federation
Rwanda
Saudi Arabia
Solomon Islands
Seychelles
Sudan
Sweden
Singapore
Saint Helena
Slovenia
Svalbard And Jan Mayen
Slovakia
Sierra Leone
San Marino
Senegal
Somalia
Suriname
Sao Tome And Principe
El Salvador
Syrian Arab Republic
Swaziland
Turks And Caicos Islands
Chad
French Southern Territories
Togo
Thailand
Tajikistan
Tokelau
Turkmenistan
Tunisia
Tonga
East Timor
Turkey
Trinidad And Tobago
Tuvalu
Taiwan, Province Of China
United Republic Of Tanzania
Ukraine
Uganda
United States Minor Outlying Islands
United States
Uruguay
Uzbekistan
Holy See (Vatican City State)
Saint Vincent And The Grenadines
Venezuela
Virgin Islands, British
Virgin Islands, U.S.
VN
VU
WF
WS
YE
YT
YU
ZA
ZM
ZW
Viet Nam
Vanuatu
Wallis And Futuna
Samoa
Yemen
Mayotte
Yugoslavia
South Africa
Zambia
Zimbabwe
Tipos de documento Document Types

Cdigo
Descripcin
CIPF
CI emitida por PF
CIPP
CI emitida por PP
CUIT
CUIT
DNI
DNI
LC
LC
LE
LE
PS
Pasaporte
Tipos de medio de pago Payment Methods Types
Cdigo
Descripcin
AMEX
American Express
MASTERCARD
Mastercard
VISA
Visa
En este caso se enva un error al comercio ya que el Valor Cuota solo puede utilizarse
cuando CD = CH.
Anexo 5: Intercambio de Mensajes XML con PU

Comercio - PU
En la URL: https://www.epayments.hsbc.com.ar/public/ssl/routing.aspx se
encontrar publicada una pgina la cual recibir un documento xml y el cdigo de
comercio que envi el mismo a travs de un post de http.
Los campos que debern acompaar dicho mensaje http son los siguientes:
XML : Contendr todo el documento XML en forma encriptada. Dicho documento
representar al sobre para envio de transacciones.
AppId: Contendr el cdigo nico de aplicacin (El mismo ser entregado por PU en el
momento que el comercio pueda comenzar a transaccionar).
PU Comercio
Una vez que la transaccin haya finalizado, ya sea bien o mal, PU responder teniendo
en cuenta lo siguiente:
Si la transaccin fue exitosa, PU pondr responder segn las siguientes condiciones:
Si se solicit una registracin o pago de una orden, responder mediante un mensaje
http por post a la url de respuesta definida por el comercio para dicha transaccin.
Dichas URL se debern establecer en el momento que el comercio comience a
transaccionar contra PU y quedar cargo del comercio definir cuales sern las mismas.
Si se solicit una autenticacin, responder mediante un mensaje http por post a la url
definida en el documento XML originante de dicha transaccin.
Si la transaccin no fue exitosa, PU responder mediante un mensaje http por post a la
url de respuesta definida por el comercio para la transaccin de error. Dicha URL se
debern establecer en el momento que el comercio comience a transaccionar contra PU
y quedar cargo del comercio definir cual ser la misma.
En ambos casos, los campos que acompaaran dicho mensaje http sern los
siguientes:
XML : Contendr todo el documento XML en forma encriptada. Dicho documento
representar al sobre para envio de transacciones.
AppId: Contendr el cdigo nico de aplicacin.
Anexo 6: Cdigos de Error

Transaccin de pago de orden
Cdigo
Descripcin
15176
Error al validar el XML contra el esquema.
15179
Error al dar de alta el/los domicilio(s) de la orden de compra.
La operacin ha sido abortada.
15180
Ocurri un error inesperado al dar de alta el/los domicilio(s) de
la orden de compra. La operacin ha sido abortada.
15181
Ocurri un error inesperado al dar de alta la orden de compra.
15182
No hay concordancia entre las direcciones recibidas.
15183
Error al setear los domicilios con la orden de compra.
15185
Error al setear al receptor de la orden de compra.
15186
Error al intentar pasar de estado la orden .
15187
Error al intentar pasar de estado algn tem de la orden .
15188
Error inesperado al ejecutar el pago de la orden.
15194
Se ha producido un error al crear el documento para dar de
alta la orden de compra.
15195
alta los domicilios.
15197
Error general, consultar con el ejecutivo de cuentas.
15205
15206
15207
15208
15210
15212
15213
15244
15232
15250
15251
15254
15255
15264
15265
15266
15267
15275
15276
15277
15278
15279
15280
15281
15282
15332
15333
15334
15335
No hay concordancia entre los receptores recibidos.

alta los receptores.
Error al dar de alta el/los receptor(es) de la orden de compra.
Ocurri un error inesperado al dar de alta el/los receptor(es) de
la orden de compra. La operacin ha sido abortada.
Error al setear los receptores con la orden de compra.
Faltan la/s direccion/es de entrega.
El mtodo abreviado requiere que el comercio permita enviar a
mltiples direcciones.
Error al procesar sus datos personales
El comercio no opera bajo las condiciones especificadas
El monto de la orden de compra supera al monto mximo
permitido por Secure ePayments para usuarios que aun no
validaron su domicilio.
El monto de la orden de compra supera al monto mximo
permitido por Secure ePayments.
El error de eG-Pay no existe.
El tipo de transaccin de eG-Pay no existe.
Error al dar de alta los planes de cuotas
Los planes de cuota enviados no son vlidos
Los planes de pago son requeridos y no fueron enviados
Los datos enviados en alguno de los planes de pago no son
consistentes
Los rangos de las cuotas en alguno de los planes de pago
estn vacios.
Los valores de las cuotas deben ser mayores que cero.
El Financial Rate debe ser mayor a -100 y menor que 1000
El Financial Rate y el Quota Value en alguno de los planes de
pago estn vacios.
El valor de las Cuotas Desde debe ser menor que el de las
Cuotas Hasta.
Falta especificar el valor del Financial Rate en alguno de los
planes de pago.
No es posible enviar valores para el Financial Rate y el Quota
Value para un mismo plan de pago.
El Quota Value debe ser mayor a cero.
El nodo Total debe contener un valor numrico mayor o igual a
cero.
El nodo Taxes debe contener un valor numrico mayor o igual
a cero.
El nodo Shipping debe contener un valor numrico mayor o
igual a cero.
El nodo Discount debe contener un valor numrico mayor o
igual a cero.
Anexo 7: Sobre - Esquema XML

<ElementType name="Body" model="open" content="empty"/>
<ElementType name="Header" model="closed" content="eltOnly" order="seq">
<element type="TransactionId" minOccurs="1" maxOccurs="1"/>
</ElementType>
<ElementType name="TransactionId" model="closed" content="textOnly"
dt:type="string"/>
<ElementType name="XPU_ExternalEnvelope" model="closed"
<element type="Header" minOccurs="1" maxOccurs="1"/>
<element type="Body" minOccurs="1" maxOccurs="1"/>
</ElementType>
</Schema>
<XPU_ExternalEnvelope>
<Header>
<TransactionId>XPU_NombreTransaccion</TransactionId>
</Header>
<Body/>
</XPU_ExternalEnvelope>
Nodo/ElementoAtributo
Header/TransactionId
Body
Descripcin
Cdigo nico de identificacin de transaccin
Documento XML con la transaccin a enviar
Axexo 8: Tipos de datos utilizados por los esquemas XML

Tipo
Descripcin
I1
Entero de 1 byte. Ej: 1, 128, -127
I2
Entero de 2 bytes. Ej: 1, 703, -32768
I4
Entero de 4 bytes. Ej: 1, 703, -32768, 148343, -1000000000
Boolean
Booleano o Logico. Unicos posibles valores: 0 o 1.
String
Cadena de caracteres
Date
Fecha. Formato: aaaa-mm-dd (a: Ao, m: Mes, d: Da)
Nota: La fecha de cumplir con la norma ISO 8601.
Fixed 14.4
Nmero real de 14 digitos y 4 decimales. El separador decimal
es el signo . (punto). No acepta separador de miles
Number
Valor numerico. Acepta decimales, siendo el separador
decimal el signo . (punto). No acepta separador de miles
Anexo 9: Web Services Consulta de Ordenes
Es posible consultar informacin bsica de las rdenes asociadas al comercio en forma
automtica, mediante la invocacin del web method ExternalDispatcher.
El archivo PU_DispatcherWS Web Service.htm provisto con el paquete de integracin,
describe la especificacin y adicionalmente incluye un formulario ejemplo apuntando al
ambiente de staging.
Requerimientos de los campos en los documentos XML
R: Valor requerido
O: Valor opcional. Nota: Si en el esquema el campo figura como obligatorio, el mismo
debe existir pero con un valor nulo o vaco.
C: Valor condicional Requerido o no, de acuerdo al valor de otros campos.
WSPU_GetStoreOrders.biz
<Schema name="Untitled-schema">
<ElementType name="AVCStatus" model="closed" content="textOnly"

dt:type="string"/>
<ElementType name="AchievedStatus" model="closed" content="eltOnly"
order="seq">
<element type="Id" minOccurs="1" maxOccurs="1"/>
<element type="From" minOccurs="1" maxOccurs="1"/>
<element type="To" minOccurs="1" maxOccurs="1"/>
</ElementType>
<ElementType name="AscendingOrder" model="closed" content="textOnly"
dt:type="boolean"/>
<ElementType name="CurrentStatus" model="closed" content="eltOnly"
order="seq">
<element type="Status" minOccurs="0" maxOccurs="*"/>
</ElementType>
<ElementType name="Customer" model="closed" content="eltOnly" order="seq">
<element type="FirstName" minOccurs="1" maxOccurs="1"/>
<element type="LastName" minOccurs="1" maxOccurs="1"/>
</ElementType>
<ElementType name="ExpirationTo" model="closed" content="textOnly"
dt:type="string"/>
<ElementType name="FirstName" model="closed" content="textOnly"
dt:type="string"/>
<ElementType name="From" model="closed" content="textOnly"
dt:type="string"/>
<ElementType name="Id" model="closed" content="textOnly" dt:type="string"/>
<ElementType name="LastName" model="closed" content="textOnly"
dt:type="string"/>
<ElementType name="OrderCode" model="closed" content="textOnly"
dt:type="string"/>
<ElementType name="OrderTotal" model="closed" content="eltOnly"
order="seq">
<element type="From" minOccurs="1" maxOccurs="1"/>
<element type="To" minOccurs="1" maxOccurs="1"/>
</ElementType>
<ElementType name="Origin" model="closed" content="textOnly"
dt:type="string"/>
<ElementType name="PaymentMethod" model="closed" content="eltOnly"
order="seq">
<element type="Type" minOccurs="1" maxOccurs="1"/>
<element type="Origin" minOccurs="1" maxOccurs="1"/>
</ElementType>
<ElementType name="Status" model="closed" content="empty">
<AttributeType name="Id" required="yes"/>
<attribute type="Id"/>
</ElementType>
<ElementType name="To" model="closed" content="textOnly" dt:type="string"/>
<ElementType name="Type" model="closed" content="textOnly"
dt:type="string"/>
<ElementType name="WSPU_GetStoreOrders" model="closed"
<element type="OrderCode" minOccurs="1" maxOccurs="1"/>
<element type="CurrentStatus" minOccurs="1" maxOccurs="1"/>
<element type="AchievedStatus" minOccurs="1" maxOccurs="1"/>
<element type="PaymentMethod" minOccurs="1" maxOccurs="1"/>
<element type="ExpirationTo" minOccurs="1" maxOccurs="1"/>
<element type="AVCStatus" minOccurs="1" maxOccurs="1"/>

<element type="Customer" minOccurs="1" maxOccurs="1"/>
<element type="OrderTotal" minOccurs="1" maxOccurs="1"/>
<element type="AscendingOrder" minOccurs="1" maxOccurs="1"/>
</ElementType>
</Schema>
Ejemplo
<WSPU_GetStoreOrders>
<OrderCode>PP4556232</OrderCode>
<CurrentStatus>
<Status Id="C"/>
<Status Id="A"/>
</CurrentStatus>
<AchievedStatus>
<Id>"C"</Id>
<From>2001-12-10</From>
<To>2001-12-10</To>
</AchievedStatus>
<PaymentMethod>
<Type>VISA</Type>
<Origin>LOC</Origin>
</PaymentMethod>
<ExpirationTo>2001-10-10</ExpirationTo>
<AVCStatus>V</AVCStatus>
<Customer>
<FirstName>Pedro</FirstName>
<LastName>Gonzales</LastName>
</Customer>
<OrderTotal>
<From>100983.32</From>
<To>123432.23</To>
</OrderTotal>
<AscendingOrder>1</AscendingOrder>
</WSPU_GetStoreOrders>
OrderCode
CurrentStatus
CurrentStatus/Status
AchiedvedStatus
AchievedStatus/Id
CurrentStatus/From
CurrentStatus/To
PaymentMethod
Descripcin
Largo
Cdigo nico de identificacin de la orden de 20
compra (asignado por el comercio).
Nodo para definir el filtro por estado actual
Elemento para definir los estados por los
cuales se desea filtrar
Nodo para definir el filtro por estados
alcanzados
Id del estado por el cual deben haber pasado
las ordenes filtradas
Fecha a partir de la cual debe considerarse la
ocurrencia del status
Fecha hasta la cual debe considerarse la
ocurrencia del status
Nodo para definir el filtro por mtodo de pago
O
R
O
O
O
R
PaymentMethod/Type
PaymentMethod/Origin
ExpirationTo
AVCStatus
Customer
Customer/FirstName
Customer/LastName
OrderTotal
OrderTotal/From
OrderTotal/To
AscendingOrder
Tipo de medio de pago, segn tabla. Ej,

VISA, AMEX
Origen del medio de pago segn tabla
Fecha hasta la cual debe considerarse la
expiracin de la orden Ej.: "Todas las
ordenes que hayan expirado antes del
17/4/2002"
Estado del Address Validation Code del
usuario asociado
Nodo para definir el filtro por cliente
Nombre del usuario
Apellido del usuario
Nodo para definir el filtro por importe total de
la orden
Importe a partir del cual se debe filtrar
Importe hasta el cual se debe filtrar
Especifica si el resultado se desea en orden
ascendente (1) o descendente (0).
WSPU_GetStoreOrdersResp.biz
<ElementType name="Order" model="closed" content="empty">
<AttributeType name="OrderCode" dt:type="string" required="yes"/>
<AttributeType name="Id" dt:type="i4" required="yes"/>
<AttributeType name="CurrencyId" dt:type="string" required="yes"/>
<AttributeType name="Total" dt:type="fixed.14.4" required="yes"/>
<AttributeType name="CurrentStatus" dt:type="string" required="yes"/>
<AttributeType name="CurrentStatusTimestamp" dt:type="dateTime.tz"
required="yes"/>
<AttributeType name="BuyDate" dt:type="dateTime.tz" required="yes"/>
<AttributeType name="PaymentMethodType" dt:type="string"
required="yes"/>
<attribute type="OrderCode"/>
<attribute type="Id"/>
<attribute type="CurrencyId"/>
<attribute type="Total"/>
<attribute type="CurrentStatus"/>
<attribute type="CurrentStatusTimestamp"/>
<attribute type="BuyDate"/>
<attribute type="PaymentMethodType"/>
</ElementType>
<ElementType name="Orders" model="closed" content="eltOnly" order="seq">
<element type="Order" minOccurs="1" maxOccurs="1"/>
</ElementType>
<ElementType name="WSPU_GetStoreOrdersResp" model="closed"
<element type="Orders" minOccurs="1" maxOccurs="1"/>
</ElementType>
</Schema>
Ejemplo
<WSPU_GetStoreOrdersResp>
<Orders>
O
O
O
O
R
O
O
R
O
O
R
<Order OrderCode="jj66628783" Id="123456789" CurrencyId="ARS"

Total="10037.32" CurrentStatus="P" CurrentStatusTimestamp="2000-12-31T00:00:00"
BuyDate="2000-12-31T00:00:00" PaymentMethodType="VISA"/>
</Orders>
</WSPU_GetStoreOrdersResp>
Orders
Orders/Order
Orders/Order/OrderCode
Orders/Order/Id
Orders/Order/CurrencyId
Orders/Order/Total
Orders/Order/Taxes
Orders/Order/Shipping
Orders/Order/Discount
Orders/Order/Deliverable
Orders/Order/OneShipment
Orders/Order/DeliveryDate
Orders/Order/DeliveryAgency
Orders/Order/DeliveryTracking
Orders/Order/ClientIP
Orders/Order/CurrentStatus
Orders/Order/CurrentStatusTim
estamp
Orders/Order/BuyDate
Orders/Order/PaymentMethodT
ype
Orders/Order/UserId
Descripcin
Nodo que agrupa los elementos iterativos
"Order"
Nodo que agrupa los datos de una order
de pago.
ID de la orden asignado por el comercio.
ID de la orden asignado por PU
ID de la moneda segn tabla
Importe total de la orden
Importe de la orden correspondiente a
impuestos.
gastos de envo.
descuentos.
Especifica si se trata de un bien enviable.
Especifica si la orden debe ser
despachada en un solo envo
Fecha estimada de envio
Empresa de transportes
Especifica si el comercio realizar el
tracking de la orden.
IP desde la cual se conecto el cliente
Estado actual de la orden
Fecha y hora en el cual la orden alcanz
el estado actual
Fecha de pago.
Tipo de medio de pago utilizado por el
cliente (Ej. VISA, AMEX, etc.)
ID del usuario en Secure ePayments.
Largo
R
R
20
R
R
R
R
R
R
R
R
R
R
R
R
R
R
R
R
R
R
Anexo 10: Notificacin Asincrnica de Transaccin de Pago Exitosa

Este servicio optativo permite asegurar la recepcin en el site del comercio, de la
confirmacin del xito de una transaccin de pago en forma on-line.
El uso de este servicio es especialmente recomendado en aquellos sites que cuenten
con procesos automticos crticos, desencadenados a partir de una transaccin de pago
exitosa, es decir, cuando la consulta manual por medio del site Administrador no sea
una opcin vlida.
El servicio enviar mediante http POST el documento XML descripto por el esquema
ASPU_PostOrderSuccess.biz. El POST ser dirigido a una URL informada
especficamente para este fin por el site del comercio (ASPU_PostOrderSuccessURL).
Los envos se repetirn a intervalos fijos hasta que Secure ePayments reciba desde el
site del comercio la respuesta ASPU_PostOrderSuccessResp.
Los XMLs involucrados debern estar incluidos en el sobre externo (ver Anexo 7), y en
ningn caso estarn encriptados.
ASPU_PostOrderSuccess.biz
<ElementType name="DateTimeStatus" model="closed" content="textOnly"
dt:type="dateTime"/>
<ElementType name="Id" model="closed" content="textOnly" dt:type="string"/>
<ElementType name="Order" model="closed" content="eltOnly" order="seq">
<element type="Id" minOccurs="1" maxOccurs="1"/>
<element type="PUId" minOccurs="1" maxOccurs="1"/>
<element type="Status" minOccurs="1" maxOccurs="1"/>
<element type="DateTimeStatus" minOccurs="1" maxOccurs="1"/>
<element type="PaymentMethodType" minOccurs="1" maxOccurs="1"/>
<element type="PayString" minOccurs="1" maxOccurs="1"/>
<element type="PayName" minOccurs="1" maxOccurs="1"/>
</ElementType>
<ElementType name="PUId" model="closed" content="textOnly" dt:type="i4"/>
<ElementType name="PaymentMethodType" model="closed" content="textOnly"
dt:type="string"/>
<ElementType name="PayString" model="closed" content="textOnly"
dt:type="string"/>
<ElementType name="PayName" model="closed" content="textOnly"
dt:type="string"/>
<ElementType name="Status" model="closed" content="textOnly"
dt:type="string"/>
<ElementType name="ASPU_PostOrderSuccess" model="closed"
</ElementType>
</Schema>
Ejemplo
<ASPU_PostOrderSuccess>
<Order>
<Id>XX33096</Id>
<PUId>5456688</PUId>
<Status>Autorizada</Status>
<DateTimeStatus>2002-01-01T03:30:23</DateTimeStatus>
<PaymentMethodType>VISA</PaymentMethodType>
<PayString>5678</PayString>
<PayName>Jose Perez</PayName>
</Order>
</ASPU_PostOrderSuccess>
Order/Id
Order/PUId
Order/Status
Order/DateTimeStatus
Order/PaymentMethodType
Order/PayString
Order/PayName
Descripcin
ID de la orden asignado por el comercio.
ID de la orden asignado por Secure
ePayments.
Estado de la orden luego del intento de
pago
Fecha y hora
Descripcin del medio de pago
Ultimos 4 digitos de la tarjeta de credito
Titular de la tarjeta
Largo
20
20
R
R
R
R
R
R
R
ASPU_PostOrderSuccessResp.biz
<ElementType name="Ack" model="closed" content="textOnly"
dt:type="boolean"/>
<ElementType name="Order" model="closed" content="eltOnly" order="seq">
<element type="Ack" minOccurs="1" maxOccurs="1"/>
</ElementType>
<ElementType name="ASPU_PostOrderSuccessResp" model="closed"
</ElementType>
</Schema>
Ejemplo:
<ASPU_PostOrderSuccessResp>
<Order>
<Ack>1</Ack>
</Order>
</ASPU_PostOrderSuccessResp>
Order/Ack
Descripcin
Indica que la notificacin fue recibida por
el site del comercio, interrumpiendo los
intentos peridicos de notificacin por
parte de Secure ePayments.
Largo
1
Anexo 11: Captura automtica

Descripcin
La captura automtica de una orden se produce cuando se produce la autorizacin de
una orden. O sea, no hay una captura o confirmacin manual por parte del Comercio,
sino que se realiza en forma automtica.
Para que se realice la captura automtica deben cumplirse ciertas condiciones:
Debe haber transcurrido el tiempo de captura del comercio.
El comercio debe informar en la orden que sta es capturable automticamente.
Deben cumplirse las condiciones de captura definidas para el comercio.
Para que un comercio opere con captura automtica el campo allowAutomaticCapture
debe informarse con el valor 1 en el XML. Adems debe informarnos que desea operar
con esta modalidad.
Una vez que el usuario comprador paga la orden y el sistema autoriza el pago de la
misma, para realizar la captura automtica, el sistema realiza los siguientes pasos:
Verifica que la orden es capturable automticamente.
Verifica que transcurri tiempo de captura del comercio.
Verifica que se cumplen las condiciones de captura.
Captura la orden.
Verifica que el comercio debe recibir un mail por la captura automtica de cada orden.
Enva el mail al comercio informando la captura automtica.
Captura automtica por validacin telefnica

Descripcin
La captura automtica de una orden puede producirse cuando Customer Service valida
telefnicamente el domicilio de entrega de resumen de una tarjeta de un usuario
comprador. Esta sera una condicin adicional para validar en forma automtica.
Como con la validacin telefnica se determina si una tarjeta es nacional o extranjera, y
estas condiciones forman parte de las reglas de captura de un comercio, puede suceder
que rdenes que no fueron capturadas automticamente en el momento de su
autorizacin, ahora cumplan con todas las condiciones de captura automtica y deban
ser capturadas. Para realizarse la captura automtica deben cumplirse las siguientes
condiciones:
Debe haber transcurrido el tiempo de captura del comercio.
El comercio debe informar en la orden que sta es capturable automticamente.
Deben cumplirse las condiciones de captura definidas para el comercio.
Condiciones previas
Las ordenes son capturadas y el comercio recibe un mail por cada orden informando
que fue capturada automticamente.
Para que un comercio opere con captura automtica el campo allowAutomaticCapture
debe informarse con el valor 1 en el XML. Adems debe informarnos que desea operar
con esta modalidad.
8. Customer Service.
Ante cualquier duda o consulta, debera comunicarse a nuestro Call Center al telefono
0800-999-5050 o con su ejecutivo de cuentas, si prefiere hacerlo por e-mail escribanos
a epayments@hsbc.com.ar.

HSBC Secure Epayments

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

HSBC Secure Epayments

Uploaded by

Copyright:

Available Formats

Secure ePayments

The worlds local bank

Bienvenido a Secure ePayments

1. Nuestro sitio www.epayments.hsbc.com.ar

Como doy de alta el servicio?

Una vez que tenga el alta puede realizar todo tipo

2. Alta del servicio

El Id deber tener un mnimo de 7 digitos, pudiendo ser alfanumericos.

Una vez completado correctamente el formulario, un ejecutivo de cuentas se contactara

3. Implementacion del servicio

4. Alta del sitio web

Una vez logueado se encuentra en el MENU PRINCIPAL

Nota: el comercio ya fue dado de alta automaticamente en el proceso de registracin de

Una vez ingresado se pedira que complete codigo, descripcion y e e-mail.

El cdigo ser el identificador por parte de la empresa y servir a Secure ePayments

El alta se realiza desde el MENU PRINCIPAL en la opcin COMERCIOS.

El cdigo de comercio, es el nmero de comercio en el caso de Mastercard y

El cdigo de terminal, nmero asociado al nmero de comercio.

Igualemente puede esperar la aceptacin, cargar uno nuevo o simplemente modificar lo

Cmo doy de alta un usuario?

Cmo consulto los usuarios que estn vigentes?

Cmo doy de baja un usuario?

7. Parametria del SITIO

Clave de encriptacion (solo para version 3.0 XML): consta de 48 caracteres

Campos de decisin comercial:

Desea utilizar Captura Automtica?

Utiliza Not. Asincrnica?

Desea mostrar el ticket de pago en cada autorizacin?

Administracion de ordenes de Pago

Desde el MENU PRINCIPAL, luego de loguaerse, debera ingresar por ORDENES,

Comercio: Filtro utilizado cuando posee mas de un comercio o sitio.

Autorizacion: Fecha dia/mes/ao de la transaccion.

Sitio: Nombre del sitio donde se realizo el pago.

Validada: Se corroboraron los datos en forma sactifactoria.

Captura y cierre de Lotes:

Encontrara el listado de las ordenes que componen cada lote.

Implementacion tecnica (Formulario con campos Hidden)

Descripcion de cada campo adicional al ejemplo 1.

Implementacion tecnica (Programacion XML)

DATOS DE MENSAJES DE LA TRANSACCION

Ensobrado de las transacciones

1) o la orden no es entregable (Deliverable =

0) o la orden nos es entregable (Deliverable

Nota: La fecha de cumplir con la norma ISO

Comentarios o algn dato de inters

Apellido del receptor.

Descripcin del ttulo de cortesa.

Cdigo identificatorio de medio de pago. (Ver anexo 2).

<element type="StateId" minOccurs="1" maxOccurs="1"/>

<ElementType name="StateId" model="closed" content="textOnly"

Nmero de telfono perteneciente al domicilio.

Comentarios o algn dato de inters adicional.

Alias del domicilio, el mismo ser visualizado

Tipos de documento Document Types

Anexo 5: Intercambio de Mensajes XML con PU

Anexo 6: Cdigos de Error

No hay concordancia entre los receptores recibidos.

Anexo 7: Sobre - Esquema XML

Axexo 8: Tipos de datos utilizados por los esquemas XML

<ElementType name="AVCStatus" model="closed" content="textOnly"

<element type="AVCStatus" minOccurs="1" maxOccurs="1"/>

Tipo de medio de pago, segn tabla. Ej,

<Order OrderCode="jj66628783" Id="123456789" CurrencyId="ARS"