⛔ [DEPRECATED] El uso de KCC (archivos CGI) ha quedado obsoleto por parte de Transbank.

Django-webpay

Aplicacion de integracion entre Django y Webpay. Es necesario tener en cuenta las recomendaciones del manual para entener el procedimiento que se requiere.

Esta app ayuda a la integración con Webpay en tu app Django sin embargo se debe contemplar lo siguiente:

La realización de tus páginas de exito/fracaso.
El alojo de la carpeta cgi-bin en tu servidor.
Permisos adecuados para los CGI.
Configuración adecuada del archivo tbk_config.dat requerido por Webpay.
Generación de las llaves de cifrado.

Instalación

Extisten dos opciones para instalarlo, estas son:

°Descargando la carpeta

$ python setup.py install

°O también agregando a requeriments.txt

-e git+git://github.com/felicesyforrados/django-webpay.git#egg=django-webpay

Después ejecutar el comando

$ pip install -r requirements.txt

Configuración

Agregar vista que validara los parametros que nos de el CGI de Webpay
```
 # urls.py
 url(r'^webpay/compra/$', include('webpay.urls')),
```
Agregar las variables en settings.py

°Tipo de transaccion que manejaras
```
 # settings.py
 TBK_TIPO_TRANSACCION = 'TR_NORMAL'
```
°URL de la página de exito de tu comercio
```
 # settings.py
 TBK_URL_EXITO = 'http://tucomercio.com/paginaexito'
```
°URL de la página de fracaso de tu comercio
```
 # settings.py
 TBK_URL_FRACASO = 'http://tucomercio/paginafracaso'
```
°Ruta directa del CGI que esta en el KCC de Transbank
```
 # settings.py
 URL_CGI_PAGO = '/cgi-bin/tbk_bp_pago.cgi'
```
°Ruta directa del archivo mac que validara la autenticidad de la respuesta
```
 # settings.py
 URL_CGI_VALIDA_MAC = '/cgi-bin/tbk_check_mac.cgi'
```
°Logger de Webpay. Es el nombre del log con que se identificara para guardar informacion.
```
 # settings.py
 LOGGER_WEBPAY = 'loggerapp.django'
```

Agregar app a settings.py

 #settings.py
 ...
 INSTALLED_APPS = (
     ...,
     'webpay',
 )

Crear Tablas

°South

 python manage.py schemamigration webpay --initial

Uso

La dinámica básica con Webpay es primero armar un formulario el cual contiene los parametros que se le enviaran al CGI y Webpay los pueda procesar así mismo generar un registro en el modelo para su posterior comprobación, después Webpay tomara el control del navegador y pedira los datos del tarjetahabiente, Webpay es quien validara el número de la tarejta y el código, cuando todo este correcto mandara a llamar una vista la cual es la que validara los datos entregados por Webpay, al estar todo correcto se guardara un registro en el modelo OrdenCompraWebpay y se enviara un Signal el cual se puede hacer uso para guardar los datos en otro modelo si es que lo requiere el usuario.

Agregar formulario a la vista y guardar el registro en OrdenCompraWebpay

 # views.py
 #Vista principal para la compra en Webpay
 from webpay.forms import WebPayNormalForm
 from webpay.conf import *
 from webpay.models import OrdenCompraWebpay
 ord_compra = "numaleatorio"
 montof = 12000 * 100
 #El parametro initial se mandara todos los parametros para armar el formulario. El parametro type_submit ayudara
 #a armar la imagen, en este caso es un submit con la leyenda Realizar pedido
 form = WebPayNormalForm(
     initial={
         'TBK_TIPO_TRANSACCION': settings.TBK_TIPO_TRANSACCION,
         'TBK_MONTO': montof,
         'TBK_ORDEN_COMPRA': ord_compra,
         'TBK_ID_SESION': "num_usuario",
         'TBK_URL_EXITO': settings.TBK_URL_EXITO,
         'TBK_URL_FRACASO': settings.TBK_URL_FRACASO},
     type_submit="<input type='submit' class='button alt' id='place_order' value='Realizar el pedido' disabled>",
     action_form=settings.URL_CGI_PAGO)
 try:
     ord_m = OrdenCompraWebpay(orden_compra=ord_compra, monto=int(montof)/100)
     ord_m.save()
 except Exception, e:
     print "Error"
 return render(request, '/vista_pago_webpay.html', {"form":form})

° Template /vista_pago_webpay.html

     {% if form %}
         {{form.render}}
     {% endif %}

Crear vistas de exito fracaso y especificarlas en el archivo de configuracion de Webpay asi como en el settings.py

Se lo requiere el usuario, se puede escuchar el signal enviado por django-webpay, los singals son

 °pago_fue_satisfactorio
 °respuesta_invalida
 °monto_invalido
 °mac_invalido

° El signal se puede escuchar de la siguiente manera

 #app/signals.py
 from webpay.signals import pago_fue_satisfactorio, respuesta_invalida, monto_invalido, mac_invalido
 @receiver(pago_fue_satisfactorio)
 def webpay_handler(sender, **kwargs):
     objeto_odern_compra_webpay = sender

Contacto

dev@felicesyforrados.cl

0xbepresent/django-webpay

Django-webpay

Instalación

Configuración

Uso

Links

Contacto