Sie sind auf Seite 1von 153

Manual

de Integracin Decidir

Tabla de contenido
Sobre este Manual

Consideraciones

Requisitos para empezar a operar

Homologacin con First Data

Cierre de Lote

Formato del archivo de cierre de lote

4.1

Configurar Promociones Bancarias

BIN Heredado

5.1

Creacin de nuevos ID Sites

5.2

Token de Seguridad

Cmo me integro?

Flujo de una Transaccin

7.1

Pedido de Autorizacin en 1 paso

7.1.1

Requerimiento

7.1.1.1

Campos adicionales para el medio de pago Rapipago

7.1.1.1.1

Campos adicionales para el medio de Pago Fcil (Caja De Pagos)


Consideraciones para Pagomiscuentas (Banelco)

7.1.1.1.2

Requerimientos de VISA para comercios Agregadores.

7.1.1.1.3

Split de Transacciones

7.1.1.1.5 7.1.1.1.4

Split por montos fijos

7.1.1.1.5.1

Split porcentual

7.1.1.1.5.2

Ejemplo
Respuesta
Ejemplo
Pedido de Autorizacin en 2 pasos

7.1.1.1.6
7.1.1.2
7.1.1.2.1
7.1.2

Pasos

7.1.2.1

Observaciones

7.1.2.2

Esquema Transaccional

7.1.2.3

Invocacin al Formulario
Formulario Custom

7.1.3
7.1.3.1

Manual de Integracin Decidir

Requerimiento
Pedido de Informacin de una Transacccin
Requerimiento
Ejemplo
Respuesta
Ejemplo
Ver Estado de una Transacccin

7.1.3.1.1
7.1.4
7.1.4.1
7.1.4.1.1
7.1.4.2
7.1.4.2.1
7.1.5

Validacion de datos adicionales

7.1.5.1

Requerimiento

7.1.5.2

Ejemplo
Respuesta
Ejemplo

7.1.5.2.1
7.1.5.3
7.1.5.3.1

Realizar Anulacin

7.1.6

Requerimiento

7.1.6.1

Ejemplo
Respuesta
Ejemplo
Realizar Devolucin
Realizar una Devolucin TOTAL
Requerimiento
Ejemplo
Respuesta
Ejemplo
Realizar una Devolucin PARCIAL
Requerimiento
Ejemplo
Respuesta
Ejemplo
Realizar una Confirmacin
Requerimiento
Ejemplo
Respuesta
Ejemplo
Ejemplos de integracin

7.1.6.1.1
7.1.6.2
7.1.6.2.1
7.1.7
7.1.7.1
7.1.7.1.1
7.1.7.1.1.1
7.1.7.1.2
7.1.7.1.2.1
7.1.7.2
7.1.7.2.1
7.1.7.2.1.1
7.1.7.2.2
7.1.7.2.2.1
7.1.8
7.1.8.1
7.1.8.1.1
7.1.8.2
7.1.8.2.1
7.2
3

Manual de Integracin Decidir

Pedido de Autorizacin

7.2.1

Invocacin al Formulario

7.2.2

Formulario Custom

7.2.2.1

Obtener Informacin de Respuesta

7.2.3

Ver Estado de una Transacccin

7.2.4

Devolucin

7.2.5

Devolucin Total

7.2.5.1

Devolucin Parcial

7.2.5.2

Anulacin

7.2.6

Configuraciones Adicionales

Mails de confirmacin

8.1

Time Out de la Compra

8.2

Servicio de Prevencin de Fraude CyberSource

Funcionamiento del Servicio

9.1

Datos Adicionales a Enviar

9.2

Datos Comunes a Todos los Verticales

9.2.1

Verticales

9.2.2

Travel

9.2.2.1

Retail

9.2.2.2

Ticketing

9.2.2.3

Services

9.2.2.4

Digital Goods

9.2.2.5

Implementacin del Device Fingerprint


Valores de los parmetros involucrados

9.2.3
9.2.3.1

Segmentos de Cdigo para la implementacin del DF en la pgina de


checkout

9.2.3.2

Consideraciones al momento de Implementar

9.2.3.3

Cmo verificar si est generando bien el DF?

9.2.3.4

Ejemplo de Pedido de Auorizacin con CyberSource

9.3

Cdigos de Respuesta de CyberSource

9.4

Tablas de Referencia

10

Tabla de Medios de Pago

10.1

Cdigos de Estado de las Transacciones

10.2

Cdigos de motivos de rechazo

10.3
4

Manual de Integracin Decidir

Cdigos de provinias para CyberSource


Soporte

10.4
11

Manual de Integracin Decidir

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

Manual de Integracin Decidir

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 ser notificados de la publicacin de nuevas versiones, le sugerimos que se suscriban
al servicio de Updates de nuevos releases.

Consideraciones

Manual de Integracin Decidir

Pre 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

Manual de Integracin Decidir

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 (hd@decidir.com.ar) 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

Manual de Integracin Decidir

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. Manualmente: 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. Automticamente: 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

Manual de Integracin Decidir

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).
Ejemplo (link para download): lote00080114150915.01.txt
El layout del archivo enviado es el siguiente:
Registro Detalle:

Formato del archivo de cierre de lote

11

Manual de Integracin Decidir

Campo

Posicin

Tipo de dato

Tipo de
Registro

[1-1]

Char, default "D".

Id de
Transaccin

[2-11]

Alfanumrico de 10 dgitos, completando con "0" a la


izquierda.

Medio de
Pago

[12-14]

Numrico, 3 dgitos completando con "0 a la izquierda.


Por ejemplo: 001 identifica a Visa

Nmero de
Tarjeta

[15-34]

Numrico de 20 dgitos. Se informan los ltimos 4 dgitos


del nmero de tarjeta, completando con "0" a la izquierda.

Operacin

[35-35]

Char valores posibles:


C:compra
D:devolucin
A:anulacin

Fecha de
Operacin

[36-43]

Numrico de 8 dgitos, formato "DDMMYYYY".

Monto de
Operacin

[44-55]

Numrico de 12 dgitos, 10 enteros + 2 decimales (sin


punto decimal).

Cdigo de
Autorizacin

[56-61]

Numrico de 6 dgitos, completando con "0" a la izquierda.

Nmero de
Cupn

[62-67]

Numrico de 6 dgitos.

Id Site
Decidir

[68-82]

Numrico de 15 dgitos, el Id Site SIEMPRE es de 8


dgitos y se completa con 7 ceros a la izquierda.

Nmero de
lote

[83-85]

Numrico de 3 dgitos.

Filler

[86-100]

15 caracteres completados con "0".

**Registro Trailer:**

Formato del archivo de cierre de lote

12

Manual de Integracin Decidir

Campo

Posicin

Tipo de dato

Tipo de Registro

[1-1]

Char, default "T".

Cantidad Registros
"Detalle"

[2-11]

Numrico de 10 dgitos, completando con "0" a la


izquierda.

Medio de Pago

[12-14]

Numrico de 3 dgitos, completando con "0" a la


izquierda.

Nmero de Lote

[15-17]

Numrico de 3 dgitos (000...999).

Contador de
Compras

[18-21]

Numrico de 4 dgitos (0000...9999), cantidad de


compras netas.

Monto de Compras

[22-33]

Numrico de 12 dgitos, formato $$$$$$$$$$CC,


monto total de compras netas.

Cantidad de
Devoluciones

[34-37]

Numrico de 4 dgitos (0000...9999), cantidad de


devoluciones netas.

Contador de
Anulaciones

[50-53]

Numrico de 4 dgitos (0000...9999), cantidad de


anulaciones.

Monto de
Anulaciones

[54-65]

Numrico de 12 dgitos, formato $$$$$$$$$$CC,


monto de anulaciones

Filler

[66-100]

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".

Formato del archivo de cierre de lote

13

Manual de Integracin Decidir

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 (no requiere crear
nuevos ID Sites).
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

14

Manual de Integracin Decidir

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>comprador@email.com.ar</EMAILCLIENTE>
<URLDINAMICA>http://sddtest.aerolineas.com.ar/Mpol20/decidirpost</URLDINAMICA>
<BIN>450799</BIN>
<MONTO>1010.85</MONTO>
</Request>
</api:Payload>

BIN Heredado

15

Manual de Integracin Decidir

Creacin de nuevos ID Sites


Tipo de Promocin

Setup en
Decidir

Promocin con % de
descuento con Banco
ABC (comercio absorbe
50% del descuento). Ej.
"20% de descuento con
todas las tarjetas del
Banco ABC"

a) Alta Nuevo ID
Site; b) Alta
Filtro de Bines
de todas las
tarjetas del
Banco ABC
habilitadas para
la promo

a) Aplicar descuento que absorbe el


comercio y enviar las trx al nuevo ID
Site

Promocin de cuotas sin


inters con las tarjetas
de un determinado
Banco. Ej. "6 cuotas sin
inters con todas las
tarjetas del Banco
ABC"

a) Alta Nuevo ID
Site; b) Alta
Filtro de Bines
de todas las
tarjetas del
Banco ABC
habilitadas para
la promo

a) Enviar las trx al nuevo ID site


creado

Promocin de cuotas sin


inters con un medio de
pago de todos los
Bancos. Ej: "12 cuotas
sin inters con las Visa
de todos los Bancos"

N/A

N/A

Promicin de cuotas sin


inters + % de
descuento. Ej. "15% de
descuento y 6 cuotas
sin inters con todas
las tarjetas del Banco
ABC"

a) Alta Nuevo ID
Site; b) Alta
Filtro de Bines
de todas las
tarjetas del
Banco ABC
habilitadas para
la promo

a) Si el comercio absorbe el 15% de


descuento, aplicarlo antes de enviar la
trx a Decidir, si lo hace el Banco no
hacer nada, ya que el descuento ser
aplicado en el resumen del cliente; b)
Enviar la trx al nuevo ID Site creado

Setup en Comercio

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

16

Manual de Integracin Decidir

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

17

Manual de Integracin Decidir

Token de Seguridad
El Token de seguridad se obtiene enviando un mail a hd@decidir.com.ar. 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

18

Manual de Integracin Decidir

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

Manual de Integracin Decidir

Flujo de una Transaccin


Toda transaccin de pago independientemente del mtodo de integracin, realiza la
siguiente secuencia:

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.
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.

Flujo de una Transaccin

20

Manual de Integracin Decidir

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

21

Manual de Integracin Decidir

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): Debe bajarse del sandbox y consumirlo localmente.
Direccin (Endpoint): https://sps.decidir.com/services/t/1.1/Authorize

Pedido de Autorizacin en 1 paso

22

Manual de Integracin Decidir

Requerimiento
Campo

Security

Merchant

URL_OK

URL_Error

EncodingMethod

Payload

Descripcin

Tipo de
Dato

No

Token de
Seguridad
Generado en el
Portal de
DECIDIR, es
necesario
enviarlo
solamente si no
se puede
transportar en el
Header HTTP

Alfanumrico
hasta 32
caracteres

PRISMA
RV82RVHO5T0O5CZUUT

No

Cdigo de
comercio o
cuenta provisto
por DECIDIR

Alfanumrico
de 8
caracteres

12345678

No

URL a la que el
comprador ser
dirigido cuando
la compra
resulte exitosa

Alfanumrico
hasta 256
caracteres

http://susitio.com/payment/
payment/Ok(relativo)

No

URL a la que el
comprador ser
dirigido cuando
la compra no
resulte exitosa

Alfanumrico
hasta 256
caracteres

http://susitio.com/payment/
o payment/Error (relativo)

Si

Especifica el tipo
de codificacin
que se usa para
los datos de la
transacciones
de pagos

Alfanumrico
hasta 16
caracteres

XML

Documento
codificado en el
formato
especificado en
el campo
EncodingMethod
el cual contiene
los datos de la
transaccin a
Autorizar

Alfanumrico
hasta 2048
caracteres

Xml, compuesto por los


campos descritos en las ta
2, 3, 4. (ver ejemplo).

Mandatorio

Pedido de Autorizacin en 1 paso

Valores posibles / Ejem

23

Manual de Integracin Decidir

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


autorizar.
Campo

NROCOMERCIO

NROOPERACION

MONTO

CUOTAS

Descripcin

