Solicitando um Pagamento¶

Esta é a classe principal do PagSeguro-Python. Todo o processo de pagamento é realizado através dela.

O mínimo necessário para fazer uma solicitação de pagamento é:

• Criar uma instância de Payment passando o seu email e token.
• Adicionar um ou mais itens.
• Chamar o método request()
• Ler o atributo payment_url para obter a URL para a qual o comprador deve ser redirecionado

Mas é possível também definir outros atributos:

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)¶

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

Exemplos:

>>> payment = Payment(email=local_settings.PAGSEGURO_ACCOUNT_EMAIL, token=local_settings.PAGSEGURO_TOKEN)
>>> payment.add_item(item_id=u'id-do-item-1', description=u'Desc. do produto', amount=7, quantity=2)
>>> payment.add_item(item_id=u'id-do-item-2', description=u'Um outro produto', amount=24.1, quantity=2)
>>> payment.set_client(name=u'Adam Yauch', phone_area_code=11, phone_number=12341234, cpf='93537621701')
>>> payment.set_shipping(cost=1.2)
>>> payment.request()
>>> url = payment.payment_url