Especificaciones

Tcnicas para integrar

PagosWeb
Protocolo versin 3.4

Joaqun Requena 1580 Of. 102 Montevideo Uruguay

Telfonos: +598 2402 2330*
www.pagosweb.com.uy e-mail: ccaetano@pagosweb.com.uy
Pgina 1 de 24

Versiones

Versin

Fecha

Comentarios

1.0
2.0
3.1
3.2

15/04/08
20/07/09
07/10/10
11/11/11

3.3

02/05/12

Versin inicial
Modificaciones para Plugin VISA
Actualizacin de documentacin
Actualizacin de diagramas y formato general del
documento
Actualizacin de nombres de procedimientos a invocar

3.4

04/06/12

3.5
3.6

20/07/12
23/10/12

3.7

15/02/13

3.8
3.9

15/04/13
22/05/13

3.10

8/11/13

3.11

28/05/14

3.12

02/07/14

Se agrega parmetro opcional numeroOrden en el

Response y URL de pruebas
Ajustes de redaccin y actualizacin de URL de testing
Cambios por la versin 3.3 del protocolo, configuracin
de OCA y uso de llave 3DES.
Campo numeroOrden pasa de alfanumrico a
numrico.
Se agrega configuracin de RedPagos y Componente
PHP
Se agrega configuracin de e-BROU y Banred
Se agrega configuracin de Skrill, Diners, Diners
Discover y Lider
Se modifica algoritmo de encriptacin, se modifica
mtodo de acceso OCA
Se agrega tabla de medios de pago disponibles.
Se agrega campo cantidadCuotas en el response
Se aclara operativa con la cdula para RedPagos
Creacin de protocolo v 3.4 que contiene los cambios
necesarios para la ley 19210 (ley de inclusin
financiera)

Pgina 2 de 24

Contenido del documento

Introduccin .................................................................................................................................. 4
Solucin de Pagos con PagosWeb ................................................................................................. 4
Descripcin del Proceso de Pago .............................................................................................. 4
Diagrama de Alto Nivel ......................................................................................................... 4
Proceso de Compra................................................................................................................ 5
Secuencia de una Transaccin............................................................................................... 6
Implementacin ............................................................................................................................ 8
Configuracin del sistema ......................................................................................................... 8
Configuracin PagosWeb ...................................................................................................... 8
Configuracin VISA ................................................................................................................ 8
Configuracin MasterCard .................................................................................................... 8
Configuracin OCA ................................................................................................................ 9
Configuracin RedPagos ....................................................................................................... 9
Configuracin e-BROU ......................................................................................................... 11
Configuracin Banred .......................................................................................................... 11
Configuracin Skrill.............................................................................................................. 11
Comunicacin HTTP ................................................................................................................ 12
Request a PagosWeb........................................................................................................... 12
URL para Pruebas ................................................................................................................ 16
Response de PagosWeb ...................................................................................................... 17
Seguridad 3DES en Request y Response. ................................................................................ 18
1-

Componente PHP ........................................................................................................ 18

2-

Implantacin por parte del comercio.......................................................................... 18

Pgina 3 de 24

Introduccin
El objetivo de este documento es mostrar como integrar la solucin de pagos ofrecida
por PagosWeb con el sitio web de compras.

Solucin de Pagos con PagosWeb

Esta solucin consta de un componente que resuelve la comunicacin entre el sitio
web del comercio y las plataformas de pago seguro de los distintos medios de pago.
Dicho componente funciona como vnculo seguro entre el comercio y la pgina de
pagos y se inicia cuando el socio efecta una compra en el sitio web del comercio.

Descripcin del Proceso de Pago

Diagrama de Alto Nivel

Pgina 4 de 24

Proceso de Compra

El cliente ingresa normalmente al sitio web del comercio, donde elige los
artculos o servicios que desea comprar. Cuando llena su carrito de compra y
va a la pgina en la cual podr pagar por los mismo a travs de los medios de
pago disponibles.

Cuando el cliente elige uno de estos medios de pago, la pgina del comercio
debe invocar la pgina de Request de PagosWeb a travs de HTTP/POST.

El sistema PagosWeb redirigir al usuario a la pgina web del procesador

