djpg is a Django module that integrates with the online payment service PagSeguro.
It will not touch your database neither alter your Django installation, djpg simply provides the machinery for you to send and receive requests from PagSeguro in a clean and pythonic way.
Simply run:
$ pip install djpgAfter installing, the only configurations required are PAGSEGURO_EMAIL and PAGSEGURO_TOKEN. You should add them to your settings.py file. The first is your signup email from PagSeguro, the other is the token they'll give you when you have a seller account. For example:
PAGSEGURO_EMAIL = '[email protected]'
PAGSEGURO_TOKEN = '78W52AQQ9Q8Q7D45S98AS8715SAQLEB1'from djpg import Cart, Item
def my_checkout_view(request):
cart = Cart(reference='myref123', redirect_url='https://mysite.com/')
item = Item(id=1, amount=19.50, description='Cool T-shirts!', quantity=2)
cart.add_item(item)
code = cart.checkout()
if code:
# This will redirect the user to the checkout page,
# where the cart can be paid.
return cart.proceed(code)The following snippet will ensure djpg receives notifications from PagSeguro and dispatch them to the respective signals.
urlpatterns += patterns('',
url(r'^pagseguro/', include('djpg.urls'))
)Keep in mind that this endpoint needs to be configured in your PagSeguro account also (e.g.: https://mysite.com/pagseguro/notifications/). Then you can connect listeners to the signals that are relevant to you.
from djpg.signals import transaction_paid
def on_paid(sender, **kwargs):
transaction = kwargs.pop('transaction')
ref = transaction['reference']
status = transaction['status']
# ...
transaction_paid.connect(on_paid)The following signals are available:
- notification_received
- transaction_received
- transaction_waiting
- transaction_analysis
- transaction_paid
- transaction_available
- transaction_dispute
- transaction_returned
- transaction_canceled
- transaction_unknown