pagseguro.api.v2 package

Submodules

pagseguro.api.v2.notification module

class pagseguro.api.v2.notification.Notification(email, token, notification_code)[source]

Bases: object

Classe para tratamento das notificações sobre o status de pagamentos

pagseguro.api.v2.payment module

class pagseguro.api.v2.payment.Payment(email, token, receiver_email=None, currency='BRL', reference=None, extra_amount=None, redirect_url=None, notification_url=None, max_uses=None, max_age=None, **kwargs)[source]

Bases: pagseguro.api.base_payment.BasePaymentRequest

Classe que implementa a requisição à API do PagSeguro versão 2

Parameters:
  • email (str) – (obrigatório) O email da sua conta no PagSeguro
  • token (str) – (obrigatório) O seu token de acesso ao PagSeguro
  • receiver_email (str) – (opcional)
  • currency (str) – (opcional) A moeda a ser utilizada. Nesta versão apenas o valor BRL é aceito e ele é definido por padrão. Não se preocupe com este parâmetro.
  • reference (str) – (opcional) Um identificador para a transação. Você irá utilizar este valor posteriormente para identificar as transações.
  • extra_amount (float) – (opcional) Um valor extra que deve ser adicionado ou subtraído ao valor total do pagamento.
  • redirect_url (str) – (opcional) URL para a qual o comprador será redirecionado após o final do fluxo de pagamento. Tamanho máximo de 255 caracteres.
  • notification_url (str) – (opcional) URL para a qual o PagSeguro enviará os códigos de notificação relacionados ao pagamento. Toda vez que houver uma mudança no status da transação e que demandar sua atenção, uma nova notificação será enviada para este endereço.
  • max_uses (int) – Determina o número máximo de vezes que o código de pagamento criado pela chamada à API de Pagamentos poderá ser usado. Este parâmetro pode ser usado como um controle de segurança.
  • max_age (int) – (opcional) Determina o prazo (em segundos) durante o qual o código de pagamento criado pela chamada à API de Pagamentos poderá ser usado. Este parâmetro pode ser usado como um controle de segurança
add_item(item_id, description, amount, quantity, shipping_cost=None, weight=None)[source]
api_version()[source]
payment_url()[source]

Retorna a url para onde o cliente deve ser redirecionado para continuar o fluxo de pagamento.

Returns:str, URL de pagamento
request()[source]

Faz a requisição de pagamento ao servidor do PagSeguro.

set_client(*args, **kwargs)[source]

Se você possui informações cadastradas sobre o comprador você pode utilizar este método para enviar estas informações para o PagSeguro. É uma boa prática pois evita que seu cliente tenha que preencher estas informações novamente na página do PagSeguro.

Parameters:
  • name (str) – (opcional) Nome do cliente
  • email (str) – (opcional) Email do cliente
  • phone_area_code (str) – (opcional) Código de área do telefone do cliente. Um número com 2 digitos.
  • phone_number (str) – (opcional) O número de telefone do cliente.
  • cpf – (str): (opcional) Número do cpf do comprador
  • born_date – (date): Data de nascimento no formato dd/MM/yyyy
Exemplo:
>>> from pagseguro import Payment
>>> from pagseguro import local_settings
>>> payment = Payment(email=local_settings.PAGSEGURO_ACCOUNT_EMAIL, token=local_settings.PAGSEGURO_TOKEN)
>>> payment.set_client(name=u'Adam Yauch', phone_area_code=11)
set_shipping(*args, **kwargs)[source]

Define os atributos do frete

Parameters:
  • type (int) – (opcional) Tipo de frete. Os valores válidos são: 1 para ‘Encomenda normal (PAC).’, 2 para ‘SEDEX’ e 3 para ‘Tipo de frete não especificado.’
  • cost (float) – (opcional) Valor total do frete. Deve ser maior que 0.00 e menor ou igual a 9999999.00.
  • street (str) – (opcional) Nome da rua do endereço de envio do produto
  • address_number – (opcional) Número do endereço de envio do produto.
  • complement – (opcional) Complemento (bloco, apartamento, etc.) do endereço de envio do produto.
  • district – (opcional) Bairro do endereço de envio do produto.
  • postal_code – (opcional) CEP do endereço de envio do produto.
  • city – (opcional) Cidade do endereço de envio do produto.
  • state – (opcional) Estado do endereço de envio do produto.
  • country – (opcional) País do endereço de envio do produto. Apenas o valor ‘BRA’ é aceito.
pagseguro.api.v2.payment.payment_v2_schema = <voluptuous.Schema object at 0x236cbd0>

Schema utilizado para validar os atributos da classe Payment da versão 2 da API ..todo:: Verificar porque a validação de URLs não está funcionando

pagseguro.api.v2.schemas module

pagseguro.api.v2.schemas.client_schema = <voluptuous.Schema object at 0x34d3690>

pagseguro.api.v2.settings module

Module contents