معرفی شرکت ها
django-satispaython-0.1.4
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشترتوضیحات
A simple django app to manage Satispay payments following the Web-button flow.
| ویژگی | مقدار |
|---|---|
| سیستم عامل | - |
| نام فایل | django-satispaython-0.1.4 |
| نام | django-satispaython |
| نسخه کتابخانه | 0.1.4 |
| نگهدارنده | [] |
| ایمیل نگهدارنده | [] |
| نویسنده | Daniele Pira |
| ایمیل نویسنده | daniele.pira@otto.to.it |
| آدرس صفحه اصلی | https://github.com/otto-torino/django-satispaython |
| آدرس اینترنتی | https://pypi.org/project/django-satispaython/ |
| مجوز | GPL-3.0-or-later |
# django-satispaython
A simple django app to manage Satispay payments following the [Web-button flow](https://developers.satispay.com/docs/web-button-pay).
## Requirements
* python >= 3.6
* django >= 3
* [`satispaython`](https://github.com/otto-torino/satispaython) >= 0.2
## Installation
You can install this package with pip: `pip install django-satispaython`.
## Usage
### Key generation and key-id
In order to use django-satispaython you need to generate a [RSA private key](https://developers.satispay.com/reference#genereate-rsa-keys) and then get a [key-id](https://developers.satispay.com/reference#keyid).
Django-satispaython is based on [satispaython](https://github.com/otto-torino/satispaython) so you can import it, [create a key](https://github.com/otto-torino/satispaython#key-generation) and [obtain a key-id](https://github.com/otto-torino/satispaython#obtain-a-key-id-using-a-token).
### Configuration
Once you created a RSA key and got a key-id add django-satispaython to your INSTALLED_APPS:
```python
INSTALLED_APPS = (
#...
'django_satispaython.apps.DjangoSatispaythonConfig',
#...
)
```
Then add the followings to you django settings:
```python
SATISPAYTHON_PRIVATE_KEY_PATH = '/path/to/my/key.pem'
SATISPAYTHON_KEY_ID_PATH = '/path/to/my/key-id.txt'
SATISPAYTHON_STAGING = True
```
* `SATISPAYTHON_PRIVATE_KEY_PATH`: the path of your PEM file containing the RSA private key used to get your key-id.
* `SATISPAYTHON_KEY_ID_PATH`: the path of the file containing the key-id coupled with the private-key.
* `SATISPAYTHON_STAGING`: if `True` django-satispaython will use the [Sandbox](https://developers.satispay.com/docs/sandbox-account) endpoints.
### Satispay API
In order to use the [Satispay API](https://developers.satispay.com/reference) import django-satispaython.api:
```python
from django_satispaython import api as satispay
```
Then you can:
#### Create a payment
```python
satispay.create_payment(amount_unit, currency, callback_url, expiration_date=None, external_code=None, metadata=None, idempotency_key=None)
```
You may use satispaython utility function [`format_datetime`](https://github.com/otto-torino/satispaython#create-a-payment) to get a correctly formatted `expiration_date` to supply to the request.
#### Get payment details
```python
satisapy.get_payment_details(payment_id)
```
## Templatetags
In order to render the Satispay button just load the tag and use it in the template:
```
{% load django_satispaython %}
...
{% satispay_button payment_id=<your_payment_id> %}
```
Note that the button will automatically point at the endpoint (production or sandbox) specified in the project [`settings`](https://github.com/otto-torino/django-satispaython#configuration).
## Database and Admin
Django-satispaython comes with a SatispayPayment model which contains every info associated to a payment and is automatically showed in the admin page.
> :information_source: All the Satispay API functions return an instance of the SatispayPayment model *without* actually storing it by default.
If you want to store a newly created payment in the database or update an already existing one with the informations provided by the response, set the `update` parameter to `True`.
```python
satispay.create_payment(amount_unit, currency, callback_url, expiration_date=None, external_code=None, metadata=None, idempotency_key=None, update=True)
satisapy.get_payment_details(payment_id, update=True)
```
In this case an output similar to django's [`update_or_create`](https://docs.djangoproject.com/en/3.1/ref/models/querysets/#update-or-create) will be returned.
## TODOS
* Signals
* ImproperlyConfiguredException
نیازمندی
| مقدار | نام |
|---|---|
| >=3,<4 | django |
| - | satispaython |
زبان مورد نیاز
| مقدار | نام |
|---|---|
| >=3.6,<4.0 | Python |
نحوه نصب
نصب پکیج whl django-satispaython-0.1.4:
pip install django-satispaython-0.1.4.whl
نصب پکیج tar.gz django-satispaython-0.1.4:
pip install django-satispaython-0.1.4.tar.gz