SPS Documentacion

Manual
de Integracin Decidir
Tabla de contenido
Sobre este Manual 0
Consideraciones 1
Requisitos para empezar a operar 2
Homologacin con First Data 3
Cierre de Lote 4
Formato del archivo de cierre de lote 4.1
Configurar Promociones Bancarias 5
BIN Heredado 5.1
Creacin de nuevos ID Sites 5.2
Cmo me integro? 6
Token de Seguridad 6.1
Flujo de una Transaccin 6.2
Pedido de Autorizacin en 1 paso 6.2.1
Requerimiento 6.2.1.1
Campos adicionales para el medio de pago Rapipago 6.2.1.1.1
Campos adicionales para el medio de Pago Fcil (Caja De Pagos)
Consideraciones para Pagomiscuentas (Banelco) 6.2.1.1.2
Consideraciones para Nevada 6.2.1.1.4 6.2.1.1.3

Consideraciones para Visa DEBITO 6.2.1.1.5
Requerimientos de VISA para comercios Agregadores. 6.2.1.1.6
Requerimientos de Mastercard para comercios agregadores.
Split de Transacciones 6.2.1.1.8 6.2.1.1.7
Split por montos fijos 6.2.1.1.8.1
Split porcentual 6.2.1.1.8.2
Ejemplo 6.2.1.1.9
Respuesta 6.2.1.2
Ejemplo 6.2.1.2.1
Pedido de Autorizacin en 2 pasos 6.2.2
Pasos 6.2.2.1
Observaciones 6.2.2.2
2
Manual de Integracin Decidir
Esquema de una Transaccin 6.2.2.3

Invocacin al Formulario 6.2.3
Formulario Custom 6.2.3.1
Requerimiento 6.2.3.1.1
Pedido de Informacin de una Transacccin 6.2.4
Ejemplo 6.2.4.1.1
Respuesta 6.2.4.2
Ejemplo 6.2.4.2.1
Ver Estado de una Transacccin 6.2.5
Validacion de datos adicionales 6.2.5.1
Ejemplo 6.2.5.2.1
Respuesta 6.2.5.3
Ejemplo 6.2.5.3.1
Realizar Anulacin 6.2.6
Ejemplo 6.2.6.1.1
Respuesta 6.2.6.2
Ejemplo 6.2.6.2.1
Realizar Devolucin 6.2.7
Realizar una Devolucin TOTAL 6.2.7.1
Ejemplo 6.2.7.1.1.1
Respuesta 6.2.7.1.2
Ejemplo 6.2.7.1.2.1
Realizar una Devolucin PARCIAL 6.2.7.2
Ejemplo 6.2.7.2.1.1
Respuesta 6.2.7.2.2
Ejemplo 6.2.7.2.2.1
Realizar una Confirmacin 6.2.8
Ejemplo 6.2.8.1.1
3
Respuesta 6.2.8.2
Ejemplo 6.2.8.2.1
Ejemplos de integracin 6.3
Pedido de Autorizacin 6.3.1
Invocacin al Formulario 6.3.2
Formulario Custom 6.3.2.1
Obtener Informacin de Respuesta 6.3.3
Ver Estado de una Transacccin 6.3.4
Devolucin 6.3.5
Devolucin Total 6.3.5.1
Devolucin Parcial 6.3.5.2
Anulacin 6.3.6
Configuraciones Adicionales 7
Mails de confirmacin 7.1
Time Out de la Compra 7.2
Servicio de Prevencin de Fraude CyberSource 8
Funcionamiento del Servicio 8.1
Datos Adicionales a Enviar 8.2
Datos Comunes a Todos los Verticales 8.2.1
Verticales 8.2.2
Travel 8.2.2.1
Retail 8.2.2.2
Ticketing 8.2.2.3
Services 8.2.2.4
Digital Goods 8.2.2.5
Implementacin del Device Fingerprint 8.2.3
Valores de los parmetros involucrados 8.2.3.1
Segmentos de Cdigo para la implementacin del DF en la pgina de
checkout 8.2.3.2
Consideraciones al momento de Implementar 8.2.3.3
Cmo verificar si est generando bien el DF? 8.2.3.4
Ejemplo de Pedido de Auorizacin con CyberSource 8.3
Cdigos de Respuesta de CyberSource 8.4
Revisin Manual de Transacciones - Notificacin de cambio de estado 8.5
4
Tablas de Referencia 9
Tabla de Medios de Pago 9.1
Cdigos de Estado de las Transacciones 9.2
Cdigos de motivos de rechazo 9.3
Cdigos de provincias para CyberSource 9.4
Soporte 10
5
Sobre este Manual

Alcance
Este documento describe los aspectos tcnicos de integracin, de aquellos comercios que
deseen procesar cobros on-line, con su propio nmero de comercio ante las distintos
medios de pago. No es un manual de uso del backoffice de la Plataforma de Decidir.
Objetivo
El manual describe los pasos a seguir y pre requisitos que un comercio debe cumplir, para
poder operar e integrar la plataforma de DECIDIR con sus sistemas de E-Commerce.
Audiencia
Este manual est destinado a los desarrolladores que deseen integrar la solucin de
procesamiento de pagos on-line y prevencin de Fraude de DECIDIR, a su plataforma de E-
Commerce, a travs de la API de DECIDIR.
La implementacin del servicio de DECIDIR, requiere conocimientos de desarrollo de

software, para poder generar cdigo que interacte con la API de DECIDIR para invocar
servicios y procesar respuestas.
Sobre este Manual 6

Consideraciones
Esta documentacin corresponde a la versin 1.1 de las APIs. Cabe mencionar que
debern utilizarse en los entornos productivos, la misma versin sobre la cual se ha
realizado el desarrollo y certificado su funcionalidad.
Para implementar esta API, no es necesario que el comercio est certificado bajo las
normas PCI.
Para ser notificados de la publicacin de nuevas versiones, le sugerimos que se suscriban

al servicio de Updates de nuevos releases.
Consideraciones 7
Requisitos para comenzar a operar

Antes de poder comenzar a integrarse y operar con Decidir, por favor considere los
siguientes pre requisitos:
Requisitos para iniciar la integracin tcnica en sandbox

1. Firmar la Solicitud de Adhesin al Servicio.
2. Completar la Planilla Tcnica de configuracin.
3. Obtener por parte de DECIDIR los usuarios para acceder al backoffice.
4. Solicitar el Token de seguridad para sandbox.
Requisitos para operar en produccin

1. Gestionar ante los distintos medios de pago, el/los nmeros de comercio con los que
desea operar.
2. Solicitar el Token de seguridad para produccin.
Requisitos para empezar a operar 8

Homologacin con FirstData

Para homologar la operatoria de las tarjetas Mastercard, Cabal y Diners, FirstData requiere
una serie de pasos adicionales.
El comercio deber enviar a DECIDIR ([email protected]) un instructivo con los pasos a

realizar en su e-commerce para realizar una compra. Estos pasos deben incluir usuario y
contrasea de ser necesario en el circuito de compras (el envo de usuario y clave slo son
requeridos para aquellos casos en los cules se requiere un acceso para que el usuario
pueda ingresar al sitio para efectuar una compra).
Cabe destacar que las pruebas a realizar por FirstData no necesariamente deben ser
efectuadas sobre el sitio definitivo del comercio, pero la pgina proporcionada debe ser lo
ms parecida a la misma.
IMPORTANTE: El proceso de homologacin puede demorar hasta 4 semanas

aproximadamente, y este tiempo no depende directamente de Decidir.
Homologacin con First Data 9

Cierre de Lote
El cierre de lote le permite al comercio hacer la presentacin ante cada Marca de las
operaciones de Compras, Anulaciones y Devoluciones realizadas para que las mismas
puedan ser liquidadas por cada medio de pago.
Los cierres de lotes de cada medio de pago pueden realizarse de 2 maneras:
1. Manual: esta modalidad es on demand. Para ello, un usuario del comercio debe
ingresar a la consola de Decidir y seleccionar el medio de pago a cerrar lote. Opcin de
men: Men --> Cerrar Lote. Para ms detalle por favor consultar el Manual de
Administracin de Decidir.
2. Automtica: Los procesos se ejecutan diariamente luego de la medianoche, y al

finalizar, se envan al comercio cada uno de los archivos del cierre de lote de cada
medio de pago habilitado.
Los resmenes correspondientes a los cierres de lotes automticos efectuados pueden ser
enviados por:
E-MAIL
FTP/SFTP
En caso de que el comercio opte por recibir los resmenes va e-mail, debe indicarnos a
qu direccin o direcciones de correo electrnico desea recibir tales archivos.
En caso de que el comercio opte por recibir los resmenes va FTP o SFTP, debe
indicarnos los siguientes datos: URL del servidor, usuario y clave.
Cierre de Lote 10
Formato del archivo de cierre de lote

automtico
Al finalizar el cierre de lote automtico, se genera un archivo por medio de pago con el
detalle de las transacciones incluidas en dicho cierre.
Las especificaciones del archivo son:
Nomenclatura del nombre de cada archivo generado: lote########_ddmmyy.MP.txt

########: ID Site Decidir (8 dgitos)
ddmmyy: Fecha en la que se realiz el cierre (6 dgitos).
MP: ID de medio de pago (1 2 dgitos).
Archivo Ejemplo: lote00090915_220616.24.txt
El layout del archivo enviado es el siguiente:
Registros Detalle:
Formato del archivo de cierre de lote 11

Campo Posicin Tipo de dato
TIPOREGISTRO [1-1] Tipo de Registro, Char default "D".

Id de Transaccin, Alfanumrico de 10
IDTRANSACCIONSITE [2-11] dgitos, completando con "0" a la
izquierda.
Medio de Pago, numrico, 3 dgitos
IDMEDIOPAGO [12-14] completando con "0 a la izquierda. Por
ejemplo: 001 identifica a Visa
Nmero de Tarjeta, numrico de 20
dgitos. Se informan los seis primeros
FORMATTEDNROTARJETA [15-34] digitos (BIN), ltimos 4 dgitos del nmero
de tarjeta y se completa con "0" los digitos
restantes.
Operacin, Char valores posibles:
C:compra
TIPOOPERACION [35-35]
D:devolucin
A:anulacin
Fecha de Operacin, numrico de 8
FECHA [36-43]
dgitos, formato "DDMMYYYY".
Monto de Operacin, numrico de 12
MONTO [44-55] dgitos, 10 enteros + 2 decimales (sin
punto decimal).
Cdigo de Autorizacin, numrico de 6

CODAUT* [56-61] dgitos, completando con "0" a la
izquierda.
NROTICKET [62-67] Nmero de Cupn, numrico de 6 dgitos.
Id Site Decidir, numrico de 15 dgitos, el

IDSITE [68-82] Id Site siempre es de 8 dgitos y se
completa con 7 ceros a la izquierda.
IDLOTE [83-85] Nmero de lote, numrico de 3 dgitos.
CUOTAS [86-88] Nmero de lote, numrico de 3 dgitos.

Fecha de cierre, nmero de lote, numrico
FECHACIERRE [89-96]
de 8 dgitos.
Nmero de establecimiento, numrico de

NROESTABLECIMIENTO [97-126]
30 dgitos.
Registro Trailer:

Campo Posicin Tipo de dato
TIPOREGISTRO [1-1] Tipo de Registro, Char, default "T".

Cantidad Registros "Detalle", numrico de 10
CANTIDADREGISTROS [2-11]
dgitos, completando con "0" a la izquierda.
Medio de Pago, numrico de 3 dgitos,
IDMEDIOPAGO [12-14]
completando con "0" a la izquierda.
Nmero de Lote, numrico de 3 dgitos

IDLOTE [15-17]
(000...999).
Contador de Compras, numrico de 4 dgitos

CANTCOMPRAS [18-21]
(0000...9999), cantidad de compras netas.
Monto de Compras, numrico de 12 dgitos,
MONTOCOMPRAS [22-33] formato $$$$$$$$$$CC, monto total de
compras netas.
Cantidad de Devoluciones, numrico de 4

CANTDEVUELTAS [34-37] dgitos (0000...9999), cantidad de
devoluciones netas.
Contador de Anulaciones, numrico de 12,
MONTODEVUELTAS [38-49] formato $$$$$$$$$$CC, cantidad de
anulaciones.
Cantidad de Anulaciones, numrico de 4
CANTANULADAS [50-53]
dgitos (0000...9999), monto de anulaciones
Monto de Anulaciones, numrico de 12
MONTOANULADAS [54-65] dgitos, formato $$$$$$$$$$CC, monto de
anulaciones
FILLER [66-100] Filler, 35 caracteres completados con "0".
Consideraciones:
El cierre de lote slo es realizado para los medios de pago que corresponden a Tarjetas
de Crdito.
En el caso de existir una Anulacin ("A") de una compra, en archivo de cierre de lote se
informa solamente el registro de la Anulacin con el mismo ID de Operacin de la
compra original.
Para las marcas administradas por FirstData (Mastercard, Cabal, Diners, Mas, etc) el
cierre de lote es realizado directamente por FirstData y en la consola de Decidir y en
los archivos que reciban, siempre se informar el lote "000".
*Para el caso especfico de AMEX el cdigo de autorizacin (CODAUT), es nmerico
de 2 posiciones [56-57].


Cmo configurar promociones bancarias

y de medios de pago?
La operacin con un gateway de pagos, permite la configuracin y procesamiento de
promociones bancarias, que el comercio tenga acordadas con las distintas entidades.
Hay distintos tipos de promociones y configuraciones que es posible realizar, en relacin a

las entidades bancarias y los distintos medios de pagos:
Los tipos de configuraciones ms habituales son:
1. Promociones de cuotas sin inters.

2. Promociones de % de descuento
3. Promociones de % de descuento + cuotas sin inters.
4. Limitar transacciones por medio de pago y Banco.
Todas estas promociones pueden ser parametrizadas a travs de 2 mtodos posibles:
a) BIN HEREDADO - Mayor esfuerzo de setup del lado del comercio:
Permite independencia de Decidir para configurar promociones minimizando la

necesidad de crear nuevos ID Sites para el comercio.
Ms rpida implementacin.
b) CREACION DE NUEVOS ID SITES - Mayor esfuerzo de setup del lado de Decidir.
Mayor interaccin con Decidir para el setup.

Permite mejor reportera de las promociones.
Describimos a continuacin, los detalles de configuracin de cada uno de los mtodos.
Configurar Promociones Bancarias 15

BIN Heredado
En el caso de elegir esta modalidad, el mayor esfuerzo desde el punto de vista de la
configuracin de la promocin est del lado del comercio, y se independiza de Decidir a la
hora de generar una promocin ya que esta modalidad no requiere la creacin de nuevos ID
Sites.
Deber realizar el control de los bines (los primeros 6 dgitos de la tarjeta que permiten
identificar la marca de tarjeta y el banco emisor de la misma), de la/s entidad/es bancaria/s
con la/s que acord la promocin, y enviar en el campo BIN, estos 6 dgitos en el servicio
SendAuthorizeRequest.
De esta forma, el formulario de captura de datos del pago, slo solicitar al tarjetahabiente,
los 10 dgitos restantes, en vez de los 16.
Ejemplo de llamada del servicio enviando el campo BIN
<api:Payload xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-

<Request>
<PARAMSITIO>a0</PARAMSITIO>
<CUOTAS>3</CUOTAS>
<NROOPERACION>3002072</NROOPERACION>
<MEDIODEPAGO>1</MEDIODEPAGO>
<NROCOMERCIO>12345678</NROCOMERCIO>
<IDTEMPLATES>50</IDTEMPLATES>
<EMAILCLIENTE>[email protected]</EMAILCLIENTE>
<URLDINAMICA>http://sddtest.aerolineas.com.ar/Mpol20/decidirpost</URLDINAMICA>
<BIN>450799</BIN>
<MONTO>1010.85</MONTO>
</Request>
</api:Payload>
BIN Heredado 16
Creacin de nuevos ID Sites

Setup en
Tipo de Promocin Setup en Comercio
Decidir
a) Alta Nuevo ID
Promocin con % de
Site; b) Alta
descuento con Banco
Filtro de Bines
ABC (comercio absorbe a) Aplicar descuento que absorbe el
de todas las
50% del descuento). Ej. comercio y enviar las trx al nuevo ID
tarjetas del
"20% de descuento con Site
Banco ABC
todas las tarjetas del
habilitadas para
Banco ABC"
la promo
a) Alta Nuevo ID
Promocin de cuotas sin
Site; b) Alta
inters con las tarjetas
Filtro de Bines
de un determinado
de todas las a) Enviar las trx al nuevo ID site
Banco. Ej. "6 cuotas sin
tarjetas del creado
inters con todas las
Banco ABC
tarjetas del Banco
habilitadas para
ABC"
la promo
Promocin de cuotas sin
inters con un medio de
pago de todos los
N/A N/A
Bancos. Ej: "12 cuotas
sin inters con las Visa
de todos los Bancos"
a) Alta Nuevo ID
Promicin de cuotas sin
Site; b) Alta a) Si el comercio absorbe el 15% de
inters + % de
Filtro de Bines descuento, aplicarlo antes de enviar la
descuento. Ej. "15% de
de todas las trx a Decidir, si lo hace el Banco no
descuento y 6 cuotas
tarjetas del hacer nada, ya que el descuento ser
sin inters con todas
Banco ABC aplicado en el resumen del cliente; b)
las tarjetas del Banco
habilitadas para Enviar la trx al nuevo ID Site creado
ABC"
la promo
Esta modalidad implica un mayor esfuerzo desde el punto de vista de la configuracin de la

promocin del lado de Decidir. Hay mayor interaccin entre el comercio y Decidir para el
setup de la promocin.
En el caso de elegir esta modalidad, el comercio obtiene una mejor reportera de las
promociones realizadas, pudiendo discriminar las operaciones que se cursan por los Id
Sites creados para cada promocin.
Creacin de nuevos ID Sites 17

Para cualquiera de las opciones descriptas en la tabla de promociones, el comercio deber

informar a Decidir la lista de bines (primeros 6 dgitos de la tarjeta de crdito), los cuales se
controlarn en Decidir cuando el tarjetahabiente ingrese los datos sensibles al momento del
pago. La lista de bines puede ser considerada como lista blanca (bines habilitados para la
promocin), o como lista negra (bines exceptuados de la promocin).
Creacin de nuevos ID Sites 18

