⛔ [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:

1. La realización de tus páginas de exito/fracaso.
2. El alojo de la carpeta cgi-bin en tu servidor.
3. Permisos adecuados para los CGI.
4. Configuración adecuada del archivo tbk_config.dat requerido por Webpay.
5. 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

1. Agregar vista que validara los parametros que nos de el CGI de Webpay

    # urls.py
    url(r'^webpay/compra/$', include('webpay.urls')),
   

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

3. Agregar app a settings.py

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

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

1. 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 %}
   

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

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

Links

1. Transbank KCC

Contacto

dev@felicesyforrados.cl