Tipo de Dato

Valores Posibles /
Ejemplos

Cdigo de
Comercio o
cuenta provisto
por
DECIDIR(mismo
valor que viaja
en el Merchant)

Alfanumrico
de 8
caracteres

12345678

Identificacin
unvocamente
de la
transaccin para
el Comercio.
Debe ser
distinto para
cada operacin.

Alfanumrico
de 1 a 40
caracteres

10000012

Importe en
Pesos de la
transaccin.

Numrico
con 9 dgitos
con hasta 2
decimales
999999[.CC]
Usando el
punto como
separador
de
decimales.
No se
permiten
comas, ni
como
separador
de miles ni
como
separador
de
decimales.

$125,38 ->
125.38 $12 -> 12
o 12.00

No

Cantidad de
cuotas en las
que se realiza
el pago

Decimal de
hasta dos
dgitos.

Depende del
contrato del
comercio con el
medio de pago.
01, 02, 06, 12,
etc.

Mandatorio

Valor que
identifica al
medio de pago

Pedido de Autorizacin en 1 paso

Numrico de

Ver ANEXO 1

24

Manual de Integracin Decidir

MEDIODEPAGO

EMAILCLIENTE

BIN

No

hasta 3
dgitos.

referencia
Medios de Pago

Si

El comercio
deber enviar a
DECIDIR el
email del
cliente. Esta
direccin se
utilizar para
enviar el mail de
confirmacin de
la compra al
cliente

Alfanumrico
de hasta 80
caracteres.

cliente@mail.com

No

Los primeros 6
dgitos de la
tarjeta que
permiten
identificar la
marca de tarjeta
y el banco
emisor de la
misma. Se
envian para la
configuracin de
promociones
por BIN
heredado

Numrico de
6 dgitos

450799

Pedido de Autorizacin en 1 paso

seleccionado
por el usuario
para realizar la
transaccin.

25

Manual de Integracin Decidir

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.

Pedido de Autorizacin en 1 paso

26

Manual de Integracin Decidir

Campo

CANTDIASFECHAVENC

CANTDIASPAGO

RECARGO

FECHAVTO

CLIENTE

Mandatorio

Descripcin

Tipo de Dato

Valores
Posibles /
Ejemplos

Son los das


que existen
entre el 1 y
2
vencimiento
de la
factura.

Numrico, 2
dgitos

Poner "00"
si la factura
no tiene 2
vencimiento.

Son los das


despus del
primer
vencimiento
y hasta el
que el
cliente
puede pagar
la factura
por
Rapipago

Numrico, 3
dgitos

---

Recargo por
vencimiento
del plazo.
Dato
generado
por el
comercio.
Es un monto
(no un
porcentaje).

Numrico, 7
dgitos con hasta
2 decimales
99999[.CC]

---

Fecha de
vencimiento
para el pago
del cupn.
Dato
generado
por el
comercio

Numrico, 6
dgitos(AAMMDD)

---

Cdigo de
cliente
provisto por
Rapipago al
momento de
habilitar al
comercio.
Dato fijo

Numrico, 8
dgitos

---

Impresin y simbologa del cdigo de barras:

Pedido de Autorizacin en 1 paso

27

Manual de Integracin Decidir

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.

Pedido de Autorizacin en 1 paso

28

Manual de Integracin Decidir

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.

Campo

RECARGO

FECHAVTO

FECHAVTO2

Tipo de Dato

Valores
Posibles
/Ejemplos

Recargo por
vencimiento del
plazo. Dato
generado por el
comercio. Es un
monto (no un
porcentaje)

Numrico, 7
dgitos con hasta
2 decimales
99999[.CC]

---

Fecha de
vencimiento para
el pago del cupn.
Dato generado por
el comercio

Numrico, 6
dgitos(AAMMDD)

---

Fecha del segundo


vencimiento para
el pago del cupn.
Dato generado por
el comercio

Numrico, 6
dgitos(AAMMDD)

---

Mandatorio

Descripcin

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.

Pedido de Autorizacin en 1 paso

29

Manual de Integracin Decidir

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

FECHAVTO

Tipo

Valor

Numrico

Mximo
11
dgitos,
dato de
longitud
variable.

Pedido de Autorizacin en 1 paso

Observaciones
Fecha y hora de vencimiento
de la factura. Puede omitirse
las horas y minutos,
informando solo la fecha con
formato DDMMYY.

Formato
DDMMYY
o
DDMMYY
HHMM

30

Manual de Integracin Decidir

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 autorizacinde 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:

Pedido de Autorizacin en 1 paso

31

Manual de Integracin Decidir

Parmetro

Mandatorio

Descripcin

Formato

Indicador del tipo de


documento

Numrico, 1
dgito

ADOCUMENTO

Nmero de CUIT,
CUIL o Nmero
nico (en este caso
completar con ceros
a la izquierda)

Caracter, 11
posiciones

AFACTPAGAR

No

Nmero de Factura a
Pagar

Alfanumrico
12 caracteres

AFACTDEVOL

No

Nmero de factura
de
anulacion/Devolucin

Alfanumrico
12 caracteres.

AINDICADOR

0
1
2
Nmero
nico

ANOMBRECOM

Nombre de comercio
o nombre y apellido
del vendedor

Alfanumrico
20 caracteres.
En caso de
nombre y
apellido,deben
estar
separados por
/

ADOMICILIOCOMERCIO

Direccin del
comercio o del
vendedor

Alfanumrico
20 caracteres.

ANROPUERTA

Nmero de puerta

Alfanumrico
6 caracteres

ACODPOSTAL

Cdigo postal

Alfanumrico
8 caracteres

ARUBRO

Cdigo de actividad
(rubro)

Alfanumrico
5 caracteres

descargar
Tabla

Alfanumrico
3 caracteres

Consultar
codificacin
con el
medio de
pago

Alfanumrico
5 caracteres

Consultar
codificacin
con el
medio de
pago

ACODCANAL

ACODGEOGRAFICO

No

No

Pedido de Autorizacin en 1 paso

Cdigo de canal

Cdigo geogrfico
del vendedor

32

Manual de Integracin Decidir

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.

Pedido de Autorizacin en 1 paso

33

Manual de Integracin Decidir

Split de Transacciones
DECIDIR permite realizar transacciones distribuidas (Split de transacciones) para aquellos
comercios que operen por cuenta y orden de terceros y necesitan dividir sus operaciones
entre varios establecimientos en los autorizadores. Esta funcionalidad permite realizar el
Split de transacciones entre "n" nmeros de comercios distintos en una misma operacin.
Cada uno de los comercios de DECIDIR deber contar con un nmero de establecimiento
en cada medio de pago.
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.

Pedido de Autorizacin en 1 paso

34

Manual de Integracin Decidir

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:
Parmetro

NROCOMERCIO

IMPDIST

SITEDIST

CUOTASDIST

Mandatorio

Descripcin

Formato

Valores Posibles /
Ejemplos

Nmero de
Comercio Padre
provisto por
DECIDIR.

Alfanumrico
de 8
caracteres.

Importe de cada
una de las
subtransacciones.
Los importes
deben postearse
separados por #.

"999999.CC"
Con
decimales
usando el
puntos como
separador
de
decimales.
No se
permiten
comas, ni
como
separador
de miles ni
como
separador
de
decimales.

125.38#12#12.00

Nmeros de
comercios
provistos por
DECIDIR para
cada uno de los
subcomercios
asociados al
comercio Padre.
Deben postearse
separados por #.

Alfanumrico
de 8
caracteres.

00100511#01100511

Cantidad de
cuotas por cada
subcomercio.
Deben postearse
separados por #.

Decimal de 2
dgitos.

01#06#12

Indica si la
transaccin es
distribuida o no.
Si no es enviado

Pedido de Autorizacin en 1 paso

Null Transaccin
no distribuida.
35

Manual de Integracin Decidir

IDMODALIDAD

Pedido de Autorizacin en 1 paso

el **pedido de
autorizacin** se
toma como
comercio no
distribuido, para
no afectar la
operatoria actual.

no distribuida.
S Transaccin
distribuida.
N Transaccin no
distribuida.

36

Manual de Integracin Decidir

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:
Parmetro

IDMODALIDAD

Mandatorio

Pedido de Autorizacin en 1 paso

Descripcin
Indica si la transaccin
es distribuida o no. Si
no es enviado el "post"
se toma como
comercio no
distribuido, para no
afectar la operatoria
actual.

Formato

Valores
Posibles
Null. S
Transaccin
distribuida.
N
transaccin
no
distribuida.

37

Manual de Integracin Decidir

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><!-- merchand proporcionado por DECIDIR-->
<api:URL_OK>www.sitioDeEjemplo.com</api:URL_OK>
<api:URL_ERROR>www.SitioDeEjemplo.com</api:URL_ERROR>
<api:EncodingMethod>XML</api:EncodingMethod>
<api:Payload>
<Request>
<NROCOMERCIO>12345678</NROCOMERCIO><!-- merchand proporcionado por DECIDIR-->
<NROOPERACION>ABCDEF-1234-12221-FDE1-00000200</NROOPERACION>
<MONTO>50.01</MONTO>
<MEDIODEPAGO>1</MEDIODEPAGO>
<EMAILCLIENTE>comprador@email.com.ar</EMAILCLIENTE>
</Request>
</api:Payload>
</api:SendAuthorizeRequest>
</soapenv:Body>
</soapenv:Envelope>

Pedido de Autorizacin en 1 paso

38

Manual de Integracin Decidir

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

StatusCode

Cdigo de estado o
valor de retorno del
Servicio

StatusMessage

Descripcin del cdgo


de retorno o estado del
servicio

Url del formulario de


pago

URL

https://forms.decidir.ne
formulario/commands?
command=formulario&
f7b1-4ee9-e76b-9cc84

No

Identificador Privado
del Requerimiento
obtenido en la
respuesta de la
operacin
SendAuthorizeRequest.
Nunca debe ser
expuesto hacia el Web
Browser. Solo ser
utilizado entre el Site y
DECIDIR

Alfanumrico
hasta 48
caracteres

8496472a-8c87-e35b-d
94d5e31eb12f

No

Identificador Pblico
del Requerimiento
obenido en la
respuesta de la
operacin
SendAuthorizeRequest

Alfanumrico
de hasta 48
caracteres

7d3938c9-f7b1-4ee9-e
9cc84f73fe81

URL Request

RequestKey

PublicRequestKey

Numrico de
4 posiciones

-1 -> OK
otro ->Error

Alfanumricoo
hasta 256

El campo o elemento Payload es utilizado para retornar los datos de la respuesta de la


transaccin.

Pedido de Autorizacin en 1 paso

39

Manual de Integracin Decidir

Campo

Mandatorio

Descripcin

Tipo de Dato

Valores
posibles
Ejemplo

Fecha y Hora.
aaaammddTHHMMSSZ
La hora se expresa en
formato 24 hs.

FECHAHORA

Si

Fecha y Hora
de la
Transaccin

MONEDA

No

Nombre de la
Moneda

NROTICKET

No

Nmero de
Ticket o
Voucher

Numrico de Hasta 4
dgitos

CODAUTORIZACION

No

Cdigo de
Autorizacin

Alfanumrico de hasta
8 caracteres

No

Nmero de
Tarjeta,
enmascarado
segn
normativas
nacionales,
regionales o
globales

No

Cdigo de
Barras
generado
para Pago
Fcil
RapiPago

NROTARJETAVISIBLE

CODBARRAS

Pedido de Autorizacin en 1 paso

Alfanumrico hasta 64
caracteres

40

Manual de Integracin Decidir

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>

Pedido de Autorizacin en 1 paso

41

Manual de Integracin Decidir

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

42

Manual de Integracin Decidir

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 (Ver Nota)
Las reglas de aceptacin del Monto2 dependen de cada medio de pago, y del tipo de
operatoria.
DECIDIR no realiza validaciones sobre el Monto2.
Como ejemplo, un medio de pago puede aceptar que el Monto2 sea +5% -20%
respecto al Monto1.
El comercio debe validar con cada medio de pago, los rangos que cada uno autoriza.
Se realiza utilizando el mismo ID de transaccin que la Pre Autorizacin. Si la
autorizacin es aprobada, la misma ingresar al cierre de lote del da y ser liquidada
por el medio de pago normalmente.