Cmo me integro?
Este captulo describe el mecanismo de integracin y los tipos de operaciones posibles con
los distintos medios de pago.
Las operaciones disponibles son:
Autorizacin en 1 paso
Autorizacin en 2 pasos
Confirmacin (slo para la operatoria de autorizacin en 2 pasos)
Anulacin
Devolucin
Consulta de estado
Pedido de informacin
A continuacin se explica el flujo transaccional y luego ejemplos en php especficos.
Cmo me integro? 19
Token de Seguridad
El Token de seguridad se obtiene enviando un mail a [email protected]. Una vez recibido
el Token, deber ser enviado en el campo adicional Authorization del Header HTTP.
Ejemplo:
Si el token generado es: BBR87JNRBK0RJY9SVDZNN3VR la asignacin ser:
Authorization: PRISMA BBR87JNRBK0RJY9SVDZNN3VR
Token de Seguridad 20
Flujo de una Transaccin

Toda transaccin de pago independientemente del mtodo de integracin, realiza la
siguiente secuencia de 4 pasos basicos:
1. El comercio diagrama el formulario que va a utilizar para la captura de los datos del
medio de pago, teniendo en cuenta los campos definidos en en el apartado Formulario
custom
2. Para invocarlo, inicializa el componente JS . Ver Requerimiento del formulario custom:
3. Este ltimo toma los datos de la tarjeta y l mismo enva los datos a DECIDIR SPS.
4. DECIDIR a travs de un callback, devuelve el ID de la transaccin y con dicho ID se
confirma luego la operacin.
El comercio debe pedir Autorizacin a DECIDIR a travs de un WebService, con la

informacin devuelta se deber instanciar un formulario donde el cliente completar con los
datos de su tarjeta. (Ver: Ejemplos de Integracin).
El Formulario le ceder el control al comercio una vez que el cliente haya finalizado la
compra y en ese momento se tendr que confirmar la finalizacin de la transaccin.
Flujo de una Transaccin 21

Al finalizar la transaccin el comercio recibe un email con los datos de la transaccin

realizada. Este Mail es enviado a la cuenta de correo que inform el Comercio cliente al
momento de su implementacin.
Por lo cual procederemos a explicar primeramente el pedido de autorizacin y la

confirmacin, ya que estos dos servicios no se ven modificados sea cual sea el mtodo de
integracin que se desee implementar.
Luego en el sub-apartado Ejemplos de Integracin, haremos referencia a estos dos

servicios.
Adems DECIDIR ofrece operaciones extras sobre las transacciones que no influyen en el
ciclo bsico, como ser:
1. Ver el estado de una transaccin.

2. Pedir una anulacin.
3. Confirmar una Transaccin (solamente para comercios que utilizan confirmacin en 2
pasos, vease Anexo)
4. Pedir devolucin
NOTA: Es importante tener en cuenta que no ser posible integrarse desde el localhost ni
en produccin ni en desarrollo.
Flujo de una Transaccin 22

Pedido de Autorizacin:
El pedido de autorizacin es un servicio que valida la informacin que se enva para ver si
se puede continuar con el proceso de pago.
Esto se realiza a travs del web service Authorize, bajo el mtodo "SendAuthorizeRequest",
envindole el XML que se observa en Ejemplo de un requerimiento para el pedido de
Autorizacin .
Con esta operacin el comercio enva a DECIDIR los datos de la autorizacin requerida, el
servicio posee un conjunto de campos y un conjunto de datos variables los cuales se envan
en el campo Payload codificados segn se indique en el campo EncodingMethod.
Sandbox
Contrato de Servicio (WSDL): https://sandbox.decidir.com/services/t/1.1/Authorize?

wsdl
Direccin (Endpoint):
https://sandbox.decidir.com/services/t/1.1/Authorize.AuthorizeHttpSoap11Endpoint
Produccin
Contrato de Servicio (WSDL): https://sps.decidir.com/services/t/1.1/Authorize?wsdl
Direccin (Endpoint): https://sps.decidir.com/services/t/1.1/Authorize
Pedido de Autorizacin en 1 paso 23

Requerimiento

