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