Skip to content

mariofix/django-payments-chile

Repository files navigation

django-payments-chile

django-payments-chile es una extensión para django-payments, una biblioteca que proporciona una interfaz universal para procesar pagos en aplicaciones Django. Este proyecto añade soporte específico para varios proveedores de pagos chilenos como Flow, Khipu, Webpay, y otros.

⚠️ ⚠️ Este proyecto está en desarrollo activo, usar con precaución. ⚠️ ⚠️

PyPI - Status Downloads Codacy Badge Codacy Badge pre-commit.ci status Tests & Coverage PyPI PyPI - Python Version PyPI - Implementation PyPI - License

Proveedores de pago soportados

Proveedor Estado Descripcion
Flow Plataforma chilena para pagos en línea que admite múltiples métodos de pago.
Khipu Permite pagos mediante transferencia electrónica en tiempo real.
Klap Solución de pagos electrónicos enfocados en comercios.
Kushki Proveedor de pagos electrónicos que facilita la integración con diversas plataformas.
Onepay Pago rápido y seguro usando códigos QR.
Payku Plataforma de pagos enfocada en pequeñas y medianas empresas.
Webpay El sistema de pago en línea más utilizado en Chile, operado por Transbank.

Características

  • Soporte para múltiples proveedores de pago en un solo proyecto.
  • API consistente para crear, procesar y verificar transacciones.
  • Fácil configuración y personalización.
  • Documentación clara para desarrolladores.
  • Soporte para eventos de éxito, fallo, y reembolsos de pagos.

Instalación

La biblioteca django-payments-chile está disponible en PyPi. Puedes instalarla fácilmente con tu gestor de paquetes favorito, como pip, poetry, o pipenv.

pip install django-payments-chile

Instalación de Extras

Algunos proveedores requieren dependencias adicionales para funcionar correctamente. Puedes instalar estas dependencias mediante extras:

# Instala todas las dependencias extra
pip install django-payments-chile[todos]

Los extras disponibles son:

  • webpay: Incluye la dependencia transbank-sdk.
  • oneclick: También incluye transbank-sdk.
  • todos: Instala todas las dependencias extra mencionadas.

Por ejemplo, para instalar solo las dependencias necesarias para Webpay, puedes ejecutar:

pip install django-payments-chile[webpay]

Esto es equivalente a instalar las dependencias manualmente:

pip install django-payments-chile transbank-sdk

Nota: La instalación de extras es opcional. Si prefieres, puedes gestionar las dependencias adicionales de forma manual en tu proyecto.

Configuración de Proveedores

Agrega las credenciales de los proveedores de pago en tu archivo de configuración:

PAYMENT_VARIANTS = {
    'flow': ('django_payments_chile.FlowProvider', {
        'api_key': 'tu_api_key_flow',
        'secret': 'tu_secret_flow',
    }),
    'webpay': ('django_payments_chile.WebpayProvider', {
        'commerce_code': 'tu_commerce_code_webpay',
        'api_key': 'tu_api_key_webpay',
    }),
}

Licencia

Este proyecto no está afiliado, asociado ni patrocinado por ninguna de las empresas mencionadas en el listado de compatibilidad.

El código de este proyecto está disponible bajo la licencia MIT, lo que significa que puedes utilizarlo, modificarlo y distribuirlo de manera libre, sujeto a las condiciones establecidas en dicha licencia.