correspondiente donde ingresar los datos de la tarjeta de crdito. En este
punto el nmero de tarjeta de crdito, fecha de vencimiento, CVC u otros datos
confidenciales son encriptados y manejados por los servidores del medio de
pago elegido.

Luego de haber ejecutado el paso anterior, el sistema PagosWeb invocar a

travs de HTTP/POST una de las pginas proporcionadas por el comercio al
momento de la afiliacin al sistema PagosWeb.

Se deben configurar 3 URLs que corresponden a los distintos resultados a los que
puede llegar una compra, los cuales se detallan a continuacin:
o

Aprobada

El sistema de tarjeta de crdito ha aprobado la compra y la misma fue

registrada.
o

Rechazada

El sistema de tarjeta de crdito rechazo la compra, este estado se puede

alcanzar por ejemplo si el tarjeta habiente no tiene suficiente saldo, o existe
algn problema con la tarjeta de crdito.
o

Cancelada

El usuario ha cancelado la compra al momento de ingresar los datos de la

tarjeta de crdito.

Pgina 5 de 24

Secuencia de una Transaccin

Tarjeta habiente

Carrito de compras

PagosWeb

Selecciona un
producto y hace clic
en agregar al carrito

Registra el producto

Hace clic en el botn

comprar.

Muestra el formulario
de compra y solicita
los datos del cliente.

Genera el formulario
para enviarlo por
POST a PagosWeb.

Ingresa los datos y

hace clic en Pagar

Ingresa datos de la
tarjeta de crdito y
acepta las
condiciones.

Pgina 6 de 24

Recibe las variables e

inicia la transaccin,
empaquetando lo
datos de acuerdo a las
especificaciones del
medio de pago
utilizado.

Redirige el navegador
del tarjetahabiente a la
pgina del medio de
pago donde deber
ingresar los datos
solicitados por estas
firmas.

Pgina 7 de 24

Procesa la transaccin
e invoca la pgina de
respuesta de
PagosWeb

Procesa la informacin
recibida del medio de
pago correspondiente
y verifica si la
transaccin fue
aprobada o negada.

Redirige al cliente a la
pgina del comercio.

Implementacin
Configuracin del sistema
Configuracin PagosWeb

URL Compra aprobada. URL del sitio del comercio a donde invocar
desde PagosWeb si la transaccin de compra fue aprobada por el procesador.

URL Compra rechazada. URL del sitio del comercio a donde invocar
desde PagosWeb si la transaccin de compra fue rechazada por el procesador.

URL Compra cancelada. URL del sitio del comercio a donde invocar
desde PagosWeb si el procesador de la compra indica que la transaccin de
compra fue cancelada por el usuario.

Configuracin VISA
La siguiente informacin es necesaria para el uso de Visa a travs PagosWeb.
La informacin solicitada, es provista por VISA al comercio en el momento de su
afiliacin
1. Cdigo de Adquirente
2. Cdigo de Comercio
3. Cdigo de Terminal
4. Vector de Inicializacin
5. Llaves Pblicas de Cifrado y Firma de Certificado Digital

Configuracin MasterCard
La siguiente informacin es necesaria para el uso de MasterCard a travs PagosWeb.
La informacin solicitada, es provista por MasterCard al comercio en el momento de su
afiliacin
1. Nmero de Comercio
2. SERVLET de comunicacin con MasterCard

Pgina 8 de 24

Configuracin OCA
La siguiente informacin es necesaria para el uso de OcaCard a travs PagosWeb.
La informacin solicitada, es provista por OCA SA al comercio en el momento de su
afiliacin
1. Nmero de Comercio
2. Nmero Terminal
3. Tipo de Compra (0 = comn, 3 = Metros)

Configuracin RedPagos
La siguiente informacin es necesaria para el uso de RedPagos a travs PagosWeb.
La informacin solicitada, es provista por RedPagos al comercio en el momento de su
afiliacin
1. Nmero de Comercio
2. Cdigo de Comercio
Tambin se le solicita al comercio
3. Email de Notificacin.
4. Tiempo de Vencimiento de Compra
5. Cdula es un campo obligatorio.
Al usar RedPagos a travs de PagosWeb este genera una pantalla de
confirmacin que se muestra a continuacin.

Pgina 9 de 24

La cual solicita al comprador que acepte o cancele la compra y adems le

