Integracja PayU z Django - Prosty sposób na dodanie płatności do aplikacji

Współczesne aplikacje internetowe coraz częściej wymagają integracji z systemami płatności, a jednym z popularniejszych rozwiązań na rynku jest PayU. Jeśli pracujesz z frameworkiem Django, być może zastanawiasz się, jak zintegrować tę popularną metodę płatności w swojej aplikacji. W tym artykule pokażemy Ci, jak to zrobić, oraz przeprowadzimy Cię przez przykłady kodu, które pomogą Ci zrealizować tę integrację.

Czym jest PayU i dlaczego warto go używać?

PayU to jeden z liderów rynku płatności online, oferujący szeroki wachlarz usług dla sklepów internetowych i aplikacji. Jest to system umożliwiający łatwe przeprowadzanie transakcji w internecie, wspierający różne metody płatności, w tym karty kredytowe, przelewy online, BLIK, portfele elektroniczne i inne. Dzięki PayU użytkownicy mogą szybko i bezpiecznie dokonywać płatności, a Ty jako właściciel aplikacji – zarządzać transakcjami i generować raporty.

Integracja PayU z Django to dobry sposób na umożliwienie użytkownikom dokonywania płatności w prosty sposób, bez konieczności budowania własnego systemu płatności od podstaw. Dzięki odpowiedniej integracji zaoszczędzisz czas i zasoby, jednocześnie oferując profesjonalne i bezpieczne rozwiązanie.

Jak zacząć integrację Django z PayU?

Integracja PayU z Django jest procesem stosunkowo prostym, zwłaszcza jeśli masz doświadczenie z tworzeniem aplikacji internetowych. Wykorzystamy dostępne API PayU, aby umożliwić użytkownikom dokonywanie płatności. Do pracy z PayU będziemy używać oficjalnej biblioteki Django, którą należy zainstalować i skonfigurować. W poniższym przykładzie pokażemy, jak to zrobić.

Kroki integracji Django z PayU

Przede wszystkim musisz wykonać kilka kroków, aby prawidłowo skonfigurować płatności PayU w swojej aplikacji Django. Oto ogólny przegląd tych kroków:

• Załóż konto w PayU - Musisz zarejestrować się na platformie PayU i uzyskać dostęp do swoich kluczy API.
• Zainstaluj bibliotekę do Django - Aby łatwiej pracować z API, warto zainstalować odpowiednią bibliotekę, np. django-payments lub użyć REST API PayU.
• Skonfiguruj ustawienia w Django - W pliku ustawień Django dodaj wszystkie wymagane klucze API i inne konfiguracje.
• Stwórz model płatności - Musisz stworzyć odpowiedni model, który będzie przechowywał informacje o płatnościach w Twojej aplikacji.
• Dodaj formularz płatności - Użyj formularza, aby umożliwić użytkownikom dokonywanie płatności.
• Przetwarzaj transakcje - Po zakończeniu transakcji należy zaktualizować stan płatności i poinformować użytkownika o jej wyniku.

Instalacja django-payments

Jednym z najprostszych sposobów integracji PayU z Django jest użycie pakietu django-payments, który obsługuje różne systemy płatności, w tym PayU. Aby go zainstalować, wystarczy wykonać poniższe polecenie:

pip install django-payments

Po zainstalowaniu pakietu, należy go dodać do pliku settings.py w sekcji INSTALLED_APPS:

INSTALLED_APPS = [
    ...
    'payments',
]

Konfiguracja kluczy API PayU

Aby zintegrować PayU, musisz posiadać odpowiednie klucze API, które otrzymasz po założeniu konta na platformie PayU. Wartością kluczową jest tutaj merchant pos id, pos auth key oraz pos security key. Te dane będziesz musiał dodać do pliku settings.py Twojej aplikacji Django:

PAYU_MERCHANT_POS_ID = 'TwojePosID'
PAYU_POS_AUTH_KEY = 'TwojAuthKey'
PAYU_POS_SECURITY_KEY = 'TwojSecurityKey'

Model płatności w Django

Teraz, gdy masz zainstalowaną bibliotekę i skonfigurowane klucze API, czas na stworzenie modelu płatności, który będzie przechowywał wszystkie informacje związane z transakcjami użytkowników. Model ten może wyglądać następująco:

from django.db import models
from payments.models import BasePayment

class Payment(BasePayment):
    amount = models.DecimalField(max_digits=10, decimal_places=2)
    status = models.CharField(max_length=100, choices=(
        ('pending', 'Pending'),
        ('completed', 'Completed'),
        ('failed', 'Failed'),
    ), default='pending')
    transaction_id = models.CharField(max_length=255)

Model ten przechowuje podstawowe informacje o płatności, takie jak kwota transakcji, status płatności oraz unikalny identyfikator transakcji.

Formularz płatności

Aby umożliwić użytkownikom dokonywanie płatności, musisz stworzyć formularz, który wyśle dane do systemu PayU. Możesz to zrobić za pomocą formularza HTML w Django. Przykład prostego formularza płatności:

Po wysłaniu formularza użytkownik zostanie przekierowany na stronę PayU, gdzie będzie mógł dokończyć płatność. Po zakończeniu transakcji system PayU zwróci odpowiedni komunikat, który będziesz musiał przetworzyć w aplikacji.

Przetwarzanie wyników płatności

Po zakończeniu płatności, PayU zwróci odpowiedni komunikat (tzw. callback), który zawiera informacje o statusie płatności. Musisz zaimplementować widok, który odbierze te dane i odpowiednio zaktualizuje status płatności w Twojej aplikacji Django.

from django.http import HttpResponse
from .models import Payment

def payment_callback(request):
    transaction_id = request.GET['transaction_id']
    payment_status = request.GET['status']
    
    try:
        payment = Payment.objects.get(transaction_id=transaction_id)
        payment.status = payment_status
        payment.save()
    except Payment.DoesNotExist:
        return HttpResponse("Nie znaleziono płatności", status=404)
    
    return HttpResponse("Płatność została przetworzona", status=200)

Ten kod odbiera dane z PayU i aktualizuje status płatności w systemie. Na koniec wyświetla odpowiedni komunikat użytkownikowi.

Podsumowanie

Integracja PayU z Django jest stosunkowo prosta i daje szerokie możliwości w zakresie obsługi płatności online. Dzięki bibliotece django-payments, integracja staje się jeszcze łatwiejsza i pozwala na szybkie uruchomienie płatności w Twojej aplikacji. Powyższe przykłady pozwalają na stworzenie podstawowej integracji z PayU, która może być dostosowana do indywidualnych potrzeb Twojej aplikacji.

Jeśli chcesz, aby Twoja aplikacja umożliwiała płatności online w prosty i bezpieczny sposób, z pewnością warto zainwestować czas w integrację z PayU. Jest to rozwiązanie, które świetnie sprawdza się w przypadku sklepów internetowych, aplikacji do sprzedaży usług oraz wszędzie tam, gdzie wymagana jest szybka i efektywna obsługa płatności online.