LiqPay Python3 SDK
Project description
|liqpaylogo| image:: https://www.liqpay.ua/1508940109424071/static/img/images/logo.svg
===== |liqpaylogo| SDK-Python
:Version: 1.0.2 :Web: https://www.liqpay.ua/ :Download: https://pypi.org/project/liqpay-sdk-python3/ :Source: https://github.com/aorzh/liqpay-sdk-python3 :Documentation: https://www.liqpay.ua/documentation/en/ :Keywords: liqpay, privat24, privatbank, python, internet acquiring, P2P payments, two-step payments
What python version is supported?
- Python 3.4, 3.5, 3.6
Get Started
- Sign up in https://www.liqpay.ua/en/authorization.
- Create a company.
- In company settings, on API tab, get Public key and Private key.
- Done.
Installation
From pip :: $ pip install liqpay-sdk-python3
Working with LiqPay Callback locally
If you need debugging API Callback on local environment use https://localtunnel.github.io/www/
How it use?
Example 1: Basic
Backend
::
liqpay = LiqPay(public_key, private_key)
html = liqpay.cnb_form({
'action': 'pay',
'amount': '1',
'currency': 'USD',
'description': 'description text',
'order_id': 'order_id_1',
'version': '3'
})
Frontend
Variable html
will contain next html form
::
<form method="POST" action="https://www.liqpay.ua/api/3/checkout" accept-charset="utf-8">
<input type="hidden" name="data" value="eyAidmVyc2lvbiIgOiAzLCAicHVibGljX2tleSIgOiAieW91cl9wdWJsaWNfa2V5IiwgImFjdGlv
biIgOiAicGF5IiwgImFtb3VudCIgOiAxLCAiY3VycmVuY3kiIDogIlVTRCIsICJkZXNjcmlwdGlv
biIgOiAiZGVzY3JpcHRpb24gdGV4dCIsICJvcmRlcl9pZCIgOiAib3JkZXJfaWRfMSIgfQ=="/>
<input type="hidden" name="signature" value="QvJD5u9Fg55PCx/Hdz6lzWtYwcI="/>
<input type="image"
src="//static.liqpay.ua/buttons/p1ru.radius.png"/>
</form>
Example 2: Integrate Payment widget to Django
Payment widget documentation
_
.. _Payment widget documentation
:
https://www.liqpay.ua/documentation/en/api/aquiring/widget/
Backend
views.py
::
from liqpay import LiqPay
from django.views.generic import TemplateView
from django.shortcuts import render
from django.http import HttpResponse
class PayView(TemplateView):
template_name = 'billing/pay.html'
def get(self, request, *args, **kwargs):
liqpay = LiqPay(settings.LIQPAY_PUBLIC_KEY, settings.LIQPAY_PRIVATE_KEY)
params = {
'action': 'pay',
'amount': '100',
'currency': 'USD',
'description': 'Payment for clothes',
'order_id': 'order_id_1',
'version': '3',
'sandbox': 0, # sandbox mode, set to 1 to enable it
'server_url': 'https://test.com/billing/pay-callback/', # url to callback view
}
signature = liqpay.cnb_signature(params)
data = liqpay.cnb_data(params)
return render(request, self.template_name, {'signature': signature, 'data': data})
@method_decorator(csrf_exempt, name='dispatch')
class PayCallbackView(View):
def post(self, request, *args, **kwargs):
liqpay = LiqPay(settings.LIQPAY_PUBLIC_KEY, settings.LIQPAY_PRIVATE_KEY)
data = request.POST.get('data')
signature = request.POST.get('signature')
sign = liqpay.str_to_sign(settings.LIQPAY_PRIVATE_KEY + data + settings.LIQPAY_PRIVATE_KEY)
if sign == signature:
print('callback is valid')
response = liqpay.decode_data_from_str(data)
print('callback data', response)
return HttpResponse()
urls.py
::
from django.conf.urls import url
from billing.views import PayView, PayCallbackView
urlpatterns = [
url(r'^pay/$', PayView.as_view(), name='pay_view'),
url(r'^pay-callback/$', PayCallbackView.as_view(), name='pay_callback'),
]
Frontend
::
<div id="liqpay_checkout"></div>
<script>
window.LiqPayCheckoutCallback = function() {
LiqPayCheckout.init({
data: "{{ data }}",
signature: "{{ signature }}",
embedTo: "#liqpay_checkout",
mode: "embed" // embed || popup,
}).on("liqpay.callback", function(data){
console.log(data.status);
console.log(data);
}).on("liqpay.ready", function(data){
// ready
}).on("liqpay.close", function(data){
// close
});
};
</script>
<script src="//static.liqpay.ua/libjs/checkout.js" async></script>
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for liqpay_sdk_python3-1.0.2-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 795e0cdad2867cd667faf86a00615ba864ab9b35d15ef2a27e3b855c65b82785 |
|
MD5 | 83bf8ac99b03e5e2a5e03397a61e64ca |
|
BLAKE2b-256 | 7ae2ded2e4e4f9583cc37f75045e7a26c589dbce23fa6e6e1d3c364e98b581ce |