muestra la lista de transacciones pendientes de pago.
Si el comprador acepta la transaccin se le enviara un cupn de compra, por lo
que se le solicita al comercio que valide el email del comprador.

Pgina 10 de 24

Configuracin e-BROU
La siguiente informacin es necesaria para el uso de e-BROU a travs PagosWeb.
La informacin solicitada, es provista por e-BROU al comercio en el momento de su
afiliacin
1. 1. Nmero de Organismo
2. Tipo de Servicio

Configuracin Banred
La siguiente informacin es necesaria para el uso de Banred a travs PagosWeb.
La informacin solicitada, es provista por Banred al comercio en el momento de su
afiliacin
1. Cdigo de Comercio
Tambin se le solicita al comercio
2. Tiempo de Vencimiento de Factura

Configuracin Skrill
La siguiente informacin es necesaria para el uso de Skrill a travs PagosWeb.
La informacin solicitada, es provista por Skrill al comercio en el momento de su
afiliacin
3. 1. Nmero de Organismo
4. Tipo de Servicio

Pgina 11 de 24

Comunicacin HTTP
Request a PagosWeb
El Request a la pgina de PagosWeb debe ser efectuado mediante el mtodo HTTP
POST.
EL formulario HTTP debe contener los siguientes campos:
Campo

Tipo

Presencia Descripcin

idCliente

Numrico

Nmero de cliente dentro de la aplicacin

PagosWeb, asignado en la instalacin. Es fijo
a partir de la primera instalacin

idTarjetaCredito

Numrico

Ver Detalle de Medios de Pago.

primerNombre

Alfanumrico

Primer nombre del tarjetahabiente.

primerApellido

Alfanumrico

Primer apellido del tarjetahabiente

email

Alfanumrico

Direccin de correo del tarjetahabiente

Monto de la compra (sin separadores de miles

y como separador de decimales se debe usar
el punto).

valorTransaccion

Numrico

Ejemplo: $ 1.234,50 debe enviarse: 1234.5

cantidadCuotas

Numrico

Cantidad de cuotas en que se realiza la

compra.
Cdigos de monedas.
Valores posibles:

moneda

Numrico

M
858 Pesos
840 Dlares

numeroOrden

Alfanumrico

version

Alfanumrico

Nmero de orden del comercio. Sirve como

referencia de la transaccin efectuada en el
comercio.
Versin actual del paquete de informacin.
Valor actual: 3.4

fecha

Alfanumrico

Fecha hora de la transaccin. En formato

yyyy-MM-ddhh:mm:ss

plan

Alfanumrico

Campo de largo 2 solo usado por Oca.

Especifica el tipo de compra (0 = comn, 3 =
con metros)

Pgina 12 de 24

segundoNombre

Alfanumrico

Segundo nombre del tarjetahabiente.

segundoApellido

Alfanumrico

Segundo apellido del tarjetahabiente.

direccionEnvio

Alfanumrico

Direccin de envo de la mercadera

plazoEntrega

Alfanumrico

Plazo de entrega declarado al cliente

telefono

Alfanumrico

Telfono de contacto del cliente.

cedula

Alfanumrico

Cdula del cliente. Ver Condicin de cdula

consumidorFinal

Numrico

importeGravado

Numrico

numeroFactura

Numrico

Alfanumrico

transactionSecurityToken

(Ley 19210) Se debe indicar si la venta es

realizada a un consumidor final. El valor 1
indica que es consumidor final, 0 que no lo es.
(Ley 19210) Importe gravado por IVA (sin
separadores de miles y como separador de
decimales se debe usar el punto).
Es mandatorio si consumidorFinal=1 y debe
tener el valor gravado con IVA.
Ver Detalle de importe gravado.
(Ley 19210) Nmero de factura que ser
utilizado por el medio de pago elegido, para
informar la devolucin de IVA a la DGI.
Es aplicable si consumidorFinal=1.
Si el campo no est presente o vaco se usar
el ID interno de la transaccin en PagosWEB.
Datos de la transaccin encriptada con 3DES.

Notas

Los nombres de los campos deben ser establecidos tal cual estn escritos en
la documentacin, respetando minsculas y maysculas.

Presencia:
o M = Mandatorio
o C = Condicional
o O = Opcional

Condicin de Cdula.

La cdula de identidad es el documento de identificacin nacional en Uruguay, y est