Tipo de
Campo Mandatorio Descripcin Valores posibles / Eje
Dato
Token de
Seguridad
Generado en el
Portal de
Alfanumrico
DECIDIR, es PRISMA
Security S hasta 32
necesario enviarlo RV82RVHO5T0O5CZUU
caracteres
solamente si no se
puede transportar
en el Header
HTTP
Cdigo de
comercio o cuenta Alfanumrico
Merchant S provisto por de 8 12345678
DECIDIR caracteres
(ID_SITE)
URL a la que el
comprador ser Alfanumrico
http://susitio.com/paymen
URL_OK No dirigido cuando la hasta 256
payment/Ok(relativo)
compra resulte caracteres
exitosa
URL a la que el
comprador ser Alfanumrico
http://susitio.com/paymen
URL_Error No dirigido cuando la hasta 256
o payment/Error (relativo
compra no resulte caracteres
exitosa
Especifica el tipo
de codificacin
que se usa para
los datos de la
Alfanumrico
transacciones de
EncodingMethod S hasta 16 XML
pagos (Siempre
caracteres
debe ser XML,
este campo est
para futuras
implementaciones.
Documento
codificado en el
formato
especificado en el
Alfanumrico Xml, compuesto por los
campo
Payload S hasta 2048 campos descritos en las
EncodingMethod
caracteres 2, 3, 4. (ver ejemplo).
el cual contiene
los datos de la
transaccin a
Autorizar

El Campo o Elemento Payload es utilizado para enviar los datos de la transaccin a

autorizar.
Valores
Tipo de
Campo Mandatorio Descripcin Posibles /
Dato
Ejemplos
Cdigo de
Comercio o
cuenta provisto Alfanumrico
NROCOMERCIO S por de 8 12345678
DECIDIR(mismo caracteres
valor que viaja
en el Merchant)
Identificacin
unvocamente
de la
Alfanumrico
transaccin para
NROOPERACION S de 1 a 40 10000012
el Comercio.
caracteres
Debe ser
distinto para
cada operacin.
Numrico
con 9 dgitos
con hasta 2
decimales
999999[.CC]
Usando el
punto como
separador
de
Importe en $125,38 ->
decimales.
MONTO S Pesos de la 125.38 $12 ->
No se
transaccin. 1200 o 12.00
permiten
comas, ni
como
separador
de miles ni
como
separador
de
decimales.
Depende del
Cantidad de contrato del
Decimal de
cuotas en las comercio con el
CUOTAS No hasta dos
que se realiza medio de pago.
dgitos.
el pago 01, 02, 06, 12,
etc.
Valor que
identifica al

medio de pago Numrico de Tablas de

MEDIODEPAGO No seleccionado hasta 3 referencia
por el usuario dgitos. Medios de Pago
para realizar la
transaccin.
El comercio
deber enviar a
DECIDIR el
email del
cliente. Esta Alfanumrico
EMAILCLIENTE Si direccin se de hasta 80 [email protected]
utilizar para caracteres.
enviar el mail de
confirmacin de
la compra al
cliente
Los primeros 6
dgitos de la
tarjeta que
permiten
identificar la
marca de tarjeta
y el banco Numrico de
BIN No 450799
emisor de la 6 dgitos
misma. Se
envian para la
configuracin de
promociones
por BIN
heredado

Campos adicionales para el medio de pago Rapipago
DECIDIR generar el cupn de pagos que deber ser impreso y luego el comprador deber
concurrir a un centro Rapipago a abonar.

Valores
Campo Mandatorio Descripcin Tipo de Dato Posibles /
Ejemplos
Son los das

que existen
Poner "00"
entre el 1 y
Numrico, 2 si la factura
CANTDIASFECHAVENC S 2
dgitos no tiene 2
vencimiento
vencimiento.
de la
factura.
Son los das
despus del
primer
vencimiento
y hasta el
Numrico, 3
CANTDIASPAGO S que el ---
dgitos
cliente
puede pagar
la factura
por
Rapipago
Recargo por
vencimiento
del plazo.
Dato Numrico, 7
generado dgitos con hasta
RECARGO S ---
por el 2 decimales
comercio. 99999[.CC]
Es un monto
(no un
porcentaje).
Fecha de
vencimiento
para el pago
del cupn. Numrico, 6
FECHAVTO S ---
Dato dgitos(AAMMDD)
generado
por el
comercio
Cdigo de
cliente
provisto por
Rapipago al Numrico, 8
CLIENTE S ---
momento de dgitos
habilitar al
comercio.
Dato fijo
Impresin y simbologa del cdigo de barras:

Los cdigos de barras debern estar alejados de los bordes de hoja y de las lneas oscuras
paralelas al cdigo de barras. Una distancia ideal sera 5mm.
La simbologa adecuada para la impresin del cdigo de barras para RapiPago es

Interleaved 2 de 5.

Campos adicionales para el medio de Pago Fcil (Caja De Pagos)
DECIDIR generar el cupn de pagos que deber ser impreso y luego el comprador deber
concurrir a un centro Pago Fcil a abonar.
Valores
Campo Mandatorio Descripcin Tipo de Dato Posibles
/Ejemplos
Recargo por
vencimiento del
Numrico, 7
plazo. Dato
dgitos con hasta
RECARGO S generado por el ---
2 decimales
comercio. Es un
99999[.CC]
monto (no un
porcentaje)
Fecha de
vencimiento para
Numrico, 6
FECHAVTO S el pago del cupn. ---
dgitos(AAMMDD)
Dato generado
por el comercio
Fecha del
segundo
vencimiento para Numrico, 6
FECHAVTO2 S ---
el pago del cupn. dgitos(AAMMDD)
Dato generado
por el comercio
Impresin y simbologa del cdigo de barras:
Los cdigos de barras debern estar alejados de los bordes de hoja y de las lneas oscuras
paralelas al cdigo de barras. Una distancia ideal sera 5mm.
La simbologa adecuada para la impresin del cdigo de barras para Pago Fcil (Caja de
Pagos) es Code 128C.

Consideraciones para Pagomiscuentas (Banelco)
Slo podrn generar facturas aquellas personas que posean clave de acceso en
Pagomiscuentas (ver www.pagomiscuentas.com.ar).
El parmetro NROOPERACION acta como identificador de factura por lo que admite slo
20 caracteres alfanumricos.
Una vez que la transaccin es aprobada por PAGOMISCUENTAS, el usuario debe ingresar
al sitio de PAGOMISCUENTAS o bien a su HOMEBANKING para completar el pago de la
factura recin generada a travs de nuestro sistema.
A los campos descriptos previamente para el pedido de autorizacin se deber agregar el

siguiente parmetro exclusivo para transacciones de Pagomiscuentas:
Dato Tipo Valor Observaciones Formato

Mximo
Fecha y hora de vencimiento
11 DDMMYY
de la factura. Puede omitirse
dgitos, o
FECHAVTO Numrico las horas y minutos,
dato de DDMMYY
informando solo la fecha con
longitud HHMM
formato DDMMYY.
variable.

Consideraciones para Nevada
Para poder utilizar la opcin NEVAPLAN debe enviarse el parmetro IDPLAN con el valor
"2". Por decisin de NEVADA, sta operatoria es exclusiva de las tarjetas NEVADA "puras":
BIN 504363 (es decir las tarjetas cobranding con VISA o Mastercard NO lo tienen
disponible).
Ejemplo XML:
<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:api="http://api.decidir.com

<soap:Header/>
<soap:Body>
<api:Execute>
<api:Security>PRISMA XXXXXXXXXXXXXXXXXXXXXXXX</api:Security>
<api:Session></api:Session>
<api:Merchant>12345678</api:Merchant>
<api:Operation>Compra</api:Operation>
<api:EncodingMethod>XML</api:EncodingMethod>
<api:Payload>
<Request>
<NROOPERACION>operacion0001</NROOPERACION>
<MONTO>100</MONTO>
<MONEDA>032</MONEDA>
<CUOTAS>02</CUOTAS>
<TIPODOC></TIPODOC>
<NRODOC></NRODOC>
<CALLE></CALLE>
<NROPUERTA></NROPUERTA>
<NOMBREENTARJETA></NOMBREENTARJETA>
<NROTARJETA>504363XXXXXXXXXX</NROTARJETA>
<VENCIMIENTO>MMAA</VENCIMIENTO>
<CODSEGURIDAD>XXX</CODSEGURIDAD>

<IDPLAN>2</IDPLAN>
</Request>
</api:Payload>
</api:Execute>
</soap:Body>
</soap:Envelope>

Consideraciones para Visa DEBITO
Para utilizar este medio de pago, no se requiere estar adherido a Verified by Visa para
utilizarlo.
Cuando opere fuera de una "billetera virtual" debern solicitarse Fecha de Vencimiento y
CVV. Opera en un solo pago. Acepta Anulaciones Totales y Devoluciones (Totales y
Parciales). No permite operar en dos pasos.

Requerimientos de VISA para comercios Agregadores
VISA solicita a los comercios que operan como agregadores, que suministren informacin
adicional de los comercios para quienes estn presentando determinada operacin, en el
pedido de autorizacin de la transaccin.
Aquellos comercios que operen bajo esta modalidad, para las operaciones VISA debern
realizar lo siguiente:
1. Informar a DECIDIR para realizar la configuracin correspondiente
2. En el requerimiento inicial enviar los siguientes parmetros adicionales:
Parmetro Mandatorio Descripcin Formato

Posibles
0
1
Indicador del tipo de Numrico, 1
AINDICADOR S 2
documento dgito
Nmero
nico
Nmero de CUIT,
CUIL o Nmero
Caracter, 11
ADOCUMENTO S nico (en este caso
posiciones
completar con ceros
a la izquierda)
Nmero de Factura a Alfanumrico
AFACTPAGAR No
Pagar 12 caracteres
Nmero de factura
Alfanumrico
AFACTDEVOL No de
12 caracteres.
anulacion/Devolucin
Alfanumrico
20 caracteres.
En caso de
Nombre de comercio
nombre y
ANOMBRECOM S o nombre y apellido
apellido,deben
del vendedor
estar
separados por
/
Direccin del
Alfanumrico
ADOMICILIOCOMERCIO S comercio o del
20 caracteres.
vendedor
Alfanumrico
ANROPUERTA S Nmero de puerta
6 caracteres
Alfanumrico
ACODPOSTAL S Cdigo postal
8 caracteres

Cdigo de actividad Alfanumrico descargar

ARUBRO S
(rubro) 5 caracteres Tabla
Alfanumrico Valor fijo:
ACODCANAL No Cdigo de canal
3 caracteres "005"
informar
el cdigo
Cdigo Postal del Alfanumrico Postal del
ACODGEOGRAFICO No
vendedor 5 caracteres vendedor
(ej: 1900,
1043)
Alfanumrico
Descripcin del
APRODUCTO No de 20
producto
caractares
En el caso en que la autorizacin contenga ms de un artculo de distintos proveedores,

informar los datos del artculo que posea mayor valor unitario.

Requerimientos de Mastercard para comercios Agregadores
Mastercard solicita a los comercios que operan como agregadores, que suministren
informacin adicional de los comercios para quienes estn presentando determinada
operacin, en el pedido de autorizacin de la transaccin.
Aquellos comercios que operen bajo esta modalidad, para las operaciones MASTERCARD,
CABAL, DINERS, ARGENCARD debern realizar lo siguiente:
1. Informar a DECIDIR para realizar la configuracin correspondiente en su back office.
2. En el requerimiento inicial enviar los siguientes parmetros adicionales:
Valores
Posibles
0
CUIT
1
Indicador del tipo de Numrico,
AINDICADOR S CUIL
documento 1 dgito
2
Nmero
nico
Nmero de CUIT, CUIL
o Nmero nico (en Caracter,
ADOCUMENTO S este caso completar 11
con ceros a la posiciones
izquierda)

Split de Transacciones
Para aquellos comercios que operen por cuenta y orden de terceros y/o necesitan dividir
una nica transaccin entre varios establecimientos en los autorizadores de Medios de de
pago, DECIDIR permite realizar transacciones distribuidas (Split de transacciones).
Esta funcionalidad, permite que en una misma transaccin de venta intervengan "n" ID
Sites distintos. Usando Split, el sistema genera y administra una transaccin por cada ID
Site, utilizando los mismos datos del medio de pago ingresado, pero imputando los
diferentes montos segn se defina.
Cada una de estas transacciones se denomina sub transaccin. Todas compartiran el

mismo ID de transaccin y se diferenciarn por el IDsite relacionado o el monto utilizado.
El ID site que genera la transaccin es el ID Site Padre, con el cul se identificar la
transaccin gral, y los dems ID sites sern los Hijos. Es importante tener en cuenta que la
transaccin de pago se distribuir sobre los ID Sites denominados Hijos, y sobre estos se
impactarn realmente las subtransacciones.
La respuesta (Get Authorize Answer) al pedido de Autorizacin en un Split de transacciones
siempre responder sobre el IDSite Padre informando en el parmetro COD de
AUTORIZACION de la transaccin el ltimo Cdigo de Autorizacin obtenido en las
subtransacciones involucradas.
Para obtener informacin a detalle de cada sub transaccin, debe recurrirse al Servicio
OPERATIONS (ver seccin 6.2.5 Ver estado de una transaccin)
Existen 2 modalidades:
1. Por montos fijos: para aquellos comercios que operan con distintos sitios de terceros y
en cada operacin puede intervenir cualquiera de ellos, con montos distintos.
2. Por porcentaje: para aquellos comercios que operan siempre con los mismos sitios de
terceros en cada transaccin y el porcentaje del monto es fijo.
Observaciones en cuanto a la anulacin y la devolucin:
Las devoluciones o anulaciones totales de una transaccin, se hacen referenciando al

IDsite Padre y al ID de transaccin. Esta accin actuar sobre todas las subtransacciones
hijas.
Si lo que se requiere es anular o devolver una subtransaccin, se debe referenciar al IdSIte

Hijo corespondiente (tenga en cuenta que si ese ID Site coincide con el ID SIte Padre, la
devolucin/Anulacin ser sobre la transaccin completa).
Las devoluciones parciales deben hacerse sobre los ID sites hijos ya que es necesario
saber a que subtransaccin corresponde la devolucin.

En el campo merchant del request debe ir siempre el ID Site Padre, y el campo

NROCOMERCIO es donde se especifca el IDSite Hijo indicando sobre que subtransaccin
se realizar la devolucin/anulacin.
RECUERDE: Si entre los comercios a los que se distribuye la transaccin se esncuentra el

comercio padre, no ser posible realizar una anulacin total o devolucin total nicamnete
sobre ese comercio, ya que el id de este se usar para anular o devolver la transaccin
entera.

Split de Transacciones por Montos Fijos
Modificaciones a tener en cuenta en cuenta en el requerimiento inicial para los comercios

que operan de manera distribuida por montos fijos:
Valores Posibles /
Ejemplos
Alfanumrico
ID Site provisto por
NROCOMERCIO S de 8
DECIDIR.
caracteres.
"999999.CC"
Con
decimales
usando el
puntos como
separador
Importe de cada de
una de las decimales.
subtransacciones. No se
IMPDIST S 125.38#12#12.00
Los importes deben permiten
postearse comas, ni
separados por #. como
separador
de miles ni
como
separador
de
decimales.
ID sites provistos
por DECIDIR para
cada uno de los
sites asociados al
ID site Padre (Es el
informado en el
campo _Merchant_ Alfanumrico
SITEDIST S de todos los de 8 00100511#01100511
servicios y el caracteres.
campo
_NROCOMERCIO_
en el Pedido de
autorizacin).
Deben postearse
separados por #.
Cantidad de cuotas
por cada
Decimal de 2
CUOTASDIST S subcomercio. 01#06#12
dgitos.
Deben postearse
separados por #.

Indica si la
transaccin es
distribuida o no. Si Null Transaccin
no es enviado el no distribuida.
**pedido de S Transaccin
IDMODALIDAD S autorizacin** se distribuida.
toma como N Transaccin no
comercio no distribuida.
distribuido, para no
afectar la
operatoria actual.

Split de Transacciones Porcentual
Modificaciones a tener en cuenta en el requerimiento inicial para los comercios que operan
de manera distribuida por porcentaje; no es necesario enviar los comercios en los que se
distribuye:
Valores
Posibles
Indica si la transaccin
Null. S
es distribuida o no. Si
Transaccin
no es enviado el "post"
distribuida.
se toma como
IDMODALIDAD S N
comercio no
transaccin
distribuido, para no
no
afectar la operatoria
distribuida.
actual.

Ejemplo de un requerimiento para el pedido de Autorizacin
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:api="http://api.decidir.com.ar">
<soapenv:Header/>
<soapenv:Body>
<api:SendAuthorizeRequest>
<api:Security>PRISMA RV82RVHO5T0O5CZUUTX2FLHU</api:Security>
<api:Merchant>12345678</api:Merchant>
<api:URL_OK>www.sitioDeEjemplo.com</api:URL_OK>
<api:URL_ERROR>www.SitioDeEjemplo.com</api:URL_ERROR>
<api:Payload>
<Request>
<NROCOMERCIO>12345678</NROCOMERCIO>
<NROOPERACION>ABCDEF-1234-12221-FDE1-00000200</NROOPERACION>
</Request>
</api:Payload>
</api:SendAuthorizeRequest>
</soapenv:Body>
</soapenv:Envelope>

Respuesta
Como en el requerimiento, en la operacin SendAutorizeRequest (Ver Pedido de
Autorizacin) se recibirn un conjunto de campos, y un conjunto de datos variables los
cuales se envan en el campo Payload codificados segn se indique en el campo
EncodingMethod descritos en las tablas siguientes.
Campo Mand. Descripcin Tipo de Dato Valores posibles
Cdigo de estado o -1 -> OK

Numrico de
StatusCode S valor de retorno del otro ->Error
4 posiciones
Servicio
Descripcin del cdgo
Alfanumricoo
StatusMessage S de retorno o estado del -
hasta 256
servicio
https://forms.decidir.ne
Url del formulario de formulario/commands?
URL Request S URL
pago command=formulario&
f7b1-4ee9-e76b-9cc84
Identificador Privado
del Requerimiento
obtenido en la
respuesta de la
operacin Alfanumrico
8496472a-8c87-e35b-d
RequestKey No SendAuthorizeRequest. hasta 48
94d5e31eb12f
Nunca debe ser caracteres
expuesto hacia el Web
Browser. Solo ser
utilizado entre el Site y
DECIDIR
Identificador Pblico
del Requerimiento
Alfanumrico
obenido en la 7d3938c9-f7b1-4ee9-e
PublicRequestKey No de hasta 48
respuesta de la 9cc84f73fe81
caracteres
operacin
SendAuthorizeRequest
El campo o elemento Payload es utilizado para retornar los datos de la respuesta de la

transaccin.

Valores
posibles
Campo Mandatorio Descripcin Tipo de Dato
Ejemplo
Fecha y Hora.
Fecha y Hora
aaaammddTHHMMSSZ
FECHAHORA Si de la
La hora se expresa en
Transaccin
formato 24 hs.
Nombre de la
MONEDA No
Moneda
Nmero de
Numrico de Hasta 4
NROTICKET No Ticket o
dgitos
Voucher
Cdigo de Alfanumrico de hasta
CODAUTORIZACION No
Autorizacin 8 caracteres
Nmero de
Tarjeta,
enmascarado
segn
NROTARJETAVISIBLE No
normativas
nacionales,
regionales o
globales
Cdigo de
Barras
generado Alfanumrico hasta 64
CODBARRAS No
para Pago caracteres
Fcil
RapiPago

Ejemplo de una respuesta para la confirmacin de una transaccin
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
<soapenv:Body>
<api:SendAuthorizeRequestResponse xmlns:api="http://api.decidir.com.ar">
<api:StatusCode>-1</api:StatusCode>
<api:StatusMessage>Solicitud de Autorizacin Registrada</api:StatusMessage>
<api:URL_Request>https://forms.decidir.net/formulario/commands?command=formulario&
m=7d3938c9-f7b1-4ee9-e76b-9cc84f73fe81
</api:URL_Request>
<api:RequestKey>e9aa9a10-6069-807d-165f-00380b65a0f5</api:RequestKey>
<api:PublicRequestKey>7d3938c9-f7b1-4ee9-e76b-9cc84f73fe81</api:PublicRequestKey
</api:SendAuthorizeRequestResponse>
</soapenv:Body>
</soapenv:Envelope>

Autorizacin en 2 pasos
Esta funcionalidad permite realizar la autorizacin de una operacin en 2 pasos (2
mensajes), en lugar de realizarlo en 1 paso (1 mensaje) como es habitual. Describimos a
continuacin, el alcance de esta operatoria, detallando las caractersticas y usos de cada
uno de los pasos.
Pedido de Autorizacin en 2 pasos 47

Pasos de la Autorizacin
Paso 1 Pre-autorizacin (o tambin llamado Autorizacin

sin Captura)
Se realiza sobre un Monto1 que reserva saldo disponible del tarjetahabiente. Figuran bajo el
estado Pre Autorizada en DECIDIR, que es un estado intermedio. Puede ser Rechazada
por el medio de pago, por los mismos motivos que una autorizacin normal. Tiene una
validez de 15 das. Nunca aparece en el resumen de cuenta del tarjetahabiente. No se
incluye en los cierres de lote diarios. No se liquidan por parte del medio de pago al
comercio.
Estados posteriores que puede tener una Pre-autorizacin:
Autorizada (Cuando el medio de pago acepta el Paso 2)

Rechazada (Cuando el medio de pago rechaza el Paso 2)
Anulada (Cuando el comercio pide la anulacin. Libera saldo del tarjetahabiente. No
aceptan anulaciones estos medios de pago: MasterCard, Cabal, Coopeplus, Nexo y
Ms)
Vencida (Cuando no es confirmada luego de 15 das)
Paso 2 Confirmacin (o Captura)

Esta autorizacin es un tipo de mensaje distinto a una autorizacin normal. Puede
realizarse nicamente sobre operaciones en estado Pre Autorizada. Puede realizarse por
un Monto2 distinto al Monto1 Pre Autorizado:
Las reglas de aceptacin del Monto2 dependen de cada medio de pago. Previamente a
solicitar esta funcionalidad en DECIDIR, el comercio debe solicitar al medio de pago los
porcentajes de variacion del Monto2 que tiene autorizados para esta operatoria.
El Comercio debe informar estos porcentajes a Help Desk, en DECIDIR para que sean
parametrizados en su IDSITE.
Por default, estos porcentajes estan ambos en 0% (Monto2=Monto1)
DECIDIR valida que el Monto2 est comprendido dentro de los porcentajes de
variacin informados por el comercio para el medio de pago. Si la validacin falla,
DECIDIR no permite realizar la Confirmacin.
Como ejemplo, un medio de pago puede aceptar que el Monto2 sea +5% -20%
respecto al Monto1.
La operacin de Confirmacin se realiza utilizando el mismo ID de transaccin que la
Pre Autorizacin.
La operacin de Confirmacin siempre es aceptada por el medio de pago, de modo que

sea ingresada al cierre de lote del da para ser liquidada, momento en el cual, la
transaccion puede ser rechazada por el medio de pago.
Sugerencia al momento de implementar:

La utilizacin de esta funcionalidad permite resolver diferentes problematicas, relacionadas
al armado de pedidos y su logstica. Se sugiere que los usuarios internos de esta solucin
puedan testear que el valor final del pedido est dentro de los rangos aceptados por el
medio de pago, a fin de evitar conflictos al momento de querer confirmar la transaccin.

Observaciones
De cara al servicio de DECIDIR, cada uno de los pasos cuenta como una transaccin
independiente. Es decir, que a los efectos de la facturacin del servicio, esta operatoria
cuentan como 2 transacciones.
La Devolucin de una Transaccin en dos pasos, se hace por el monto efectivamente
capturado (2do paso).
Medios de Pago que aceptan esta operatoria

Visa
MasterCard

Esquema Transaccional
El siguiente diagrama refleja el flujo transaccional de esta operatoria.
Consideraciones sobre el resultado al invocar el WS de

Confirmacin
Cuando el monto a Confirmar est por fuera de los rangos establecidos con el medio de
pago, el Comercio obtiene como
RESULTADO: RECHAZADA, StatusCode=100 y IDMOTIVO=100
El Estado de la transaccin sigue en Preautorizada.
Cuando el monto a Confirmar est dentro del rango establecido con el medio de pago, el
Comercio obtiene como RESULTADO: APROBADA / StatusCode= -1 / IDMOTIVO=0
Cambia el estado de la transaccin a Autorizada.
Ejemplos de Respuestas de los dos casos posibles:
Rechazo:

<soapenv:Body>
<api:ExecuteResponse xmlns:api="http://api.decidir.com.ar">
<api:StatusCode>100</api:StatusCode>
<api:StatusMessage>Confirmacion Rechazada</api:StatusMessage>
<api:AuthorizationKey>3EBA89AE73AC03966B1447855943778</api:AuthorizationKey>
<api:Payload>
<Answer>
<IDMOTIVO>100</IDMOTIVO>
<RESULTADO>RECHAZADA</RESULTADO>
<FECHAHORA>2015/11/18 11:12:23</FECHAHORA>
</Answer>
</api:Payload>
</api:ExecuteResponse>
</soapenv:Body>
</soapenv:Envelope>
Aceptacin:
<soapenv:Body>
<api:StatusMessage>Confirmacion Recibida</api:StatusMessage>
<api:AuthorizationKey>3EBA89AE73AC03966B1447855966865</api:AuthorizationKey>
<api:Payload>
<Answer>
<RESULTADO>APROBADA</RESULTADO>
</Answer>
</api:Payload>
</soapenv:Body>
</soapenv:Envelope>

Formulario
La solucin permite utilizar como formulario de pago, un formulario propio del usuario
(formulario custom) o bien el uso de un formulario predefinido por Decidir (formulario
embedded).
Actualmente slo se dispone de la integracin con un formulario Custom. La ventaja de este

mtodo es el nivel de personalizacin que puede alcanzar en el diseo de su formulario.
En sucesivas actualizaciones incorporaremos las especificaciones necesarias para utilizar

el Formulario embedded, cuya implementacin requiere de menor esfuerzo de
programacin por parte del comercio.
Invocacin al Formulario 53
Formulario Custom
En este esquema el cdigo del Formulario de Pagos debe ser desarrollado por el comercio
bajo estrictas especificaciones brindadas por DECIDIR. Se debe tener en cuenta que al
elegir este mecanismo el Comercio acepta implementar todos y cada uno de los cambios
que DECIDIR solicite en el futuro, para permitir que el producto disponga de todas las
funcionalidades previstas y necesarias.
Para integrar este formulario se debe incluir el javascript provisto por decidir e instanciar la
clase Payment llamando al mtodo init pasando los parmetros segun se detalla abajo.
Url javascript en sandbox: https://sandbox.decidir.com/custom/callback/1.1/payment.js

Url javascript en produccin: https://sps.decidir.com/custom/callback/1.1/payment.js
Mapeo para instaciar el init: id|id del formulrio fieldsId|Mapeo de los imputs de datos
callback|Funcin a ejecutar, esta obtendr por parmetro con la propiedad
PublicAnswerKey, la cul ser necesaria para llamar el GetAuthorizeAnswer
options|opciones adicionales de configuracin
Adems, las adecuaciones necesarias para soportar el Formulario de pago en diferentes

Dispositivos estarn a cargo del Comercio Cliente.
Ejemplos de Formularios que el cliente puede armar.

http://www.pigmalionstudios.com/decidir/payment/
En los diferentes ejemplos podr chequear como funcionan las validaciones proporcionadas
por el script JS que se invoca desde el Servidor de Decidir. Estas validaciones se ejecutan
sobre cada campo que se despliega en el formulario
Los mensajes definidos en cada caso, no pueden ser modificados.
Requerimiento del formulario custom:

Para invocarlo se debe incluir el script alojado en
https://sandbox.decidir.com/custom/callback/1.1/payment.js para sandbox o en
https://sps.decidir.com/custom/callback/1.1/payment.js para produccin, y hacer la
invocacin con la siguiente linea:
new Payment().init(json);
En el init se debe pasar un JSON con los siguientes campos:
Tipo de
Nombre Descripcin
Dato
id Identificador del formulario Alfanumrico
Objeto
fieldsId Ids de los input del formulario
JSON
Funcin que se ejecutar al terminar el script, en esta se
callback deber recuperar el PublicAnswerKey pasandolo por funcin
parmetro
Parametros adicionales de configuracin este campo es Objeto
options
opcional JSON
Como dijimos en la tabla anterior se deben enviar en los id de los inputs del formulario
dentro de un JSON, a continuacin se detallan estos campos:
Id en el JSON Mandatorio Descripcin Tipo de dato
Nombre del
CardHolderName S Alfanumrico
tarjetahabiente
Direccin de correo
CardHolderMail S Alfanumrico
electrnico
Numrico de
CardNumber S Nmero de la tarjeta hasta 20
caracteres
S (Puede elegir
reemplazarlo por
Alfanumrico
mandar el Fecha de vencimiento
CardExpirationDate de 4
CardExpirationMonth de la tarjeta
caracteres
y
CardExpirationYear)
No (Pero se manda
nicamente si no se Mes en la fecha de Numrico de
CardExpirationMonth
enva el vencimiento 2 caracteres
CardExpirationDate)
No (Pero se manda
nicamente si no se Numrico de
CardExpirationYear Ao de vencimiento
enva el 2 caracteres
CardExpirationDate)
Cdigo de seguridad Numrico de
CardSecurityCode S
de la tarjeta 3 caracteres
PublicRequestKey Alfanumrico
PublicRequestKey S devuelto por el de hasta 48
SendAuthorizeRequest caracteres
Numerico,
Fecha de nacimiento
CardHolderDateOfBirth No Formato
del tarjetahabiente
DDMMYYYY
Identificador del tipo
CardHolderIdentificationType No de documento. DNI 1, Numrico
CI 2, LE 3, LC 4
Nro de documento del Numrico de

CardHolderIdentification No
tarjetahabiente 8 posiciones
Alfanumrico,
Calle de entrega del
CardHolderAddressStreet No mximo 30
resumen
caracteres
Nmero de Puerta de Numrico,

CardHolderAddressNumber No
entrega del resumen mximo 6
Validaciones de datos en campos del Formulario Custom y

Ayudas contextuales.
Este mtodo permite aplicar validaciones a los campos del formulario que mejoran la
calidad de datos y la experiencia de usuario. Estas validaciones se describen a continuacion
y se habilitan dentro del parmetro options.
Los campos adicionales del parmetro options, son todos opcionales, pero deben setearse
de acuerdo al funcionamiento esperado del formulario.
Valores
Id en el JSON Descripcin
posibles
En caso de ser "true" mostrar el

nombre de la marca tarjeta que se
true o
displayCreditCardTypeDetected est ingresando. (Visa, American
flase
Express, Mastercard o Diners
Club)
Podr contener un String que
representa el ID del control html
sobre el cual se mostrar la
marca tarjeta detectada. En caso
de ser null, si el valor
null o
displayCreditCardTypeContainerId displayCreditCardTypeDetected
String
es true, se crear un control
propio y se ubicar a la derecha
del <input type="text"> sobre el
que se completa el nmero de
tarjeta
Es el valor del IdMediodePago.
Indica si se validar que el
nmero de tarjeta ingresado se
1, 2, 6,
corresponda con una marca
cardType 15, etc o
tarjeta predefinida. 1 (visa), 15
null
(mastercard), 6 (amex), 8 (diners
club), null (sin restriccin de
marca tarjeta)
En caso de tener un valor
numrico, se utilizar como BIN
de tarjeta reduciendo la cantidad
null o
cardBin de dgitos a completar por el
Valor
usuario en CreditCardNumber. Si
es null, significa que no se utiliza
BIN
true o Indica si se va a mostrar el
displayCardBin
false nmero de BIN
Podr contener un String que

representa el ID del control html
sobre el cual se mostrar el
nmero de BIN. En caso de ser
(null o
displayCardBinContainerId null, si el valor displayCardBin es
String)
true, se crear un control propio y
se ubicar por sobre el <input
type="text"> donde se completa
el nmero de tarjeta.
CONSIDERACIONES:
Validacion de datos adicionales: Si el comercio va a utilizar este servcio para las

transacciones VISA, es mandatorio que envie los campos en el JSON
(CardHolderDateOfBirth , CardHolderIdentificationType, CardHolderIdentification,
CardHolderAddressNumber).
Los campos informados en el JSON, podrn ser accedidos desde la consola SAC de
DECIDIR cuando corresponda.
Solicitar Informacin de una Transaccin:

El pedido de informacin se realiza a travs del servicio GetAuthorizeAnswer. Este servicio
permite recuperar la informacin y el estado de una transaccin, adems es utilizado para
confirmar que el comercio volvi a tomar el control luego de invocar al formulario, con lo
cual su invocacin es obligatoria.
Sandbox
Contrato de Servicio (WSDL): https://sandbox.decidir.com/services/t/1.1/Authorize?

wsdl
Direccin (Endpoint):
https://sandbox.decidir.com/services/t/1.1/Authorize.AuthorizeHttpSoap11Endpoint
Produccin
Contrato de Servicio (WSDL): Debe bajarse del sandbox y consumirlo localmente.
Direccin (Endpoint): https://sps.decidir.com/services/t/1.1/Authorize
Pedido de Informacin de una Transacccin 60

Requerimiento
En el llamado a DECIDIR se debern enviar los siguientes campos del servicio:
Tipo de
Campo Mandatorio Descripcin Valores posibles
Dato
Token de Seguridad
Generado en el Portal
de DECIDIR, es Alfanumrico
Security No necesario enviarlo hasta 32 1234567890ABCDEF123
solamente si no se caracteres
puede transportar en
el Header HTTP
Cdigo de comercio o Alfanumrico
Merchant Si cuenta provisto por de 8 12345678
DECIDIR caracteres
del Requerimiento
obtenido en la
respuesta de la
operacin Alfanumrico
RequestKey Si SendAuthorizeRequest hasta 48 8496472a-8c87-e35b-dcf2
. Nunca debe ser caracteres
expuesto hacia el Web
Browser. Solo ser
utilizado entre el Site y
DECIDIR
Identificador Pblico
de la Respuesta
Recibido segn el
mtodo utilizado de
Integracin
(Formulario Embebed
Alfanumrico
o Custom) en un
AnswerKey S hasta 48 8496472a-8c87-e35b-dcf2
campo del formulario
caracteres
posteado al Site, o
como propiedad
retornada en la
invocacin del mtodo
de Inicio de Pago
(Java Script).

Ejemplo
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:api="http://api.decidir.com.ar">
<SOAP-ENV:Body>
<api:GetAuthorizeAnswer>
<api:Security>1234567890ABCDEF1234567890ABCDEF</a:Security>
<api:RequestKey>8496472a-8c87-e35b-dcf2-94d5e31eb12f</api:RequestKey>
<api:AnswerKey>8496472a-12df-e35b-dcf2-94d5e31eb12f</api:AnswerKey>
</api:GetAuthorizeAnswer>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Respuesta del requerimiento para ver el estado de una

transaccin
Como en el requerimiento, en la operacin SendAutorizeRequest (Ver Pedido de
Autorizacin) se recibirn un conjunto de campos descriptos, y un conjunto de datos
variables los cuales se envan en el campo Payload codificados segn se indique en el
campo EncodingMethod.
Valores
Tipo de posibles
Campo Mandatorio Descripcin
Dato /
Ejemplo
-1 -> OK
Cdigo de estado o 0 a
Numrico de
StatusCode Si valor de retorno del 99999 o
5 posiciones
Servicio vaco ->
error
Descripcin del
Alfanumrico
StatusMessage Si cdigo de retorno o -
hasta 256
estado del servicio
Alfanumrico
AuthorizationKey No hasta 256 -
de la Respuesta
caracteres
Especifica el tipo
codificacin que se Alfanumrico
EncodingMethod No usa para los datos hasta 16 XML
de la transacciones caracteres
de pagos
Documento
codificado en el
formato especificado
en el campo Alfanumrico
Payload No EncodingMethod el hasta 2048 -
cual contiene los caracteres
datos de la
transaccin a
Autorizar
El campo o elemento Payload es utilizado para retornar los datos de la respuesta de la

transaccin.
Fecha y Hora Fecha y Hora.

aaaammddTHHMMSSZ

FECHAHORA Si de la La hora se expresa en

Transaccin formato 24 hs.
Nombre de la
MONEDA No
Moneda
Nmero de
Numrico de Hasta 4
dgitos
Voucher
Cdigo de Alfanumrico de hasta
CODAUTORIZACION No
Autorizacin 8 caracteres
Nmero de
Tarjeta,
enmascarado
segn
NROTARJETAVISIBLE No
normativas
nacionales,
regionales o
globales
Cdigo de
Barras
generado Alfanumrico hasta 64
CODBARRAS No
para Pago caracteres
Fcil
RapiPago
Informa el
cdigo ejemplos, 100
numrico de 10101 / 10103
RESULTADOCS No
la respuesta cdigos de
de Cybersource
Cybersource.
Informa el
identificador
de la
solicitud,
generado por
Cybersource,
para ubicarla
rpidamente Ejemplos:
IDENTIFICADORCS No dentro del 443189013623
Desicion 555189013623
Manager. Si
el campo no
se visualiza,
implica que
la trasaccion
no llego a
Cybersource

Nota: El StatusCode sirve como indicador de correcta ejecucin del servicio y de la

finalizacin satisfactoria del flujo de la transaccin. En caso de que ambas cosas hayan
sucedido devolver -1, por otro lado s la transaccin fue rechazada el valor devuelto
coincidir con el IDMOTIVO reflejando el motivo de rechazo de la operacin. El otro caso
posible, es que por alguna razn (como ser configuracin o datos invlidos, tanto en este
mtodo cmo en el SendAuthorizeRequest) el pago no pueda realizarse, en este caso
aparecer un cdigo segn el motivo por el cul el pago no pueda ser efectuado. Dirijas a
la Tabla de StatusCode para ms informacin.

Ejemplo de una Respuesta para el Pedido de Autozacin de una Transaccin
<SOAP-ENV:Envelopexmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:api="http://api.de
<SOAP-ENV:Body>
<api:GetAuthorizeAnswerResponsexmlns:api="http://api.decidir.com.ar">
<api:StatusMessage>APROBADA</api:StatusMessage>
<api:AuthorizationKey>8496472a-8c87-e35b-dcf2-94d5e31eb12f</api:AuthorizationKey
<api:Payload>
<Answer xmlns="http://api.decidir.com.ar">
<FECHAHORA>2015-02-21T14:46:03Z</FECHAHORA >
<MONEDA>Peso Argentino</MONEDA>
<NROTICKET>725</NROTICKET>
<CODAUTORIZACION>090273</CODAUTORIZACION >
<NROTARJETAVISIBLE>450799XXXXXX4905</NROTARJETAVISIBLE >
<CODBARRAS></CODBARRAS>
</Answer>
<Request xmlns="http://api.decidir.com.ar">
<NROPERACION>1234</NROPERACION>
</Request>
</api:Payload>
</api:GetAuthorizeAnswerResponse>
</SOAP-ENV:Body>

Ver el estado de una transaccin.

Este servicio permite que un Comercio consulte transacciones y pueda verificar el estado en
que se encuentran las mismas.
Sandbox
Contrato de Servicio (WSDL): https://sandbox.decidir.com/services/t/1.1/Operation?

wsdl
Direccin (Endpoint): https://sandbox.decidir.com/services/t/1.1/Operation
Produccin
Contrato de Servicio (WSDL): https://sps.decidir.com/services/t/1.1/Operation?wsdl
Direccin (Endpoint): https://sps.decidir.com/services/t/1.1/Operation
Ver Estado de una Transacccin 67

Validacin Adicional de Datos

Slo para Transacciones con VISA.
Para que este servicio funcione, el comercio debe estar enviando en la invocacion al
formulario los campos necesarios.
La validacin adicional es parte de la informacin que se recibe de Visa al efectuarse la

compra.
La informacin se compone de 4 dgitos, cada dgito es el resultado de la validacin de un

dato ingresado por el comprador.
En el siguiente orden se informan los resultados de la validacin:
Tipo de Documento.
Nmero de Documento.
Nmero de Puerta de Domicilio de Entrega del resumen de la tarjeta. Fecha de Nacimiento
del Titular de la Tarjeta.
Los valores posibles son:
0 = Dato Correcto.
1 = Dato No Coincidente.
2 = Dato No Validado.
Esta validacin la realiza VISA en forma on line con los datos que poseen en la entidad. El
resultado de estas validaciones es solo orientativo, las transacciones no se rechazan por
encontrarse estos datos incorrectos.
El resultado se recibe dentro del Response en el campo VALDOM. Siempre incluye el

literal VTE (Ejemplo: VTE0011)

Requerimiento para ver el estado de una transaccin

En el llamado a DECIDIR se debern enviar los siguientes campos del servicio:
Valores
Tipo de
Campo Mandatorio Descripcin posibles /
Dato
Ejemplo
Cdigo de
comercio o Alfanumrico
IDSITE S cuenta de 8 12345678
provisto por caracteres
DECIDIR
Identificacin
unvocamente
de la
transaccin
Alfanumrico
para el
IDTRANSACTIONSIT S de 1 a 40 141120084707
Comercio.
caracteres.
Debe ser
distinto para
cada
operacin.

Ejemplo de un requerimiento para ver el estado de una transaccin
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:api="urn:DECIDIR.net">
<SOAP-ENV:Body>
<api:GetByOperationId>
<api:IDSITE>305</api:IDSITE>
<api:IDTRANSACTIONSIT>141120084707</api:IDTRANSACTIONSIT>
</api:GetByOperationId>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Respuesta del estado de una transaccin
Cam/po Mandatorio Descripcin Tipo de Dato
Numrico de 8
dgitos,
FECHA_ORIGINAL No
formato
"DDMMYYYY".
Numrico con
9 dgitos con
hasta 2
decimales
999999[.CC]
Usando el
punto como
Importe en
separador de $125,38 -> 125.38
MONTO S Pesos de la
decimales. No $12 -> 12.00
transaccin.
se permiten
comas, ni
como
separador de
miles ni como
separador de
decimales.
Cdigo de
autorizacin Decimal de
Depende del contrato
CUOTAS No generado por hasta dos
pago. 01, 02, 06, 12,
el medio de dgitos.
pago
Numero de
Numrico de
Hasta 4 dgitos
Voucher
Describe el
estado en el
ESTADO_DESCRI S que se Alfanumrico
encuentra la
transaccin
Nmero
identificador
del motivo por
IDMOTIVO S Numrico ver Tabla
el que se
encuentra en
dicho estado
Descripcin
adicional del
MOTIVO_ADIIONAL No motivo que Alfanumrico
viene en

algunos casos
Nombre del
TITULAR No titular de la Alfanumrico
tarjeta.
Numero 1 -> DNI
identificador Numrico, 1 2 -> CI
IDTIPODOC No
del tipo de dgito 3 -> LE
documento 4 -> LC
Nmero de
NRODOC No Numrico
documento
DNI
Tipo de CI
TIPODOC No
documento LE
LC
Cdigo de
autorizacin Alfanumrico
CODAUT S recibido del de hasta 8
medio de caracteres
pago.
Nmero de
Tarjeta,
alfanumrico
enmascarado
NROTARJ4 No de 20
segn
caracteres
normativas
nacionales
Descripcin
del motivo por
MOTIVO No el cul se Alfanumrico
encuentra en
ese estado.
Solo
transacciones
Visa Alfanumerico
VALDOM No .Respuesta de de 7 Ver Tabla
la validacin posiciones
de datos
adicionales
Mail del
Alfanumrico
usuario al que
MAIL S de 100 Ejemplo: decidir@hot
se le emite la
caracteres.
factura
Cdigo de
comercio o Alfanumrico
IDSITE S cuenta de 8
provisto por caracteres
DECIDIR

Nmero
identificador
del estado en
IDESTADO S Numrico
el que se
encuentra la
transaccin
Valor que
identifica al
medio de pago Ver [ANEXO Tablas
IDMEDIOPAGO S seleccionado Numrico Pago]
por el usuario (../../../Anexos/Tablas
para realizar la
transaccin
Nombre del
MEDIOPAGO_DESCRI S alfanumrico
medio de pago
identificador
FEMENINO
SEXOTITULAR No del sexo del
MASCULINO
tarjetahabiente
Calle donde el
tarjetahabiente
Varchar,
CALLE No recibe el
mximo 30
resumen de la
tarjeta
Nmero de
puerta donde
Numrico,
NROPUERTA No recibe el
mximo 6
resumen el
tarjetahabiente
Parmetro de
uso libre para
el comercio,
puede Alfanumrico
visualizarse en hasta 256
los caracteres,
PARAMSITIO No templates, permite los sig.
colocando: . El caracteres
valor enviado especiales "_-
tambin es ,.;:@|"
devuelto en el
post por
background
Fecha de
vencimiento
de la primera Numrico de 8
cuota, dgitos,
FECHAVTOCUOTA1 No necesario para formato
el medio de "DDMMYYYY".
pago

PYMENAcin
Alfanumrico
Resultado del hasta 8
Servicio de Caracteres,
RESULTADOCS no
Prevencin de VERDE /
fraudede ROJO /
AMARILLO
Identificador Alfanumrico
IDENTIFICADORCS No de la trx en de 256
CS. caracteres.

Ejemplo de una respuesta del estado de una transaccin
<?xml version="1.0" encoding="UTF-8"?>

<soapenv:Body>
<Operations xmlns="urn:Decidir.net">
<Operation>
<IDTRANSACCIONSITE>1357926</IDTRANSACCIONSITE>
<FECHA_ORIGINAL xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"
<CUOTAS>6</CUOTAS>
<ESTADO_DESCRI>Ingresada</ESTADO_DESCRI>
<MOTIVO_ADICIONAL xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"
<TITULAR>Nombre Titular</TITULAR>
<IDTIPODOC>1</IDTIPODOC>
<NRODOC>XXXXXXX</NRODOC>
<TIPODOC>DNI</TIPODOC>
<CODAUT xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true" />
<NROTARJ4 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true" />
<MOTIVO />
<VALDOM xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true" />
<MAIL>[email protected]</MAIL>
<IDSITE>XXXXXXXX</IDSITE>
<IDESTADO>1</IDESTADO>
<IDMEDIOPAGO>1</IDMEDIOPAGO>
<MEDIOPAGO_DESCRI>Visa</MEDIOPAGO_DESCRI>
<SEXOTITULAR xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"/>
<CALLE xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true" />
<NROPUERTA xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true" />
<PARAMSITIO xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true" />
<FECHAVTOCUOTA1 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"
<IDOPERACIONMEDIOPAGO>119800</IDOPERACIONMEDIOPAGO>
<TERMINAL>99002002</TERMINAL>
<LOTE>063</LOTE>
<RESULTADOCS>VERDE</RESULTADOCS>
<IDENTIFICADORCS>4501215399145000001513</IDENTIFICADORCS>
</Operation>
</Operations>
</soapenv:Body>
</soapenv:Envelope>

Realizar una Anulacin

A travs de este mtodo se puede anular una transaccin. Para ello, la transaccin debe
estar en estado Autorizada (4) o PreAutorizada (11).
Observacin: En el caso de las transacciones spliteadas se puede hacer devolucion total

sobre uno de los comercios en los que se distribuye la orden, siempre y cuando no sea el
comercio padre, es decir aquel que se envi en el merchant, en caso de envar el idsite del
padre, la devolucin se hrar sobre todos los comercios involucrados en la distribucin.
Realizar Anulacin 76
Requerimiento
Valores
Tipo de
Campo Mandatorio Descripcin posibles
Dato
/ Ejemplo
Cdigo de
Comercio o
cuenta provisto
por
DECIDIR(mismo
valor que viaja en
el Merchant). Si la
anulacin es
Alfanumrico
sobre una
NROCOMERCIO S de 8 12345678
transaccn
caracteres
spliteada y se
desea anular
solamente la
distribucin a un
comercio
especfico se
enva el ID site de
dicho comercio.*
Identificacin
unvocamente de
la transaccin Alfanumrico
NROOPERACION S para el Comercio. de 1 a 40 10000012
Debe ser distinto caracteres
para cada
operacin.
*En caso de que el comercio padre se encunetre involucrado en la distribucin envar la

anulacin con el ID site de este implicara anular toda la transaccin y no solo la distribucin
a dicho comercio.
Ejemplo

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/20
<soap:Body>
<Execute xmlns="http://api.decidir.com.ar">
<Security>XXXXXXXXXXXXXXXXXXXXXXXXX</Security>
<Session xsi:nil="true" />
<Merchant>12345678</Merchant>
<Operation>Anulacion</Operation>
<EncodingMethod>XML</EncodingMethod>
<api:Payload xmlns:api="http://api.decidir.com.ar">
<Request xmlns="">
<NROOPERACION>CV142668740924-1</NROOPERACION>
</Request>
</api:Payload>
</Execute>
</soap:Body>
</soap:Envelope>
Respuesta para una Anulacin
Valores
Campo Mandatorio Descripcin Tipo de Dato posibles /
Ejemplo
Nmero de
identificacin
del motivo
del resultado
Resultado
RESULTADO S de la Alfanumrico
anulacin
Para casos
de
transacciones
aprobadas es
0. En las
Fecha y Hora transacciones
Fecha y
(aaaammddTHMMSSZ) rechazadas
FECHAHORA Si Hora de la
La hora se expresa en vara el
Transaccin
formato 24 hs. cdiigo
dependiendo
del motivo de
rechazo y del
medio de
pago.
Ejemplo de una respuesta para una Anulacin

<soapenv:Body>
<api:StatusMessage>Anulacin aceptada</api:StatusMessage>
<api:AuthorizationKey>E8321D4F9E6DDC6D3D1426687429614</api:AuthorizationKey>
<api:Payload>
<Answer>
</Answer>
</api:Payload>
</soapenv:Body>
</soapenv:Envelope>
Realizar una devolucin

A travs de este mtodo se realizan devoluciones totales o parciales. Para ello la
transaccin debe estar en estado Acreditada (6) Autorizada* (14).
Realizar Devolucin 81
Realizar una devolucin Total

Si no se le indica monto, la devolucin se har por el total de la orden.
Observacin: En el caso de las transacciones spliteadas se puede hacer devolucion total

sobre uno de los comercios en los que se distribuye la orden, siempre y cuando no sea el
comercio padre, es decir aquel que se envi en el merchant, en caso de envar el idsite del
padre, la devolucin se hrar sobre todos los comercios involucrados en la distribucin.
Requerimiento
Valores
Tipo de
Dato
/ Ejemplo
Cdigo de
Comercio o
cuenta provisto
por
DECIDIR(mismo
valor que viaja en
el Merchant). Si la
devolucin es
Alfanumrico
sobre una
NROCOMERCIO S de 8 12345678
transaccn
caracteres
spliteada y se
desea anular
solamente la
distribucin a un
comercio
especfico se
enva el ID site de
dicho comercio.*
Identificacin
unvocamente de
para cada
operacin.
*En caso de que el comercio padre se encunetre involucrado en la distribucin envar la

devolucin con el ID site de este implicara anular toda la transaccin y no solo la
distribucin a dicho comercio.
Ejemplo de un requerimiento para realizar una devolucin total

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<soap:Body>
<Operation>Devolucion</Operation>
<Request xmlns="">
<NROOPERACION>179783-0</NROOPERACION>
</Request>
</api:Payload>
</Execute>
</soap:Body>
</soap:Envelope>
NOTA: el valor a ingresar en el parametro Operation nunca lleva acentos.
Respuesta
Valores
posibles
/
Ejemplo
Nmero de
identificacin
del motivo
del resultado
Resultado
devolucin
Fecha y Hora
Fecha y
(aaaammddTHHMMSSZ).
FECHAHORA S Hora de la
Transaccin
formato 24 hs.
Ejemplo de una respuesta para realizar una devolucin.

<soapenv:Body>
<api:StatusMessage>Devolucin aceptada</api:StatusMessage>
<api:Payload>
<Answer>
</Answer>
</api:Payload>
</soapenv:Body>
</soapenv:Envelope>
Realizar una devolucin Parcial

Tambin es posible realizar devoluciones parciales (incluso ms de una por orden, siempre
y cuando no se supere el monto de la misma).
Requerimiento
Valores
Tipo de
Dato
/ Ejemplo
Cdigo de
Comercio o
cuenta provisto
por
DECIDIR(mismo
valor que viaja en
el Merchant). Si la
devolucin es
Alfanumrico
sobre una
NROCOMERCIO de 8 12345678
transaccn
caracteres
spliteada y se
desea anular
solamente la
distribucin a un
comercio
especfico se
enva el ID site de
dicho comercio.
Identificacin
unvocamente de
NROOPERACION para el Comercio. de 1 a 40 10000012
para cada
operacin.
Monto que
se desea $12 ->
Especifica el devolver 12.00
MONTO S
monto a devolver. (Formato $34.50 ->
"999999.CC" 34.50
).
Ejemplo de un requerimiento para realizar una devolucin

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:api="http://api.dec
<soapenv:Header/>
<soapenv:Body>
<api:Execute>
<api:Security>XXXXXXXXXXXXXXXXXXXXXXXXXX</api:Security>
<api:Operation>Devolucion</api:Operation>
<api:EncodingMethod xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil
<api:Payload>
<Request>
<NROCOMERCIO>xxxxxx</NROCOMERCIO>
</Request>
</api:Payload>
</api:Execute>
</soapenv:Body>
</soapenv:Envelope>
Respuesta de una devolucin parcial
Valores
posibles
/
Ejemplo
Nmero de
identificacin
del motivo
del resultado
Resultado
devolucin
Fecha y Hora
Fecha y
(aaaammddTHHMMSSZ).
Transaccin
formato 24 hs.
Ejemplo de una respuesta para realizar una devolucin.
<soapenv:Body>
<api:StatusMessage>Devolucin aceptada</api:StatusMessage>
<api:AuthorizationKey>XXXXXXXXXXXXXXXXXXXXXXXXX</api:AuthorizationKey>
<api:Payload>
<Answer>
</Answer>
</api:Payload>
Realizar una Confirmacin

Esta operatoria se utiliza exclusivamente luego de haber realizado un Pedido de
Autorizacin en 2 pasos.
Realizar una Confirmacin 92

Requerimiento
Valores
Tipo de
Dato
/ Ejemplo
Cdigo de
Comercio o
cuenta provisto Alfanumrico
NROCOMERCIO S por de 8 12345678
DECIDIR(mismo caracteres
valor que viaja en
el Merchant)
Identificacin
unvocamente de
para cada
operacin.
Numrico
Monto por el cul
usando .
se confima la
cmo 12.00
MONTO No transaccin en los
separador 12
casos de monto
de centavos
variable
*
* Tener en cuenta que a diferencia del campo MONTO del Pedido de autorizacin, en este
caso el campo slo tomar como centavos los dgito posterires al punto, si se enva 1200 se
asumirn $1200 y no $12,00

Ejemplo de un requerimiento de Confirmacin
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/20

<soap:Body>
<Operation>Confirmacion</Operation>
<Request xmlns="">
<NROOPERACION>961148-0</NROOPERACION>
</Request>
</api:Payload>
</Execute>
</soap:Body>
</soap:Envelope>

Respuesta de una Confirmacin
Valores
posibles
/
Ejemplo
Nmero de
identificacin
del motivo
del resultado
Resultado
confirmacin
Fecha y Hora
Fecha y
(aaaammddTHHMMSSZ).
Transaccin
formato 24 hs.

Ejemplo de respuesta de una Confirmacin

<soapenv:Body>
<api:StatusMessage>Confirmacin Recibida</api:StatusMessage>
<api:Payload>
<Answer>
</Answer>
</api:Payload>
</soapenv:Body>
</soapenv:Envelope>

Ejemplos de integracin
Para ejemplificar el metodo de integracin utilizaremos el lenguaje PHP en su versin 5.
Ejemplos de integracin 97
Pedido de autorizacin
<?php
$end_point = "https://sandbox.decidir.com/services/t/1.1/Authorize.AuthorizeHttpSoap12Endpoint"
$wsdl = "https://sandbox.decidir.com/services/t/1.1/Authorize?wsdl";
$http_header = 'Authorization: PRISMA RV82RVHO5T0O5CZUUTX2FLHU';
$headers = array(
'http'=>array(
'header'=>$http_header)
);
$contexto = stream_context_create($headers);
$array_de_datos = array(
"Merchant"=>"12345678",
"EncodingMethod"=>"XML",
"Security"=>"PRISMA RV82RVHO5T0O5CZUUTX2FLHU",
"Payload"=>"
<Request>
<MONTO>50</MONTO>
</Request>"
);
$soap_client = new SoapClient($wsdl, array(

'stream_context'=>$contexto,
'location'=>$end_point,
));
$rta = $soap_client->SendAuthorizeRequest($array_de_datos);
if($rta->StatusCode == -1){
echo "rta ok, requestkey: $rta->RequestKey , publicRequestKey: $rta->PublicRequestKey"
}else{
echo "rta Error: $rta->StatusMessage";
}
Respuesta:
Pedido de Autorizacin 98
object(stdClass)[2]
public 'StatusCode' => int -1
public 'StatusMessage' => string 'Solicitud de Autorizacin Registrada' (length=36)
public 'URL_Request' => string 'https://forms.decidir.net/formulario/commands?command=formulario&m=
public 'RequestKey' => string '3de5eb57-eff8-2984-2610-f905fbebae21' (length=36)
public 'PublicRequestKey' => string 'e77f1a79-cefc-d5d5-a5e0-1d218256e1e5' (length=36)
Pedido de Autorizacin 99
Invocacin del formulario

Por el momento se proporciona un formulario custom como mtodo de integracin.

Formulario Custom
En este esquema el cdigo del Formulario de Pagos debe ser desarrollado por el comercio
bajo estrictas especificaciones brindadas por DECIDIR. Se debe tener en cuenta que al
elegir este mecanismo el Comercio acepta implementar todos y cada uno de los cambios
que DECIDIR solicite en el futuro, para permitir que el producto disponga de todas las
funcionalidades previstas y necesarias.
Adems, las adecuaciones necesarias para soportar el Formulario de pago en diferentes

Dispositivos estarn a cargo del Comercio Cliente.
La ventaja de este mtodo es el nivel de personalizacin que puede alcanzar en el diseo

de su formulario.
Javascript
JQuery
<html lang="en">
<head>
<meta charset="utf-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Payment method</title>
<style type="text/css">

</style>
</head>
<body class="paybox">
<h1>Formulario de Pago</h1>
<form action="respuesta.php" method="POST" id="payform">
<div class="row">
<label for="CardNumber">Nmero de Tarjeta</label>
<div id="boxCardNumber"><input type="text" id="CardNumber" placeholder="
</div>
<div class="row">
<label for="CardHolderName">Nombre</label>
<input type="text" id="CardHolderName" placeholder="Ingrese su nombre" />
</div>
<div class="row">
<div class="col col1">




<label for="CardExpirationMonth">Vencimiento</label>
<select id="CardExpirationMonth"><option>MM</option><?$m=1; do{?><option
<select id="CardExpirationYear"><option>AAAA</option><?$y=date('Y');

</div>
<label for="CardSecurityCode">CVC</label>
<input type="text" size="3" id="CardSecurityCode" placeholder="" >
</div>
</div>
<div class="row">
<label for="CardHolderMail">Email</label>
<input type="text" size="30" id="CardHolderMail" placeholder="Ingrese su email"
</div>
<br/><br/>
<div class="row">
<button type="submit" class="btn btn-primary col-xs-12">Pagar $AR 55</button
</div>
<input type="hidden" name="idRequest" id="RequestKey" value="<?php echo $rta->PublicReque
</form>
<script src="https://sandbox.decidir.com/custom/callback/1.1/payment.js"></script>
<script type="text/javascript">
new Payment().init({
id: 'payform',
fieldsId: {
CardHolderName: 'CardHolderName',

CardHolderMail: 'CardHolderMail',
CardNumber: 'CardNumber',
//Para fecha de venciomiento en 2 selectores:
CardExpirationMonth: 'CardExpirationMonth',
CardExpirationYear: 'CardExpirationYear',
//Para fecha de vencimiento en un solo campo:
//CardExpirationDate: 'CardExpirationDate',
CardSecurityCode: 'CardSecurityCode',
PublicRequestKey: 'RequestKey',
CardSecurityCodeHelper: 'CardSecurityCodeHelper'
},
callback: function (PublicAnswerKey) {
pa = PublicAnswerKey;
rk = "<?php echo $rta->RequestKey; ?>";
prk = "<?php echo $rta->PublicRequestKey; ?>";
location.href="gaa.php?pa="+pa.PublicAnswerKey+"&rk="+rk+"&prk="+prk;
},
options: {
displayCreditCardTypeDetected: true,
displayCreditCardTypeContainerId: null,
cardType: null,
cardBin: null,
displayCardBin: true,
displayCardBinContainerId: null
}
});
</script>
</body>
</html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Payment method</title>
<style type="text/css">

</style>
<script type="text/javascript" src="https://code.jquery.com/jquery-1.10.2.min.js"></script
<script type="text/javascript">

</script>
</head>
<body class="paybox">
<h1>Formulario de Pago</h1>
<form action="respuesta.php" method="POST" id="payform">
<div class="row">
<label for="CardNumber">Nmero de Tarjeta</label>
<div id="boxCardNumber"><input type="text" id="CardNumber" placeholder="
</div>
<div class="row">
<label for="CardHolderName">Nombre</label>
<input type="text" id="CardHolderName" placeholder="Ingrese su nombre" />
</div>
<div class="row">




<label for="CardExpirationMonth">Vencimiento</label>
<select id="CardExpirationMonth"><option>MM</option><?$m=1; do{?><option
<select id="CardExpirationYear"><option>AAAA</option><?$y=date('Y');

</div>
<label for="CardSecurityCode">CVC</label>
<input type="text" size="3" id="CardSecurityCode" placeholder="" >
</div>
</div>
<div class="row">
<label for="CardHolderMail">Email</label>
<input type="text" size="30" id="CardHolderMail" placeholder="Ingrese su email"
</div>
<br/><br/>
<div class="row">
<button type="submit" class="btn btn-primary col-xs-12">Pagar $AR 55</button
</div>
<input type="hidden" name="idRequest" id="RequestKey" value="<?php echo $rta->PublicReque
</form>
</body>
</html>

Obtencin de autorizacin
<?php
$RequestKey=$_GET["rk"];
$AnswerKey=$_GET["pa"];
$headers = array(
'http'=>array(
);
"Merchant"=>"12345678",
"RequestKey"=>$RequestKey,
"AnswerKey"=>$AnswerKey
);
'encoding'=>"UTF-8",
));
var_dump($soap_client->GetAuthorizeAnswer($array_de_datos));
Ejemplo de Respuesta:
Obtener Informacin de Respuesta 106

object(stdClass)#2 (5){
["StatusCode"]=> int(-1) ["StatusMessage"]=> string(8)
"Aprobada" ["AuthorizationKey"]=> string(36)
"a79ea4a6-3fdb-ec2d-1176-080957dab2f3" ["EncodingMethod"]=> string(3)
"XML" ["Payload"]=> object(stdClass)#3 (2) {
["Answer"]=> object(stdClass)#4 (6) {
["FECHAHORA"]=> string(20) "2015-08-28T16:50:46Z"
["MONEDA"]=> string(0) ""
["NROTICKET"]=> string(3) "205"
["CODAUTORIZAcin"]=> string(6) "165045"
["NROTARJETAVISIBLE"]=> string(16) "450799XXXXXX4905"
["CODBARRAS"]=> string(0) ""
}
["Request"]=> object(stdClass)#5 (3) {
["NROCOMERCIO"]=> string(8) "12345678"
["NROOPERAcin"]=> string(10) "9238742988"
["MONTO"]=> string(5) "50.00"
}
}
}
Obtener Informacin de Respuesta 107