Pedido de Autorizacin en 2 pasos

43

Manual de Integracin Decidir

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

Pedido de Autorizacin en 2 pasos

44

Manual de Integracin Decidir

Esquema Transaccional
El siguiente diagrama refleja el flujo transaccional de esta operatoria.

Pedido de Autorizacin en 2 pasos

45

Manual de Integracin Decidir

Formulario
La solucin propuesta como formulario de pago es un formulario custom. La ventaja de este
mtodo es el nivel de personalizacin que puede alcanzar en el diseo de su formulario.

Invocacin al Formulario

46

Manual de Integracin Decidir

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.

Invocacin al Formulario

47

Manual de Integracin Decidir

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://sandbox.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:


Nombre

Descripcin

Tipo de
Dato

id

Identificador del formulario

Alfanumrico

fieldsId

Ids de los input del formulario

Objeto
JSON

callback

Funcin que se ejecutar al terminar el script, en esta se


deber recuperar el PublicAnswerKey pasandolo por
parmetro

funcin

options

Parametros adicionales de configuracin este campo es


opcional

Objeto
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:

Invocacin al Formulario

48

Manual de Integracin Decidir

Id en el JSON

Mandatorio

Descripcin

Tipo de
dato

CardHolderName

Nombre del
tarjetahabiente

Alfanumrico

CardHolderMail

Direccin de correo
electrnico

Alfanumrico

CardNumber

Nmero de la tarjeta

Numrico de
hasta 20
caracteres

CardExpirationDate

S (Puede elegir
reemplazarlo por
mandar el
CardExpirationDay y
CardExpirationMonth)

Fecha de vencimiento
de la tarjeta

Alfanumrico
de 4
caracteres

CardExpirationDay

No (Pero se manda
nicamente si no se
enva el
CardExpirationDate)

Da en la fecha de
vencimiento

Numrico de
2 caracteres

CardExpirationMonth

No (Pero se manda
nicamente si no se
enva el
CardExpirationDate)

Mes de vencimiento

Numrico de
2 caracteres

CardSecurityCode

Cdigo de seguridad
de la tarjeta

Numrico de
3 caracteres

PublicRequestKey
devuelto por el
SendAuthorizeRequest

Alfanumrico
de hasta 48
caracteres

PublicRequestKey

Por otro lado tenemos los campos adicionales del pa&ametro options, todos estos son
opcionales.

Invocacin al Formulario

49

Manual de Integracin Decidir

Id en el JSON

Valores
posibles

Descripcin

true o
flase

En caso de ser "true" mostrar el


nombre de la marca tarjeta que se
est ingresando. (Visa, American
Express, Mastercard o Diners
Club)

displayCreditCardTypeContainerId

null o
String

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
displayCreditCardTypeDetected
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

cardType

1, 2, 6,
15, etc o
null

Es el valor del IdMediodePago.


Indica si se validar que el

displayCreditCardTypeDetected

nmero de tarjeta ingresado se corresponda con una marca tarjeta predefinida. 1 (visa), 15
(mastercard), 6 (amex), 8 (diners club), null (sin restriccin de marca tarjeta) cardBin | null o
Valor | En caso de tener un valor numrico, se utilizar como BIN de tarjeta reduciendo la
cantidad de dgitos a completar por el usuario en CreditCardNumber. Si es null, significa que
no se utiliza BIN displayCardBin | true o false | Indica si se va a mostrar el nmero de BIN
displayCardBinContainerId (null o String): 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, si
el valor displayCardBin es true, se crear un control propio y se ubicar por sobre el
<input type="text"> donde se completa el nmero de tarjeta.

Invocacin al Formulario

50

Manual de Integracin Decidir

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

51

Manual de Integracin Decidir

Requerimiento
En el llamado a DECIDIR se debern enviar los siguientes campos del servicio:
Campo

Mandatorio

Descripcin

Tipo de
Dato

Alfanumrico
hasta 32
caracteres

1234567890ABCDEF123

Valores posibles

Security

No

Token de Seguridad
Generado en el Portal
de DECIDIR, es
necesario enviarlo
solamente si no se
puede transportar en
el Header HTTP

Merchant

Si

Cdigo de comercio o
cuenta provisto por
DECIDIR

Alfanumrico
de 8
caracteres

12345678

Si

Identificador Privado
del Requerimiento
obtenido en la
respuesta de la
operacin
SendAuthorizeRequest
. Nunca debe ser
expuesto hacia el Web
Browser. Solo ser
utilizado entre el Site y
DECIDIR

Alfanumrico
hasta 48
caracteres

8496472a-8c87-e35b-dcf2

Identificador Pblico
de la Respuesta
Recibido segn el
mtodo utilizado de
Integracin
(Formulario Embebed
o Custom) en un
campo del formulario
posteado al Site, o
como propiedad
retornada en la
invocacin del mtodo
de Inicio de Pago
(Java Script).

Alfanumrico
hasta 48
caracteres

8496472a-8c87-e35b-dcf2

RequestKey

AnswerKey

Pedido de Informacin de una Transacccin

52

Manual de Integracin Decidir

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:Merchant>12345678</api:Merchant>
<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>

Pedido de Informacin de una Transacccin

53

Manual de Integracin Decidir

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.

Campo

Mandatorio

Descripcin

Tipo de
Dato

Valores
posibles
/
Ejemplo

Numrico de
4 posiciones

-1 -> OK
0 99999 ->
error

StatusCode

Si

Cdigo de estado o
valor de retorno del
Servicio

StatusMessage

Si

Descripcin del
cdigo de retorno o
estado del servicio

Alfanumrico
hasta 256

No

Identificador Privado
de la Respuesta

Alfanumrico
hasta 256
caracteres

No

Especifica el tipo
codificacin que se
usa para los datos
de la transacciones
de pagos

Alfanumrico
hasta 16
caracteres

XML

No

Documento
codificado en el
formato especificado
en el campo
EncodingMethod el
cual contiene los
datos de la
transaccin a
Autorizar

Alfanumrico
hasta 2048
caracteres

AuthorizationKey

EncodingMethod

Payload

El campo o elemento Payload es utilizado para retornar los datos de la respuesta de la


transaccin.
Campo

FECHAHORA

Mandatorio

Si

Pedido de Informacin de una Transacccin

Descripcin

Tipo de Dato

Fecha y Hora
de la

Fecha y Hora.
aaaammddTHHMMSSZ
La hora se expresa en
54

Manual de Integracin Decidir

formato 24 hs.
MONEDA

No

Nombre de la
Moneda

NROTICKET

No

Nmero de
Ticket o
Voucher

Numrico de Hasta 4
dgitos

CODAUTORIZACION

No

Cdigo de
Autorizacin

Alfanumrico de hasta
8 caracteres

No

Nmero de
Tarjeta,
enmascarado
segn
normativas
nacionales,
regionales o
globales

No

Cdigo de
Barras
generado
para Pago
Fcil
RapiPago

No

Informa el
cdigo
numrico de
la respuesta
de
Cybersource.

ejemplos, 100
10101 / 10103
cdigos de
Cybersource

No

Informa el
identificador
de la
solicitud,
generado por
Cybersource,
para ubicarla
rpidamente
dentro del
Desicion
Manager. Si
el campo no
se visualiza,
implica que
la trasaccion
no llego a
Cybersource

Ejemplos:
443189013623
555189013623

NROTARJETAVISIBLE

CODBARRAS

RESULTADOCS

IDENTIFICADORCS

Pedido de Informacin de una Transacccin

Alfanumrico hasta 64
caracteres

55

Manual de Integracin Decidir

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:StatusCode>-1</api:StatusCode>
<api:StatusMessage>APROBADA</api:StatusMessage>
<api:AuthorizationKey>8496472a-8c87-e35b-dcf2-94d5e31eb12f</api:AuthorizationKey
<api:EncodingMethod>XML</api:EncodingMethod>
<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">
<NROCOMERCIO>305</NROCOMERCIO>
<NROPERACION>1234</NROPERACION>
<MONTO>54.00</MONTO>
</Request>
</api:Payload>
</api:GetAuthorizeAnswerResponse>
</SOAP-ENV:Body>

Pedido de Informacin de una Transacccin

56

Manual de Integracin Decidir

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): Debe bajarse del sandbox y consumirlo localmente.
Direccin (Endpoint): https://sps.decidir.com/services/t/1.1/Operation

Ver Estado de una Transacccin

57

Manual de Integracin Decidir

Validacin Adicional de Datos


Slo para Transacciones con VISA.
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)

Ver Estado de una Transacccin

58

Manual de Integracin Decidir

Requerimiento para ver el estado de una transaccin


En el llamado a DECIDIR se debern enviar los siguientes campos del servicio:

Campo

IDSITE

IDTRANSACTIONSIT

Tipo de
Dato

Valores
posibles /
Ejemplo

Mandatorio

Descripcin

Cdigo de
comercio o
cuenta
provisto por
DECIDIR

Alfanumrico
de 8
caracteres

12345678

Identificacin
unvocamente
de la
transaccin
para el
Comercio.
Debe ser
distinto para
cada
operacin.

Alfanumrico
de 1 a 40
caracteres.

141120084707

Ver Estado de una Transacccin

59

Manual de Integracin Decidir

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>

Ver Estado de una Transacccin

60

Manual de Integracin Decidir

Respuesta del estado de una transaccin


Cam/po

Mandatorio

Descripcin

Tipo de Dato

No

Numrico de 8
dgitos,
formato
"DDMMYYYY".

Importe en
Pesos de la
transaccin.

Numrico con
9 dgitos con
hasta 2
decimales
999999[.CC]
Usando el
punto como
separador de
decimales. No
se permiten
comas, ni
como
separador de
miles ni como
separador de
decimales.

$125,38 -> 125.38


$12 -> 12.00

CUOTAS

No

Cdigo de
autorizacin
generado por
el medio de
pago

Decimal de
hasta dos
dgitos.

Depende del contrato


pago. 01, 02, 06, 12,

NROTICKET

No

Numero de
Ticket o
Voucher

Numrico de
Hasta 4 dgitos

Describe el
estado en el
que se
encuentra la
transaccin

Alfanumrico

Nmero
identificador
del motivo por
el que se
encuentra en
dicho estado

Numrico

FECHA_ORIGINAL

MONTO

ESTADO_DESCRI

IDMOTIVO

MOTIVO_ADIIONAL

No

Ver Estado de una Transacccin

Descripcin
adicional del
motivo que
viene en

ver Tabla

Alfanumrico

61

Manual de Integracin Decidir

algunos casos
No

Nombre del
titular de la
tarjeta.

IDTIPODOC

No

Numero
identificador
del tipo de
documento

Numrico, 1
dgito

NRODOC

No

Nmero de
documento

Numrico

No

Tipo de
documento

Cdigo de
autorizacin
recibido del
medio de
pago.

Alfanumrico
de hasta 8
caracteres

No

Nmero de
Tarjeta,
enmascarado
segn
normativas
nacionales

alfanumrico
de 20
caracteres

No

Descripcin
del motivo por
el cul se
encuentra en
ese estado.

Alfanumrico

No

Solo
transacciones
Visa
.Respuesta de
la validacin
de datos
adicionales

Alfanumerico
de 7
posiciones

Ver Tabla

Mail del
usuario al que
se le emite la
factura

Alfanumrico
de 100
caracteres.

Ejemplo: decidir@hot

Cdigo de
comercio o
cuenta
provisto por
DECIDIR

Alfanumrico
de 8
caracteres

TITULAR

TIPODOC

CODAUT

NROTARJ4

MOTIVO

VALDOM

MAIL

IDSITE

Ver Estado de una Transacccin

Alfanumrico
1 -> DNI
2 -> CI
3 -> LE
4 -> LC

DNI
CI
LE
LC

62

Manual de Integracin Decidir

Nmero
identificador
del estado en
el que se
encuentra la
transaccin

IDMEDIOPAGO

Valor que
identifica al
medio de pago
seleccionado
por el usuario
para realizar la
transaccin

Numrico

MEDIOPAGO_DESCRI

Nombre del
medio de pago

alfanumrico

SEXOTITULAR