compuesto por un nmero de 6 a 7 dgitos seguido de un dgito verificador.

Pgina 13 de 24

Este campo es mandatorio para RedPagos (ID=4) y opcional para el resto de los
medios de pago.
En caso de ser incluido, se debe validar en el sitio del cliente que el nmero sea
correcto, porque de lo contrario la transaccin ser rechazada debido a que el cliente
no podr efectuar el pago en las agencias de RedPagos.

Detalle de Importe gravado

El importe gravado es la parte del monto de la transaccin al cual se le aplic el IVA.
Dado que el monto total de una transaccin puede contener valores gravados y no
gravados por IVA, la ley de inclusin financiera exige que se reporte este valor para
hacer la deduccin de IVA correspondiente.
Ejemplo:
Transaccin compuesta por: $ 600 gravados con IVA y $ 300 exentos de IVA.
El valor de la transaccin se compone de:
600 + (600 * 22%) + 300 = 1.032
En este caso, los valores a enviar son:
valorTransaccion = 1032
importeGravado = 600

Pgina 14 de 24

Algoritmo de validacin de cdula

Se adjunta cdigo JavaScript con validacin de la cdula de identidad
function ValidateDocument(source, args) {
var cedula = args.Value;
if (isNaN(cedula) || parseInt(cedula) != cedula) {
//La cedula no es un numero
args.IsValid = false;
return;
}
var multiplicador = [4, 3, 6, 7, 8, 9, 2 ];
var cd = cedula % 10;
var i = 0;
var calc_cd = 0;
while (cedula > 0 && i < 7) {
cedula = Math.floor(cedula / 10);
calc_cd += cedula % 10 * multiplicador[i++];
}
calc_cd = (calc_cd % 10 == 0) ? 0 : 10 - (calc_cd % 10);
if (calc_cd == cd) {
args.IsValid = true;
}
else {
args.IsValid = false;
}
}

Pgina 15 de 24

Detalle de Medios de Pago

Identificador

Medio de Pago

Visa

MasterCard

Oca

RedPagos

E-Brou

Banred

Skrill

Diners

Diners Discover

10

Lider

11

Santander

12

BBVA

13

Banque Heritage

URL para Pruebas

http://testing.pagosweb.com.uy/v3.4/requestprocessor.aspx

Pgina 16 de 24

Response de PagosWeb
Campo

Tipo

Presencia

ventaAprobada

Bool

Descripcin
true = indica que la venta fue
aprobada
false = indica que la venta fue
rechazada

codigoAutorizacion

Alfanumrico

Opcionalmente, si la venta fue

aprobada puede reportarse un
cdigo de autorizacin provisto por el
procesador.

numeroTransaccion

Alfanumrico

Nmero de transaccin asignado por

el procesador.

monto

Numrico

Monto original de la transaccin

mensaje

Alfanumrico

Mensaje asociado a la transaccin.

Se puede mostrar en la pgina para
referencia del cliente.

numeroOrden

Alfanumrico

Se devuelve el nmero de orden que

vino originalmente en el Request (se
enva de acuerdo a la configuracin
por comercio)

idCliente

Numrico

Nmero de cliente dentro de la

aplicacin PagosWeb, asignado en
la instalacin.

fecha

Alfanumrico

Fecha en que se efectu la

respuesta en formato yyyy-MM-dd
hh:mm:ss

cantidadCuotas

Numrico

Se devuelve la cantidad de cuotas de

la operacin. Agregado para notificar
especialmente el valor de cuotas
elegido en la plataforma de Visa.

responseSecurityToken

Alfanumrico

Informacin de la respuesta
encriptados con 3Des

Pgina 17 de 24

Seguridad 3DES en Request y Response.

En la versin 3.4 de PagosWeb se incluye un campo de seguridad en las
transacciones, de esta forma PagosWeb asegura el origen de la transaccin. Este
campo debe estar cifrando utilizando el algoritmo de cifrado 3Des en su modo CBC
(CipherBlockChaining)
En la instalacin de un nuevo comercio en PagosWeb se le asigna una llave de
encriptado, la cual es enviada al contacto del comercio.
Una vez obtenida la llave hay dos formas de implementar la integracin:

1- Componente PHP
Dicha llave se deber setear en la configuracin del componente php que ser
entregado para la encriptacin.
La configuracin solicitada por el componente es la siguiente

