python-cielo

Biblioteca para autorização e captura de pagamentos pelo webservice da Cielo.

Autorização e captura

Para efetuar uma transação utilize o seguinte modelo:

from decimal import Decimal
from cielo import PaymentAttempt, GetAuthorizedException

params = {
    'affiliation_id': '1234567890',
    'api_key': 'ABCDEFG123456789',
    'card_type': PaymentAttempt.VISA,
    'total': Decimal('1.00'),
    'order_id': '7DSD163AH1',  # strings são permitidas
    'card_number': '4012001037141112',
    'cvc2': 423,  # código de segurança
    'exp_month': 1,
    'exp_year': 2010,
    'transaction': PaymentAttempt.CASH,
    'card_holders_name': 'JOAO DA SILVA',
    'installments': 1,
}

attempt = PaymentAttempt(**params)
try:
    attempt.get_authorized()
except GetAuthorizedException, e:
    print u'Não foi possível processar: %s' % e
else:
    attempt.capture()

Parâmetros

Verifique abaixo a lista de parâmetros esperados no construtor da classe PaymentAttempt.

Atributo Descrição Observações
affiliation_id Número de afiliação junto à Cielo  
api_key Chave de acesso para o webservice  
card_type Bandeira do cartão Veja as bandeiras suportadas
total Valor total do pedido (utilizar Decimal)  
order_id Identificador único do pedido  
card_number Número do cartão (sem pontos)  
cvc2 Código de segurança  
exp_month Mês de vencimento  
exp_year Ano de vencimento  
card_holders_name Nome impresso no cartão  
installments Número de parcelas  
transaction Tipo da transação / parcelamento Veja os tipos de transações suportados
sandbox Ambiente de desenvolvimento Default: False

Bandeiras suportadas

Atualmente as seguintes bandeiras são suportadas:

  • Visa: PaymentAttempt.VISA
  • Mastercard: PaymentAttempt.MASTERCARD
  • Diners: PaymentAttempt.DINERS
  • Discover: PaymentAttempt.DISCOVER
  • ELO: PaymentAttempt.ELO
  • American express: PaymentAttempt.AMEX

Tipos de transações

Atualmente os seguintes tipos de transações são suportados:

  • À vista (uma parcela): PaymentAttempt.CASH
  • Parcelado pelo estabelecimento: PaymentAttempt.INSTALLMENT_STORE
  • Parcelado pela emissora: PaymentAttempt.INSTALLMENT_CIELO

Warning

Antes de iniciar as vendas, verifique as taxas de cada tipo de transação junto à Cielo.

Indices and tables