No

identificador
del sexo del
tarjetahabiente

No

Calle donde el
tarjetahabiente
recibe el
resumen de la
tarjeta

Varchar,
mximo 30

No

Nmero de
puerta donde
recibe el
resumen el
tarjetahabiente

Numrico,
mximo 6

No

Parmetro de
uso libre para
el comercio,
puede
visualizarse en
los
templates,
colocando: . El
valor enviado
tambin es
devuelto en el
post por
background

Alfanumrico
hasta 256
caracteres,
permite los sig.
caracteres
especiales "_,.;:@|"

IDESTADO

CALLE

NROPUERTA

PARAMSITIO

FECHAVTOCUOTA1

No

Ver Estado de una Transacccin

Fecha de
vencimiento
de la primera
cuota,
necesario para
el medio de
pago

Numrico

Ver [ANEXO Tablas


Pago]
(../../../Anexos/Tablas

FEMENINO
MASCULINO

Numrico de 8
dgitos,
formato
"DDMMYYYY".

63

Manual de Integracin Decidir

PYMENAcin

Ver Estado de una Transacccin

64

Manual de Integracin Decidir

Ejemplo de una respuesta del estado de una transaccin


<?xml version="1.0" encoding="UTF-8"?>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
<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"
<MONTO>6598.00</MONTO>
<CUOTAS>6</CUOTAS>
<NROTICKET>0</NROTICKET>
<ESTADO_DESCRI>Ingresada</ESTADO_DESCRI>
<IDMOTIVO>0</IDMOTIVO>
<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>comprador@email.com.ar</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"
</Operation>
</Operations>
</soapenv:Body>
</soapenv:Envelope>

Ver Estado de una Transacccin

65

Manual de Integracin Decidir

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).

Realizar Anulacin

66

Manual de Integracin Decidir

Requerimiento
Descripcin

Tipo de
Dato

Valores
posibles
/ Ejemplo

NROCOMERCIO

Cdigo de
Comercio o
cuenta provisto
por
DECIDIR(mismo
valor que viaja en
el Merchant)

Alfanumrico
de 8
caracteres

12345678

NROOPERACION

Identificacin
unvocamente de
la transaccin
para el Comercio.
Debe ser distinto
para cada
operacin.

Alfanumrico
de 1 a 40
caracteres

10000012

Campo

Realizar Anulacin

Mandatorio

67

Manual de Integracin Decidir

Ejemplo
<?xml version="1.0" encoding="UTF-8"?>

<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>Anulacin</Operation>
<EncodingMethod>XML</EncodingMethod>
<api:Payload xmlns:api="http://api.decidir.com.ar">
<Request xmlns="">
<NROCOMERCIO>12345678</NROCOMERCIO>
<NROOPERACION>CV142668740924-1</NROOPERACION>
</Request>
</api:Payload>
</Execute>
</soap:Body>
</soap:Envelope>

Realizar Anulacin

68

Manual de Integracin Decidir

Respuesta para una Anulacin


Campo

Mandatorio

Descripcin

IDMOTIVO

Nmero de
identificacin
del motivo
del resultado

Numrico

RESULTADO

Resultado
de la
anulacin

Alfanumrico

FECHAHORA

Realizar Anulacin

Si

Fecha y
Hora de la
Transaccin

Tipo de Dato

Fecha y Hora
(aaaammddTHMMSSZ)
La hora se expresa en
formato 24 hs.

Valores
posibles /
Ejemplo

ver Tabla

Para casos
de
transacciones
aprobadas es
0. En las
transacciones
rechazadas
vara el
cdiigo
dependiendo
del motivo de
rechazo y del
medio de
pago.

69

Manual de Integracin Decidir

Ejemplo de una respuesta para una Anulacin


<?xml version="1.0" encoding="UTF-8"?>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
<soapenv:Body>
<api:ExecuteResponse xmlns:api="http://api.decidir.com.ar">
<api:StatusCode>-1</api:StatusCode>
<api:StatusMessage>Anulacin aceptada</api:StatusMessage>
<api:AuthorizationKey>E8321D4F9E6DDC6D3D1426687429614</api:AuthorizationKey>
<api:EncodingMethod>XML</api:EncodingMethod>
<api:Payload>
<Answer>
<IDMOTIVO>0</IDMOTIVO>
<RESULTADO>APROBADA</RESULTADO>
<FECHAHORA>2015/03/18 11:03:45</FECHAHORA>
</Answer>
</api:Payload>
</api:ExecuteResponse>
</soapenv:Body>
</soapenv:Envelope>

Realizar Anulacin

70

Manual de Integracin Decidir

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

71

Manual de Integracin Decidir

Realizar una devolucin Total


De este modo se devolver el monto total de la orden.

Realizar Devolucin

72

Manual de Integracin Decidir

Requerimiento

Campo

NROCOMERCIO

NROOPERACION

Realizar Devolucin

Descripcin

Tipo de
Dato

Valores
posibles
/ Ejemplo

Cdigo de
Comercio o
cuenta provisto
por
DECIDIR(mismo
valor que viaja en
el Merchant)

Alfanumrico
de 8
caracteres

12345678

Identificacin
unvocamente de
la transaccin
para el Comercio.
Debe ser distinto
para cada
operacin.

Alfanumrico
de 1 a 40
caracteres

10000012

Mandatorio

73

Manual de Integracin Decidir

Ejemplo de un requerimiento para realizar una devolucin total


<?xml version="1.0" encoding="UTF-8"?>
<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>
<Execute xmlns="http://api.decidir.com.ar">
<Security>XXXXXXXXXXXXXXXXXXXXXXXXX</Security>
<Session xsi:nil="true" />
<Merchant>12345678</Merchant>
<Operation>Devolucion</Operation>
<EncodingMethod>XML</EncodingMethod>
<api:Payload xmlns:api="http://api.decidir.com.ar">
<Request xmlns="">
<NROCOMERCIO>12345678</NROCOMERCIO>
<NROOPERACION>179783-0</NROOPERACION>
</Request>
</api:Payload>
</Execute>
</soap:Body>
</soap:Envelope>

NOTA: el valor a ingresar en el parametro Operation nunca lleva acentos.

Realizar Devolucin

74

Manual de Integracin Decidir

Respuesta

Campo

Mandatorio

Descripcin

IDMOTIVO

Nmero de
identificacin
del motivo
del resultado

Numrico

RESULTADO

Resultado
de la
devolucin

Alfanumrico

Fecha y
Hora de la
Transaccin

Fecha y Hora
(aaaammddTHHMMSSZ).
La hora se expresa en
formato 24 hs.

FECHAHORA

Realizar Devolucin

Tipo de Dato

Valores
posibles
/
Ejemplo

ver Tabla

75

Manual de Integracin Decidir

Ejemplo de una respuesta para realizar una devolucin.


<?xml version="1.0" encoding="UTF-8"?>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
<soapenv:Body>
<api:ExecuteResponse xmlns:api="http://api.decidir.com.ar">
<api:StatusCode>-1</api:StatusCode>
<api:StatusMessage>Devolucin aceptada</api:StatusMessage>
<api:AuthorizationKey>E8321D4F9E6DDC6D3D1427322973499</api:AuthorizationKey>
<api:EncodingMethod>XML</api:EncodingMethod>
<api:Payload>
<Answer>
<IDMOTIVO>0</IDMOTIVO>
<RESULTADO>APROBADA</RESULTADO>
<FECHAHORA>2015/03/25 19:36:08</FECHAHORA>
</Answer>
</api:Payload>
</api:ExecuteResponse>
</soapenv:Body>
</soapenv:Envelope>

Realizar Devolucin

76

Manual de Integracin Decidir

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).

Realizar Devolucin

77

Manual de Integracin Decidir

Requerimiento

Descripcin

Tipo de
Dato

Valores
posibles
/ Ejemplo

NROCOMERCIO

Cdigo de
Comercio o
cuenta provisto
por
DECIDIR(mismo
valor que viaja en
el Merchant)

Alfanumrico
de 8
caracteres

12345678

NROOPERACION

Identificacin
unvocamente de
la transaccin
para el Comercio.
Debe ser distinto
para cada
operacin.

Alfanumrico
de 1 a 40
caracteres

10000012

Especifica el
monto a devolver.

Monto que
se desea
devolver
(Formato
"999999.CC"
).

$12 ->
12.00
$34.50 ->
34.50

Campo

MONTO

Realizar Devolucin

Mandatorio

78

Manual de Integracin Decidir

Ejemplo de un requerimiento para realizar una devolucin


<?xml version="1.0" encoding="UTF-8"?>

<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:Merchant>12345678</api:Merchant>
<api:Operation>Devolucin</api:Operation>
<api:EncodingMethod xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
<api:Payload>
<Request>
<NROCOMERCIO>xxxxxx</NROCOMERCIO>
<NROOPERACION>14345354</NROOPERACION>
<MONTO>25.38</MONTO>
</Request>
</api:Payload>
</api:Execute>
</soapenv:Body>
</soapenv:Envelope>

Realizar Devolucin

79

Manual de Integracin Decidir

Respuesta de una devolucin parcial

Campo

Mandatorio

Descripcin

IDMOTIVO

Nmero de
identificacin
del motivo
del resultado

Numrico

RESULTADO

Resultado
de la
devolucin

Alfanumrico

Fecha y
Hora de la
Transaccin

Fecha y Hora
(aaaammddTHHMMSSZ).
La hora se expresa en
formato 24 hs.

FECHAHORA

Realizar Devolucin

Tipo de Dato

Valores
posibles
/
Ejemplo

ver Tabla

80

Manual de Integracin Decidir

Ejemplo de una respuesta para realizar una devolucin.


<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
<soapenv:Body>
<api:ExecuteResponse xmlns:api="http://api.decidir.com.ar">
<api:StatusCode>-1</api:StatusCode>
<api:StatusMessage>Devolucin aceptada</api:StatusMessage>
<api:AuthorizationKey>XXXXXXXXXXXXXXXXXXXXXXXXX</api:AuthorizationKey>
<api:EncodingMethod>XML</api:EncodingMethod>
<api:Payload>
<Answer>
<IDMOTIVO>0</IDMOTIVO>
<RESULTADO>APROBADA</RESULTADO>
<FECHAHORA>2015/09/07 10:39:37</FECHAHORA>
</Answer>
</api:Payload>
</api:ExecuteResponse>

Realizar Devolucin

81

Manual de Integracin Decidir

Realizar una Confirmacin


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

Realizar una Confirmacin

82

Manual de Integracin Decidir

Requerimiento
Descripcin

Tipo de
Dato

Valores
posibles
/ Ejemplo

NROCOMERCIO

Cdigo de
Comercio o
cuenta provisto
por
DECIDIR(mismo
valor que viaja en
el Merchant)

Alfanumrico
de 8
caracteres

12345678

NROOPERACION

Identificacin
unvocamente de
la transaccin
para el Comercio.
Debe ser distinto
para cada
operacin.

Alfanumrico
de 1 a 40
caracteres

10000012

Campo

Mandatorio

Realizar una Confirmacin

83

Manual de Integracin Decidir

Ejemplo de un requerimiento de Confirmacin


<?xml version="1.0" encoding="UTF-8"?>

<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>Confirmacion</Operation>
<EncodingMethod>XML</EncodingMethod>
<api:Payload xmlns:api="http://api.decidir.com.ar">
<Request xmlns="">
<NROCOMERCIO>12345678</NROCOMERCIO>
<NROOPERACION>961148-0</NROOPERACION>
</Request>
</api:Payload>
</Execute>
</soap:Body>
</soap:Envelope>

Realizar una Confirmacin

84

Manual de Integracin Decidir

Respuesta de una Confirmacin

Campo

IDMOTIVO

RESULTADO

FECHAHORA

Mandatorio

Descripcin

Nmero de
identificacin
del motivo
del resultado

Numrico

Resultado
de la
devolucin

Alfanumrico

Fecha y
Hora de la
Transaccin

Fecha y Hora
(aaaammddTHHMMSSZ).
La hora se expresa en
formato 24 hs.

Realizar una Confirmacin

Tipo de Dato

Valores
posibles
/
Ejemplo

ver Tabla

85

Manual de Integracin Decidir

