django-pagseguro API

Documentação detalha da interface de desenvolvimento para construção de um carrinho de compras

CarrinhoPagSeguro

class django_pagseguro.pagseguro.CarrinhoPagSeguro(email_cobranca='seu@email.com', **kwargs)

CarrinhoPagSeguro deve ser criado para gerar o Form para o PagSeguro.

As configurações do carrinho, cliente e itens do pedido são definidas usando esta classe.

A configuração geral dos atributos do carrinho é feita no atributo self.config. Os possíveis atributos podem ser encontrados na documentação oficial do PagSeguro:

Configurações do cliente devem ser feitas através do método set_cliente.

Para adicionar items ao carrinho use método add_item.

Para obter o HTML do Form do PagSeguro com o botão de Comprar use o método form.

add_item(item)

Adiciona um novo item ao carrinho.

Para mais informações, consulte a documentação da classe ItemPagSeguro

form(template='pagseguro_form.html')

Realiza o render do formulário do PagSeguro baseado no template.

Por padrão, o template usado é ‘django_pagaseguro/templates/pagseguro_form.html’, porém é possível sobrescrever o template ou passar outro template que desejar como parâmetro.

set_cliente(**kwargs)

Define as configurações do cliente. Essas informações são opcionais, mas, se existirem essa informações, é interessante defini-las para facilitar para o cliente no site do PagSeguro.

Os campos válidos são: nome, cep, end, num, compl, bairro, cidade, uf, pais, ddd, tel e email.

IMPORTANTE: Todos os valores devem ser passados como parâmetros nomeados.

ItemPagSeguro

class django_pagseguro.pagseguro.ItemPagSeguro(cod, descr, quant, valor, frete=0, peso=0)

ItemPagSeguro é usado no CarrinhoPagSeguro para representar cada Item de compra.

O frete e o valor são convertidos para o formato exigido pelo PagSeguro. Regra do PagSeguro: valor real * 100.

Dinheiro Decimal/Float PagSeguro
R$ 1,50 1.50 150
R$ 32,53 32.53 3253