Certificado: En caso de usar OCA la ruta donde est alojado el certificado .pem
CertificadoPass: Contrasea del certificado de OCA
Nrocom: Nmero de comercio asignado por OCA
Nroterm: Nmero de terminal asignado por OCA
Tcompra: Tipo de compra para OCA
urlCompraAprobada: URL al cual ser re direccionado el cliente al tener una
compra exitosa.
urlCompraRechazada: URL al cual ser re direccionado el cliente al tener una
compra rechazada.
urlCompraCancelada: URL al cual ser re direccionado el cliente al cancelar
una compra.
KEY_3DES: Llave 3DES asignado por PAGOSWEB.

2- Implantacin por parte del comercio

Con la llave provista por PagosWeb el comercio debe generar el campo

transactionSecurityToken y puede descifrar el campo responseSecurityToken
con el cual se asegura que ha sido PagosWeb quien enva la respuesta de la
transaccin.

Generar transactionSecurityToken
A continuacin se listan los pasos a seguir para cifrar la informacin de la transaccin:

Pgina 18 de 24

Concatenar informacin de transaccin. La informacin que se debe cifrar es

la misma de la transaccin, concatenada en el siguiente orden sin espacios
en blanco ni caracteres especiales: idCliente + idTarjetaCredito +
primerNombre +primerApellido + segundoNombre + segundoApellido +
cedula + email + telefono + direccionEnvio + valorTransaccion
+cantidadCuotas + moneda +numeroOrden + version +plan + plazoEntrega +
fecha + consumidorFinal + importeGravado + numeroFactura.
Es imprescindible que los valores concatenados sean idnticos a los
enviados en la transaccin as como el orden en que se concatenan, de lo
contrario la validacin de PagosWeb no dar por vlido el campo de
seguridad y se retornara a la pgina de transaccin cancelada del comercio.
Convertir informacin a cifrar en matriz de bytes de 7 bits ASCII. Para esto se
utiliza la funcin GetBytes() de la clase ASCIIEncoding.
Generar el vector de inicializacin. El vector de inicializacin es requerido por
3DES para evitar que el resultado del cifrado sea el mismo en el caso que se
intente cifrar la misma informacin. PagosWeb utiliza la fecha de la
transaccin para generar el vector de inicializacin. Por eso se requiere que
la fecha enviada en el Request sea la misma que se utiliza en el cifrado. Para
generar el vector se utilizan los datos de la fecha a partir del ltimo dgito del
ao, sin espacios ni caracteres de separacin y el carcter = al final.
Ejemplo: dFechaTrn.ToString("yyMMddhhmmss").Substring(1) + "=
Esto representa el vector en base 64, el cual se debe convertir en una matriz
de 8 bits con la funcin System.Convert.FromBase64String.
Convertir la llave del comercio. La llave provista por PagosWeb est
codificada en dgitos en base 64. Esta llave se debe convertir a una matriz de
8 bits utilizando la misma funcin.
Cifrar la informacin con 3Des en modo CBC y codificarla en dgitos de base
64. Utilizando por ejemplo la funcin System.Convert .ToBase64String

Ejemplo de cifrado en asp.net con C#

Datos de la transaccin:
idCliente = 3
idTarjetaCredito = 1
primerNombre = Armando
segundoNombre = Esteban
primerApellido = Quito
segundoApellido = Blanco
cedula = 1234567-9
email = unmail@dominio.com
telefono = 123456789
direccionEnvio = Av. Sin Nombre 0000
valorTransaccion = 1234.50
cantidadCuotas = 6
moneda = 858
numeroOrden = 3535
Pgina 19 de 24