Ver Estado de una Transacccin
<?php
$end_point = "https://sandbox.decidir.com/services/t/1.1/Operation.OperationHttpsSoap12Endpoint"
$wsdl = "https://sandbox.decidir.com/services/t/1.1/Operation?wsdl";
$headers = array(
'http'=>array(
);
"IDSITE"=>"XXXXXXX",
"IDTRANSACTIONSIT"=>"9238742994"
);

));
$rta = $soap_client->Get($array_de_datos);
print_r($rta);
Respuesta:

stdClass Object (
[Operation] => stdClass Object (
[IDTRANSACcinSITE] => 9238742994
[FECHA_ORIGINAL] => 28/08/2015 18:24:59
[MONTO] => 50.00 [CUOTAS] => 1
[NROTICKET] => 213 [ESTADO_DESCRI] => Autorizada
[IDMOTIVO] => -1
[MOTIVO_ADIcinAL] =>
[TITULAR] => vyfvu
[IDTIPODOC] => 0
[NRODOC] =>
[TIPODOC] =>
[CODAUT] => 182459
[NROTARJ4] => 4905
[MOTIVO] =>
[VALDOM] => VTE0011
[MAIL] =>
[IDSITE] => 12345678
[IDESTADO] => 4
[IDMEDIOPAGO] => 1
[MEDIOPAGO_DESCRI] => Visa
[SEXOTITULAR] =>
[CALLE] =>
[NROPUERTA] =>
[PARAMSITIO] =>
[FECHAVTOCUOTA1] =>
[IDOPERACIONMEDIOPAGO] =>
[TERMINAL] =>
[LOTE] =>
[RESULTADOCS] =>
[IDENTIFICADORCS] =>
)
)

