Django Khipu

Aplicacion de integracion entre Django y Khipu.

Configuración

• Variables en settings.py de tu proyecto Django.

  • Indentificador único de la cuenta de cobro: KHIPU_RECEIVER_ID = '236987'

  • Llave secreta y única de la cuenta de cobro: KHIPU_SECRET_KEY = '9kmbf4fckm81f9892a291a12d0m10cdf389'

• Crear las migraciones necesarias para obtener la tabla de datos de Khipu en tu proyecto.

$ python manage.py migrate khipu

• Referenciar en algun lado de las URLs de tu proyecto las de Khipu:

urlpatterns = [
    url(r'^khipu/', include('khipu.urls')),
]

Uso

Puedes usar el servicio para crear las URLs de pago y obtener el JSON de URL's Khipu y usarlas donde quieras.

>> from khipu.communication import Khipu
>> khipu = Khipu()
>> result = khipu.service('CreatePaymentURL', **{
    'subject': 'Esto es un pago de pruebas',
    'currency': 'CLP',
    'amount': '3000.0000'
   })
>> {u'payment_id': u'weyayhnbmker', u'app_url': u'khipu:///pos/weyayhnbmker', u'ready_for_terminal': False, u'payment_url': u'https://khipu.com/payment/info/weyayhnbmker', u'simplified_transfer_url': u'https://app.khipu.com/payment/simplified/weyayhnbmker', u'transfer_url': u'https://khipu.com/payment/manual/weyayhnbmker'}

Puedes usar el formulario pre-armado para poder crear los botones facilmente.

>> from khipu.forms import KhipuCreatePaymentForm
>> form_payment_khipu = KhipuCreatePaymentForm(**{
        'subject': 'Esto es un pago de pruebas via Django-Form',
        'currency': 'CLP',
        'amount': '6000.0000'
    })
    return render(request, 'carro.html', {'form_payment_khipu': form_payment_khipu})

Y en el Template Django hacer:

{{form_payment_khipu.render}}

Servicios

A continuacion se describen los servicios que pueden usarse para interactuar con Khipu.

• GetBanks: Obtener los bancos disponibles que el pagador puede usar.
• 'CreatePaymentURL'. Crear la orden de pago en Khipu y que nos devuelvan las URLs.
  • Se pueden enviar los siguientes parametros:
    • subject (obligatorio)
    • currency (obligatorio)
    • amount (obligatorio)
    • transaction_id
    • custom
    • body
    • bank_id
    • return_url
    • cancel_url
    • picture_url
    • notify_url
    • contract_url
    • notify_api_version
    • expires_date
    • send_email
    • payer_name
    • send_reminders
    • responsible_user_email
    • fixed_payer_personal_identifier
    • integrator_fee
  • Se reciben los siguientes parametros por parte de Khipu:
    • payment_id
    • payment_url
    • simplified_transfer_url
    • transfer_url
    • app_url
    • ready_for_terminal

Signals

Existen algunos signals los cuales el Proyecto Django puede recibir para realizar ciertas operaciones como aumentar dias de expiracion al usuario pagador, entregarle un servicio, etc. Los signals son los siguientes:

• payment_successful: Cuando el pago es "done" y hay que entregarle el bien o servicio al pagador.
• payment_amount_error: Existe un error con el monto que dijimos que pagara y el monto que nos llego. Hay que revisar ya que muy probablemente tiene que reembolsarse el dinero.
• payment_receiver_id_error: Existe un error con el receiver_id pues no es el mismo que nosotros usamos. Es un error muy raro y hay que revisar ya que muy probablemente tiene que reembolsarse el dinero.