version = 3.3
plan = 0
plazoEntrega = 48hs
fecha = 2012-10-2511:18:00
consumidorFinal = 1
importeGravado = 300
numeroFactura = A123456
public static string GetSecurityToken()
{
string retorno = "";
//Fecha de la transaccin = 2012-10-2511:18:00.
DateTime dFechaTransaccion = DateTime.Now;
//Llave 3Des del comercio.
string keyComercio64 = "Y8LpWzag8MliH0PSXwijck+rh2wwsCi8";
//Informacion de la transaccion a cifrar.
string textoPlano = "31ArmandoQuitoEstebanBlanco12345679unmail@dominio.com123456789
Av. Sin Nombre 00001234.50685835353.3048hs" +
dFechaTransaccion.ToString("yyyy-MM-ddhh:mm:ss") +
"1300A123456";
//Vector de incializacion= "21025111800="
string sIV64 = dFechaTransaccion.ToString("yyMMddhhmmss").Substring(1) + "=";
retorno = EncryptTextToMemory(textoPlano, keyComercio64, sIV64);
// retorno=
M7lMF5dt13yCY2yX0ATjwgo5GnkOXx4kKXYpsVMqxL8PRm3I+vORpfJo8XplfeQLfnn3q
J/WKw8fplY7URCGJfxXjSa7T6LLBcpQ6fuT3RUjRaH/TPrRpG5nW/DNhSSuuvYsUnU
+2APH7vbKRcRqytxzF4QSjoCcDiFfdwu14WM=
return retorno;
}

Pgina 20 de 24

Public static string EncryptTextToMemory(string Data, stringsKey, stringsIV)

{
try
{
System.IO.MemoryStream mStream = new System.IO.MemoryStream();
byte[] bKey = System.Convert.FromBase64String(sKey);
byte[] bIV = System.Convert.FromBase64String(sIV);

UTF8Encoding utf8 = new UTF8Encoding();

Byte[] toEncrypt = utf8.GetBytes(Data);
System.Security.Cryptography.CryptoStreamcStream = new CryptoStream(mStream,
New TripleDESCryptoServiceProvider() { Key = bKey, IV = bIV, Mode =
CipherMode.CBC }.CreateEncryptor(), CryptoStreamMode.Write);
cStream.Write(toEncrypt, 0, toEncrypt.Length);
cStream.FlushFinalBlock();
byte[] ret = mStream.ToArray();
cStream.Close();
mStream.Close();
return System.Convert.ToBase64String(ret);
}
catch (CryptographicException e)
{
Return "Error";
}
}

Ejemplo de Cifrado en PHP

<?php
//Fecha de la transaccin = 2012-10-2511:18:00
$fechaTransaccion = date;
//Vector de inicializacion = 21025111800=
$iv = base64_decode(substr($fechaTransaccion ('ymdhis'), 1) . '=');
//datos de transaccion
$string = '31ArmandoQuitoEstebanBlanco1234567-9unmail@dominio.com123456789Av.
Sin Nombre 00001234.50685835353.3048hs' . $fechaTransaccion("Y-m-dh:i:s");
//Llave del comercio
$key = base64_decode('Y8LpWzag8MliH0PSXwijck+rh2wwsCi8');
$encryptedString = encryptNET3DES($key, $iv, $string);
//Resultado =
M7lMF5dt13yCY2yX0ATjwgo5GnkOXx4kKXYpsVMqxL8PRm3I+vORpfJo8XplfeQLfnn3q
J/WKw8fplY7URCGJfxXjSa7T6LLBcpQ6fuT3RUjRaH/TPrRpG5nW/DNhSSuuvYsUn
U+2AP
H7vbKRcRqytxzF4QSjoCcDiFfdwu14WM=
function encryptNET3DES($key, $vector, $text){
$td = mcrypt_module_open (MCRYPT_3DES, '', MCRYPT_MODE_CBC, '');
$key_add = 24-strlen($key);
$key .= substr($key,0,$key_add);
$text_add = strlen($text)%8;
for($i=$text_add; $i<8; $i++){
$text .= chr(8-$text_add);
}
mcrypt_generic_init ($td, $key, $vector);
$encrypt64 = mcrypt_generic ($td, $text);
mcrypt_generic_deinit($td);
Pgina 21 de 24

mcrypt_module_close($td);
return base64_encode($encrypt64);
}
?>

Descifrar ResponseSecurityToken
A continuacin se listan los pasos a seguir para descifrar el campo de seguridad de
respuesta:

Convertir informacin a descifrar en matriz de bytes en base 64.