Devolucin
Ejemplo de una Devolucin Total
Ejemplo de una Devolucin Parcial
Devolucin 110
Devolucin Total
Ejemplo:
<?php
ini_set("display_errors", 1);
$headers = array(
'http'=>array(
);
"Merchant"=>"12345678",
"Operation"=>"Devolucin",
"Payload"=>"
<Request>
</Request>"
);

));
$rta = $soap_client->Execute($array_de_datos);
echo "<br />";
print_r($rta);
Respuesta:
Devolucin 111
stdClass Object (
[StatusCode] => -1
[StatusMessage] => Devolucin aceptada
[AuthorizationKey] => 81E1ADFC0151ED49731440792096772
[EncodingMethod] => XML
[Payload] => stdClass Object (
[Answer] => stdClass Object (
[IDMOTIVO] => 0
[RESULTADO] => APROBADA
[FECHAHORA] => 2015/08/28 17:01:36
)
)
)
Devolucin 112
Devolcin Parcial
<?php
ini_set("display_errors", 1);
$http_header = 'Authorization: PRISMA XXXXXXXXXXXXXXXXXXXXXXXX';
$headers = array(
'http'=>array(
);
"Merchant"=>"12345678",
"Security"=>"PRISMA XXXXXXXXXXXXXXXXXXXXXXXX",
"Operation"=>"Devolucin",
"Payload"=>"
<Request>
<MONTO>10</MONTO>
</Request>"
);

));
echo "<br />";
print_r($rta);
Respuesta:
Devolucin 113
stdClass Object (
[StatusCode] => -1
[StatusMessage] => Devolucin aceptada
[AuthorizationKey] => A2B770F888CF4FEE7B1441914555812
[IDMOTIVO] => 0
[FECHAHORA] => 2015/09/10 16:49:14
)
)
)
Devolucin 114
Anulacin
<?php
$headers = array(
'http'=>array(
);
"Merchant"=>"12345678",
"Operation"=>"Anulacin",
"Payload"=>"
<Request>
</Request>"
);

));
echo "<br />";
print_r($rta);
Ejemplo de respuesta:
Anulacin 115
stdClass Object (
[StatusCode] => -1
[StatusMessage] => Anulacin aceptada
[AuthorizationKey] => 81E1ADFC0151ED49731440793768081
[IDMOTIVO] => 0
[FECHAHORA] => 2015/08/28 17:29:27
)
)
)
Anulacin 116
Configuraciones adicionales
Mails de Confirmacin
Time out
Configuraciones Adicionales 117

Mails de Confirmacin
Nota: Los templates que se utilizan para el envo del e-mail de confirmacin que enva
nuestro servidor al COMERCIO y a los CLIENTES del comercio son los denominados:
ok.cliente y ok.comercio, respectivamente.
El formato de dichos archivos es de texto plano, por lo cul los mismos no pueden ser
personalizados por el comercio. Por otro lado, es posible que el comercio modifique el texto
que se encuentra en dichos archivos y, adems, les incorpore texto nuevo, aunque es
recomendable que no incorporen texto con acentos o caracteres especiales, puesto que
puede llegar a ocurrir que los mismos no sean visualizados correctamente por el usuario en
su servidor de correo electrnico.
Por otro lado, el comercio no debera tener en cuenta la recepcin de este tipo de correos
para considerar que la transaccin fue aprobada, dado que puede llegar a ocurrir que el
comercio o bien el cliente no lo reciba, ya sea por un inconveniente con su correo o bien por
motivos diversos.
Cabe destacar que nuestro sistema slo enva los e-mails de confirmacin para aquellas
operaciones que fueron aprobadas por los medios de pago pertinentes (los mismos no se
envan ni para las transacciones rechazadas, ni para las abandonadas).
Mails de confirmacin 118

