/python-tbk

Unofficial TBK Web Services Python SDK

Primary LanguagePythonMIT LicenseMIT

Unofficial TBK Web Services Python SDK

https://circleci.com/gh/cornershop/python-tbk/tree/master.svg?style=svg

Requirements

  • python: ~2.7, ^3.6
  • libxml2 >= 2.9.1
  • libxmlsec1 >= 1.2.14

🇬🇧

Installation

Just run:

$ pip install python-tbk

Usage

As simple as call (snakecased) webpay api methods:

>>> from tbk.services import WebpayService
>>> from tbk.commerce import Commerce
>>> from tbk import INTEGRACION
>>> commerce = Commerce(commerce_code, key_data, cert_data, tbk_cert_data, INTEGRACION)
>>> webpay = WebpayService(commerce)
>>> transaction = webpay.init_transaction(amount, buy_order, return_url, final_url)
>>> print(transaction['token'])
e87df74f7af4dcfdc1d17521b07413ff9a004a7b423dc47ad09f6a8166a73842

Conventions

This library use a snake cased naming convention for webservices and params for a more pythonic implementation. Every camelcased name in the webpay API was transformed to snakecase:

initTransaction(amount, buyOrder, returnURL, finalURL, sessionId)

became:

init_transaction(amount, buy_order, return_url, final_url, session_id)

Documentation

You can refer to http://www.transbankdevelopers.cl/?m=api for official API documentation. This library documentation is on the way.

Loggers

There are two levels of loggers:

tbk.services
tbk.soap

Specific service logger are defined by class name:

tbk.services.WebpayService

Bugs?

Issues are welcome at https://github.com/cornershop/python-tbk/issues

🇪🇸

Instalación

Ejecuta:

$ pip install python-tbk

Uso

Tan simple como llamar los métodos del API de Webpay (pero snakecased):

>>> from tbk.services import WebpayService
>>> from tbk.commerce import Commerce
>>> from tbk import INTEGRACION
>>> commerce = Commerce(commerce_code, key_data, cert_data, tbk_cert_data, INTEGRACION)
>>> webpay = WebpayService(commerce)
>>> transaction = webpay.init_transaction(amount, buy_order, return_url, final_url)
>>> print(transaction['token'])
e87df74f7af4dcfdc1d17521b07413ff9a004a7b423dc47ad09f6a8166a73842

Convenciones

La librería usa una convención de nombres snakecased para ser más pythonica. Cada nombre camelcased en el API de Webpay se transformó a snakecased:

initTransaction(amount, buyOrder, returnURL, finalURL, sessionId)

se traduce en:

init_transaction(amount, buy_order, return_url, final_url, session_id)

Documentación

La documentación oficial se encuentra disponible en http://www.transbankdevelopers.cl/?m=api. La documentación de esta librería está en desarrollo.

Loggers

Se encuentran definidos dos niveles de logger:

tbk.services
tbk.soap

El logger específico de un servicio está definido por su nombre de clase:

tbk.services.WebpayService

Testing cards / Tarjetas de prueba

Credit / Crédito

Marca VISA MASTERCARD
No de Tarjeta 4051885600446623 5186059559590568
Año Expiración Cualquiera Cualquiera
CVV 123 123
Resultado APROBADO RECHAZADO

Debit / Débito

  APRUEBA RECHAZA
TARJETA 4051885600446620 5186059559590560
RUT 11.111.111-1 11.111.111-1
PASSWORD 123 123