Skip to main content

Python library for ComproPago

Project description

Compropago en Python
====================

This is the Python library for ComproPago (https://compropago.com/), a Mexican
payment gateway.

Spanish from now on...

Esta es la libreria de Python para Compropago (https://compropago.com/).

ComproPago es una plataforma de pagos en efectivo que ayuda a que personas que
no cuentan con tarjeta de crédito puedan realizar transacciones en tiendas en
línea.

Los clientes finales puedan pagar sus compras de Internet en establecimientos
como 7Eleven, Oxxo, Extra, Soriana, Walmart, Coppel, Farmacia Benavides,
Bodega Aurrera y Farmacias Guadalajara entre otros.


Instalación
-----------

Con ``pip`` se instala así::

pip install compropago-python

Si usas `zc.buildout <http://www.buildout.org/en/latest/>`_ solo necesitas
añadir ``compropago-python`` a la sección ``eggs``::

[buildout]
eggs =
...
compropago-python

Instalación en modo desarrollo
------------------------------

Debes de tener instalado pip y de preferencia virtualenv y virtualenvwrapper.

.. code-block:: bash

mkvirtualenv ve
workon ve
cd compropago-python
python setupy.py develop

Con esto se instalan las dependencias. Ahora solo necesitas correr las pruebas.

.. code-block:: bash
nosetests

En Windoge
~~~~~~~~~~

Instala Python. Yo lo instale con chocolatey, pero puedes usar el metodo
que quieras. Chocolatey instaló python en C:\Tools\Python2.

Después de instalar Python hay que instalar pip con `get-pip.py
<https://bootstrap.pypa.io/get-pip.py>`_. [1]_

.. code-block:: msdos
C:\Tools\Python2\python.exe get-pip.py

Despues puedes instalar virtualenv y crear tu entorno virtual.

.. code-block:: msdos
C:\Tools\Python2\Scripts\pip.exe install virtualenv
CD C:\Code\MyProject
C:\Tools\Python2\Scripts\mkvirtualenv.exe ve
ve\Scripts\activate.exe

Finalmente:

.. code-block:: msdos
cd compropago-python
..\ve\Scripts\python.exe setup.py develop
..\ve\Scripts\nosetests.exe


¿Cómo crear un cargo?
---------------------

Para cualquier operación con el API de Compropago tendrás que usar la llave pública que puedes obtener en el panel de Control de Compropago.

.. code-block:: python
from compropago import CompropagoAPI, CompropagoCharge
COMPROPAGO_PRIVATE_API_KEY = '687881193b2423'
api = CompropagoAPI(api_key=COMPROPAGO_PRIVATE_API_KEY)
c = CompropagoCharge(
order_id = '1', # De preferencia un numero consecutivo asociado a una orden de compra
order_price = '10.59', #Compropago solo maneja pesos
order_name = 'La tiendita de la esquina',
customer_name = 'Fulano Fernandes',
customer_email = perengano@perez.com,
payment_type = 'OXXO'
)
r = api.charge(c)

Nota: Hay dos versiones del API: 1.0 y 1.1. Las dos versiones difieren bastante.
Si Compropago falla diciendo que la llave es invalida, prueba con la otra llave
que te dan el panel de control.

Los tipos de pagos soportados por `payment_type` son::

OXXO
SEVEN_ELEVEN
EXTRA
CHEDRAUI
ELEKTRA
COPPEL
FARMACIA_BENAVIDES
FARMACIA_ESQUIVAR


Verificar un cargo existente
----------------------------

Necesitaras el id del pago creado en el paso anterior.

.. code-block:: python
from compropago impo rt CompropagoAPI
COMPROPAGO_PRIVATE_API_KEY = '687881193b2423'
api = CompropagoAPI(COMPROPAGO_PRIVATE_API_KEY)
payment_id = '123234' # Viniendo de alguna pa
res = api.verify_charge(pay_id)
if res['object'] == 'event' and res['type'] == 'charge.success':
print "Pagado"

Errores
--------

Código Descripción

4001 Llave no encontrada
5001 ID de pago no encontrado
5002 Tienda no encontrada
5003 El precio del producto excede el límite por transacción en el establecimiento seleccionado
6001 Hubo un problema con el proveedor de SMS y el mensaje no se envío
6002 Se ha superado el número de envios SMS, máximo 2 mensajes por orden de pago
6003 Compañia celular inválida, soportamos: TELCEL, MOVISTAR, IUSACELL, UNEFON y NEXTEL
6004 Número de celular no válido, probablemente el número contiene menos o más de 10 dígitos

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

compropago-python-0.3.tar.gz (6.2 kB view details)

Uploaded Source

Built Distribution

compropago_python-0.3-py2-none-any.whl (9.6 kB view details)

Uploaded Python 2

File details

Details for the file compropago-python-0.3.tar.gz.

File metadata

File hashes

Hashes for compropago-python-0.3.tar.gz
Algorithm Hash digest
SHA256 7f0e9b8e689845265e51fef305bbe3859f356f7902723815eb51cf5a0ca52f1a
MD5 cdc354ddc1a42521df79066f902d6891
BLAKE2b-256 418fa840e4694eba3c59f514bd61a2e5ef1ad82f338b2f157309928b238f3eec

See more details on using hashes here.

File details

Details for the file compropago_python-0.3-py2-none-any.whl.

File metadata

File hashes

Hashes for compropago_python-0.3-py2-none-any.whl
Algorithm Hash digest
SHA256 975bc54ad69cfe3ac32f0c134f2f759cc348375fb98d37a33723eb3e07b89327
MD5 848b242c26f8f9f5b2bfb8b857d0fa57
BLAKE2b-256 3f59f2a54eb6981aba85d3d04cfac752f236251c524fa3c32c307f35b17bc959

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page