Timeout de la Compra
En DECIDIR se puede limitar el tiempo con el que el tarjetahabiente cuenta para completar
los datos sensibles de la tarjeta.
Esta funcionalidad suele usarse en comercios que necesitan liberar entradas o butacas si la
transaccin lleva ms de un determinado tiempo y no recibi respuesta de finalizacin de la
transaccin.
Por default, la sesin caduca en 30 minutos.
Si desea modificar este parmetro, debe enviar el requerimiento al Help Desk de Decidir
([email protected]).
Time Out de la Compra 119

Servicio de Prevencin de Fraude

CyberSource
La prevencin del fraude en los pagos por Internet es cada vez ms compleja a medida que
sus clientes recurren a varios canales y dispositivos. Conocimientos insuficientes de los
datos generan prdidas por operaciones fraudulentas, rechazo de transacciones vlidas y
revisiones manuales innecesarias. DECIDIR puede ayudarle a mejorar la eficacia de su
estrategia de prevencin del fraude. Implemente Cybersource nuestro potente servicio
adicional, que le permite mitigar y gestionar el fraude on line de la forma mas eficaz.
Si est interesado en contratar este servicio o si requiere informacin adicional sobre los
diferentes modelos de implementacin, lo invitamos a que se contacte con su ejecutivo
comercial DECIDIR o mediante la casilla [email protected].
Los conceptos detallados a continuacin aplican a la operatoria General del servicio.
Para poder utilizar ste servicio, el comercio debe estar integrado via WebServices con
DECIDIR y enviar en el request inicial ciertos datos adicionales de cada compra, segn se
describe a continuacin.
Servicio de Prevencin de Fraude CyberSource 120

Funcionamiento del Servicio

El servicio proporciona un "score on line", que refleja el grado de certidumbre sobre el
hecho que la transaccin sea o no genuina. A este resultado, lo llamamos Resultado
Cybersource.
DECIDIR combina este resultado, con el Resultado del emisor del medio de pago utilizado
y determina el Resultado Final de la transaccion.
El Comercio puede ver estos tres resultados en el Backoffice de la plataforma DECIDIR.
El Resultado Cybersource indicar el estatus alcanzado por la transaccin. Para facilitar

su comprensin, estos cdigos, tendrn asociado un color que es el que se ver reflejado
en el back office de Decidir. A su vez en el campo RESULTADOCS de la mensajeria se
recibe el correspondiente Cdigo de Respuesta (ver tabla Cdigos de Respuesta
CyberSource) que permite interpretar a detalle el resultado.
Resultado
Descripcin
CS / Color
Verde ACCEPT (transaccin considerada genuina por CS).
Rojo REJECT (transaccin considerada fraudulenta por CS).
REVIEW (transaccin que debe ser revisada Manualmente para
Amarillo
determinar su status final).
REJECT producido x DECIDIR (la Informacin proporcionada en la
transaccin es Incompleta. Lo determina el Proceso Validador de
Negro
DECIDIR. La transaccin no viaja a CS). Cdigos 1xxxx en adelante. Se
debe completar la informacion faltante y reintentar la transaccin.
REJECT proporcionado x DECIDIR. Lo determina el Proceso Decidir
ante un TIME OUT en el intento de conexion con Cybersource. La
informacin provista en la transaccin es suficiente, pero no fue posible
Azul
obtener el score de Cybersource. El sistema reintenta restablecer la
conexin hasta 3 veces y en caso de no conseguirlo, devuelve este
resultado.
Resultado Final de la Transaccin:

La siguiente tabla muestra el resultado final de la transaccin a partir de obtener un
Resultado emisor = Aprobado y los diferentes Resultados Cybersource.
Por Default, ante un rechazo de Cybersource, DECIDIR anular automticamente la

transaccin previamente aprobada por el emisor del medio de pago.
Funcionamiento del Servicio 121

RESULTADO RESULTADO RESULTADO FINAL

EMISOR CYBERSOURCE TRANSACCION
Aprobada Verde Aprobada

Aprobada Amarillo En Revisin/Rechazada (a)
Aprobada Azul Aprobada
Aprobada Negro Aprobada (b)

Anulada Rojo Anulada (c)
Devuelta Rojo Devuelta (c)
Ingresada Negro Ingresada (d)
(a) Depende de si el comercio tiene o no Revision Manual.
(b) Requiere que el Comercio se parametrice para continuar la transaccion al emisor, sin los
datos suficientes para ser scoreada por Cybersource.
(c) La Trasanccin fue aprobada por el Medio de pago y rechazada por Cybersource. La
Anulacin o Devolucin, es Automtica.
(d) Requiere que el comercio se parametrice para no continuar una transaccion que no
podr ser scoreada por Cybersource, por falta de informacin solicitada. La transaccin no
se enva al emisor pero queda registrada en la Consola Decidir.
Secuencia de una transaccin con CyberSource:

DECIDIR enviar la transaccin al medio de pago para obtener el "resultado del emisor" y si
este es Aprobado, activar Cybersource validando los datos adicionales recibidos. Este
proceso de validacin determinar que sean los necesarios y suficientes para scorear la
transaccin. DECIDIR rechazar aquellas transacciones que no cumplan con estos
requisitos.

Se han definido 5 verticales de negocio. Cada vertical posee reglas de prevencin de fraude
particulares, y un set de datos adicionales distintos al resto. Con lo cual, antes de comenzar
a realizar algn desarrollo, cada comercio deber identificar a qu vertical pertenece y
enviar los datos adicionales correspondientes. Una vez definida la vertical no se puede
cambiar. El Departamento de Help Desk parametrizar esta vertical en el backoffice de
DECIDIR.
Los 5 verticales definidos son:
Retail
Travel
Services
Digital Goods
Ticketing

Datos Adicionales a enviar

Para utilizar ste servicio, el comercio debe enviar a DECIDIR en cada transaccin, datos
adicionales de la compra . Esta nueva informacin, deber agregarse dentro del campo
payload en el pedido de Autorizacin. (SendAutorizeRequest).
Los datos adicionales a enviar se dividen en 3 categoras:
1. Datos de CyberSource comunes a todos los verticales. Los campos definidios como
mandatorios, deben enviarse siempre, sin importar el vertical al cual pertenecen.
Mientras que los campos definidos como opcionales, pueden no enviarse pero es
altamente recomendable que se los tenga en cuenta al momento de integrarse. El
nombre de cada campo es autoexplicativo.
2. Datos adicionales propios de cada vertical. Estos datos deben enviarse de acuerdo al
vertical al cual pertenece cada comercio y pueden llegar a ser hasta 100 campos. Los
campos referidos como CSMDDXX (donde XX es un nmero entre 01 y 99), son
campos posicionales que deben respetar lo definido en cada caso.
Restricciones: Los CSMDD1 al CSMDD11 estan ocupados por Campos con
informacin necesaria generada por el Comercio o por Decidir para todas las verticales.
No se deben alterar o utilizar para enviar otra informacin. Los CSMDD35 a CSMDD43
inclusive no pueden ser utilizados para el envo de informacin. El campo CSMDD44
puede utilizarse con una funcionalidad especifica adicional. Ver descripcin.
3. DeviceFingerPrint Este dato determina la huella digital del dispositivo desde donde se
est realizando la transaccin. Es mandatorio enviarlo en cada transaccin.
Datos Adicionales a Enviar 124

Datos de CyberSource comunes a todos los verticales

Estos datos deben enviarse siempre, sin importar el vertical al cual pertenecen.
IMPORTANTE: el no envo de cualquiera de los datos definidos como mandatorios en sta

seccin, provocar la devolucin de Resultado NEGRO.
Dentro de este set de datos se destaca por su importancia el DEVICE FINGERPRINT. Es la

huella digital del dispositivo desde donde se realiza la transaccin. Aquellos comercios
que implementen la interface con DECIDIR utilizando el Formulario Custom, deben tener en
cuenta la seccin Device Fingerprint - Implementacin del presente manual.
Parmetro Mandatorio Descripcin Descripcin

Alfanumrico
Ciudad de
CSBTCITY S de 50 Ejemplo: Villa G
facturacin
caracteres.
Alfanumrico
Pas de
CSBTCOUNTRY S de 2 Cdigo ISO ()
facturacin
caracteres.
Identificador
del usuario al
que se le
emite la Alfanumrico
CSBTCUSTOMERID Si factura. No de 50 Ejemplos:
puede caracteres.
contener un
correo
electrnico
Alfanumrico
IP de la PC
CSBTIPADDRESS S de 15 Ejemplo: 10.1.2
del comprador
caracteres.
Mail del
Alfanumrico
usuario al que
CSBTEMAIL Si de 100 Ejemplo: decidir
se le emite la
caracteres.
factura
Nombre del
Alfanumrico
usuario al que
CSBTFIRSTNAME Si de 60 Ejemplo: Juan
se le emite la
caracteres.
factura
Apellido del
Alfanumrico
usuario al que
CSBTLASTNAME Si de 60 Ejemplo: Perez
se le emite la
caracteres.
factura
Telfono del
Datos Comunes a Todos los Verticales 125

usuario al que
se le emite la
factura. No Alfanumrico
CSBTPHONENUMBER Si utilizar de 15 Ejemplo: 541160
guiones, caracteres.
puntos o
espacios.
Incluir cdigo
de pas
Cdigo Postal Alfanumrico
CSBTPOSTALCODE Si de la direccin de 10 Ejemplo: C1010
de facturacin caracteres.
Provincia de Alfanumrico
Ver Provincias
CSBTSTATE Si la direccin de de 2
corresponde a C
facturacin caracteres.
Domicilio de
facturacin
Alfanumrico
(Calle Numero
CSBTSTREET1 Si de 60 Ejemplo: Cerrito
interior
caracteres.
Numero
Exterior)
Alfanumrico
CSBTSTREET2 No Localidad de 60 Ejemplo: CABA
caracteres.
Alfanumrico
CSPTCURRENCY Si Moneda de 5 Ejemplo: ARS
caracteres.
"999999.CC"
Con
decimales
obligatorios,
usando el
puntos como
separador de Numrico de
CSPTGRANDTOTALAMOUNT Si decimales. No 15 Ejemplos:
se permiten posiciones
comas, ni
como
separador de
miles ni como
separador de
decimales.
Alfanumrico
Canal de
CSMDD6 No de 255 Valores posibles
venta
caracteres.
Cantidad de
dias que est

registrado el Alfanumrico
CSMDD7 No
cliente en el de 255
sitio del caracteres.
comercio.
(num Dias)
Para indicar si
el usuario est
comprando
como invitado
en la pgina
del comercio. Valor
CSMDD8 No Valores posibles
En caso de Booleano
ser "S", el
campo
CSMDD9 no
deber
enviarse.
Valor del
password del
usuario
Alfanumrico
registrado en
CSMDD9 No de 255
el portal del
caracteres.
comercio.
Incluir el valor
en hash
Cantidad de
transacciones
realizadas por
el mismo
Alfanumrico
usuario
CSMDD10 No de 255
registrado en
caracteres.
el portal del
comercio
(Num
transacciones)
Alfanumrico
Celular del
CSMDD11 No de 255
cliente
caracteres.
Este campo pue
Alfanumrico particular del co
CSMDD44 No uso interno de 255 especfico "NOS
caracteres. la transaccin e
Valor de uso inte
Identificador
del
Fingerprint.
Solo se
informa si el String hasta
CSDEVICEFINGERPRINTID S Cliente 255 123456789 / a0

Implementa 255
integracin
con
Formulario
Custom
Url donde se
transmitir el
post para
informar el
cambio de
estado de una String hasta
URLDINAMICA No http://www.decid
transaccin 255
revisada
manualmente
con la
herramienta
CaseManager

Datos adicionales propios de cada vertical

Estos datos deben enviarse de acuerdo al vertical al cual pertenece cada comercio. Estos
datos no son de carcter obligatorio, no obstante considere que a mayor cantidad de
informacin provista en la transaccin, ms acertado ser el resultado de Cybersource.
Recordemos los 5 verticales definidos:
Retail
Travel
Services
Digital Goods
Ticketing
Verticales 129
Datos adicionales para TRAVEL
Ruta completa del

viaje, ORIG1- Alfanumrico
CSDMCOMPLETEROUTE Si DEST1[:ORIG2- de 255
DEST2...:ORIGn- caracteres.
DESTn]
Alfanumrico
CSDMJOURNEYTYPE Si Tipo de viaje. de 32
caracteres.
Fecha y hora del
primer tramo del
viaje. Utilizar GMT.
Formato: yyyy-MM-
ddhh:mma z donde:
hh = hora en formato
12-horas a = am o pm
z = huso horario del Alfanumrico
CSDMDEPARTUREDATETIME Si vuelo de salida. Por de 25
ejemplo: si la caracteres.
compaa tiene su
sede en la ciudad de
A, pero el vuelo sale
de la ciudad B, z es el
horario de la ciudad B
al momento de la
salida.
Cantidad total de
CSADNUMBEROFPASSENGERS Si Numrico
pasajeros
Alfanumrico
Cdigo de Reserva
CSMDD17 S de 255
(PNR)
caracteres.
3rd PartyBooking?
(S/N) - Identifica si el Valor
CSMDD18 S
tarjetahabiente viaja o Booleano
no
Alfanumrico
CSMDD19 No Departure City de 3
caracteres.
Alfanumrico
CSMDD20 No Final Destination City de 3
caracteres.
International Flight - Valor

CSMDD21 No Idenifica si el viaje es
Verticales 130
internacional o no
Alfanumrico
CSMDD22 No FrequentFlyerNumber de 255
caracteres.
Alfanumrico
CSMDD23 No Class of Service de 255
caracteres.
Nmero de da de la
CSMDD24 No semana en que parte Caracter(1).
el vuelo
Nmero de la Alfanumrico
CSMDD25 No semana del ao en de 255
que se viaja caracteres.
Alfanumrico
CSMDD26 No AirlineCode de 2
caracteres.
Code Share - Nmero
de cdigo compartido Alfanumrico
CSMDD27 No para SKYTEAM, de 255
STAR ALLIANCE, caracteres.
ETC
Datos a enviar por cada pasajero, los valores deben estar separado con "#":
Verticales 131
Parmetro Mandatorio Descripcin Descripcin Valores posibl
Alfanumrico
Email del
CSITPASSENGEREMAIL Condicional de 255 [email protected]
pasajero
caracteres.
Alfanumrico
Nombre del
CSITPASSENGERFIRSTNAME Condicional de 60 Juan
pasajero
caracteres.
Alfanumrico
Nmero de
CSITPASSENGERID No de 32 21457547
pasaporte
caracteres.
Alfanumrico
Apellido del
CSITPASSENGERLASTNAME Condicional de 60 Perez
pasajero
caracteres.
Nmero de Alfanumrico
CSITPASSENGERPHONE Condicional telfono del de 15 541160913988
pasajero caracteres.
Clasificacin
del pasajero
dentro de la
Alfanumrico
empresa,
CSITPASSENGERSTATUS Condicional de 32
por ejemplo
caracteres.
standard,
gold o
platinum
Valores posibles:
Tipo de ADT: Adult CNN:
pasajero Alfanumrico Child INF: Infant
CSITPASSENGERTYPE Condicional asociado al de 32 YTH: Youth STU
precio del caracteres. Student SCR:
pasaje SeniorCitizen MI
Military
Verticales 132
Datos adicionales para RETAIL
Alfanumrico
Ciudad de envo de la
CSSTCITY Si de 50
orden
caracteres
Alfanumrico
Pas de envo de la Cdigo ISO
CSSTCOUNTRY Si de 2
orden http://apps.cy
caracteres
Alfanumrico
Correo electrnico del
CSSTEMAIL Si de 100
comprador
caracteres
Alfanumrico
Nombre de la persona
CSSTFIRSTNAME Si de 60
que recibe el producto
caracteres
Alfanumrico
Apellido de la persona
CSSTLASTNAME Si de 60
que recibe el producto
caracteres
Alfanumrico
Nmero de telfono del
CSSTPHONENUMBER Si de 15
destinatario
caracteres
Alfanumrico
Cdigo postal del
CSSTPOSTALCODE Si de 10
domicilio de envo
caracteres
Alfanumrico
CSSTSTATE Si Provincia de envo de 2 Es un carct
caracteres
Alfanumrico
CSSTSTREET1 Si Domicilio de envo de 60
caracteres
Alfanumrico
CSSTSTREET2 No Localidad de envo de 60
caracteres
Cantidad de das que Alfanumrico

CSMDD12 No tiene el comercio para de 255
hacer la entrega caracteres
Alfanumrico Valores posib
CSMDD13 No Mtodo de Despacho de 255 Notas:
caracteres envo realiza
Valor booleano para