Ejemplo de respuesta de una Confirmacin


<?xml version="1.0" encoding="UTF-8"?>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
<soapenv:Body>
<api:ExecuteResponse xmlns:api="http://api.decidir.com.ar">
<api:StatusCode>-1</api:StatusCode>
<api:StatusMessage>Confirmacin Recibida</api:StatusMessage>
<api:AuthorizationKey>E8321D4F9E6DDC6D3D1427322973292</api:AuthorizationKey>
<api:EncodingMethod>XML</api:EncodingMethod>
<api:Payload>
<Answer>
<IDMOTIVO>0</IDMOTIVO>
<RESULTADO>APROBADA</RESULTADO>
<FECHAHORA>2015/03/25 19:36:08</FECHAHORA>
</Answer>
</api:Payload>
</api:ExecuteResponse>
</soapenv:Body>
</soapenv:Envelope>

Realizar una Confirmacin

86

Manual de Integracin Decidir

Ejemplos de integracin
Para ejemplificar el metodo de integracin utilizaremos el lenguaje PHP en su versin 5.

Ejemplos de integracin

87

Manual de Integracin Decidir

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>
<NROCOMERCIO>12345678</NROCOMERCIO>
<NROOPERACION>9238742994</NROOPERACION>
<MONTO>50</MONTO>
<MEDIODEPAGO>1</MEDIODEPAGO>
<EMAILCLIENTE>comprador@email.com.ar</EMAILCLIENTE>
</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

88

Manual de Integracin Decidir

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

89

Manual de Integracin Decidir

Invocacin del formulario


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

Invocacin al Formulario

90

Manual de Integracin Decidir

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





Payment method

