Skip to main content

A pluggable Django application for integrating PagSeguro payment system

Project description

https://secure.travis-ci.org/fabiocerqueira/django-pagseguro.png?branch=master https://coveralls.io/repos/fabiocerqueira/django-pagseguro/badge.png?branch=master https://pypip.in/v/django-pagseguro/badge.png https://pypip.in/d/django-pagseguro/badge.png

Aplicação para facilitar integração do django com pagseguro.

Configurando a app django-pagseguro

Adicione a app no INSTALLED_APPS no settings.py

INSTALLED_APPS = (
    ...
    'django_pagseguro',
    ...
)

Configure no settings.py as constantes necessárias para utilizar a app.

PAGSEGURO_EMAIL_COBRANCA = 'seu@email.com' # email de cobrança usado no pagseguro
PAGSEGURO_TOKEN = '1a3ea7wq2e7eq8e1e223add23ad23' # token gerado no sistema de url de retorno do pagseguro
PAGSEGURO_URL_RETORNO = '/pagseguro/retorno/' # url para receber o POST de retorno do pagseguro
PAGSEGURO_URL_FINAL = '/obrigado/' # url final para redirecionamento
PAGSEGURO_ERRO_LOG  = '/tmp/pagseguro_erro.log' # arquivo para salvar os erros de validação de retorno com o pagseguro(opcional)

Configure a rota para url de retorno do PagSeguro no urls.py

from django_pagseguro.urls import pagseguro_urlpatterns
...
urlpatterns += pagseguro_urlpatterns()

Criando o Carrinho

Importe o Carrinho do PagSeguro

from django_pagseguro.pagseguro import ItemPagSeguro, CarrinhoPagSeguro

Configure o carrinho do PagSeguro de acordo com seu projeto, no exemplo abaixo compra de Crédito

carrinho = CarrinhoPagSeguro(ref_transacao=1)
carrinho.set_cliente(email='email@cliente.com', cep='60000000')
carrinho.add_item(ItemPagSeguro(cod=1, descr='Crédito', quant=1, valor=35.53))
form_pagseguro = carrinho.form()    # Form do pagseguro para usar no template de acordo com as configurações

Capturando sinais do retorno

O django-pagseguro foi feito para que o desenvolvedor decida como vai tratar o retorno do PagSeguro, portanto os dados enviados pelo PagSeguro não são alterados, eles são encaminhados através de um signal do django.

Existem duas opções para capturar o retorno, de forma global ou específica para cada estado do pagamento.

Signal Global:

  • pagamento_atualizado: dispara em qualquer atualização do pagamento

Signals específicos para cada status do pagamento:

  • pagamento_aprovado: Aprovado
  • pagamento_cancelado: Cancelado
  • pagamento_aguardando: Aguardando Pagamento
  • pagamento_em_analise: Em Análise
  • pagamento_completo: Completo
  • pagamento_devolvido: Devolvido

Capturando o sinal e processando os dados de retorno do PagSeguro

from django_pagseguro.signals import pagamento_aprovado
...
def liberar_pedido(sender, **kwargs):
    ref = sender.referencia
    tipo_pagamento = sender.dados['TipoPagamento'] # exemplo de como pegar informações enviada pelo PagSeguro
    # aqui você deve executar seu código para liberar o pedido para a Referência
...
pagamento_aprovado.connect(liberar_pedido)

Configurando logs

Caso queira configurar os logs, você deve fazer conforme a documentação do Django sobre a configuração de logs, por exemplo:

LOGGING = {
    ...
    'loggers': {
        'django_pagseguro': {
            'handlers': ['console'],
            'level': 'INFO',
        }
    }
    ...
}

Referências

Projetos que inspiraram esse:

Documentação do PagSeguro:

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
django-pagseguro-1.4.2.tar.gz (8.5 kB) Copy SHA256 hash SHA256 Source None Nov 22, 2013

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page