Generar vector de inicializacin, en la respuesta se agrega el campo fecha,
representa la fecha hora en que se realizo la respuesta. Con esta fecha se
debe generar el vector de inicializacin, siguiendo el mismo procedimiento que
se describe en el punto anterior.
Convertir la llave del comercio y el vector de inicializacin en matriz de bytes en
base 64.
Descifrar informacin con 3Des en modo CBC y convertir matriz resultado
(bytes de 7 bits ASCII) en texto plano.Para esto se utiliza la funcin GetString()
de la clase ASCIIEncoding.
Comprobar informacin de respuesta. La informacin cifrada es la misma
informacin que contiene la respuesta concatenada de la siguiente manera:
ventaAprobada + numeroTransaccion + monto + codigoAutorizacion +mensaje
+numeroOrden + idCliente + fecha
Nota: No se incluye en la validacin del token, el campo cantidadCuotas,
agregado recientemente al protocolo.

Pgina 22 de 24

Ejemplo de descifrado en ASP.NET con C#

Datos de la respuesta:
Venta Aprobada: True
Id Cliente: 3
Nmero Transaccin: 496
Monto: 1234,5
Cdigo Autorizacin: 1234
Mensaje: Venta Aprobada
Nmero Orden: 3535
Fecha: 2012-10-2511:18:05
Security Token:
X3XwnzaIFu/xANl/oZ7bHPjuJO0YeWot4KO9bev7GAOX3cOgkEhO4YpnBEjAbXd3
Evp11aKj8Y4=
Security Token (descifrado): True4961234,51234Venta
Aprobada353532012-10-2511:18:05
public string DesCifrarSecurityToken(string securytiToken, string sfecha)
{
//sfecha = 2012-10-2511:18:05
//securytiToken =
X3XwnzaIFu/xANl/oZ7bHPjuJO0YeWot4KO9bev7GAOX3cOgkEhO4YpnBEjAbXd3Evp11aKj8Y4=
string retorno = "";
DateTime dFechaRespuesta;
if (DateTime.TryParse(sfecha, outdFechaRespuesta))
{
string keyComercio64 = "Y8LpWzag8MliH0PSXwijck+rh2wwsCi8";
string sIV64 = dFechaRespuesta.ToString("yyMMddhhmmss").Substring(1) + "=";
retorno = DecryptTextFromMemory(securytiToken, keyComercio64, sIV64);
//retorno = True4961234,51234Venta Aprobada353532012-10-2511:18:05
}
return retorno;
}
public static string DecryptTextFromMemory(string sData, string sKey, string sIV)
{
try
{
byte[] Data = System.Convert.FromBase64String(sData);
byte[] bKey = System.Convert.FromBase64String(sKey);
byte[] bIV = System.Convert.FromBase64String(sIV);
MemoryStream msDecrypt = new MemoryStream(Data);
CryptoStream csDecrypt = new CryptoStream(msDecrypt,
New TripleDESCryptoServiceProvider() { Mode = CipherMode.CBC, Key = bKey, IV
= bIV }.CreateDecryptor(),CryptoStreamMode.Read);
byte[] fromEncrypt = newbyte[Data.Length];
csDecrypt.Read(fromEncrypt, 0, fromEncrypt.Length);

UTF8Encoding utf8 = new UTF8Encoding();

String decodedString = utf8.GetString(fromEncrypt);
return decodedString;
}
catch (CryptographicException e)
Pgina 23 de 24

{
return"Error";
}
}

Ejemplo de descifrado en PHP

<?php
//Fecha de la respuesta = "2012-10-2511:18:05"
$fechaRespuesta = date;
//Vector de inicializacion = 21025111805=
$iv = base64_decode(substr($fechaRespuesta('ymdhis'), 1) . '=');
//Llave del comercio
$key = base64_decode('Y8LpWzag8MliH0PSXwijck+rh2wwsCi8');
//Security Token de Respuesta
$strToDesc =
'X3XwnzaIFu/xANl/oZ7bHPjuJO0YeWot4KO9bev7GAOX3cOgkEhO4YpnBEjAbXd3Evp11aKj8Y4='
;
$infoRespuesta = decrypt($strToDesc, $key, $iv);
//Resultado = "True4961234,51234Venta Aprobada353532012-10-2511:18:05"
function decrypt($encrypted_text,$key,$iv)
{
$cipher = mcrypt_module_open(MCRYPT_3DES,'',MCRYPT_MODE_CBC,'');
mcrypt_generic_init($cipher, $key, $iv);
$decrypted = mdecrypt_generic($cipher, base64_decode($encrypted_text));
mcrypt_generic_deinit($cipher);
return $decrypted;
}
?>

Pgina 24 de 24