A simple, clean and less dependant client to handle payments through Redsys.
Welcome to python-redsys!
A simple, clean and less dependant client to handle payments through the Redsys platform using one of the available methods: redirect connection or (secure method).
The purpose of this library is to provide a normalized interface between Redsys and other Python applications.
Although redirect connection depends on a webserver to resolve the communication step, the RedirectClient provided in this library does not assume any kind of procedure to resolve that step; it merely prepares the necessary parameters to make a request and handles the corresponding response parameters. That's what less dependant means.
Example using redirect connection
1. Instantiate the redirect client
from decimal import Decimal as D, ROUND_HALF_UP from redsys import currencies, languages, parameters, transactions from redsys.client import RedirectClient secret_key = "123456789abcdef" sandbox = False client = RedirectClient(secret_key, sandbox)
2. Create a request
request = client.create_request()
3. Set up the request parameters
request.merchant_code = "100000001" request.terminal = "1" request.transaction_type = transactions.STANDARD_PAYMENT request.currency = currencies.EUR request.order = "000000001" # The amount must be defined as decimal and pre-formatted with only two decimals request.amount = D("10.56489").quantize(D(".01"), ROUND_HALF_UP) request.merchant_data = "merchant data for tracking purpose like order_id, session_key, ..." request.merchant_name = "Example Commerce" request.titular = "Example Ltd." request.product_description = "Products of Example Commerce" request.merchant_url = "https://example.com/redsys/response"
4. Prepare the request
This method returns a dict with the necessary post parameters that are needed during the communication step.
args = client.prepare_request(request)
5. Communication step
Redirect the user-agent to the corresponding RedSys's endpoint using the post parameters given in the previous step.
After the payment process is finish, RedSys will respond making a
request to the
merchant_url defined in step 3.
6. Create and check the response
Create the response object using the received parameters from Redsys.
create_response() throws a
ValueError in case the
received signature is not equal to the calculated one using the
merchant_parameters. This normally means that the response is
not coming from Redsys or that it has been compromised.
signature = "YqFenHc2HpB273l8c995...." merchant_parameters = "AndvIh66VZdkC5TG3nYL5j4XfCnFFbo3VkOu9TAeTs58fxddgc..." signature_version = "HMAC_SHA256_V1" response = client.create_response(signature, merchant_parameters, signature_version) if response.is_paid(): # Do the corresponding actions after a successful payment else: # Do the corresponding actions after a failed payment raise Exception(response.response, response.message)
Methods for checking the response:
According to the RedSys documentation:
Trueif the response code is between 0 and 99 (both included).
Trueif the response code is 400.
Trueif the response code is 900.
Trueif the response is paid, refunded or canceled.
Also, you can directly access the code or the message defined in Redsys
Please, feel free to send any contribution that maintains the less dependant philosophy.
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
|Filename, size||File type||Python version||Upload date||Hashes|
|Filename, size python_redsys-0.3.0-py3-none-any.whl (9.7 kB)||File type Wheel||Python version py3||Upload date||Hashes View|
|Filename, size python-redsys-0.3.0.tar.gz (9.9 kB)||File type Source||Python version None||Upload date||Hashes View|
Hashes for python_redsys-0.3.0-py3-none-any.whl