compropago-python 0.3

ComproPago Python库
====================

这是一个用于ComproPago（https://compropago.com/）的Python库，ComproPago是
一个墨西哥支付网关。

以下内容使用西班牙语...

这是ComproPago（https://compropago.com/）的Python库。

ComproPago是一个现金支付平台，帮助没有信用卡的人在网上商店进行交易。
最终客户可以在7Eleven、Oxxo、Extra、Soriana、Walmart、Coppel、Farmacia
Benavides、Bodega Aurrera和Farmacias Guadalajara等场所支付他们的在线购物。

以下是一些示例：
7Eleven、Oxxo、Extra、Soriana、Walmart、Coppel、Farmacia Benavides、
Bodega Aurrera和Farmacias Guadalajara等。


安装
-----------

使用`pip`安装如下：

pip install compropago-python

如果您使用`zc.buildout`_ `，只需将`compropago-python`添加到`eggs`部分：
[buildout]

eggs =
compropago-python
...


开发模式安装
------------------------------

您需要安装pip，并且最好安装virtualenv和virtualenvwrapper。

.. code-block:: bash

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

这样就会安装依赖项。现在只需运行测试即可。

.. code-block:: bash
nosetests

在Windoge
~~~~~~~~~~

安装Python。我用chocolatey安装的，但您也可以使用其他方法。
你想安装什么。Chocolatey 已在 C:\Tools\Python2 中安装了 Python。

安装 Python 后，需要使用 `get-pip.py` 安装 pip。
<https://bootstrap.pypa.io/get-pip.py>`_。[1]_

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

然后可以安装 virtualenv 并创建虚拟环境。

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

最后

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


如何创建一个岗位？
---------------------

要对 Compropago API 进行任何操作，您都必须使用在 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', # 建议使用与购买订单关联的连续数字
order_price = '10.59', #Compropago 只处理比索
order_name = '街角小店',
customer_name = '弗朗科·费尔南德斯',
customer_email = perengano@perez.com,
payment_type = 'OXXO'
)
r = api.charge(c)

注意：有两个 API 版本：1.0 和 1.1。这两个版本差异很大。
如果 Compropago 表示密钥无效，请尝试使用控制面板中提供的另一个密钥。
。

由 `payment_type` 支持的支付类型包括：

OXXO
SEVEN_ELEVEN
EXTRA
CHEDRAUI
ELEKTRA
COPPEL
FARMACIA_BENAVIDES
FARMACIA_ESQUIVAR


验证现有付款
----------------------------

您需要前面步骤中创建的付款 id。

.. code-block:: python
from compropago impo rt CompropagoAPI
COMPROPAGO_PRIVATE_API_KEY = '687881193b2423'
api = CompropagoAPI(COMPROPAGO_PRIVATE_API_KEY)
payment_id = '123234' # 来自某些地方
res = api.verify_charge(pay_id)
if res['object'] == 'event' and res['type'] == 'charge.success'
print "已支付"

错误
--------

代码 描述

4001 密钥未找到
5001 付款 ID 未找到
5002 店铺未找到
5003 产品价格超过所选店铺的交易限额
6001 与 SMS 提供商出现问题时，未发送消息
6002 超过了 SMS 发送次数，每笔付款最多 2 条消息
6003 无效的移动公司，我们支持：TELCEL, MOVISTAR, IUSACELL, UNEFON 和 NEXTEL
6004 无效的手机号码，可能号码包含少于或多于 10 位数字