identificar si el cliente Valor
CSMDD14 No requiere un comprobante S/N
Booleano
Verticales 133
fiscal o no S / N
CustomerLoyalityNumber Alfanumrico
CSMDD15 No - nmero de cliente de 255
frecuente caracteres
Promotional / Alfanumrico
CSMDD16 No CouponCode - nmero de 255
de cupn de descuento caracteres
Datos a enviar por cada producto, los valores deben estar separados con "#":
Alfanumrico
CSITPRODUCTCODE Condicional Cdigo del producto de 255
caracteres
Alfanumrico
Descripcin del
CSITPRODUCTDESCRIPTION Condicional de 255
producto
caracteres
Alfanumrico
CSITPRODUCTNAME Condicional Nombre del producto de 255
caracteres
Alfanumrico
Cdigo identificador
CSITPRODUCTSKU Condicional de 255
del producto
caracteres
CSITTOTALAMOUNT
= CSITUNITPRICE *
CSITQUANTITY
"999999.CC" Es
mandatorio informar
los decimales,
usando el punto
CSITTOTALAMOUNT Condicional Numrico
como separador de
decimales. No se
permiten comas, ni
como separador de
miles ni como
separador de
decimales.
Cantidad del
CSITQUANTITY Condicional Numrico
producto
Verticales 134
"999999.CC" Es
mandatorio informar
los decimales,
usando el punto
como separador de
CSITUNITPRICE Condicional decimales. No se Numrico
permiten comas, ni
como separador de
miles ni como
separador de
decimales.
Verticales 135
Datos adicionales para TICKETING
Valores
posibles
Nmero de das en los Alfanumrico
CSMDD33 Si que se desarrollara el de 255
evento caracteres
Pick up
Alfanumrico
Email
CSMDD34 Si Tipo de envo de 255
Smartphone
caracteres
Other
Datos a enviar por cada ticket, los valores deben estar separado con "#":
Verticales 136
Alfanumrico
caracteres
Alfanumrico
Descripcin del
producto
caracteres
Alfanumrico
caracteres
Alfanumrico
Cdigo identificador
del producto
caracteres
CSITTOTALAMOUNT
= CSITUNITPRICE *
CSITQUANTITY
"999999.CC" Es
mandatorio informar
los decimales,
usando el puntos
como separador de
decimales. No se
permiten comas, ni
como separador de
miles ni como
separador de
decimales.
Cantidad del
CSITQUANTITY Condicional Numrico
producto
"999999.CC" Es
mandatorio informar
los decimales,
usando el puntos
como separador de
CSITUNITPRICE Condicional decimales. No se Numrico
permiten comas, ni
como separador de
miles ni como
separador de
decimales.
Verticales 137
Datos adicionales para SERVICES
Parmetro Mandatorio Descripcin Mandatorio Valores posibles
Alfanumrico Luz, Gas, Telefono,

Tipo de
CSMDD28 Si de 255 Agua, TV, Cable,
Servicio
caracteres Internet, Impuestos.
Referencia Alfanumrico
CSMDD29 No de pago del de 255
servicio 1 caracteres
Datos a enviar por cada servicio, los valores deben estar separado con "#"
Verticales 138
Alfanumrico
CSITPRODUCTCODE Si Cdigo del servicio de 255
caracteres
Alfanumrico
Descripcin del
CSITPRODUCTDESCRIPTION Si de 255
servicio
caracteres
Alfanumrico
CSITPRODUCTNAME Si Nombre del servicio de 255
caracteres
Alfanumrico
Cdigo identificador
CSITPRODUCTSKU Si de 255
del servicio
caracteres
CSITTOTALAMOUNT
= CSITUNITPRICE *
CSITQUANTITY
"999999.CC" Es
mandatorio informar
los decimales,
usando el puntos
como separador de
decimales. No se
permiten comas, ni
como separador de
miles ni como
separador de
decimales.
Cantidad del
CSITQUANTITY No Numrico
producto
Precio unitario del
producto
"999999.CC" Es
mandatorio informar
los decimales,
usando el puntos
CSITUNITPRICE Si como separador de Numrico
decimales. No se
permiten comas, ni
como separador de
miles ni como
separador de
decimales.
Verticales 139
Datos adicionales para DIGITAL GOODS
Parmetro Mandatorio Descripcin Formato Valores posibles
WEB Session,
Tipo de Alfanumrico de
CSMDD32 Si Email,
Delivery 255 caracteres
SmartPhone
Datos a enviar por cada producto, los valores deben estar separado con "#":
Verticales 140
Alfanumrico
caracteres
Alfanumrico
Descripcin del
producto
caracteres
Alfanumrico
caracteres
Alfanumrico
Cdigo identificador
del producto
caracteres
CSITTOTALAMOUNT
= CSITUNITPRICE *
CSITQUANTITY
"999999.CC" Es
mandatorio informar
los decimales,
usando el puntos
como separador de
decimales. No se
permiten comas, ni
como separador de
miles ni como
separador de
decimales.
Cantidad del
CSITQUANTITY No Numrico
producto
Precio unitario del

producto
"999999.CC" Es
mandatorio informar
los decimales,
usando el puntos
CSITUNITPRICE Si como separador de Numrico
decimales. No se
permiten comas, ni
como separador de
miles ni como
separador de
decimales.
Verticales 141
Implementacin del Device Fingerprint

El Device Fingerprint (DF) es la huella digital del dispositivo que realiza la transaccin. Es
un dato muy importante que se tiene en cuenta en el proceso de validacin. Para obtenerlo
hay que incluir en el formulario de pago los tres segmentos de cdigo que se proporcionan
a continuacin.
Preste especial atencion a los tres parametros que deben tenerse cuenta:
CYBERSOURCE_MERCHANTID
session_id
Unique_identifier
Implementaciones Mviles: Es posible implementar el uso de Device Fingerprint en

aplicaciones Android y IOS. Si necesita utilizar CyberSource en estos ambientes, deber
referirse a otra documentacin complementaria y especfica. Solicite asistencia al
departamento de Help Desk.
Implementacin del Device Fingerprint 142

Valores de los campos y observaciones
Campo Testing Produccin Observaciones:
org_id 1snn5n9w k8vif92e Valores fijos

[Valor Al momento de entrar en
CYBERSOURCE_MERCHANTID decidir_agregador provisto por produccin, este valor lo
DECIDIR] proporciona Help Desk.
En el ejemplo:
decidir_agregador123456
genera como la concatena
session_id - -
SIN espacios en blanco de
CYBERSOURCE_MERCH
y Unique_identifier
Es parte del SessionId. En
Ejemplo:
decidir_agregador123456
es el valor 123456789
cualquier valor, con la cond
que sea nico por al meno
Unique_identifier - - hora. Usualmente se usa e
identificador de transaccin
la compra. Puede contener
Maysculas y minusculas,
numricos y estos caracter
especiales: guin (-) y
o subrayado (_).
Consideraciones
El session_id debe ser nico (puede usar cualquier cadena que est generando, como un
nmero de orden o una sesin Web ID). No utilice las mismas letras maysculas y
minsculas para indicar diferentes session_id.

Segmentos de Cdigo para la implementacin del DF en la

pgina de checkout
Se deben incluir los tres TAG que se describen a continuacion:
Imagen PNG
<p style="background:url(https://h.online-metrix.net/fp/clear.png?org_id=1snn5n9w&session_id=<CYB
<img src="https://h.online-metrix.net/fp/clear.png?org_id=1snn5n9w&session_id=<CYBERSOURCE_MERCHA
JavaScript
<script src="https://h.online-metrix.net/fp/check.js?org_id=1snn5n9w&session_id=<CYBERSOURCE_MERC
Objeto Flash
<object type="application/x-shockwave-flash" data="https://h.online-metrix.net/fp/fp.swf?org_id=1snn5

<param name="movie" value="https://h.online-metrix.net/fp/fp.swf?org_id=1snn5n9w&session_id=<CYBE
</object>

Consideraciones al momento de Implementar el Device

Fingerprint:
Se recomienda poner ste cdigo inmediatamente ANTES del tag </body>. No encierre los
segmentos en elementos visibles de HTML.
El cdigo debe ser cargado ANTES que el cliente submita la orden. Puede utilizarse una
pagina http o https. Tambin puede utilizar redirect en lugar de direct.
Para que CS pueda utilizar el DF calculado, usted debe enviar a DECIDIR en el Request del
servicio Authorize, junto con los dems datos que est enviando a CS, el siguiente campo
obligatorio:
Valores
posibles
Identificador
del
Fingerprint.
Solo se
informa si el String 123456789
CSDEVICEFINGERPRINTID S Cliente hasta /
Implementa 255 a001675b1
integracin
con
Formulario
Custom
(en el ejemplo: el unique identifier es 123456789 lo que implica que el

"CSDEVICEFINGERPRINTID"=123456789
ATENCION: vea que el deviceFingerprintID es una parte del session_id. El session_id en el

ejemplo es decidir_agregador123456789, pero usted slo debe enviar el identificador nico
que es 123456789. Y que el Nombre del parmetro a enviar a DECIDIR es
CSDEVICEFINGERPRINTID.

Cmo verificar si est generando bien el DF?

En la pagina de Cybersource Business Center, dentro del Decision Manager, la transaccin
enviada informacin de un Device Fingerprint Se ver de la siguiente manera:

Ejemplo de Pedido de Autorizacin con CyberSource

A continuacin se detalla un ejemplo de pedido de autorizacin con CyberSource en retail.
Como puede verse pasamos los datos adicionales por el payload.
Requerimiento:
<api:Payload>
<Request>
<NROOPERACION>test_visa_2509ab</NROOPERACION>
<MONTO>5499</MONTO>
<CUOTAS>1</CUOTAS>
<TIPODOC>1</TIPODOC>
<NRODOC>1213211654</NRODOC>
<CALLE/>
<NROPUERTA/>
<NOMBREENTARJETA>testr</NOMBREENTARJETA>
<NROTARJETA>4507990000004905</NROTARJETA>
<VENTARJETA>1808</VENTARJETA>
<VENCIMIENTO>1808</VENCIMIENTO>
<CODSEGURIDAD>775</CODSEGURIDAD>
<NOMBRE/>
<APELLIDO/>
<TELEFONO/>
<FECHANACIMIENTO/>
<CANTDIASFECHAVENC>0</CANTDIASFECHAVENC>
<CANTDIASPAGO/>
<RECARGO/>
<FECHAVTO/>
<FECHAVTO2/>
<CLIENTE/>
<IDTEMPLATES/>
<TITULAR/>
<CSBTCITY>Bs As</CSBTCITY>
<CSBTCOUNTRY>AR</CSBTCOUNTRY>
<CSBTCUSTOMERID>5</CSBTCUSTOMERID>
<CSBTIPADDRESS>10.2.72.122</CSBTIPADDRESS>
<CSBTEMAIL>[email protected]</CSBTEMAIL>
<CSBTFIRSTNAME>dammian ariel</CSBTFIRSTNAME>
<CSBTLASTNAME>Wajser Ñoño</CSBTLASTNAME>
<CSBTPHONENUMBER>49210465</CSBTPHONENUMBER>
<CSBTPOSTALCODE>1212</CSBTPOSTALCODE>
<CSBTSTATE>B</CSBTSTATE>
<CSBTSTREET1>lñala 12 5</CSBTSTREET1>
<CSBTSTREET2/>
<CSPTCURRENCY>ARS</CSPTCURRENCY>
Ejemplo de Pedido de Auorizacin con CyberSource 147

<CSPTGRANDTOTALAMOUNT>54.99</CSPTGRANDTOTALAMOUNT>
<CSMDD6>API</CSMDD6>
<CSMDD7>0</CSMDD7>
<CSMDD8/>
<CSMDD9/>
<CSMDD10/>
<CSMDD11>49210465</CSMDD11>
<CSSTCITY>Bs as</CSSTCITY>
<CSSTCOUNTRY>AR</CSSTCOUNTRY>
<CSSTEMAIL>[email protected]</CSSTEMAIL>
<CSSTFIRSTNAME>dammian ariel</CSSTFIRSTNAME>
<CSSTLASTNAME>Wajser Ñoño</CSSTLASTNAME>
<CSSTPHONENUMBER>49210465</CSSTPHONENUMBER>
<CSSTPOSTALCODE>1212</CSSTPOSTALCODE>
<CSSTSTATE>B</CSSTSTATE>
<CSSTSTREET1>lñala 12 5</CSSTSTREET1>
<CSMDD12>6</CSMDD12>
<CSMDD13>Flat Rate - Fixed</CSMDD13>
<CSMDD14/>
<CSMDD15/>
<CSMDD16/>
<CSITPRODUCTCODE>default</CSITPRODUCTCODE>
<CSITPRODUCTDESCRIPTION>El coso</CSITPRODUCTDESCRIPTION>
<CSITPRODUCTNAME>Venta de coso</CSITPRODUCTNAME>
<CSITPRODUCTSKU>32742</CSITPRODUCTSKU>
<CSITTOTALAMOUNT>49.99</CSITTOTALAMOUNT>
<CSITQUANTITY>1</CSITQUANTITY>
<CSITUNITPRICE>49.99</CSITUNITPRICE>
<CSDEVICEFINGERPRINTID>f38f610b-f6c3-85d2-052a-8f046feb5d3e</CSDEVICEFINGERPRINTID
<CSMDD80/>
<CSMDD81/>
<CSMDD82/>
<CSMDD83/>
<CSMDD84/>
<CSMDD85/>
<CSMDD3/>
</Request>
</api:Payload>
Respuesta: A continuacin se detallan ejemplos de respuestas de los diversos colores de

CyberSource. En el caso de las respuestas Roja, Negra y Azul el RESULTADOCS puede
variar segn lo detallado en la seccin Cdigos Numricos de Respuesta de CyberSource.
VERDE:

<Answer>
<MONEDA>Pesos</MONEDA>
<NROTARJETAVISIBLE>450799XXXXXX4905</NROTARJETAVISIBLE>
<CODAUTORIZACION>009602</CODAUTORIZACION>
<IDMOTIVO/>
<MOTIVO/>
<IDGLOBAL>341609</IDGLOBAL>
<RESULTADOCS>100</RESULTADOCS>
</Answer>
AMARILLO:
<Answer>
<IDMOTIVO></IDMOTIVO>
<MOTIVO></MOTIVO>
</Answer>
ROJO:
<Answer>
<RESULTADO>RECHAZADA</RESULTADO>
<NROTICKET></NROTICKET>
<CODAUTORIZACION></CODAUTORIZACION>
<MOTIVO>RECHAZADA POR FRAUDE</MOTIVO>
</Answer>

AZUL:
<Answer>
<MOTIVO></MOTIVO>
<IDENTIFICADORCS></IDENTIFICADORCS>
</Answer>
NEGRO:
<Answer>
<MOTIVO></MOTIVO>
<IDENTIFICADORCS></IDENTIFICADORCS>
</Answer>

Cdigos numricos de Respuesta de

CyberSource
Vimos que en el backoffice de Decidir, el resultado del servicio se expresa en colores
(Verde/Amarillo/Rojo/Azul y Negro). Cada color resume diferentes cdigos numricos que
permiten entender las diferentes situaciones que lo provocan. Este cdigo numrico, se
informar en el Campo ResultadoCS del Response. La siguiente tabla detalla cada uno de
los cdigos y su explicacin.
El Tipo refiere al mdulo o funcin de Cybersource o Decidir que produce el resultado. De

ese modo podemos distinguir un REJECT por aplicacion de reglas (cod 481) de un REJECT
ERROR por indisponibilidad de Cybersource (cod 150). La referencia Validator Processing
determina que el error en la informacion fue detectado directamente por el Validador de
informacion de Decidir.
Cdigos posibles por Color

Verde ACCEPT (100)
Rojo REJECT (481,101,102,202,231)
Amarillo REVIEW (480)
Azul Error Comunicacin con CS (150,151,152)
Negro Faltan datos (10XXX)
Cdigo Descripcin Tipo

100 Decision Manager processing ACCEPT
480 Decision Manager processing REVIEW

481 Decision Manager processing REJECT
101 Incomplete mandatory fields REJECT
102 Validation of fields REJECT


REJECT
150 CyberSource service unavailability
ERROR
REJECT
ERROR
REJECT
ERROR
Cdigos de Respuesta de CyberSource 151

Validator
10101 Bill To City is required
Processing
Validator
10102 Bill To Country is required
Processing
Validator
10103 Bill To CustomerID is required
Processing
Validator
10104 Bill To Email is required
Processing
Validator
10105 Bill To First Name is required
Processing
Validator
10106 Bill To IP Address is required
Processing
Validator
10107 Bill To Last Name is required
Processing
Validator
10108 Bill To Phone Number is required
Processing
Validator
10109 Bill To Postal Code is required
Processing
Validator
10110 Bill To State is required
Processing
Validator
10111 Bill To Street1 is required
Processing
The Item at index 0 must include a valid productCode Validator
10130
value. Processing
The Item at index 0 must include a valid productName Validator
10132
value. Processing
The Item at index 0 must include a valid productSKU Validator

10133
value. Processing
Validator
10134 The Item at index 0 must include a valid quantity value.
Processing
The Item at index 0 must include a valid totalAmount Validator

10135
value. Processing
Validator
10136 The Item at index 0 must include a valid unitPrice value.
Processing
Validator
10140 Purchase Currency is required
Processing
Validator
10141 Purchase Grand Total Ammount is required
Processing
Validator
10150 Request Message DeviceFingerprintID is required
Processing

Validator
10151 Request Message DeviceFingerprintRaw is required
Processing
Validator
10152 Request Message MerchantId is required
Processing
Validator
10153 Request Message MerchantReferenceCode
Processing
Validator
10160 Ship To City is required
Processing
Validator
10161 Ship To Country is required
Processing
Validator
10162 Ship To Email is required
Processing
Validator
10163 Ship To First Name is required
Processing
Validator
10164 Ship To Last Name is required
Processing
Validator
10165 Ship To Phone Number is required
Processing
Validator
10166 Ship To Postal Code is required
Processing
Validator
10167 Ship To State is required
Processing
Validator
10168 Ship To Street1 is required
Processing
Validator
10170 DecisionManagerTravelData CompleteRoute is required
Processing
Validator
10171 DecisionManagerTravelData JourneyType is required
Processing
DecisionManagerTravelData departureDateTime is Validator

10172
required Processing
Validator
10180 AirlineData NumberOfPassengers is required
Processing
Validator
10302 Invalid BillTo Country ISO Code
Processing
Validator
10304 Invalid BillTo Email
Processing
Validator
10305 Invalid BillTo FirstName
Processing
Validator
10306 Invalid BillTo IP Address
Processing

Validator
10307 Invalid BillTo LastName
Processing
Validator
10309 Invalid BillTo PostalCode
Processing
Validator
10310 Invalid BillTo State
Processing
Validator
10320 Invalid Card AccountNumber
Processing
Validator
10321 Invalid Card CardType
Processing
Validator
10322 Invalid Card ExpirationMonth
Processing
Validator
10323 Invalid Card ExpirationYear
Processing
Validator
10334 The Item at index 0 must include a valid quantity value.
Processing
The Item at index 0 must include a valid totalAmount Validator

10335
value. Processing
Validator
10336 The Item at index 0 must include a valid unitPrice value.
Processing
Validator
10340 Invalid PurchaseTotals Currency
Processing
Validator
10341 Invalid PurchaseTotals GrandTotalAmmount
Processing
Validator
10360 Invalid Ship To City
Processing
Validator
10361 Invalid Ship To Country
Processing
Validator
10362 Invalid Ship To Email
Processing
Validator
10363 Invalid Ship To First Name
Processing
Validator
10364 Invalid Ship To Last Name
Processing
Validator
10365 Invalid Ship To Phone Number
Processing
Validator
10366 Invalid Ship To Postal Code
Processing
Validator
10367 Invalid Ship To State

10367 Invalid Ship To State Processing
Validator
10368 Invalid Ship To Street1
Processing
Validator
10370 Invalid DecisionManagerTravelData CompleteRoute
Processing
Validator
10371 Invalid DecisionManagerTravelData JourneyType
Processing
Validator
10372 Invalid DecisionManagerTravelData departureDateTime
Processing
Validator
10380 Invalid AirlineData NumberOfPassengers
Processing
Validator
10501 Merchant Affiliation Number(MDD1) is required
Processing
Validator
10502 Merchant Name(MDD2) is required
Processing
Validator
10503 Business Vertical(MDD3) is required
Processing
Travel Additional Fields MDD17- Reservation Code Validator
10517
(PNR) is required Processing
Travel Additional Fields MDD18-3rd Party Booking is Validator
10518
required Processing
Services Additional Fields MDD28- Service Type is Validator
10528
required Processing
Digital Goods Additional Fields MDD32-Delivery Type is Validator
10532
required Processing
Ticketing Additional Fields MDD33- Numero de dias para Validator
10533
evento is required Processing
Ticketing Additional Fields MDD34-Delivery Type is Validator

10534
required Processing
Validator
10701 Invalid Merchant Affiliation Number(MDD1)
Processing
Validator
10703 Invalid Business Vertical(MDD3)
Processing
Validator
10718 Invalid Travel Additional Fields MDD18-3rd Party Booking
Processing
Invalid Ticketing Additional Fields MDD33- Numero de Validator

10733
dias para evento Processing

NOTE: cuando RESULTADOCS retorne como campo dentro del Response de la "Consulta
de estado de una Transaccion (metodo "OPERATION)" devolver el COLOR
correspondiente y no el cdigo numrico.

Revisin Manual de Transacciones -

Notificacin de cambio de estado
Si usted disponde de la funcionalidad de Revisin manual de transacciones, utilizando la
herramienta "Case manager", implementar este servicio le permitir recibir un POST con el
resultado final decidido para la transaccin.
La informacin que se recibir es la siguiente:
a. ID de Transaccin
b. Nuevo Resultado de Cybersource (VERDE/ROJO)
c. Nuevo Resultado Final de la transaccin (Aprobada/Rechazada),
d. Fecha de cambio del estado,
e. Fecha Original de la trx (si estuviese disponible)
f. Monto de la Trx.
Requisitos:
El comercio deber informar a DECIDIR la URL donde recibir las notificaciones.
El formato del post a enviar ser JSON, de la misma forma deber responder a DECIDIR
la confirmacin del aviso.
MENSAJES
a)Envo DECIDIR-Comercio:
El post se enviar con formato JSON a la URLPost definida por el cliente y configurada en
DECIDIR.
Ejemplo:
notificacion.json
Revisin Manual de Transacciones - Notificacin de cambio de estado 157

{
"timestamp": "19\/01\/2016 11:26:59",
"message-type": "notification",
"infotransaccion": {
"fechacambioestado": "19\/01\/2016 11:26:56",
"estadofinal": "Anulada",
"resultadocs": "ROJO"
"fechaoriginal": ""18\/01\/2016 10:20:59",
"monto": 125.38,
"idoperacion": "retail_fer23"
}
}
b)Envo Comercio-DECIDIR:
El comercio enviar la siguiente respuesta de recepcin OK del mensaje.
respuesta.json
{
"resultado": "ok"
}
Post a URL dinmica:

