GitLocker: The Coding Marketplace

Description:

culqipythonoficial 1.0.0

Culqi Python

Nuestra Biblioteca PYTHON oficial, es compatible con la v2.0 del Culqi API, con el cual tendrás la posibilidad de realizar cobros con tarjetas de débito y crédito, Yape, PagoEfectivo, billeteras móviles y Cuotéalo con solo unos simples pasos de configuración.
Nuestra biblioteca te da la posibilidad de capturar el status_code de la solicitud HTTP que se realiza al API de Culqi, así como el response que contiene el cuerpo de la respuesta obtenida.
Requisitos

Python 2.7+

Afiliate aquí.
Si vas a realizar pruebas obtén tus llaves desde aquí, si vas a realizar transacciones reales obtén tus llaves desde aquí.

Recuerda que para obtener tus llaves debes ingresar a tu CulqiPanel > Desarrollo > API Keys.

Recuerda que las credenciales son enviadas al correo que registraste en el proceso de afiliación.

Para encriptar el payload debes generar un id y llave RSA ingresando a CulqiPanel > Desarrollo > RSA Keys

Instalación
Ejecuta los siguientes comandos:
py -m pip install pytest
py -m pip install python-dotenv
py -m pip install culqi
py -m pip install jsonschema
py -m pip install pycryptodome

Configuracion
Para empezar a enviar peticiones al API de Culqi debes configurar tu llave pública (pk), llave privada (sk).
Para habilitar encriptación de payload debes configurar tu rsa_id y rsa_public_key.
from dotenv import load_dotenv
from culqi2 import __version__
from culqi2.client import Culqi

self.public_key = "pk_test_e94078b9b248675d"
self.private_key = "sk_test_c2267b5b262745f0"
self.culqi = Culqi(self.public_key, self.private_key)

#ecnrypt variables
self.rsa_public_key = "-----BEGIN PUBLIC KEY-----\n" + \
"MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDswQycch0x/7GZ0oFojkWCYv+g\n" + \
"r5CyfBKXc3Izq+btIEMCrkDrIsz4Lnl5E3FSD7/htFn1oE84SaDKl5DgbNoev3pM\n" + \
"C7MDDgdCFrHODOp7aXwjG8NaiCbiymyBglXyEN28hLvgHpvZmAn6KFo0lMGuKnz8\n" + \
"iuTfpBl6HpD6+02SQIDAQAB\n" + \
"-----END PUBLIC KEY-----"
self.rsa_id = "de35e120-e297-4b96-97ef-10a43423ddec"

Encriptar payload
Para encriptar el payload necesitas agregar el parámetros options que contiene tu id y llave RSA.
Ejemplo
options = {}
options["rsa_public_key"] = self.rsa_public_key #"la llave pública RSA"
options["rsa_id"] = self.rsa_id # "el id de tu llave"
token = self.token.create(data=self.token_data, **options)

Ejemplos
Crear Token
token = self.token.create(data=self.token_data)

Crear Cargo
charge = self.charge.create(data=self.charge_data)

Crear Plan
plan = self.plan.create(data=self.plan_data)

Crear Customer
customer = self.customer.create(data=self.customer_data)

Actualizar Customer
updated_customer = self.customer.update(
id_=created_customer["data"]["id"], data=metadatada
)

Obtener Customer
retrieved_customer = self.customer.read(created_customer["data"]["id"])

Crear Card
card = self.card.create(data=self.card_data)

Crear Suscripción
subscription = self.subscription.create(data=self.subscription_data)

Crear Reembolso
refund = self.refund.create(data=self.refund_data)

Pruebas
En la caperta /test econtraras ejemplo para crear un token, charge, plan, órdenes, card, suscripciones, etc.

Recuerda que si quieres probar tu integración, puedes utilizar nuestras tarjetas de prueba.

Ejemplo Prueba Token
@pytest.mark.vcr()
def test_token_create(self):
token = self.token.create(data=self.token_data)
print(token)
assert token["data"]["object"] == "token"

Ejemplo Prueba Cargo
@property
def charge_data(self):
# pylint: disable=no-member
token_data = deepcopy(Data.TOKEN)
token = self.culqi.token.create(data=token_data)
print(token)
charge_data = deepcopy(Data.CHARGE)
charge_data["source_id"] = token["data"]["id"]

return charge_data

@pytest.mark.vcr()
def test_charge_create(self):
charge = self.charge.create(data=self.charge_data)
print (charge)
assert charge["data"]["object"] == "charge"

Documentación

Referencia de API
Demo Checkout V4 + Culqi 3DS
Wiki

Changelog
Todos los cambios en las versiones de esta biblioteca están listados en
CHANGELOG.md.
Autor
Team Culqi
Licencia
El código fuente de culqi-python está distribuido bajo MIT License, revisar el archivo LICENSE.