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.