Tambin est disponple la posibilidad de que el post se enve a una URL distinta a la
configurada en el panel de Decidir. Para eso se agrega el campo URLDINAMICA en el
Payload en el pedido de autorizacin.
Ejemplo

<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:api="http://api.decidir.com

<soap:Header/>
<soap:Body>
<api:Execute>
<api:Security>PRISMA XXXXXXXXXXXXXXXXXXXXXXXX</api:Security>
<api:Session></api:Session>
<api:Operation>Compra</api:Operation>
<api:Payload>
<Request>
<NROOPERACION>operacion0001</NROOPERACION>
<MONTO>100</MONTO>
<CUOTAS>02</CUOTAS>
<TIPODOC></TIPODOC>
<NRODOC></NRODOC>
<CALLE></CALLE>
<NROPUERTA></NROPUERTA>
<NOMBREENTARJETA></NOMBREENTARJETA>
<NROTARJETA>504363XXXXXXXXXX</NROTARJETA>
<VENCIMIENTO>MMAA</VENCIMIENTO>
<CODSEGURIDAD>XXX</CODSEGURIDAD>

<URLDINAMICA>http://www.decidir.com.ar/csnotifier/listener.php</URLDINAMICA
</Request>
</api:Payload>
</api:Execute>
</soap:Body>
</soap:Envelope>

Tablas de Referencias
Tabla de Medios de Pago
Cdigos de estado
Cdigos de motivos de rechazo
Cdigos de provincias para CyberSource
Tablas de Referencia 160

Medios de Pago
MEDIODEPAGO Nombre
1 VISA
6 AMEX*
8 DINERS
15 MASTERCARD
20 MASTERCARD TEST
23 TARJETA SHOPPING
24 TARJETA NARANJA
25 PAGO FACIL
26 RAPIPAGO
27 CABAL
29 ITALCRED
30 ARGENCARD
31 VISA DBITO
34 COOPEPLUS
36 ARCASH
37 NEXO
38 CREDIMAS
39 NEVADA
41 PAGOMISCUENTAS
42 NATIVA
43 TARJETA MAS/CENCOSUD
44 TARJETA CARREFOUR
45 NACIONPYMES
46 PAYSAFECARD
47 MONEDERO ONLINE
48 CAJA DE PAGOS
50 BPS
53 LPWT
Tabla de Medios de Pago 161

54 GRUPAR
55 PATAGONIA
56 TARJETA CLUB DIA
59 TARJETA TUYA
60 DISTRIBUTION
61 LA ANONIMA
65 AMEX TERMINALES MULTIPLES*
NOTA: En el caso de AMEX se debe seleccionar solo una de las dos opciones. El uso del
IdMediodePago = 65, en lugar del IdMediodePago=6, le permite al comercio operar en su
Idsite con Multiples terminales provistas por American Express, favoreciendo la alta
disponibilidad de terminales cuando el volumen de transacciones del medio de pago es
importante.
Tabla de Medios de Pago 162

Cdigos de Estado de las Transacciones
Estado
IdEstado Descripcin Comentarios
Final?
1 Ingresada
Es un estado intermedio de la transaccin. Si
una operacin permanece en este estado,
2 A procesar
indica que la misma no ha completado
exitosamente su ciclo normal.
3 Procesada
4 Autorizada
5 Rechazada S Rechazada por el medio de pago.
Las transacciones "Autorizadas" pasan a
6 Acreditada S este estado luego de un cierre de lote
exitoso.
Cuando se hace el reverso de una

7 Anulada
operacin, antes del cierre de lote.
Anulacin Las "Anuladas" pasan a este estado luego
8 S
Confirmada del cierre de lote.
Cuando se hace el reverso de una
9 Devuelta
transaccin luego de un cierre de lote.
Devolucin Las "Devueltas" pasan a este estado luego
10 S
Confirmada del cierre de lote.
Pre Es el 1er paso, cuando se opera con
11
autorizada transacciones en 2 pasos.
Slo para Pagofcil y Rapipago, cuando se

12 Vencida S
vence la boleta de pago.
Acreditacin
13
no cerrada
14 Autorizada*
15 A reversar
A registrar
16
en Visa
Validacin
17 iniciada en
Visa
Enviada a
18 validar en
Cdigos de Estado de las Transacciones 163

Visa
Validada OK
19
en Visa
Recibido
20
desde Visa
Validada no
21
OK en Visa
Factura Slo para Pagomiscuentas, cuando se crea
22
generada exitosamente el VEP en PMC
Factura no En Pagomiscuentas, cuando no se crea
23 S
generada exitosamente el VEP en PMC.
Rechazada - Cuando el comercio posee implementado el

24 No S servicio de Verified by Visa y la misma no es
autenticada autenticada.
Rechazada - Cuando un filtro de bines cargado del lado
25 Datos S de Decidir, rechaza una tarjeta por no estar
invlidos dentro del rango permitido.
A registrar
28 en
IdValidator
Enviada a
29
IdValidator
Rechazada -
32 S Slo
No validada
Rechazada - Slo para mtodo de integracin con
38 Timeout de S formulario Embedded. Se excedi el tiempo
compra mximo en el formulario de carga de datos
Ingresada
50
Distribuida
Rechazada
51 S
por grupo
Anulada por
52 S
grupo
Cdigos de Estado de las Transacciones 164

Cdigos de Motivos de Rechazo
MEDIO
ID_ Descripcin para
IDMOTIVO DE Descripcin Corta
MP mostrar al usuario
PAGO
Esta operacin requiere
autorizacin. Llame al
PEDIR nmero que figura en el
1 1 visa
AUTORIZACION dorso de su tarjeta para
autorizar el pago, e intente
nuevamente.
LLAMAR AL nmero que figura en el
76 1 visa
EMISOR dorso de su tarjeta para
nuevamente.
El pago ha sido
CAPTURAR
4 1 visa rechazado. Reintente con
TARJETA
otro medio de pago.
El pago ha sido
5 1 visa DENEGADA rechazado. Reintente con
otro medio de pago.
El pago ha sido
rechazado. Reintente con
7 1 visa RETENGA Y LLAME
otro medio de pago.
El pago ha sido
RETENER
TARJETA
otro medio de pago.
El pago ha sido
TRANS. NO
PERMITIDA
otro medio de pago.
No fue posible procesar su

EMISOR FUERA pago en este momento.
91 1 visa
LINEA Intente nuevamente ms
tarde.

ERROR EN pago en este momento.
96 1 visa
SISTEMA Intente nuevamente ms
tarde.

Error de time out del pago en este momento.
10003 1 visa
socket Intente nuevamente ms
Cdigos de motivos de rechazo 165


TRANSAC. pago en este momento.
12 1 visa
INVALIDA Intente nuevamente ms
tarde.
ERROR AL No fue posible procesar su
RECIBIR DEL pago en este momento.
10001 1 visa
MODULO DE Intente nuevamente ms
COMUNICACIONES tarde.
La cantidad de cuotas
NO OPERA EN seleccionada es invlida.
45 1 visa
CUOTAS Intente nuevamente en
una sola cuota.
EXCEDE MAX. seleccionada es invlida.
48 1 visa
CUOTAS Intente nuevamente con
otro plan de cuotas.
La tarjeta de crdito que
est utilizando est
54 1 visa TARJETA VENCIDA
vencida. Reintente con
otro medio de pago.
La tarjeta de crdito que
est utilizando no est
TARJ. NO habilitada. Llame para
56 1 visa
HABILITADA habilitarla e intente
nuevamente, o utilice otro
medio de pago.
Fondos Insuficientes.
FONDOS
51 1 visa Intente con otro medio de
INSUFICIENTES
pago.
Fondos Insuficientes.
61 1 visa EXCEDE LIMITE Intente con otro medio de
pago.
Alguno de los datos

ingresados no es correcto.
14 1 visa TARJETA INVALIDA
Revselos e intente
nuevamente.
Alguno de los datos
Ingreso Manual ingresados no es correcto.
39 1 visa
Incorrecto Revselos e intente
nuevamente.

COMERCIO pago en este momento.
3 1 visa
INVALIDO Intente nuevamente ms
tarde.

13 1 visa MONTO INVALIDO pago en este momento.

Intente nuevamente ms
tarde.
Su tarjeta an no se
TARJETA NO encuentra vigente.
46 1 visa
VIGENTE Reintente con otro medio
de pago.

15 master
The operation failed nmero que figura en el
34 08 diners
for financial reasons. dorso de su tarjeta para
30 argencard
nuevamente.
15 master
A duplicate object pago en este momento.
8 08 diners
exists. Intente nuevamente ms
30 argencard
tarde.
15 master An error occurred
pago en este momento.
51 08 diners during the user
30 argencard authentication
tarde.
15 master An unhandled (such
pago en este momento.
53 08 diners as null pointer)
30 argencard exception occurred.
tarde.

PEDIR nmero que figura en el
1 6 amex
AUTORIZACION dorso de su tarjeta para
nuevamente.
El pago ha sido rechazado

CAPTURAR
4 6 amex el pago. Reintente con otro
TARJETA
medio de pago.
El pago ha sido rechazado
5 6 amex DENEGADA el pago. Reintente con otro
medio de pago.
ERROR AL No fue posible procesar su

RECIBIR DEL pago en este momento.
10001 6 amex
MODULO DE Intente nuevamente ms
COMUNICACIONES tarde.
ERROR seleccionada es invlida.
77 6 amex
PLAN/CUOTAS Intente nuevamente con
otro plan de cuotas.

Alguno de los datos

ingresados no es correcto.
14 6 amex TARJETA INVALIDA
Revselos e intente
nuevamente.
Los datos ingresados de

DATOS DE
su Tarjeta de crdito no
10005 6 amex TRANSACCION
son correctos. Revselos e
INCORRECTOS
intente nuevamente

COMERCIO pago en este momento.
3 6 amex
INVALIDO Intente nuevamente ms
tarde.
NO EXISTE pago en este momento.
25 6 amex
ORIGINAL Intente nuevamente ms
tarde.
NOTA: Ante cualquier otro IDMOTIVO que se reciba sugerimos inducir a repetir la
trx:Ocurri un error al procesar su pago. Intente nuevamente ms tarde.

Cdigos de provincias para CyberSource
Provincia Cdigo
CABA C
Buenos Aires B
Catamarca K
Chaco H
Chubut U
Crdoba X
Corrientes W
Entre Ros E
Formosa P
Jujuy Y
La Pampa L
La Rioja F
Mendoza M
Misiones N
Neuqun Q
Ro Negro R
Salta A
San Juan J
San Luis D
Santa Cruz Z
Santa Fe S
Santiago del Estero G
Tierra del Fuego V

Tucumn T
Cdigos de provincias para CyberSource 169

Soporte
Decidir ofrece un servicio de soporte 7x24x365 con el siguiente alcance:
Lunes a Viernes de 9 a 18 hs: Soporte Tcnico, Atencin Comercial y Soporte

Transaccional.
Resto de los das y horarios: Soporte Transaccional.
Vas de Contacto
Telfono: +54 11 4379-3460

Mail: [email protected]
Mail: [email protected] (ante disrupcin transaccional)
Soporte 170

SPS Documentacion

Cargado por

Copyright:

Formatos disponibles

SPS Documentacion

Cargado por

Información del documento

Descripción original:

Derechos de autor

Formatos disponibles

Compartir este documento

Compartir o incrustar documentos

Opciones para compartir

¿Le pareció útil este documento?

¿Este contenido es inapropiado?

Copyright:

Formatos disponibles

SPS Documentacion

Cargado por

Copyright:

Formatos disponibles

Manual

Consideraciones para Nevada 6.2.1.1.4 6.2.1.1.3

Esquema de una Transaccin 6.2.2.3

Sobre este Manual

La implementacin del servicio de DECIDIR, requiere conocimientos de desarrollo de

Sobre este Manual 6

Para ser notificados de la publicacin de nuevas versiones, le sugerimos que se suscriban

Requisitos para comenzar a operar

Requisitos para iniciar la integracin tcnica en sandbox

Requisitos para operar en produccin

Requisitos para empezar a operar 8

Homologacin con FirstData

El comercio deber enviar a DECIDIR ([email protected]) un instructivo con los pasos a

IMPORTANTE: El proceso de homologacin puede demorar hasta 4 semanas

Homologacin con First Data 9

Los cierres de lotes de cada medio de pago pueden realizarse de 2 maneras:

2. Automtica: Los procesos se ejecutan diariamente luego de la medianoche, y al

Formato del archivo de cierre de lote

Las especificaciones del archivo son:

Nomenclatura del nombre de cada archivo generado: lote########_ddmmyy.MP.txt

El layout del archivo enviado es el siguiente:

Formato del archivo de cierre de lote 11

Campo Posicin Tipo de dato

TIPOREGISTRO [1-1] Tipo de Registro, Char default "D".

Cdigo de Autorizacin, numrico de 6

NROTICKET [62-67] Nmero de Cupn, numrico de 6 dgitos.

Id Site Decidir, numrico de 15 dgitos, el

CUOTAS [86-88] Nmero de lote, numrico de 3 dgitos.

Nmero de establecimiento, numrico de

Formato del archivo de cierre de lote 12

Campo Posicin Tipo de dato

TIPOREGISTRO [1-1] Tipo de Registro, Char, default "T".

Nmero de Lote, numrico de 3 dgitos

Contador de Compras, numrico de 4 dgitos

Cantidad de Devoluciones, numrico de 4

Formato del archivo de cierre de lote 13

Formato del archivo de cierre de lote 14

Cmo configurar promociones bancarias

Hay distintos tipos de promociones y configuraciones que es posible realizar, en relacin a

Los tipos de configuraciones ms habituales son:

1. Promociones de cuotas sin inters.

Todas estas promociones pueden ser parametrizadas a travs de 2 mtodos posibles:

a) BIN HEREDADO - Mayor esfuerzo de setup del lado del comercio:

Permite independencia de Decidir para configurar promociones minimizando la

b) CREACION DE NUEVOS ID SITES - Mayor esfuerzo de setup del lado de Decidir.

Mayor interaccin con Decidir para el setup.

Describimos a continuacin, los detalles de configuracin de cada uno de los mtodos.

Configurar Promociones Bancarias 15

Ejemplo de llamada del servicio enviando el campo BIN

<api:Payload xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-

Creacin de nuevos ID Sites

Esta modalidad implica un mayor esfuerzo desde el punto de vista de la configuracin de la

Creacin de nuevos ID Sites 17

Para cualquiera de las opciones descriptas en la tabla de promociones, el comercio deber

Creacin de nuevos ID Sites 18

Las operaciones disponibles son:

A continuacin se explica el flujo transaccional y luego ejemplos en php especficos.

Si el token generado es: BBR87JNRBK0RJY9SVDZNN3VR la asignacin ser:

Authorization: PRISMA BBR87JNRBK0RJY9SVDZNN3VR