django-pagseguro 1.4.2

A pluggable Django application for integrating PagSeguro payment system

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:

Author

Fábio Cerqueira

Pip

django-pagseguro==1.4.2

Classifiers

  • Framework :: Django
  • Intended Audience :: Developers
  • Operating System :: OS Independent
  • Topic :: Software Development
  • Intended Audience :: System Administrators
File Type Python Version Uploaded On Downloads
django-pagseguro-1.4.2.tar.gz Source Nov. 22, 2013 1,940
Version Release Date
1.4.2 Nov. 22, 2013
1.4.1 Nov. 7, 2013
1.4 June 12, 2013
1.3 June 7, 2013
1.2.2 Aug. 29, 2012
1.2.1 Aug. 29, 2012
1.2 Aug. 29, 2012
1.1.2 Aug. 29, 2012
1.1.1 Aug. 29, 2012
1.1 Aug. 29, 2012
1.0 Aug. 29, 2012
beta Aug. 26, 2015
Date Package Version Action
Aug. 26, 2015, 12:19 a.m. django-pagseguro 1.1.1 Release Created
Aug. 26, 2015, 12:19 a.m. django-pagseguro 1.2.1 Release Created
Aug. 26, 2015, 12:19 a.m. django-pagseguro 1.2.2 Release Created
Aug. 26, 2015, 12:19 a.m. django-pagseguro beta Release Created
Aug. 26, 2015, 12:19 a.m. django-pagseguro 1.3 Release Created
Aug. 26, 2015, 12:19 a.m. django-pagseguro 1.2 Release Created
Aug. 26, 2015, 12:19 a.m. django-pagseguro 1.1 Release Created
Aug. 26, 2015, 12:19 a.m. django-pagseguro 1.0 Release Created
Aug. 26, 2015, 12:19 a.m. django-pagseguro 1.1.2 Release Created
Aug. 26, 2015, 12:19 a.m. django-pagseguro 1.4.2 Release Created
Aug. 26, 2015, 12:19 a.m. django-pagseguro 1.4.1 Release Created
Aug. 26, 2015, 12:19 a.m. django-pagseguro 1.4 Release Created
Aug. 26, 2015, 12:19 a.m. django-pagseguro Package Created