input[type=text]::-ms-clear { display: none; }
.paybox { background: #f6f6f6; font-family: Arial,sans-serif; font-size: 14px; }

.paybox h1 { width: 350px; padding: 30px; margin: auto; border-width: 1px 1px 0px 1px; border-sty

.paybox form { border: 1px solid #ddd; padding: 30px; border-radius: 0px 0px 10px 10px; width: 35
.paybox form .row { margin-bottom: 10px;}
.paybox form .row .col { display: inline-block; vertical-align: top;}
.paybox form .row .col1 { width: 55%; }
.paybox form .row .col2 { width: 40%; }
.paybox form label { display: block; padding-top: 10px; font-weight: bold;}

.paybox form input[type="text"], select { padding-left: 6px; height: 40px; line-height: 1; margin
.paybox form select { width: 70px;}
.paybox form input[id="CardNumber"] { width: 55%; border-radius: 5px; }
.paybox form input[id="CardHolderName"] { width: 100%; border-radius: 5px; }
.paybox form input[id="CardSecurityCode"] { border-radius: 5px 0px 0px 5px; }
.paybox form input[id="CardHolderMail"] { width: 100%; border-radius: 5px; }
.paybox form input[id="CardExpirationDate"] { border-radius: 5px; }
.paybox form #boxCardNumber { position: relative; }
.paybox form ::-webkit-input-placeholder {color: #999;}
.paybox form ::-moz-placeholder {color: #999;}
.paybox form :-ms-input-placeholder {color: #999;}
.paybox form :-moz-placeholder {color: #999; letter-spacing: 1px;}
.paybox form #CardNumber:-ms-input-placeholder { letter-spacing: 1px; }
.paybox form #CardNumber::-moz-placeholder { letter-spacing: 1px; }
.paybox form #CardNumber::-webkit-input-placeholder { letter-spacing: 1px; }

Invocacin al Formulario

91

Manual de Integracin Decidir

.paybox form #CardSecurityCodeHelper { background-color: #f2f2f2; color: #5e656b; display: inline

.paybox form button[type="submit"] { border: 1px solid #54c7c3; padding: 6px; border-radius: 5px;
.paybox form button[type="submit"]:hover { background: #6dcecb;}



Formulario de Pago


Nmero de Tarjeta



Nombre









Vencimiento
MM
AAAA



CVC
?



Email




Pagar $AR 55





new Payment().init({
id: 'payform',
fieldsId: {
CardHolderName: 'CardHolderName',
CardHolderMail: 'CardHolderMail',
CardNumber: 'CardNumber',
//Para fecha de venciomiento en 2 selectores:
CardExpirationMonth: 'CardExpirationMonth',

Invocacin al Formulario

92

Manual de Integracin Decidir

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
}
});





Payment method

input[type=text]::-ms-clear { display: none; }
.paybox { background: #f6f6f6; font-family: Arial,sans-serif; font-size: 14px; }

.paybox h1 { width: 350px; padding: 30px; margin: auto; border-width: 1px 1px 0px 1px; border-sty

.paybox form { border: 1px solid #ddd; padding: 30px; border-radius: 0px 0px 10px 10px; width: 35
.paybox form .row { margin-bottom: 10px;}
.paybox form .row .col { display: inline-block; vertical-align: top;}
.paybox form .row .col1 { width: 55%; }
.paybox form .row .col2 { width: 40%; }
.paybox form label { display: block; padding-top: 10px; font-weight: bold;}

.paybox form input[type="text"], select { padding-left: 6px; height: 40px; line-height: 1; margin
.paybox form select { width: 70px;}
.paybox form input[id="CardNumber"] { width: 55%; border-radius: 5px; }
.paybox form input[id="CardHolderName"] { width: 100%; border-radius: 5px; }
.paybox form input[id="CardSecurityCode"] { border-radius: 5px 0px 0px 5px; }
.paybox form input[id="CardHolderMail"] { width: 100%; border-radius: 5px; }

Invocacin al Formulario

93

Manual de Integracin Decidir

.paybox form input[id="CardExpirationDate"] { border-radius: 5px; }


.paybox form #boxCardNumber { position: relative; }
.paybox form ::-webkit-input-placeholder {color: #999;}
.paybox form ::-moz-placeholder {color: #999;}
.paybox form :-ms-input-placeholder {color: #999;}
.paybox form :-moz-placeholder {color: #999; letter-spacing: 1px;}
.paybox form #CardNumber:-ms-input-placeholder { letter-spacing: 1px; }
.paybox form #CardNumber::-moz-placeholder { letter-spacing: 1px; }
.paybox form #CardNumber::-webkit-input-placeholder { letter-spacing: 1px; }

.paybox form #CardSecurityCodeHelper { background-color: #f2f2f2; color: #5e656b; display: inline

.paybox form button[type="submit"] { border: 1px solid #54c7c3; padding: 6px; border-radius: 5px;
.paybox form button[type="submit"]:hover { background: #6dcecb;}



jQuery(document).ready(function() {

jQuery.getScript('https://sandbox.decidir.com/custom/callback/1.1/payment.js', function(data,
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
}
});
});
});



Formulario de Pago

Invocacin al Formulario

94

Manual de Integracin Decidir



Nmero de Tarjeta



Nombre









Vencimiento
MM
AAAA



CVC
?



Email




Pagar $AR 55



Invocacin al Formulario

95

Manual de Integracin Decidir

Obtencin 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";
$RequestKey=$_GET["rk"];
$AnswerKey=$_GET["pa"];
$headers = array(
'http'=>array(
'header'=>$http_header)
);
$contexto = stream_context_create($headers);

$array_de_datos = array(
"Merchant"=>"12345678",
"Security"=>"PRISMA RV82RVHO5T0O5CZUUTX2FLHU",
"RequestKey"=>$RequestKey,
"AnswerKey"=>$AnswerKey
);
$contexto = stream_context_create($headers);
$soap_client = new SoapClient($wsdl, array(
'stream_context'=>$contexto,
'location'=>$end_point,
'encoding'=>"UTF-8",
));
var_dump($soap_client->GetAuthorizeAnswer($array_de_datos));

Ejemplo de Respuesta:

Obtener Informacin de Respuesta

96

Manual de Integracin Decidir

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

97

Manual de Integracin Decidir

Ver Estado de una Transacccin


<?php
ini_set("ERROR_REPORT", 1);
$end_point = "https://sandbox.decidir.com/services/t/1.1/Operation.OperationHttpsSoap12Endpoint"
$wsdl = "https://sandbox.decidir.com/services/t/1.1/Operation?wsdl";
$http_header = 'Authorization: PRISMA RV82RVHO5T0O5CZUUTX2FLHU';
$headers = array(
'http'=>array(
'header'=>$http_header)
);
$contexto = stream_context_create($headers);
$array_de_datos = array(
"IDSITE"=>"XXXXXXX",
"IDTRANSACTIONSIT"=>"9238742994"
);

$soap_client = new SoapClient($wsdl, array(


'stream_context'=>$contexto,
'location'=>$end_point,
));
$rta = $soap_client->Get($array_de_datos);
echo "<br />";
print_r($rta);

Respuesta:

Ver Estado de una Transacccin

98

Manual de Integracin Decidir

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] =>
)
)

Ver Estado de una Transacccin

99

Manual de Integracin Decidir

Devolucin
Ejemplo de una Devolucin Total
Ejemplo de una Devolucin Parcial

Devolucin

100

Manual de Integracin Decidir

Devolucin Total
Ejemplo:
<?php
ini_set("display_errors", 1);
$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",
"Operation"=>"Devolucin",
"Payload"=>"
<Request>
<NROCOMERCIO>12345678</NROCOMERCIO>
<NROOPERACION>9238742988</NROOPERACION>
</Request>"
);
$soap_client = new SoapClient($wsdl, array(
'stream_context'=>$contexto,
'location'=>$end_point,
));
$rta = $soap_client->Execute($array_de_datos);
echo "<br />";
print_r($rta);

Respuesta:

Devolucin

101

Manual de Integracin Decidir

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

102

Manual de Integracin Decidir

Devolcin Parcial
<?php
ini_set("display_errors", 1);
$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 XXXXXXXXXXXXXXXXXXXXXXXX';
$headers = array(
'http'=>array(
'header'=>$http_header)
);
$contexto = stream_context_create($headers);
$array_de_datos = array(
"Merchant"=>"12345678",
"EncodingMethod"=>"XML",
"Security"=>"PRISMA XXXXXXXXXXXXXXXXXXXXXXXX",
"Operation"=>"Devolucin",
"Payload"=>"
<Request>
<NROCOMERCIO>12345678</NROCOMERCIO>
<NROOPERACION>9238742989</NROOPERACION>
<MONTO>10</MONTO>
</Request>"
);
$soap_client = new SoapClient($wsdl, array(
'stream_context'=>$contexto,
'location'=>$end_point,
));
$rta = $soap_client->Execute($array_de_datos);
echo "<br />";
print_r($rta);
``

**Respuesta: **
```php
stdClass Object (
[StatusCode] => -1
[StatusMessage] => Devolucin aceptada
[AuthorizationKey] => A2B770F888CF4FEE7B1441914555812
[EncodingMethod] => XML
[Payload] => stdClass Object (
[Answer] => stdClass Object (

Devolucin

103

Manual de Integracin Decidir

[IDMOTIVO] => 0
[RESULTADO] => APROBADA
[FECHAHORA] => 2015/09/10 16:49:14
)
)
)

Devolucin

104

Manual de Integracin Decidir

Anulacin
<?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",
"Operation"=>"Anulacin",
"Payload"=>"
<Request>
<NROCOMERCIO>12345678</NROCOMERCIO>
<NROOPERACION>9238742993</NROOPERACION>
</Request>"
);
$soap_client = new SoapClient($wsdl, array(
'stream_context'=>$contexto,
'location'=>$end_point,
));
$rta = $soap_client->Execute($array_de_datos);
echo "<br />";
print_r($rta);

Ejemplo de respuesta:

Anulacin

105

Manual de Integracin Decidir

stdClass Object (
[StatusCode] => -1
[StatusMessage] => Anulacin aceptada
[AuthorizationKey] => 81E1ADFC0151ED49731440793768081
[EncodingMethod] => XML
[Payload] => stdClass Object (
[Answer] => stdClass Object (
[IDMOTIVO] => 0
[RESULTADO] => APROBADA
[FECHAHORA] => 2015/08/28 17:29:27
)
)
)

Anulacin

106

Manual de Integracin Decidir

Configuraciones adicionales
Mails de Confirmacin
Time out

Configuraciones Adicionales

107

Manual de Integracin Decidir

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

108

Manual de Integracin Decidir

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
(hd@decidir.com.ar).

Time Out de la Compra

109

Manual de Integracin Decidir

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 comercial@decidir.com.ar.
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

110

Manual de Integracin Decidir

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
CS / Color

Descripcin

Verde

ACCEPT (transaccin considerada genuina por CS).

Rojo

REJECT (transaccin considerada fraudulenta por CS).

Amarillo

REVIEW (transaccin que debe ser revisada Manualmente para


determinar su status final).

Negro

REJECT producido x DECIDIR (la Informacin proporcionada en la


transaccin es Incompleta. Lo determina el Proceso Validador de
DECIDIR. La transaccin no viaja a CS). Cdigos 1xxxx en adelante. Se
debe completar la informacion faltante y reintentar la transaccin.

Azul

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, se debe reintentar
ejecutar la misma.

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

111

Manual de Integracin Decidir

RESULTADO
EMISOR

RESULTADO
CYBERSOURCE

RESULTADO FINAL
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.

Funcionamiento del Servicio

112

Manual de Integracin Decidir

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

Funcionamiento del Servicio

113

Manual de Integracin Decidir

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. Estos datos deben enviarse
siempre, sin importar el vertical al cual pertenecen. 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. 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 MDD1 al MDD11 estan ocupados por Campos con informacion
Necesaria Generada por Decidir para todas las verticales. No se deben alterar. Los
MDD35 a MDD43 inclusive no pueden ser utilizados para el envo de informacin
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

114

Manual de Integracin Decidir

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

Valores posib

Ciudad de
facturacin

Alfanumrico
de 50
caracteres.

Ejemplo: Villa
General Belgran

Pas de
facturacin

Alfanumrico
de 2
caracteres.

Cdigo ISO ()

CSBTCUSTOMERID

Si

Identificador
del usuario al
que se le
emite la
factura. No
puede
contener un
correo
electrnico

Alfanumrico
de 50
caracteres.

Ejemplos:
453458

CSBTIPADDRESS

IP de la PC
del comprador

Alfanumrico
de 15
caracteres.

Ejemplo: 10.1.2

Si

Mail del
usuario al que
se le emite la
factura

Alfanumrico
de 100
caracteres.

Ejemplo:
decidir@hotmai

Si

Nombre del
usuario al que
se le emite la
factura

Alfanumrico
de 60
caracteres.

Ejemplo: Juan

Si

Apellido del
usuario al que
se le emite la
factura

Alfanumrico
de 60
caracteres.

Ejemplo: Perez

CSBTCITY

CSBTCOUNTRY

CSBTEMAIL

CSBTFIRSTNAME

CSBTLASTNAME

Telfono del

Datos Comunes a Todos los Verticales

115

Manual de Integracin Decidir

usuario al que
se le emite la
factura. No
utilizar
guiones,
puntos o
espacios.
Incluir cdigo
de pas

Alfanumrico
de 15
caracteres.

Ejemplo:
541160913988

Si

Cdigo Postal
de la direccin
de facturacin

Alfanumrico
de 10
caracteres.

Ejemplo: C1010
1010

Si

Provincia de
la direccin de
facturacin

Alfanumrico
de 2
caracteres.

Ver Provincias
Ejemplo: Enviar
corresponde a
CABA

CSBTSTREET1

Si

Domicilio de
facturacin
(Calle Numero
interior
Numero
Exterior)

Alfanumrico
de 60
caracteres.

Ejemplo: Cerrito
piso 8

CSBTSTREET2

No

Localidad

Alfanumrico
de 60
caracteres.

Ejemplo: CABA

Si

Moneda

Alfanumrico
de 5
caracteres.

Ejemplo: ARS

CSPTGRANDTOTALAMOUNT

Si

"999999.CC"
Con
decimales
obligatorios,
usando el
puntos como
separador de
decimales. No
se permiten
comas, ni
como
separador de
miles ni como
separador de
decimales.

Numrico de
15
posiciones

Ejemplos:
> 125.38
12.00

CSMDD6

No

Canal de
venta

Alfanumrico
de 255
caracteres.

Valores posibles
Web, Mobile,
Telefonica

CSBTPHONENUMBER

CSBTPOSTALCODE

CSBTSTATE

CSPTCURRENCY

Si

Cantidad de

Datos Comunes a Todos los Verticales

116

Manual de Integracin Decidir

CSMDD7

No

dias que est


registrado el
cliente en el
sitio del
comercio.
(num Dias)

Alfanumrico
de 255
caracteres.

No

Para indicar si
el usuario est
comprando
como invitado
en la pgina
del comercio.
En caso de
ser "S", el
campo
CSMDD9 no
deber
enviarse.

Valor
Booleano

No

Valor del
password del
usuario
registrado en
el portal del
comercio.
Incluir el valor
en hash

Alfanumrico
de 255
caracteres.

CSMDD10

No

Cantidad de
transacciones
realizadas por
el mismo
usuario
registrado en
el portal del
comercio
(Num
transacciones)

Alfanumrico
de 255
caracteres.

CSMDD11

No

Celular del
cliente

Alfanumrico
de 255
caracteres.

Identificador
del
Fingerprint.
Solo se
informa si el
Cliente
Implementa
integracin
con
Formulario
Custom

String hasta
255

CSMDD8

CSMDD9

CSDEVICEFINGERPRINTID

Datos Comunes a Todos los Verticales

Valores posibles
(S/N)

123456789 /
a001675b1

117

Manual de Integracin Decidir

Datos Comunes a Todos los Verticales

118

Manual de Integracin Decidir

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

119

Manual de Integracin Decidir

Datos adicionales para TRAVEL


Parmetro

Descripcin

Descripcin

Ruta completa del


viaje, ORIG1DEST1[:ORIG2DEST2...:ORIGnDESTn]

Alfanumrico
de 255
caracteres.

Si

Tipo de viaje.

Alfanumrico
de 32
caracteres.

CSDMDEPARTUREDATETIME

Si

Fecha y hora del


primer tramo del
viaje. Utilizar GMT.
Formato: yyyy-MMddhh:mma z donde:
hh = hora en formato
12-horas a = am o pm
z = huso horario del
vuelo de salida. Por
ejemplo: si la
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.

Alfanumrico
de 25
caracteres.

CSADNUMBEROFPASSENGERS

Si

Cantidad total de
pasajeros

Numrico

CSMDD17

Cdigo de Reserva
(PNR)

Alfanumrico
de 255
caracteres.

3rd PartyBooking?
(S/N) - Identifica si el
tarjetahabiente viaja o
no

Valor
Booleano

CSDMCOMPLETEROUTE

CSDMJOURNEYTYPE

CSMDD18

Mandatorio

Si

CSMDD19

No

Departure City

Alfanumrico
de 3
caracteres.

CSMDD20

No

Final Destination City

Alfanumrico
de 3
caracteres.

No

International Flight Idenifica si el viaje es

Valor

CSMDD21
Verticales

120

Manual de Integracin Decidir

internacional o no
FrequentFlyerNumber

Alfanumrico
de 255
caracteres.

No

Class of Service

Alfanumrico
de 255
caracteres.

No

Nmero de da de la
semana en que parte
el vuelo

Caracter(1).

CSMDD25

No

Nmero de la
semana del ao en
que se viaja

Alfanumrico
de 255
caracteres.

CSMDD26

No

AirlineCode

Alfanumrico
de 2
caracteres.

No

Code Share - Nmero


de cdigo compartido
para SKYTEAM,
STAR ALLIANCE,
ETC

Alfanumrico
de 255
caracteres.

CSMDD22

CSMDD23

CSMDD24

CSMDD27

No

Datos a enviar por cada pasajero, los valores deben estar separado con "#":

Verticales

121

Manual de Integracin Decidir

Parmetro

Mandatorio

Descripcin

Descripcin

Valores posibl

CSITPASSENGEREMAIL

Condicional

Email del
pasajero

Alfanumrico
de 255
caracteres.

jperez@hotmail.c

CSITPASSENGERFIRSTNAME

Condicional

Nombre del
pasajero

Alfanumrico
de 60
caracteres.

Juan

CSITPASSENGERID

No

Nmero de
pasaporte

Alfanumrico
de 32
caracteres.

21457547

CSITPASSENGERLASTNAME

Condicional

Apellido del
pasajero

Alfanumrico
de 60
caracteres.

Perez

Condicional

Nmero de
telfono del
pasajero

Alfanumrico
de 15
caracteres.

541160913988

Condicional

Clasificacin
del pasajero
dentro de la
empresa,
por ejemplo
standard,
gold o
platinum

Alfanumrico
de 32
caracteres.

Condicional

Tipo de
pasajero
asociado al
precio del
pasaje

CSITPASSENGERPHONE

CSITPASSENGERSTATUS

CSITPASSENGERTYPE

Verticales

Alfanumrico
de 32
caracteres.

Valores posibles:
ADT: Adult CNN:
Child INF: Infant
YTH: Youth STU
Student SCR:
SeniorCitizen MI
Military

122

Manual de Integracin Decidir

Datos adicionales para RETAIL


Parmetro

Mandatorio

Descripcin

Descripcin

CSSTCITY

Si

Ciudad de envo de la
orden

Alfanumrico
de 50
caracteres

CSSTCOUNTRY

Si

Pas de envo de la
orden

Alfanumrico
de 2
caracteres

CSSTEMAIL

Si

Correo electrnico del


comprador

Alfanumrico
de 100
caracteres

CSSTFIRSTNAME

Si

Nombre de la persona
que recibe el producto

Alfanumrico
de 60
caracteres

CSSTLASTNAME

Si

Apellido de la persona
que recibe el producto

Alfanumrico
de 60
caracteres

CSSTPHONENUMBER

Si

Nmero de telfono del


destinatario

Alfanumrico
de 15
caracteres

CSSTPOSTALCODE

Si

Cdigo postal del


domicilio de envo

Alfanumrico
de 10
caracteres

CSSTSTATE

Si

Provincia de envo

Alfanumrico
de 2
caracteres

CSSTSTREET1

Si

Domicilio de envo

Alfanumrico
de 60
caracteres

No

Localidad de envo

Alfanumrico
de 60
caracteres

CSMDD12

No

Cantidad de das que


tiene el comercio para
hacer la entrega

Alfanumrico
de 255
caracteres

CSMDD13

No

Mtodo de Despacho

Alfanumrico
de 255
caracteres

No

Valor booleano para


identificar si el cliente
requiere un comprobante

CSSTSTREET2

CSMDD14

Verticales

Valor
Booleano

Cdigo ISO
http://apps.cy

Es un carct

S/N

123

Manual de Integracin Decidir

fiscal o no S / N
CSMDD15

CSMDD16

No

CustomerLoyalityNumber
- nmero de cliente
frecuente

Alfanumrico
de 255
caracteres

No

Promotional /
CouponCode - nmero
de cupn de descuento

Alfanumrico
de 255
caracteres

Datos a enviar por cada producto, los valores deben estar separados con "#":
Parmetro

Mandatorio

Descripcin

Descripcin

Condicional

Cdigo del producto

Alfanumrico
de 255
caracteres

CSITPRODUCTDESCRIPTION

Condicional

Descripcin del
producto

Alfanumrico
de 255
caracteres

CSITPRODUCTNAME

Condicional

Nombre del producto

Alfanumrico
de 255
caracteres

Condicional

Cdigo identificador
del producto

Alfanumrico
de 255
caracteres

CSITTOTALAMOUNT

Condicional

CSITTOTALAMOUNT
= CSITUNITPRICE *
CSITQUANTITY
"999999.CC" Es
mandatorio informar
los decimales,
usando el punto
como separador de
decimales. No se
permiten comas, ni
como separador de
miles ni como
separador de
decimales.

Numrico

CSITQUANTITY

Condicional

Cantidad del
producto

Numrico

CSITPRODUCTCODE

CSITPRODUCTSKU

Verticales

124

Manual de Integracin Decidir

CSITUNITPRICE

Verticales

Condicional

"999999.CC" Es
mandatorio informar
los decimales,
usando el punto
como separador de
decimales. No se
permiten comas, ni
como separador de
miles ni como
separador de
decimales.

Numrico

125

Manual de Integracin Decidir

Datos adicionales para TICKETING


Parmetro

CSMDD33

CSMDD34

Mandatorio

Si

Si

Descripcin

Formato

Nmero de das en los


que se desarrollara el
evento

Alfanumrico
de 255
caracteres

Tipo de envo

Alfanumrico
de 255
caracteres

Valores
posibles

Pick up
Email
Smartphone
Other

Datos a enviar por cada ticket, los valores deben estar separado con "#":

Verticales

126

Manual de Integracin Decidir

Parmetro

Mandatorio

Descripcin

Descripcin

Condicional

Cdigo del producto

Alfanumrico
de 255
caracteres

CSITPRODUCTDESCRIPTION

Condicional

Descripcin del
producto

Alfanumrico
de 255
caracteres

CSITPRODUCTNAME

Condicional

Nombre del producto

Alfanumrico
de 255
caracteres

Condicional

Cdigo identificador
del producto

Alfanumrico
de 255
caracteres

CSITTOTALAMOUNT

Condicional

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.

Numrico

CSITQUANTITY

Condicional

Cantidad del
producto

Numrico

Condicional

"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.

Numrico

CSITPRODUCTCODE

CSITPRODUCTSKU

CSITUNITPRICE

Verticales

127

Manual de Integracin Decidir

Datos adicionales para SERVICES


Parmetro

Mandatorio

Descripcin

Mandatorio

Valores posibles

CSMDD28

Si

Tipo de
Servicio

Alfanumrico
de 255
caracteres

Luz, Gas, Telefono,


Agua, TV, Cable,
Internet, Impuestos.

CSMDD29

No

Referencia
de pago del
servicio 1

Alfanumrico
de 255
caracteres

CSMDD30

No

Referencia
de pago del
servicio 2

Alfanumrico
de 255
caracteres

CSMDD31

No

Referencia
de pago del
servicio 3

Alfanumrico
de 255
caracteres

Datos a enviar por cada servicio, los valores deben estar separado con "#"

Verticales

128

Manual de Integracin Decidir

CSITPRODUCTCODE

Si

Cdigo del servicio

Alfanumrico
de 255
caracteres

CSITPRODUCTDESCRIPTION

Si

Descripcin del
servicio

Alfanumrico
de 255
caracteres

CSITPRODUCTNAME

Si

Nombre del servicio

Alfanumrico
de 255
caracteres

Si

Cdigo identificador
del servicio

Alfanumrico
de 255
caracteres

CSITTOTALAMOUNT

Condicional

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.

Numrico

CSITQUANTITY

No

Cantidad del
producto

Numrico

Si

Precio unitario del


producto
"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.

Numrico

CSITPRODUCTSKU

CSITUNITPRICE

Verticales

129

Manual de Integracin Decidir

Datos adicionales para DIGITAL GOODS


Parmetro

Mandatorio

Descripcin

CSMDD32

Si

Tipo de
Delivery

Formato
Alfanumrico de
255 caracteres

Valores posibles
WEB Session,
Email,
SmartPhone

Datos a enviar por cada producto, los valores deben estar separado con "#":

Verticales

130

Manual de Integracin Decidir

Parmetro

Mandatorio

Descripcin

Formato

Condicional

Cdigo del producto

Alfanumrico
de 255
caracteres

CSITPRODUCTDESCRIPTION

Condicional

Descripcin del
producto

Alfanumrico
de 255
caracteres

CSITPRODUCTNAME

Condicional

Nombre del producto

Alfanumrico
de 255
caracteres

Condicional

Cdigo identificador
del producto

Alfanumrico
de 255
caracteres

CSITTOTALAMOUNT

Condicional

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.

Numrico

CSITQUANTITY

No

Cantidad del
producto

Numrico

Si

Precio unitario del


producto
"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.

Numrico

CSITPRODUCTCODE

CSITPRODUCTSKU

CSITUNITPRICE

Verticales

131

Manual de Integracin Decidir

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 la pgina de Checkout uno de 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

Implementacin del Device Fingerprint

132

Manual de Integracin Decidir

Valores de los campos y observaciones


Campo

Testing

Produccin

Observaciones:

org_id

1snn5n9w

k8vif92e

Valores fijos

CYBERSOURCE_MERCHANTID

decidir_agregador

[Valor
provisto por
DECIDIR]

Al momento de entrar en
produccin, este valor lo
proporciona Help Desk.

En el ejemplo:
decidir_agregador123456
genera como la concatena
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
hora. Usualmente se usa e
identificador de transaccin
la compra. Puede contener
Maysculas y minusculas,
numricos y estos caracter
especiales: guin (-) y
o subrayado (_).

session_id

Unique_identifier

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.

Implementacin del Device Fingerprint

133

Manual de Integracin Decidir

Segmentos de Cdigo para la implementacin del DF en la


pgina de checkout
Las opciones de implementacin son:
Imagen PNG

<p style="background:url(https://h.online-metrix.net/fp/clear.png?org_id=1snn5n9w&amp;session_id=<CYB

<img src="https://h.online-metrix.net/fp/clear.png?org_id=1snn5n9w&amp;session_id=<CYBERSOURCE_MERCHA

JavaScript

<script src="https://h.online-metrix.net/fp/check.js?org_id=1snn5n9w&amp;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&amp;session_id=<CYBE


</object>

Implementacin del Device Fingerprint

134

Manual de Integracin Decidir

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:
Parmetro

CSDEVICEFINGERPRINTID

Mandatorio

Descripcin

Formato

Identificador
del
Fingerprint.
Solo se
informa si el
Cliente
Implementa
integracin
con
Formulario
Custom

String
hasta
255

Valores
posibles

123456789
/
a001675b1

(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.

Implementacin del Device Fingerprint

135

Manual de Integracin Decidir

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:

Implementacin del Device Fingerprint

136

Manual de Integracin Decidir

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:
<NROCOMERCIO>00201114</NROCOMERCIO>
<NROOPERACION>test_visa_2509ab</NROOPERACION>
<MEDIODEPAGO>1</MEDIODEPAGO>
<MONTO>5499</MONTO>
<MONEDA>032</MONEDA>
<CUOTAS>1</CUOTAS>
<EMAILCLIENTE>asdasdasd@asdasd.com</EMAILCLIENTE>
<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>wajser@gmail.com</CSBTEMAIL>
<CSBTFIRSTNAME>dammian ariel</CSBTFIRSTNAME>
<CSBTLASTNAME>Wajser &amp;Ntilde;o&amp;ntilde;o</CSBTLASTNAME>
<CSBTPHONENUMBER>49210465</CSBTPHONENUMBER>
<CSBTPOSTALCODE>1212</CSBTPOSTALCODE>
<CSBTSTATE>B</CSBTSTATE>
<CSBTSTREET1>l&amp;ntilde;ala 12 5</CSBTSTREET1>
<CSBTSTREET2/>
<CSPTCURRENCY>ARS</CSPTCURRENCY>
<CSPTGRANDTOTALAMOUNT>54.99</CSPTGRANDTOTALAMOUNT>
<CSMDD6>API</CSMDD6>

Ejemplo de Pedido de Auorizacin con CyberSource

137

Manual de Integracin Decidir

<CSMDD7>0</CSMDD7>
<CSMDD8/>
<CSMDD9/>
<CSMDD10/>
<CSMDD11>49210465</CSMDD11>
<CSSTCITY>Bs as</CSSTCITY>
<CSSTCOUNTRY>AR</CSSTCOUNTRY>
<CSSTEMAIL>wajser@gmail.com</CSSTEMAIL>
<CSSTFIRSTNAME>dammian ariel</CSSTFIRSTNAME>
<CSSTLASTNAME>Wajser &amp;Ntilde;o&amp;ntilde;o</CSSTLASTNAME>
<CSSTPHONENUMBER>49210465</CSSTPHONENUMBER>
<CSSTPOSTALCODE>1212</CSSTPOSTALCODE>
<CSSTSTATE>B</CSSTSTATE>
<CSSTSTREET1>l&amp;ntilde;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/>

Respuesta:
<RESULTADO>APROBADA</RESULTADO>
<FECHAHORA>25/09/2015 12:00:10</FECHAHORA>
<MONEDA>Pesos</MONEDA>
<NROTICKET>2659</NROTICKET>
<NROTARJETAVISIBLE>450799XXXXXX4905</NROTARJETAVISIBLE>
<CODAUTORIZACION>009602</CODAUTORIZACION>
<IDMOTIVO/>
<MOTIVO/>
<IDESTADO>4</IDESTADO>
<IDGLOBAL>341609</IDGLOBAL>
<RESULTADOCS>100</RESULTADOCS>
<IDENTIFICADORCS>4431932092045000001513</IDENTIFICADORCS>

Ejemplo de Pedido de Auorizacin con CyberSource

138

Manual de Integracin Decidir

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.
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

202

Validation of fields

REJECT

231

Validation of fields

REJECT

150

CyberSource service unavailability

REJECT ERROR

151

CyberSource service unavailability

REJECT ERROR

152

CyberSource service unavailability

REJECT ERROR

10101

Bill To City is required

Validator
Processing

10102

Bill To Country is required

Validator
Processing

10103

Bill To CustomerID is required

Validator
Processing

10104

Bill To Email is required

Validator
Processing

10105

Bill To First Name is required

Validator
Processing

Cdigos de Respuesta de CyberSource

139

Manual de Integracin Decidir

10106

Bill To IP Address is required

Validator
Processing

10107

Bill To Last Name is required

Validator
Processing

10109

Bill To Postal Code is required

Validator
Processing

10110

Bill To State is required

Validator
Processing

10111

Bill To Street1 is required

Validator
Processing

10130

The Item at index 0 must include a valid productCode


value.

Validator
Processing

10132

The Item at index 0 must include a valid productName


value.

Validator
Processing

10133

The Item at index 0 must include a valid productSKU


value.

Validator
Processing

10134

The Item at index 0 must include a valid quantity


value.

Validator
Processing

10135

The Item at index 0 must include a valid totalAmount


value.

Validator
Processing

10136

The Item at index 0 must include a valid unitPrice


value.

Validator
Processing

10150

Request Message DeviceFingerprintID is required

Validator
Processing

10160

Ship To City is required

Validator
Processing

10161

Ship To Country is required

Validator
Processing

10162

Ship To Email is required

Validator
Processing

10163

Ship To First Name is required

Validator
Processing

10164

Ship To Last Name is required

Validator
Processing

10165

Ship To Phone Number is required

Validator
Processing

10166

Ship To Postal Code is required

Validator
Processing

10167

Ship To State is required

Validator
Processing

Cdigos de Respuesta de CyberSource

140

Manual de Integracin Decidir

10168

Ship To Street1 is required

Validator
Processing

10302

Invalid BillTo Country ISO Code

Validator
Processing

10304

Invalid BillTo Email

Validator
Processing

10305

Invalid BillTo FirstName

Validator
Processing

10306

Invalid BillTo IP Address

Validator
Processing

10307

Invalid BillTo LastName

Validator
Processing

10334

The Item at index 0 must include a valid quantity


value.

Validator
Processing

10335

The Item at index 0 must include a valid totalAmount


value.

Validator
Processing

10336

The Item at index 0 must include a valid unitPrice


value.

Validator
Processing

10361

Invalid Ship To Country

Validator
Processing

10362

Invalid Ship To Email

Validator
Processing

10363

Invalid Ship To First Name

Validator
Processing

10364

Invalid Ship To Last Name

Validator
Processing

10365

Invalid Ship To Phone Number

Validator
Processing

10366

Invalid Ship To Postal Code

Validator
Processing

Cdigos de Respuesta de CyberSource

141

Manual de Integracin Decidir

Tablas de Referencias
Taba de Medios de Pago
Cdigos de Retorno del Servicio de Pago
Cdigos de motivos de rechazo

Tablas de Referencia

142

Manual de Integracin Decidir

Medios de Pago
MEDIODEPAGO

Nombre

VISA

AMEX

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

143

Manual de Integracin Decidir

54

GRUPAR

55

PATAGONIA

56

TARJETA CLUB DIA

59

TARJETA TUYA

60

DISTRIBUTION

61

LA ANONIMA

Tabla de Medios de Pago

144

Manual de Integracin Decidir

Cdigos de Estado de las Transacciones


IdEstado

Descripcin

Ingresada

Estado
Final?

Comentarios

Es un estado intermedio de la transaccin. Si


una operacin permanece en este estado,
indica que la misma no ha completado
exitosamente su ciclo normal.

A procesar

Procesada

Autorizada

Rechazada

Rechazada por el medio de pago.

Acreditada

Las transacciones "Autorizadas" pasan a


este estado luego de un cierre de lote
exitoso.

Anulada

Anulacin
Confirmada

Devuelta

10

Devolucin
Confirmada

11

Pre
autorizada

12

Vencida

13

Acreditacin
no cerrada

14

Autorizada*

15

A reversar

16

A registrar
en Visa

17

Validacin
iniciada en
Visa

18

Cuando se hace el reverso de una


operacin, antes del cierre de lote.
S

Las "Anuladas" pasan a este estado luego


del cierre de lote.
Cuando se hace el reverso de una
transaccin luego de un cierre de lote.

Las "Devueltas" pasan a este estado luego


del cierre de lote.
Es el 1er paso, cuando se opera con
transacciones en 2 pasos.

Slo para Pagofcil y Rapipago, cuando se


vence la boleta de pago.

Enviada a
validar en

Cdigos de Estado de las Transacciones

145

Manual de Integracin Decidir

Visa
19

Validada OK
en Visa

20

Recibido
desde Visa

21

Validada no
OK en Visa

22

Factura
generada

23

Factura no
generada

En Pagomiscuentas, cuando no se crea


exitosamente el VEP en PMC.

24

Rechazada No
autenticada

Cuando el comercio posee implementado el


servicio de Verified by Visa y la misma no es
autenticada.

25

Rechazada Datos
invlidos

Cuando un filtro de bines cargado del lado


de Decidir, rechaza una tarjeta por no estar
dentro del rango permitido.

28

A registrar
en
IdValidator

29

Enviada a
IdValidator

32

Rechazada No validada

Slo

38

Rechazada Timeout de
compra

Slo para mtodo de integracin con


formulario Embedded. Se excedi el tiempo
mximo en el formulario de carga de datos

50

Ingresada
Distribuida

51

Rechazada
por grupo

52

Anulada por
grupo

Slo para Pagomiscuentas, cuando se crea


exitosamente el VEP en PMC

Cdigos de Estado de las Transacciones

146

Manual de Integracin Decidir

Cdigos de Motivos de Rechazo


IDMOTIVO

Medio
de
pago

Tipo de
operacin

Amex

Autorizacin

Approved

Amex

Autorizacin

Approve with ID

Amex

Autorizacin

Approve VIP

92

Amex

Autorizacin

" Approved (Express Rewards Program);"

100

Amex

Autorizacin

Deny

101

Amex

Autorizacin

Expired card

103

Amex

Autorizacin

Deny Invalid Manual Entry 4DBC

104

Amex

Autorizacin

Deny New card issued

105

Amex

Autorizacin

Deny Account Canceled

107

Amex

Autorizacin

Please Call Issuer

109

Amex

Autorizacin

Invalid merchant

110

Amex

Autorizacin

Invalid amount

111

Amex

Autorizacin

Invalid account

115

Amex

Autorizacin

Service not permitted

118

Amex

Autorizacin

No record for card

122

Amex

Autorizacin

" Invalid card (CID); security code"

125

Amex

Autorizacin

Invalid effective date

181

Amex

Autorizacin

Format error

182

Amex

Autorizacin

Please wait

183

Amex

Autorizacin

Invalid currency code

200

Amex

Autorizacin

Deny Pick up card

400

Amex

Autorizacin

Reversal accepted

911

Amex

Autorizacin

Card issuer timeout

912

Amex

Autorizacin

Card issuer unavailable

940

Amex

Autorizacin

PPN expired

941

Amex

Autorizacin

PPN invalid

942

Amex

Autorizacin

PPN auth limit exceeded

Cdigos de motivos de rechazo

Descripcin

147

Manual de Integracin Decidir

943

Amex

Autorizacin

PPN amount limit exceeded

944

Amex

Autorizacin

PPN PPN canceled

945

Amex

Autorizacin

PPN invalid expiration date

946

Amex

Autorizacin

PPN please call changed to deny

947

Amex

Autorizacin

PPN timeout

9999

Amex

Autorizacin

Rechazada XXX

10000

Amex

Autorizacin

Imposible Inicializar Server Amex

10001

Amex

Autorizacin

Time out

10002

Amex

Autorizacin

Otros problemas en Autorizacin

10003

Amex

Autorizacin

Error en construccin 1100

10004

Amex

Autorizacin

Error en construccin 1110

Visa

Autorizacin

APROBADA (authno)

Visa

Autorizacin

PEDIR AUTORIZAcin

Visa

Autorizacin

PEDIR AUTORIZAcin

Visa

Autorizacin

COMERCIO INVALIDO

Visa

Autorizacin

CAPTURAR TARJETA

Visa

Autorizacin

DENEGADA

Visa

Autorizacin

RETENGA Y LLAME

11

Visa

Autorizacin

APROBADA

12

Visa

Autorizacin

TRANSAC. INVALIDA

13

Visa

Autorizacin

MONTO INVALIDO

14

Visa

Autorizacin

TARJETA INVALIDA

25

Visa

Autorizacin

NO EXISTE ORIGINAL

28

Visa

Autorizacin

SERVICIO NO DISPONIBLE

30

Visa

Autorizacin

ERROR EN FORMATO

38

Visa

Autorizacin

EXCEDE ING.DE PIN

39

Visa

Autorizacin

Ingreso Manual Incorrecto

43

Visa

Autorizacin

RETENER TARJETA

45

Visa

Autorizacin

NO OPERA EN CUOTAS

46

Visa

Autorizacin

TARJETA NO VIGENTE

47

Visa

Autorizacin

PIN REQUERIDO

48

Visa

Autorizacin

EXCEDE MAX. CUOTAS

Cdigos de motivos de rechazo

148

Manual de Integracin Decidir

49

Visa

Autorizacin

ERROR FECHA VENCIM.

51

Visa

Autorizacin

FONDOS INSUFICIENTES

53

Visa

Autorizacin

CUENTA INEXISTENTE

54

Visa

Autorizacin

TARJETA VENCIDA

55

Visa

Autorizacin

PIN INCORRECTO

56

Visa

Autorizacin

TARJ. NO HABILITADA

57

Visa

Autorizacin

TRANS. NO PERMITIDA

58

Visa

Autorizacin

SERVICIO INVALIDO

61

Visa

Autorizacin

EXCEDE LIMITE

65

Visa

Autorizacin

EXCEDE LIM. TARJETA

76

Visa

Autorizacin

LLAMAR AL EMISOR

77

Visa

Autorizacin

ERROR PLAN/CUOTAS

85

Visa

Autorizacin

APROBADA

89

Visa

Autorizacin

TERMINAL INVALIDA

91

Visa

Autorizacin

EMISOR FUERA LINEA

94

Visa

Autorizacin

NRO. SEC. DUPLICAD

95

Visa

Autorizacin

RE-TRANSMITIENDO

96

Visa

Autorizacin

ERROR EN SISTEMA

98

Visa

Autorizacin

VER RECHAZO EN MOTIVO ADICIONAL

9997

Visa

Autorizacin

Operacin Reversada

9998

Visa

Autorizacin

Operacin no Reversada

9999

Visa

Autorizacin

RECHAZADA (con motivo no existente en


base)

10000

Visa

Autorizacin

ERROR AL CONECTAR CON EL MODULO


DE COMUNICACIONES

10001

Visa

Autorizacin

ERROR AL RECIBIR DEL MODULO DE


COMUNICACIONES

10002

Visa

Autorizacin

ERROR REPORTADO POR EL MODULO DE


COMUNICACIONES

10003

Visa

Autorizacin

Error de time out del socket

10004

Visa

Autorizacin

NO AUTENTICADA

10005

Visa

Autorizacin

DATOS DE TRANSACcin INCORRECTOS

10016

Visa

Autorizacin

Error de autenticacin

Cdigos de motivos de rechazo

149

Manual de Integracin Decidir

Master

Autorizacin

Operacin completada exitosamente

Master

Autorizacin

The API call has not yet completed and is


pending on The availability of Payment Server
entities.

Master

Autorizacin

A specified object was not found. The object is


Indicated by the SRC.

Master

Autorizacin

A required parameter was not found. The


parameter is Indicated by the SRC

Master

Autorizacin

A required parameter was too short. The


parameter is Indicated by the SRC.

Master

Autorizacin

A required parameter was too long. The


parameter is Indicated by the SRC.

Master

Autorizacin

A required parameter was formatted


incorrectly. The Parameter is indicated by the
SRC

Master

Autorizacin

A required parameter had an incorrect value.


The Parameter is indicated by the SRC

Master

Autorizacin

A duplicate object exists.

Master

Autorizacin

A parameter mismatch occurred. The


parameter is indicated by the SRC.

10

Master

Autorizacin

There was an error parsing the input stream.

11

Master

Autorizacin

An object is not in the correct state for this


action.

12

Master

Autorizacin

A communication error occurred in the


Payment Server.

13

Master

Autorizacin

The Payment Server experienced an


unexpected internal error.

14

Master

Autorizacin

A database communications error occurred.

15

Master

Autorizacin

A cassette-specific error occurred. Refer to


Cassette-supplementary information for
documentation.

16

Master

Autorizacin

An error or informational return code is


returned from the C API library in the SRC.

17

Master

Autorizacin

The API version used by the application


program is newer than that supported by the
Payment Server.

18

Master

Autorizacin

The API version used by the application is no


longer supported by the Payment Server.

19

Master

Autorizacin

Auto approve in ReceivePayment or


AcceptPayment failed.

Cdigos de motivos de rechazo

150

Manual de Integracin Decidir

20

Master

Autorizacin

Auto deposit in ReceivePayment or


AcceptPayment failed

21

Master

Autorizacin

The cassette is not running

22

Master

Autorizacin

The cassette is not valid.

23

Master

Autorizacin

The operation is not supported in sysplex


environment.

24

Master

Autorizacin

The parameter has a null value.

30

Master

Autorizacin

The XML document is not correct.

31

Master

Autorizacin

The parameter must be specified when


another parameter is specified.

32

Master

Autorizacin

The combination of the parameters specified


in a API command is not allowed.

33

Master

Autorizacin

An error related with the Batch operation


occurred.

34

Master

Autorizacin

The operation failed for financial reasons.

50

Master

Autorizacin

An error occurred when initializing the servlet.

51

Master

Autorizacin

An error occurred during the user


authentication

52

Master

Autorizacin

An error occurred during the user


authorization.

53

Master

Autorizacin

An unhandled (such as null pointer) exception


occurred.

54

Master

Autorizacin

The parameter can not be specified multiple


times in this API command.

55

Master

Autorizacin

" The command name is not recognized as a


valid $til; command. "

56

Master

Autorizacin

Error related with encryption/decryption key.

57

Master

Autorizacin

An administration object is not active.

58

Master

Autorizacin

The parameter should not be specified.

59

Master

Autorizacin

The object could not be deleted.

60

Master

Autorizacin

A WebSphere/WebServer related error has


been occurred.

10005

Master

Autorizacin

DATOS DE TRANSACcin INCORRECTOS

32768

Master

Autorizacin

The application did not send the required API


version parameter to the Payment Server.

Cdigos de motivos de rechazo

151

Manual de Integracin Decidir

Cdigos de provincias para CyberSource


Provincia

Cdigo

CABA

Buenos Aires

Catamarca

Chaco

Chubut

Crdoba

Corrientes

Entre Ros

Formosa

Jujuy

La Pampa

La Rioja

Mendoza

Misiones

Neuqun

Ro Negro

Salta

San Juan

San Luis

Santa Cruz

Santa Fe

Santiago del Estero

Tierra del Fuego

Tucumn

Cdigos de provinias para CyberSource

152

Manual de Integracin Decidir

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: hd@decidir.com.ar
Mail: controldered@decidir.com.ar (ante disrupcin transaccional)

Soporte

153

Das könnte Ihnen auch gefallen