MANUAL

Efectivo Ltda.

BOTON DE PAGO EFECTY

Cdigo: G.M.011
Versin: 04
Clasificacin: Pblico-Confidencial
Fecha de Vigencia: 18/07/2012
Pgina 1 de 4

BOTON DE PAGO EFECTY

1.

OBJETIVO

El botn de pago Efecty tiene como fin permitir a los clientes de las tiendas virtuales pagar sus productos
a travs de puntos de servicio Efecty.

2.

CONTENIDO

La tienda virtual debe tener una opcin para pagar mediante Efecty, dicha opcin debe ser configurada
de la siguiente forma:
Utilizacin del botn de pagos de Efecty
Al seleccionar el botn de pagos Efecty se debe abrir la pgina de pagos de Efecty dentro de una
ventana emergente la cual se instancia desde javaScript mediante el siguiente cdigo:
window.open( ' "+ pagina +" ,' ','toolbar=no, location=no, directories=no, status=no, menubar=no,
scrollbars=no, resizable=no, width=700, height=640');
Donde la variable pagina contiene la direccin web donde est alojada la pgina de pagos de Efecy.
La pgina para pagos de Efecty recibe cuatro parmetros que son enviados desde la tienda virtual, estos
parmetros contienen la informacin del pago a realizar.
EFvalorTotal => Se asigna el valor del pago, el tipo de dato es decimal.
EFPin => Se asigna el pin generado por el cliente para identificar el pago, debe ser menor o igual
a 30 caracteres, el tipo de dato es alfanumrico.
EFFechaVigencia => Fecha durante la cual el pin es vlido, el tipo de dato es datetime, y debe
estar en formato yyyy/MM/dd .
EFCodProyecto => Cdigo que Efecty le asigno al proyecto del cliente, el tipo de dato es entero.
Dichos parmetros deben tener el mismo nombre descrito anteriormente,.

A pesar del tipo de dato de cada parmetro, estos deben ser enviados como cadena de caracteres,
posteriormente la pgina de pagos de Efecty verifica que los parmetros estn con el tipo de dato
correcto.

2.1.

Formas para llamar a la pgina de pagos de Efecty.

La pgina de pagos de Efecty se puede llamar utilizando el mtodo GET y el mtodo POST, los cuales se
utilizan dentro de la programacin de pginas Web.

MANUAL

Efectivo Ltda.

2.1.1

BOTON DE PAGO EFECTY

Cdigo: G.M.011
Versin: 04
Clasificacin: Pblico-Confidencial
Fecha de Vigencia: 18/07/2012
Pgina 2 de 4

Mtodo GET:

Los parmetros nombrados al inicio del documento se deben pasar dentro de la cadena de la direccin
web, los cuales sern extrados por la pgina de pagos de Efecty y presentados al usuario.
Ejemplo(asp.net):
El siguiente fragmento de cdigo se debe implementar dentro de la lgica del negocio de la pgina web.
string valorTotal = Valor de la venta;
string Pin = Pin generado por la tienda virtual;
string FechaVigencia = Fecha hasta la cual el pin es vigente.
string CodProyecto = Cdigo que Efecty le asigno al proyecto.
string pagina = "https://Direccion de Efecty/EfectyBotonPagoGet.aspx?EFvalorTotal="
+valorTotal+"&EFPin=" + pin +
"&EFFechaVigencia="+FechaVigencia+"&EFCodProyecto="+CodProyecto;
Page.ClientScript.RegisterStartupScript(GetType(), "open",
window.open( ' "+ pagina +" ,' ','toolbar=no, location=no, directories=no, status=no, menubar=no,
scrollbars=no, resizable=no, width=700, height=640'); ", true);
Donde Direccion de Efecty corresponde a la ruta web donde se encuentra alojada la pagina de pagos
de Efecty. A saber:
https://190.145.114.135:20028/BotonPagoEfecty/EfectyBotonPagoGet.aspx
2.1.2

Mtodo POST

Dentro de un formulario web se debe crear los objetos tipo hidden que contendrn los datos a enviar a la
pgina de pagos Efecty, la accin del formulario debe estar dirigida a la pgina
EfectyBotonPagoPost.aspx, la cual se encarga de extraer los datos y presentrselos al usuario.
Ejemplo Formulario Post (asp.net):
El siguiente fragmento de cdigo debe ser implementado dentro del cdigo html de la pagina web.
<script language="javascript" type="text/javascript">
function SubmitPost() {
document.getElementById('EFvalorTotal').value = document.getElementById('txtValorPost').value;
document.getElementById('EFpin').value = document.getElementById('txtPinPost').value;
document.getElementById('EFFechaVigencia').value = document.getElementById('txtFechaPost').value;
document.getElementById('EFCodProyecto').value =
document.getElementById('txtCodProyectoPost').value;
window.open('', 'ventana', 'toolbar=no, location=no, directories=no, status=no, menubar=no,
scrollbars=no, resizable=no, width=700, height=640')
}
</script>
<form id="FrmPost" action="https://Direccion de Efecty /EfectyBotonPagoPost.aspx"
method="post" target="ventana" onsubmit="SubmitPost();">
<input type="hidden" name ="EFvalorTotal" id="EFvalorTotal" />
<input type="hidden" name="EFpin" id="EFpin" />
<input type="hidden" name="EFFechaVigencia" id="EFFechaVigencia" />
<input type="hidden" name="EFCodProyecto" id= "EFCodProyecto" />

MANUAL

Efectivo Ltda.

BOTON DE PAGO EFECTY

Cdigo: G.M.011
Versin: 04
Clasificacin: Pblico-Confidencial
Fecha de Vigencia: 18/07/2012
Pgina 3 de 4

<p> <strong>Cliente POST</strong></p>

<table>
<tr>
<td>
Valor
</td>
<td>
<input type="text" id="txtValorPost" />
</td>
</tr>
<tr>
<td>
Pin
</td>
<td>
<input type="text" id="txtPinPost" />
</td>
</tr>
<tr>
<td>
Fecha Vigencia
</td>
<td>
<input type="text" id="txtFechaPost" />
</td>
</tr>
<tr>
<td>
Codigo proyecto
</td>
<td>
<input type="text" id="txtCodProyectoPost" />
</td>
</tr>
</table>
<input type="submit" value="Enviar Post" />
</form>

Donde txtValorPost, "txtPinPost", "txtFechaPost", txtCodProyectoPost son cajas de texto html, en los
cuales se introducen los valores de los parmetros a enviar a la pgina de pagos de Efecty.
Direccin de Efecty corresponde a la ruta web donde se encuentra alojada la pagina de pagos de
Efecty.

2.2.

Pruebas

URL para pruebas WAN

http://190.248.30.67:81/BotonPagoEfecty/EfectyBotonPagoGet.aspx
http://190.248.30.67:81/BotonPagoEfecty/EfectyBotonPagopost.aspx
Una vez finalizadas las pruebas de aceptacin, el Cliente Corporativo debe enviar un correo al contacto
comercial de Efecty con el detalle de las transacciones registradas.

MANUAL

Efectivo Ltda.

3.

BOTON DE PAGO EFECTY

Cdigo: G.M.011
Versin: 04
Clasificacin: Pblico-Confidencial
Fecha de Vigencia: 18/07/2012
Pgina 4 de 4

CAMBIOS RESPECTO A LA VERSIN ANTERIOR

VERSIN

FECHA DE
VIGENCIA

ELABORADO POR

RAZN DE LA ACTUALIZACIN

01

05/05/2011

Analista Mr. de
Desarrollo

Versin Inicial

02

25/10/2011

Analista Mr. de Modelo E

Actualizacin de Direccin URL Direccin Efecty

03

29/05/2012

Analista Mr. de Modelo E

Se incluyen las URL de pruebas

Punto 2.2 de este documento.

04

18/07/2012

Analista Mr. de Modelo E

Actualizacin Plantilla y termino Empresarial a

Corporativo