├── .editorconfig ├── .gitignore ├── LICENSE ├── README.md ├── cieloApi3 ├── __init__.py ├── address.py ├── cieloEcommerce.py ├── creditCard.py ├── customer.py ├── environment.py ├── merchant.py ├── objectJSON.py ├── payment.py ├── recurrentPayment.py ├── request │ ├── __init__.py │ ├── base.py │ ├── createCardToken.py │ ├── createSale.py │ ├── deactivateRecorrency.py │ ├── queryRecorrency.py │ ├── querySale.py │ ├── reactivateRecorrency.py │ └── updateSale.py └── sale.py ├── example ├── saleBoletoComplete.py ├── saleBoletoSimple.py ├── saleCard.py ├── saleCardRecurring.py ├── saleCardRecurringSchedule.py └── saleCardToken.py ├── requirements.txt ├── setup.cfg └── setup.py /.editorconfig: -------------------------------------------------------------------------------- 1 | # http://editorconfig.org 2 | 3 | root = true 4 | 5 | [*] 6 | indent_style = space 7 | indent_size = 4 8 | insert_final_newline = true 9 | trim_trailing_whitespace = true 10 | end_of_line = lf 11 | charset = utf-8 12 | 13 | # Docstrings and comments use max_line_length = 79 14 | [*.py] 15 | max_line_length = 119 16 | 17 | # Use 2 spaces for the HTML files 18 | [*.html] 19 | indent_size = 2 20 | 21 | # The JSON files contain newlines inconsistently 22 | [*.json] 23 | indent_size = 2 24 | insert_final_newline = ignore 25 | 26 | [**/admin/js/vendor/**] 27 | indent_style = ignore 28 | indent_size = ignore 29 | 30 | # Minified JavaScript files shouldn't be changed 31 | [**.min.js] 32 | indent_style = ignore 33 | insert_final_newline = ignore 34 | 35 | # Makefiles always use tabs for indentation 36 | [Makefile] 37 | indent_style = tab 38 | 39 | # Batch files use tabs for indentation 40 | [*.bat] 41 | indent_style = tab 42 | -------------------------------------------------------------------------------- /.gitignore: -------------------------------------------------------------------------------- 1 | # Byte-compiled / optimized / DLL files 2 | __pycache__/ 3 | *.py[cod] 4 | *$py.class 5 | 6 | # C extensions 7 | *.so 8 | 9 | # Distribution / packaging 10 | .Python 11 | env/ 12 | build/ 13 | develop-eggs/ 14 | dist/ 15 | downloads/ 16 | eggs/ 17 | .eggs/ 18 | lib/ 19 | lib64/ 20 | parts/ 21 | sdist/ 22 | var/ 23 | *.egg-info/ 24 | .installed.cfg 25 | *.egg 26 | 27 | # PyInstaller 28 | # Usually these files are written by a python script from a template 29 | # before PyInstaller builds the exe, so as to inject date/other infos into it. 30 | *.manifest 31 | *.spec 32 | 33 | # Installer logs 34 | pip-log.txt 35 | pip-delete-this-directory.txt 36 | 37 | # Unit test / coverage reports 38 | htmlcov/ 39 | .tox/ 40 | .coverage 41 | .coverage.* 42 | .cache 43 | nosetests.xml 44 | coverage.xml 45 | *,cover 46 | .hypothesis/ 47 | 48 | # Translations 49 | *.mo 50 | *.pot 51 | 52 | # Django stuff: 53 | *.log 54 | local_settings.py 55 | 56 | # Flask stuff: 57 | instance/ 58 | .webassets-cache 59 | 60 | # Scrapy stuff: 61 | .scrapy 62 | 63 | # Sphinx documentation 64 | docs/_build/ 65 | 66 | # PyBuilder 67 | target/ 68 | 69 | # IPython Notebook 70 | .ipynb_checkpoints 71 | 72 | # pyenv 73 | .python-version 74 | 75 | # celery beat schedule file 76 | celerybeat-schedule 77 | 78 | # dotenv 79 | .env 80 | 81 | # virtualenv 82 | venv/ 83 | ENV/ 84 | 85 | # Spyder project settings 86 | .spyderproject 87 | 88 | # Rope project settings 89 | .ropeproject 90 | 91 | example/teste.py 92 | 93 | .idea/* 94 | -------------------------------------------------------------------------------- /LICENSE: -------------------------------------------------------------------------------- 1 | MIT License 2 | 3 | Copyright (c) 2017 tMalaca 4 | 5 | Permission is hereby granted, free of charge, to any person obtaining a copy 6 | of this software and associated documentation files (the "Software"), to deal 7 | in the Software without restriction, including without limitation the rights 8 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell 9 | copies of the Software, and to permit persons to whom the Software is 10 | furnished to do so, subject to the following conditions: 11 | 12 | The above copyright notice and this permission notice shall be included in all 13 | copies or substantial portions of the Software. 14 | 15 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 16 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 17 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE 18 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER 19 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, 20 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE 21 | SOFTWARE. 22 | -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | # API-3.0-Python 2 | 3 | SDK API-3.0 Python Cielo 4 | 5 | 6 | 7 | * [Principais recursos](#principais-recursos) 8 | * [Limitações](#limitações) 9 | * [Exemplos](#exemplos) 10 | * [Criando um pagamento com cartão de crédito](#criando-um-pagamento-com-cartão-de-crédito) 11 | * [Criando um pagamento recursivo com cartão de crédito](#criando-um-pagamento-recursivo-com-cartão-de-crédito) 12 | * [Criando um agendamento de pagamento recursivo com cartão de crédito](#criando-um-agendamento-de-pagamento-recursivo-com-cartão-de-crédito) 13 | * [Gerando token de cartão de crédito e criando um pagamento com o token](#gerando-token-de-cartão-de-crédito-e-criando-um-pagamento-com-o-token) 14 | * [Gerando um boleto simples](#gerando-um-boleto-simples) 15 | * [Gerando um boleto completo](#gerando-um-boleto-completo) 16 | * [Manual Oficial da Cielo](#manual-oficial-da-cielo) 17 | 18 | ## Principais recursos 19 | 20 | * [x] Pagamentos por cartão de crédito. 21 | * [x] Pagamentos recorrentes. 22 | * [x] Com autorização na primeira recorrência. 23 | * [x] Com autorização a partir da primeira recorrência. 24 | * [x] Pagamentos por cartão de débito. 25 | * [x] Pagamentos por boleto (Bradesco e Banco do Brasil). 26 | * [ ] Pagamentos por transferência eletrônica. 27 | * [x] Cancelamento de autorização. 28 | * [x] Consulta de pagamentos. 29 | 30 | ## Limitações 31 | 32 | Por envolver a interface de usuário da aplicação, o SDK funciona apenas como um framework para criação das transações. Nos casos onde a autorização é direta, não há limitação; mas nos casos onde é necessário a autenticação ou qualquer tipo de redirecionamento do usuário, o desenvolvedor deverá utilizar o SDK para gerar o pagamento e, com o link retornado pela Cielo, providenciar o redirecionamento do usuário. 33 | 34 | ## Utilizando o SDK 35 | Para criar um pagamento simples com cartão de crédito com o SDK, basta fazer: 36 | 37 | ## Instalação 38 | O API-3.0 Python Cielo pode ser facilmente instalado com o comando a seguir: 39 | ```bash 40 | pip install cieloApi3 41 | ``` 42 | 43 | ## Exemplos 44 | ### Criando um pagamento com cartão de crédito 45 | 46 | ```python 47 | from cieloApi3 import * 48 | 49 | import json 50 | 51 | # Configure o ambiente 52 | environment = Environment(sandbox=True) 53 | 54 | # Configure seu merchant, para gerar acesse: https://cadastrosandbox.cieloecommerce.cielo.com.br/ 55 | merchant = Merchant('MerchantId', 'MerchantKey') 56 | 57 | # Crie uma instância de Sale informando o ID do pagamento 58 | sale = Sale('123') 59 | 60 | # Crie uma instância de Customer informando o nome do cliente 61 | sale.customer = Customer('Fulano de Tal') 62 | 63 | # Crie uma instância de Credit Card utilizando os dados de teste 64 | # esses dados estão disponíveis no manual de integração 65 | credit_card = CreditCard('123', 'Visa') 66 | credit_card.expiration_date = '12/2018' 67 | credit_card.card_number = '0000000000000001' 68 | credit_card.holder = 'Fulano de Tal' 69 | 70 | # Crie uma instância de Payment informando o valor do pagamento 71 | sale.payment = Payment(15700) 72 | sale.payment.credit_card = credit_card 73 | 74 | # Cria instância do controlador do ecommerce 75 | cielo_ecommerce = CieloEcommerce(merchant, environment) 76 | 77 | # Criar a venda e imprime o retorno 78 | response_create_sale = cielo_ecommerce.create_sale(sale) 79 | print '----------------------response_create_sale----------------------' 80 | print json.dumps(response_create_sale, indent=2) 81 | print '----------------------response_create_sale----------------------' 82 | 83 | # Com a venda criada na Cielo, já temos o ID do pagamento, TID e demais 84 | # dados retornados pela Cielo 85 | payment_id = sale.payment.payment_id 86 | 87 | # Com o ID do pagamento, podemos fazer sua captura, 88 | # se ela não tiver sido capturada ainda 89 | response_capture_sale = cielo_ecommerce.capture_sale(payment_id, 15700, 0) 90 | print '----------------------response_capture_sale----------------------' 91 | print json.dumps(response_capture_sale, indent=2) 92 | print '----------------------response_capture_sale----------------------' 93 | 94 | # E também podemos fazer seu cancelamento, se for o caso 95 | response_cancel_sale = cielo_ecommerce.cancel_sale(payment_id, 15700) 96 | print '---------------------response_cancel_sale---------------------' 97 | print json.dumps(response_cancel_sale, indent=2) 98 | print '---------------------response_cancel_sale---------------------' 99 | ``` 100 | 101 | 102 | ### Criando um pagamento recursivo com cartão de crédito 103 | ```python 104 | 105 | from cieloApi3 import * 106 | 107 | import json 108 | 109 | # Configure o ambiente 110 | environment = Environment(sandbox=True) 111 | 112 | # Configure seu merchant, para gerar acesse: https://cadastrosandbox.cieloecommerce.cielo.com.br/ 113 | merchant = Merchant('MerchantId', 'MerchantKey') 114 | 115 | # Crie uma instância de Sale informando o ID do pagamento 116 | sale = Sale('789') 117 | 118 | # Crie uma instância de Customer informando o nome do cliente 119 | sale.customer = Customer('Comprador accept') 120 | 121 | # Crie uma instância de Credit Card utilizando os dados de teste 122 | # esses dados estão disponíveis no manual de integração 123 | credit_card = CreditCard('262', 'Visa') 124 | credit_card.expiration_date = '03/2019' 125 | credit_card.card_number = '1234123412341231' 126 | credit_card.holder = 'Teste Holder' 127 | 128 | recurrent_payment = RecurrentPayment() 129 | recurrent_payment.interval = INTERVAL_SEMIANNUAL 130 | recurrent_payment.end_date = '2019-12-01' 131 | 132 | # Crie uma instância de Payment informando o valor do pagamento 133 | sale.payment = Payment(1500) 134 | sale.payment.recurrent_payment = recurrent_payment 135 | sale.payment.credit_card = credit_card 136 | 137 | # Cria instância do controlador do ecommerce 138 | cielo_ecommerce = CieloEcommerce(merchant, environment) 139 | 140 | # Criar a venda e imprime o retorno 141 | response_create_sale = cielo_ecommerce.create_sale(sale) 142 | print '----------------------response_create_sale----------------------' 143 | print json.dumps(response_create_sale, indent=2) 144 | print '----------------------response_create_sale----------------------' 145 | 146 | 147 | 148 | # Com a venda criada na Cielo, já temos o ID do pagamento, TID e demais 149 | # dados retornados pela Cielo 150 | payment_id = sale.payment.payment_id 151 | 152 | # Com o ID do pagamento, podemos fazer sua captura, 153 | # se ela não tiver sido capturada ainda 154 | response_capture_sale = cielo_ecommerce.capture_sale(payment_id, 15700, 0) 155 | print '----------------------response_capture_sale----------------------' 156 | print json.dumps(response_capture_sale, indent=2) 157 | print '----------------------response_capture_sale----------------------' 158 | 159 | # E também podemos fazer seu cancelamento, se for o caso 160 | response_cancel_sale = cielo_ecommerce.cancel_sale(payment_id, 15700) 161 | print '---------------------response_cancel_sale---------------------' 162 | print json.dumps(response_cancel_sale, indent=2) 163 | print '---------------------response_cancel_sale---------------------' 164 | 165 | 166 | 167 | # Com a venda recorrente criada na Cielo, já temos o ID do pagamento recorrente 168 | recurrent_payment_id = sale.payment.recurrent_payment.recurrent_payment_id 169 | 170 | # Consulta informações da venda recorrente 171 | response_get_recurrent_payment = cielo_ecommerce.get_recurrent_payment(recurrent_payment_id) 172 | print '---------------------response_get_recurrent_payment---------------------' 173 | print json.dumps(response_get_recurrent_payment, indent=2) 174 | print '---------------------response_get_recurrent_payment---------------------' 175 | ``` 176 | 177 | 178 | ### Criando um agendamento de pagamento recursivo com cartão de crédito 179 | ```python 180 | from cieloApi3 import * 181 | 182 | import json 183 | 184 | # Configure o ambiente 185 | environment = Environment(sandbox=True) 186 | 187 | # Configure seu merchant, para gerar acesse: https://cadastrosandbox.cieloecommerce.cielo.com.br/ 188 | merchant = Merchant('MerchantId', 'MerchantKey') 189 | 190 | # Crie uma instância de Sale informando o ID do pagamento 191 | sale = Sale('789') 192 | 193 | # Crie uma instância de Customer informando o nome do cliente 194 | sale.customer = Customer('Comprador rec programada') 195 | 196 | # Crie uma instância de Credit Card utilizando os dados de teste 197 | # esses dados estão disponíveis no manual de integração 198 | credit_card = CreditCard('262', 'Visa') 199 | credit_card.expiration_date = '03/2019' 200 | credit_card.card_number = '1234123412341231' 201 | credit_card.holder = 'Teste Holder' 202 | 203 | recurrent_payment = RecurrentPayment(False) 204 | recurrent_payment.interval = INTERVAL_SEMIANNUAL 205 | recurrent_payment.start_date = '2015-06-01' 206 | recurrent_payment.end_date = '2019-12-01' 207 | 208 | # Crie uma instância de Payment informando o valor do pagamento 209 | sale.payment = Payment(1500) 210 | sale.payment.recurrent_payment = recurrent_payment 211 | sale.payment.credit_card = credit_card 212 | 213 | # Cria instância do controlador do ecommerce 214 | cielo_ecommerce = CieloEcommerce(merchant, environment) 215 | 216 | # Criar a venda e imprime o retorno 217 | response_create_sale = cielo_ecommerce.create_sale(sale) 218 | print '----------------------response_create_sale----------------------' 219 | print json.dumps(response_create_sale, indent=2) 220 | print '----------------------response_create_sale----------------------' 221 | ``` 222 | 223 | ### Gerando token de cartão de crédito e criando um pagamento com o token 224 | ```python 225 | from cieloApi3 import * 226 | 227 | import json 228 | 229 | # Configure o ambiente 230 | environment = Environment(sandbox=True) 231 | 232 | # Configure seu merchant, para gerar acesse: https://cadastrosandbox.cieloecommerce.cielo.com.br/ 233 | merchant = Merchant('MerchantId', 'MerchantKey') 234 | 235 | # Crie uma instância de Credit Card utilizando os dados de teste 236 | # esses dados estão disponíveis no manual de integração 237 | credit_card = CreditCard('123', 'Visa') 238 | credit_card.expiration_date = '12/2018' 239 | credit_card.card_number = '4532117080573700' 240 | credit_card.holder = 'Comprador T Cielo' 241 | credit_card.customer_name = 'Comprador Teste Cielo' 242 | 243 | # Cria instância do controlador do ecommerce 244 | cielo_ecommerce = CieloEcommerce(merchant, environment) 245 | 246 | # Criar a venda e imprime o retorno 247 | response_create_card_token = cielo_ecommerce.create_card_token(credit_card) 248 | print '----------------------response_create_card_token----------------------' 249 | print json.dumps(response_create_card_token, indent=2) 250 | print '----------------------response_create_card_token----------------------' 251 | 252 | # Com o cartão gerado token na Cielo, já temos o Token do cartão para uma futura cobrança 253 | new_card_token = credit_card.card_token 254 | print 'New Card Token:', new_card_token 255 | 256 | # Crie uma instância de Sale informando o ID do pagamento 257 | sale = Sale('456') 258 | 259 | # Crie uma instância de Customer informando o nome do cliente 260 | sale.customer = Customer('Comprador Teste') 261 | 262 | # Crie uma instância de Credit Card utilizando os dados de teste via token 263 | credit_card_token = CreditCard('123', 'Visa') 264 | credit_card_token.card_token = new_card_token 265 | 266 | # Crie uma instância de Payment informando o valor do pagamento 267 | sale.payment = Payment(100) 268 | sale.payment.credit_card = credit_card_token 269 | 270 | # Cria instância do controlador do ecommerce 271 | cielo_ecommerce = CieloEcommerce(merchant, environment) 272 | 273 | # Criar a venda e imprime o retorno 274 | response_create_sale = cielo_ecommerce.create_sale(sale) 275 | print '----------------------response_create_sale----------------------' 276 | print json.dumps(response_create_sale, indent=2) 277 | print '----------------------response_create_sale----------------------' 278 | ``` 279 | 280 | ### Gerando um boleto simples 281 | ```python 282 | from cieloApi3 import * 283 | 284 | import json 285 | 286 | # Configure o ambiente 287 | environment = Environment(sandbox=True) 288 | 289 | # Configure seu merchant, para gerar acesse: https://cadastrosandbox.cieloecommerce.cielo.com.br/ 290 | merchant = Merchant('MerchantId', 'MerchantKey') 291 | 292 | # Crie uma instância de Sale informando o ID do pagamento 293 | sale = Sale('333') 294 | 295 | # Crie uma instância de Customer informando o nome do cliente 296 | sale.customer = Customer('Comprador Teste') 297 | 298 | # Crie uma instância de Payment informando o valor do pagamento 299 | sale.payment = Payment(15700) 300 | sale.payment.type = PAYMENTTYPE_BOLETO 301 | 302 | sale.payment.provider = PROVIDER_BRADESCO 303 | 304 | # Cria instância do controlador do ecommerce 305 | cielo_ecommerce = CieloEcommerce(merchant, environment) 306 | 307 | # Criar a venda e imprime o retorno 308 | response_create_sale = cielo_ecommerce.create_sale(sale) 309 | print '----------------------response_create_sale----------------------' 310 | print json.dumps(response_create_sale, indent=2) 311 | print '----------------------response_create_sale----------------------' 312 | 313 | # Com a venda criada na Cielo, já temos o ID do pagamento, TID e demais 314 | # dados retornados pela Cielo 315 | payment_id = sale.payment.payment_id 316 | 317 | # Com o ID do pagamento, podemos fazer uma consulta do pagamento 318 | response_get_sale = cielo_ecommerce.get_sale(payment_id) 319 | print '----------------------response_get_sale----------------------' 320 | print json.dumps(response_get_sale, indent=2) 321 | print '----------------------response_get_sale----------------------' 322 | 323 | print '\r\nLink Boleto:', sale.payment.url, '\r\n' 324 | ``` 325 | 326 | ### Gerando um boleto completo 327 | ```python 328 | from cieloApi3 import * 329 | 330 | import json 331 | 332 | # Configure o ambiente 333 | environment = Environment(sandbox=True) 334 | 335 | # Configure seu merchant, para gerar acesse: https://cadastrosandbox.cieloecommerce.cielo.com.br/ 336 | merchant = Merchant('MerchantId', 'MerchantKey') 337 | 338 | # Crie uma instância de Sale informando o ID do pagamento 339 | sale = Sale('555') 340 | 341 | # Crie uma instância de Customer informando o nome do cliente 342 | sale.customer = Customer('Comprador Teste') 343 | 344 | # Crie uma instância de Payment informando o valor do pagamento 345 | payment = Payment(15700) 346 | payment.type = PAYMENTTYPE_BOLETO 347 | 348 | payment.provider = PROVIDER_BANCO_DO_BRASIL 349 | payment.address = 'Rua Alegria N: 3 Bairro: Rosa São Paulo-SP' 350 | payment.boleto_number = '123' 351 | payment.assignor = 'Empresa Teste' 352 | payment.demonstrative = 'Demonstrativo Teste' 353 | payment.expiration_date = '2017-06-11' 354 | payment.identification = '11884926754' 355 | payment.instructions = 'Aceitar somente até a data de vencimento, após essa data juros de 1% dia.' 356 | 357 | sale.payment = payment 358 | 359 | # Cria instância do controlador do ecommerce 360 | cielo_ecommerce = CieloEcommerce(merchant, environment) 361 | 362 | # Criar a venda e imprime o retorno 363 | response_create_sale = cielo_ecommerce.create_sale(sale) 364 | print '----------------------response_create_sale----------------------' 365 | print json.dumps(response_create_sale, indent=2) 366 | print '----------------------response_create_sale----------------------' 367 | 368 | # Com a venda criada na Cielo, já temos o ID do pagamento, TID e demais 369 | # dados retornados pela Cielo 370 | payment_id = sale.payment.payment_id 371 | 372 | # Com o ID do pagamento, podemos fazer uma consulta do pagamento 373 | response_get_sale = cielo_ecommerce.get_sale(payment_id) 374 | print '----------------------response_get_sale----------------------' 375 | print json.dumps(response_get_sale, indent=2) 376 | print '----------------------response_get_sale----------------------' 377 | 378 | print '\r\nLink Boleto:', sale.payment.url, '\r\n' 379 | ``` 380 | 381 | ## Manual Oficial da Cielo 382 | 383 | Para mais informações sobre a integração com a API 3.0 da Cielo, vide o manual em: [Integração API 3.0](https://developercielo.github.io/Webservice-3.0/) 384 | -------------------------------------------------------------------------------- /cieloApi3/__init__.py: -------------------------------------------------------------------------------- 1 | from .environment import * 2 | from .merchant import * 3 | 4 | from .sale import * 5 | from .customer import * 6 | from .creditCard import * 7 | from .payment import * 8 | 9 | from .recurrentPayment import * 10 | 11 | from .cieloEcommerce import * 12 | -------------------------------------------------------------------------------- /cieloApi3/address.py: -------------------------------------------------------------------------------- 1 | 2 | class Address(object): 3 | 4 | def __init__(self): 5 | 6 | self.street = None 7 | self.number = None 8 | self.complement = None 9 | self.zip_code = None 10 | self.city = None 11 | self.state = None 12 | self.country = None 13 | -------------------------------------------------------------------------------- /cieloApi3/cieloEcommerce.py: -------------------------------------------------------------------------------- 1 | 2 | from .request.createSale import CreateSale 3 | from .request.querySale import QuerySale 4 | from .request.updateSale import UpdateSale 5 | from .request.createCardToken import CreateCardToken 6 | from .request.queryRecorrency import QueryRecorrency 7 | from .request.deactivateRecorrency import DeactivateRecorrency 8 | from .request.reactivateRecorrency import ReactivateRecorrency 9 | 10 | class CieloEcommerce(object): 11 | 12 | def __init__(self, merchant, environment): 13 | 14 | self.environment = environment 15 | self.merchant = merchant 16 | 17 | def create_sale(self, sale): 18 | 19 | request = CreateSale(self.merchant, self.environment) 20 | 21 | return request.execute(sale) 22 | 23 | def capture_sale(self, payment_id, amount = None, service_tax_amount = None): 24 | request = UpdateSale('capture', self.merchant, self.environment) 25 | 26 | request.amount = amount 27 | request.service_tax_amount = service_tax_amount 28 | 29 | return request.execute(payment_id) 30 | 31 | def cancel_sale(self, payment_id, amount = None): 32 | request = UpdateSale('void', self.merchant, self.environment) 33 | 34 | request.amount = amount 35 | 36 | return request.execute(payment_id) 37 | 38 | def get_sale(self, payment_id): 39 | request = QuerySale(self.merchant, self.environment) 40 | 41 | return request.execute(payment_id) 42 | 43 | def create_card_token(self, creditCard): 44 | 45 | request = CreateCardToken(self.merchant, self.environment) 46 | 47 | return request.execute(creditCard) 48 | 49 | def get_recurrent_payment(self, recurrent_payment_id): 50 | 51 | request = QueryRecorrency(self.merchant, self.environment) 52 | 53 | return request.execute(recurrent_payment_id) 54 | 55 | def deactivate_recurrent_payment(self, recurrent_payment_id): 56 | 57 | request = DeactivateRecorrency(self.merchant, self.environment) 58 | 59 | return request.execute(recurrent_payment_id) 60 | 61 | def reactivate_recurrent_payment(self, recurrent_payment_id): 62 | 63 | request = ReactivateRecorrency(self.merchant, self.environment) 64 | 65 | return request.execute(recurrent_payment_id) 66 | 67 | 68 | -------------------------------------------------------------------------------- /cieloApi3/creditCard.py: -------------------------------------------------------------------------------- 1 | 2 | from .objectJSON import ObjectJSON 3 | 4 | class CreditCard(ObjectJSON): 5 | 6 | def __init__(self, security_code, brand): 7 | 8 | self.card_number = None 9 | self.holder = None 10 | self.expiration_date = None 11 | self.security_code = security_code 12 | self.save_card = None 13 | self.brand = brand 14 | self.card_token = None 15 | self.customer_name = None 16 | 17 | 18 | def update_return(self, response_return): 19 | 20 | self.card_token = response_return['CardToken'] 21 | -------------------------------------------------------------------------------- /cieloApi3/customer.py: -------------------------------------------------------------------------------- 1 | 2 | class Customer(object): 3 | 4 | def __init__(self, name): 5 | 6 | self.name = name 7 | self.email = None 8 | self.birth_date = None 9 | self.identity = None 10 | self.identity_type = None 11 | self.address = None 12 | self.delivery_adress = None 13 | -------------------------------------------------------------------------------- /cieloApi3/environment.py: -------------------------------------------------------------------------------- 1 | class Environment(object): 2 | 3 | def __init__(self, sandbox): 4 | 5 | # Production 6 | if not sandbox: 7 | self.api = 'https://api.cieloecommerce.cielo.com.br/' 8 | self.api_query = 'https://apiquery.cieloecommerce.cielo.com.br/' 9 | else: 10 | self.api = 'https://apisandbox.cieloecommerce.cielo.com.br/' 11 | self.api_query = 'https://apiquerysandbox.cieloecommerce.cielo.com.br/' 12 | -------------------------------------------------------------------------------- /cieloApi3/merchant.py: -------------------------------------------------------------------------------- 1 | class Merchant(object): 2 | 3 | def __init__(self, id, key): 4 | self.id = id 5 | self.key = key 6 | -------------------------------------------------------------------------------- /cieloApi3/objectJSON.py: -------------------------------------------------------------------------------- 1 | 2 | import json 3 | from future.utils import integer_types 4 | 5 | 6 | class ObjectJSON(object): 7 | 8 | def toJSON(self): 9 | 10 | dicionary = json.loads(json.dumps(self, default=lambda o: o.__dict__)) 11 | 12 | dicionary = remove_none(dicionary) 13 | 14 | dicionary = process_name_key(dicionary) 15 | 16 | return json.dumps(dicionary, indent=2) 17 | 18 | def prepare(self): 19 | pass 20 | 21 | def __getattribute__(self, attribute): 22 | 23 | if attribute == '__dict__': 24 | self.prepare() 25 | 26 | return object.__getattribute__(self, attribute) 27 | 28 | 29 | def process_name_key(dictionary): 30 | 31 | if not isinstance(dictionary, dict): 32 | return dictionary 33 | 34 | newDictionary = {} 35 | 36 | for key in dictionary: 37 | newDictionary[capitalize_key(key)] = process_name_key(dictionary[key]) 38 | 39 | return newDictionary 40 | 41 | def capitalize_key(key): 42 | parts = key.split('_') 43 | 44 | newParts = [] 45 | for part in parts: 46 | newParts.append(part.capitalize()) 47 | 48 | return ''.join(newParts) 49 | 50 | def remove_none(dado): 51 | 52 | if isinstance(dado, dict): 53 | return remove_none_dict(dado) 54 | elif isinstance(dado, list): 55 | return remove_none_list(dado) 56 | 57 | return dado 58 | 59 | def remove_none_dict(obj): 60 | retorno = {} 61 | for chave in obj: 62 | valor = obj[chave] 63 | types = integer_types + (float, complex) 64 | if valor or isinstance(valor, types): 65 | retorno[chave] = remove_none(valor) 66 | 67 | return retorno 68 | 69 | def remove_none_list(lista): 70 | resposta = [] 71 | for linha in lista: 72 | valor = remove_none(linha) 73 | resposta.append(valor) 74 | 75 | return resposta 76 | -------------------------------------------------------------------------------- /cieloApi3/payment.py: -------------------------------------------------------------------------------- 1 | 2 | from .objectJSON import ObjectJSON 3 | 4 | PAYMENTTYPE_CREDITCARD = "CreditCard" 5 | PAYMENTTYPE_DEBITCARD = "DebitCard" 6 | PAYMENTTYPE_ELECTRONIC_TRANSFER = "ElectronicTransfer" 7 | PAYMENTTYPE_BOLETO = "Boleto" 8 | 9 | PROVIDER_BRADESCO = "Bradesco" 10 | PROVIDER_BANCO_DO_BRASIL = "BancoDoBrasil" 11 | PROVIDER_SIMULADO = "Simulado" 12 | 13 | class Payment(ObjectJSON): 14 | 15 | def __init__(self, amount, installments = 1): 16 | 17 | self.amount = amount 18 | self.service_tax_amount = None 19 | self.installments = installments 20 | self.interest = None 21 | self.capture = None 22 | self.authenticate = None 23 | self.recurrent = None 24 | self.recurrent_payment = None 25 | self.credit_card = None 26 | self.proof_of_sale = None 27 | self.authorization_code = None 28 | self.soft_descriptor = None 29 | self.return_url = None 30 | self.provider = None 31 | self.payment_id = None 32 | self.tid = None 33 | self.type = None 34 | self.received_date = None 35 | self.captured_amount = None 36 | self.captured_date = None 37 | self.currency = None 38 | self.country = None 39 | self.return_code = None 40 | self.return_message = None 41 | self.status = None 42 | self.links = None 43 | self.extra_data_collection = None 44 | self.expiration_date = None 45 | self.url = None 46 | self.number = None 47 | self.bar_code_number = None 48 | self.digitable_line = None 49 | self.address = None 50 | 51 | #Boleto 52 | self.boleto_number = None 53 | self.assignor = None 54 | self.demonstrative = None 55 | self.identification = None 56 | self.instructions = None 57 | 58 | 59 | def prepare(self): 60 | 61 | if self.credit_card: 62 | self.type = PAYMENTTYPE_CREDITCARD 63 | -------------------------------------------------------------------------------- /cieloApi3/recurrentPayment.py: -------------------------------------------------------------------------------- 1 | 2 | INTERVAL_MONTHLY = "Monthly" 3 | INTERVAL_BIMONTHLY = "Bimonthly" 4 | INTERVAL_QUARTERLY = "Quarterly" 5 | INTERVAL_SEMIANNUAL = "SemiAnnual" 6 | INTERVAL_ANNUAL = "Annual" 7 | 8 | class RecurrentPayment(object): 9 | 10 | def __init__(self, authorize_now=True): 11 | 12 | self.authorize_now = authorize_now 13 | self.start_date = None 14 | self.end_date = None 15 | self.interval = None 16 | self.recurrent_payment_id = None 17 | -------------------------------------------------------------------------------- /cieloApi3/request/__init__.py: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/DeveloperCielo/API-3.0-Python/8d8d923009c4b30cf38a7d7f065c46fae688a847/cieloApi3/request/__init__.py -------------------------------------------------------------------------------- /cieloApi3/request/base.py: -------------------------------------------------------------------------------- 1 | import uuid, json 2 | 3 | from future.utils import raise_with_traceback 4 | from requests import Request, Session 5 | 6 | class Base(object): 7 | 8 | def __init__(self, merchant): 9 | 10 | self.merchant = merchant 11 | 12 | def send_request(self, method, uri, data=None, params=None): 13 | 14 | s = Session() 15 | 16 | body = data 17 | 18 | headers = { 19 | 'User-Agent': "CieloEcommerce/3.0 Python SDK", 20 | 'RequestId': str(uuid.uuid4()), 21 | 'MerchantId': self.merchant.id, 22 | 'MerchantKey': self.merchant.key 23 | } 24 | 25 | if not body: 26 | headers['Content-Length'] = '0' 27 | else: 28 | headers["Content-Type"] = "application/json" 29 | 30 | if not isinstance(data, dict): 31 | body = body.toJSON() 32 | 33 | req = Request(method, uri, data=body, headers=headers, params=params) 34 | 35 | prep = s.prepare_request(req) 36 | 37 | response = s.send(prep) 38 | 39 | if 'json' in response.headers['Content-Type'].lower(): 40 | answers = response.json() 41 | else: 42 | answers = [{ 43 | 'Code': str(response.status_code), 44 | 'Message': response.text 45 | }] 46 | 47 | if response.status_code >= 400: 48 | errors = [] 49 | 50 | for answer in answers: 51 | errors.append('\r\n * [%s] %s\r\n' % (answer['Code'], answer['Message'])) 52 | 53 | data_send = json.loads(body or 'null') 54 | 55 | raise_with_traceback(Exception('\r\n%s\r\nMethod: %s\r\nUri: %s\r\nData: %s' % (''.join(errors), method, response.url, json.dumps(data_send, indent=2)))) 56 | 57 | return answers 58 | -------------------------------------------------------------------------------- /cieloApi3/request/createCardToken.py: -------------------------------------------------------------------------------- 1 | 2 | from .base import Base 3 | 4 | class CreateCardToken(Base): 5 | 6 | def __init__(self, merchant, environment): 7 | 8 | super(CreateCardToken, self).__init__(merchant) 9 | 10 | self.environment = environment 11 | 12 | def execute(self, creditCard): 13 | 14 | uri = '%s1/card' % self.environment.api 15 | 16 | response = self.send_request("POST", uri, creditCard) 17 | 18 | creditCard.update_return(response) 19 | 20 | return response 21 | -------------------------------------------------------------------------------- /cieloApi3/request/createSale.py: -------------------------------------------------------------------------------- 1 | 2 | from .base import Base 3 | 4 | class CreateSale(Base): 5 | 6 | def __init__(self, merchant, environment): 7 | 8 | super(CreateSale, self).__init__(merchant) 9 | 10 | self.environment = environment 11 | 12 | def execute(self, sale): 13 | 14 | uri = '%s1/sales' % self.environment.api 15 | 16 | response = self.send_request("POST", uri, sale) 17 | 18 | sale.update_return(response) 19 | 20 | return response 21 | -------------------------------------------------------------------------------- /cieloApi3/request/deactivateRecorrency.py: -------------------------------------------------------------------------------- 1 | 2 | from .base import Base 3 | 4 | class DeactivateRecorrency(Base): 5 | 6 | def __init__(self, merchant, environment): 7 | 8 | super(DeactivateRecorrency, self).__init__(merchant) 9 | 10 | self.environment = environment 11 | 12 | def execute(self, payment_id): 13 | 14 | uri = '%s1/RecurrentPayment/%s/Deactivate' % (self.environment.api_query, payment_id) 15 | 16 | return self.send_request("PUT", uri) 17 | -------------------------------------------------------------------------------- /cieloApi3/request/queryRecorrency.py: -------------------------------------------------------------------------------- 1 | 2 | from .base import Base 3 | 4 | class QueryRecorrency(Base): 5 | 6 | def __init__(self, merchant, environment): 7 | 8 | super(QueryRecorrency, self).__init__(merchant) 9 | 10 | self.environment = environment 11 | 12 | def execute(self, payment_id): 13 | 14 | uri = '%s1/RecurrentPayment/%s' % (self.environment.api_query, payment_id) 15 | 16 | return self.send_request("GET", uri) 17 | -------------------------------------------------------------------------------- /cieloApi3/request/querySale.py: -------------------------------------------------------------------------------- 1 | 2 | from .base import Base 3 | 4 | class QuerySale(Base): 5 | 6 | def __init__(self, merchant, environment): 7 | 8 | super(QuerySale, self).__init__(merchant) 9 | 10 | self.environment = environment 11 | 12 | def execute(self, payment_id): 13 | 14 | uri = '%s1/sales/%s' % (self.environment.api_query, payment_id) 15 | 16 | return self.send_request("GET", uri) 17 | -------------------------------------------------------------------------------- /cieloApi3/request/reactivateRecorrency.py: -------------------------------------------------------------------------------- 1 | 2 | from .base import Base 3 | 4 | class ReactivateRecorrency(Base): 5 | 6 | def __init__(self, merchant, environment): 7 | 8 | super(ReactivateRecorrency, self).__init__(merchant) 9 | 10 | self.environment = environment 11 | 12 | def execute(self, payment_id): 13 | 14 | uri = '%s1/RecurrentPayment/%s/Reactivate' % (self.environment.api_query, payment_id) 15 | 16 | return self.send_request("PUT", uri) 17 | -------------------------------------------------------------------------------- /cieloApi3/request/updateSale.py: -------------------------------------------------------------------------------- 1 | 2 | from .base import Base 3 | 4 | class UpdateSale(Base): 5 | 6 | def __init__(self, type, merchant, environment): 7 | 8 | super(UpdateSale, self).__init__(merchant) 9 | 10 | self.environment = environment 11 | self.type = type 12 | self.service_tax_amount = None 13 | self.amount = None 14 | 15 | def execute(self, payment_id): 16 | 17 | uri = '%s1/sales/%s/%s' % (self.environment.api, payment_id, self.type) 18 | 19 | params = {} 20 | 21 | if self.amount: 22 | params['amount'] = self.amount 23 | 24 | if self.service_tax_amount: 25 | params['serviceTaxAmount'] = self.service_tax_amount 26 | 27 | return self.send_request('PUT', uri, params=params) 28 | -------------------------------------------------------------------------------- /cieloApi3/sale.py: -------------------------------------------------------------------------------- 1 | 2 | from .objectJSON import ObjectJSON 3 | 4 | class Sale(ObjectJSON): 5 | 6 | def __init__(self, merchant_order_id): 7 | 8 | self.merchant_order_id = merchant_order_id 9 | self.customer = None 10 | self.payment = None 11 | 12 | def update_return(self, r): 13 | 14 | payment = r.get('Payment') or {} 15 | self.payment.payment_id = payment.get('PaymentId') 16 | self.payment.url = payment.get('Url') 17 | 18 | if self.payment.recurrent_payment: 19 | recurrent = payment.get('RecurrentPayment') or {} 20 | self.payment.recurrent_payment.recurrent_payment_id = recurrent.get('RecurrentPaymentId') 21 | -------------------------------------------------------------------------------- /example/saleBoletoComplete.py: -------------------------------------------------------------------------------- 1 | #-*- coding: utf-8 -*-s 2 | 3 | import sys 4 | sys.path.insert(0, "./") 5 | 6 | from cieloApi3 import * 7 | 8 | import json 9 | 10 | # Configure o ambiente 11 | environment = Environment(sandbox=True) 12 | 13 | # Configure seu merchant, para gerar acesse: https://cadastrosandbox.cieloecommerce.cielo.com.br/ 14 | merchant = Merchant('MerchantId', 'MerchantKey') 15 | 16 | # Crie uma instância de Sale informando o ID do pagamento 17 | sale = Sale('555') 18 | 19 | # Crie uma instância de Customer informando o nome do cliente 20 | sale.customer = Customer('Comprador Teste') 21 | 22 | # Crie uma instância de Payment informando o valor do pagamento 23 | payment = Payment(15700) 24 | payment.type = PAYMENTTYPE_BOLETO 25 | 26 | payment.provider = PROVIDER_BANCO_DO_BRASIL 27 | payment.address = 'Rua Alegria N: 3 Bairro: Rosa São Paulo-SP' 28 | payment.boleto_number = '123' 29 | payment.assignor = 'Empresa Teste' 30 | payment.demonstrative = 'Demonstrativo Teste' 31 | payment.expiration_date = '2017-06-11' 32 | payment.identification = '11884926754' 33 | payment.instructions = 'Aceitar somente até a data de vencimento, após essa data juros de 1% dia.' 34 | 35 | sale.payment = payment 36 | 37 | # Cria instância do controlador do ecommerce 38 | cielo_ecommerce = CieloEcommerce(merchant, environment) 39 | 40 | # Criar a venda e imprime o retorno 41 | response_create_sale = cielo_ecommerce.create_sale(sale) 42 | print '----------------------response_create_sale----------------------' 43 | print json.dumps(response_create_sale, indent=2) 44 | print '----------------------response_create_sale----------------------' 45 | 46 | # Com a venda criada na Cielo, já temos o ID do pagamento, TID e demais 47 | # dados retornados pela Cielo 48 | payment_id = sale.payment.payment_id 49 | 50 | # Com o ID do pagamento, podemos fazer uma consulta do pagamento 51 | response_get_sale = cielo_ecommerce.get_sale(payment_id) 52 | print '----------------------response_get_sale----------------------' 53 | print json.dumps(response_get_sale, indent=2) 54 | print '----------------------response_get_sale----------------------' 55 | 56 | print '\r\nLink Boleto:', sale.payment.url, '\r\n' 57 | -------------------------------------------------------------------------------- /example/saleBoletoSimple.py: -------------------------------------------------------------------------------- 1 | #-*- coding: utf-8 -*-s 2 | 3 | import sys 4 | sys.path.insert(0, "./") 5 | 6 | from cieloApi3 import * 7 | 8 | import json 9 | 10 | # Configure o ambiente 11 | environment = Environment(sandbox=True) 12 | 13 | # Configure seu merchant, para gerar acesse: https://cadastrosandbox.cieloecommerce.cielo.com.br/ 14 | merchant = Merchant('MerchantId', 'MerchantKey') 15 | 16 | # Crie uma instância de Sale informando o ID do pagamento 17 | sale = Sale('333') 18 | 19 | # Crie uma instância de Customer informando o nome do cliente 20 | sale.customer = Customer('Comprador Teste') 21 | 22 | # Crie uma instância de Payment informando o valor do pagamento 23 | sale.payment = Payment(15700) 24 | sale.payment.type = PAYMENTTYPE_BOLETO 25 | 26 | sale.payment.provider = PROVIDER_BRADESCO 27 | 28 | # Cria instância do controlador do ecommerce 29 | cielo_ecommerce = CieloEcommerce(merchant, environment) 30 | 31 | # Criar a venda e imprime o retorno 32 | response_create_sale = cielo_ecommerce.create_sale(sale) 33 | print '----------------------response_create_sale----------------------' 34 | print json.dumps(response_create_sale, indent=2) 35 | print '----------------------response_create_sale----------------------' 36 | 37 | # Com a venda criada na Cielo, já temos o ID do pagamento, TID e demais 38 | # dados retornados pela Cielo 39 | payment_id = sale.payment.payment_id 40 | 41 | # Com o ID do pagamento, podemos fazer uma consulta do pagamento 42 | response_get_sale = cielo_ecommerce.get_sale(payment_id) 43 | print '----------------------response_get_sale----------------------' 44 | print json.dumps(response_get_sale, indent=2) 45 | print '----------------------response_get_sale----------------------' 46 | 47 | print '\r\nLink Boleto:', sale.payment.url, '\r\n' 48 | -------------------------------------------------------------------------------- /example/saleCard.py: -------------------------------------------------------------------------------- 1 | #-*- coding: utf-8 -*-s 2 | 3 | import sys 4 | sys.path.insert(0, "./") 5 | 6 | from cieloApi3 import * 7 | 8 | import json 9 | 10 | # Configure o ambiente 11 | environment = Environment(sandbox=True) 12 | 13 | # Configure seu merchant, para gerar acesse: https://cadastrosandbox.cieloecommerce.cielo.com.br/ 14 | merchant = Merchant('MerchantId', 'MerchantKey') 15 | 16 | # Crie uma instância de Sale informando o ID do pagamento 17 | sale = Sale('123') 18 | 19 | # Crie uma instância de Customer informando o nome do cliente 20 | sale.customer = Customer('Fulano de Tal') 21 | 22 | # Crie uma instância de Credit Card utilizando os dados de teste 23 | # esses dados estão disponíveis no manual de integração 24 | credit_card = CreditCard('123', 'Visa') 25 | credit_card.expiration_date = '12/2018' 26 | credit_card.card_number = '0000000000000001' 27 | credit_card.holder = 'Fulano de Tal' 28 | 29 | # Crie uma instância de Payment informando o valor do pagamento 30 | sale.payment = Payment(15700) 31 | sale.payment.credit_card = credit_card 32 | 33 | # Cria instância do controlador do ecommerce 34 | cielo_ecommerce = CieloEcommerce(merchant, environment) 35 | 36 | # Criar a venda e imprime o retorno 37 | response_create_sale = cielo_ecommerce.create_sale(sale) 38 | print '----------------------response_create_sale----------------------' 39 | print json.dumps(response_create_sale, indent=2) 40 | print '----------------------response_create_sale----------------------' 41 | 42 | # Com a venda criada na Cielo, já temos o ID do pagamento, TID e demais 43 | # dados retornados pela Cielo 44 | payment_id = sale.payment.payment_id 45 | 46 | # Com o ID do pagamento, podemos fazer sua captura, 47 | # se ela não tiver sido capturada ainda 48 | response_capture_sale = cielo_ecommerce.capture_sale(payment_id, 15700, 0) 49 | print '----------------------response_capture_sale----------------------' 50 | print json.dumps(response_capture_sale, indent=2) 51 | print '----------------------response_capture_sale----------------------' 52 | 53 | # E também podemos fazer seu cancelamento, se for o caso 54 | response_cancel_sale = cielo_ecommerce.cancel_sale(payment_id, 15700) 55 | print '---------------------response_cancel_sale---------------------' 56 | print json.dumps(response_cancel_sale, indent=2) 57 | print '---------------------response_cancel_sale---------------------' 58 | -------------------------------------------------------------------------------- /example/saleCardRecurring.py: -------------------------------------------------------------------------------- 1 | #-*- coding: utf-8 -*-s 2 | 3 | import sys 4 | sys.path.insert(0, "./") 5 | 6 | from cieloApi3 import * 7 | 8 | import json 9 | 10 | # Configure o ambiente 11 | environment = Environment(sandbox=True) 12 | 13 | # Configure seu merchant, para gerar acesse: https://cadastrosandbox.cieloecommerce.cielo.com.br/ 14 | merchant = Merchant('MerchantId', 'MerchantKey') 15 | 16 | # Crie uma instância de Sale informando o ID do pagamento 17 | sale = Sale('789') 18 | 19 | # Crie uma instância de Customer informando o nome do cliente 20 | sale.customer = Customer('Comprador accept') 21 | 22 | # Crie uma instância de Credit Card utilizando os dados de teste 23 | # esses dados estão disponíveis no manual de integração 24 | credit_card = CreditCard('262', 'Visa') 25 | credit_card.expiration_date = '03/2019' 26 | credit_card.card_number = '1234123412341231' 27 | credit_card.holder = 'Teste Holder' 28 | 29 | recurrent_payment = RecurrentPayment() 30 | recurrent_payment.interval = INTERVAL_SEMIANNUAL 31 | recurrent_payment.end_date = '2019-12-01' 32 | 33 | # Crie uma instância de Payment informando o valor do pagamento 34 | sale.payment = Payment(1500) 35 | sale.payment.recurrent_payment = recurrent_payment 36 | sale.payment.credit_card = credit_card 37 | 38 | # Cria instância do controlador do ecommerce 39 | cielo_ecommerce = CieloEcommerce(merchant, environment) 40 | 41 | # Criar a venda e imprime o retorno 42 | response_create_sale = cielo_ecommerce.create_sale(sale) 43 | print '----------------------response_create_sale----------------------' 44 | print json.dumps(response_create_sale, indent=2) 45 | print '----------------------response_create_sale----------------------' 46 | 47 | 48 | 49 | 50 | 51 | # Com a venda criada na Cielo, já temos o ID do pagamento, TID e demais 52 | # dados retornados pela Cielo 53 | payment_id = sale.payment.payment_id 54 | 55 | # Com o ID do pagamento, podemos fazer sua captura, 56 | # se ela não tiver sido capturada ainda 57 | response_capture_sale = cielo_ecommerce.capture_sale(payment_id, 15700, 0) 58 | print '----------------------response_capture_sale----------------------' 59 | print json.dumps(response_capture_sale, indent=2) 60 | print '----------------------response_capture_sale----------------------' 61 | 62 | # E também podemos fazer seu cancelamento, se for o caso 63 | response_cancel_sale = cielo_ecommerce.cancel_sale(payment_id, 15700) 64 | print '---------------------response_cancel_sale---------------------' 65 | print json.dumps(response_cancel_sale, indent=2) 66 | print '---------------------response_cancel_sale---------------------' 67 | 68 | 69 | 70 | 71 | 72 | # Com a venda recorrente criada na Cielo, já temos o ID do pagamento recorrente 73 | recurrent_payment_id = sale.payment.recurrent_payment.recurrent_payment_id 74 | 75 | # Consulta informações da venda recorrente 76 | response_get_recurrent_payment = cielo_ecommerce.get_recurrent_payment(recurrent_payment_id) 77 | print '---------------------response_get_recurrent_payment---------------------' 78 | print json.dumps(response_get_recurrent_payment, indent=2) 79 | print '---------------------response_get_recurrent_payment---------------------' 80 | 81 | # # Desativa uma venda recorrente (Algum erro na API da Cielo, parou de funcionar) 82 | # response_deactivate_recurrent_payment = cielo_ecommerce.deactivate_recurrent_payment(recurrent_payment_id) 83 | # print '---------------------response_deactivate_recurrent_payment---------------------' 84 | # print json.dumps(response_deactivate_recurrent_payment, indent=2) 85 | # print '---------------------response_deactivate_recurrent_payment---------------------' 86 | 87 | # # Reativa uma venda recorrente (Algum erro na API da Cielo, parou de funcionar) 88 | # response_reactivate_recurrent_payment = cielo_ecommerce.reactivate_recurrent_payment(recurrent_payment_id) 89 | # print '---------------------response_reactivate_recurrent_payment---------------------' 90 | # print json.dumps(response_reactivate_recurrent_payment, indent=2) 91 | # print '---------------------response_reactivate_recurrent_payment---------------------' 92 | -------------------------------------------------------------------------------- /example/saleCardRecurringSchedule.py: -------------------------------------------------------------------------------- 1 | #-*- coding: utf-8 -*-s 2 | 3 | import sys 4 | sys.path.insert(0, "./") 5 | 6 | from cieloApi3 import * 7 | 8 | import json 9 | 10 | # Configure o ambiente 11 | environment = Environment(sandbox=True) 12 | 13 | # Configure seu merchant, para gerar acesse: https://cadastrosandbox.cieloecommerce.cielo.com.br/ 14 | merchant = Merchant('MerchantId', 'MerchantKey') 15 | 16 | # Crie uma instância de Sale informando o ID do pagamento 17 | sale = Sale('789') 18 | 19 | # Crie uma instância de Customer informando o nome do cliente 20 | sale.customer = Customer('Comprador rec programada') 21 | 22 | # Crie uma instância de Credit Card utilizando os dados de teste 23 | # esses dados estão disponíveis no manual de integração 24 | credit_card = CreditCard('262', 'Visa') 25 | credit_card.expiration_date = '03/2019' 26 | credit_card.card_number = '1234123412341231' 27 | credit_card.holder = 'Teste Holder' 28 | 29 | recurrent_payment = RecurrentPayment(False) 30 | recurrent_payment.interval = INTERVAL_SEMIANNUAL 31 | recurrent_payment.start_date = '2015-06-01' 32 | recurrent_payment.end_date = '2019-12-01' 33 | 34 | # Crie uma instância de Payment informando o valor do pagamento 35 | sale.payment = Payment(1500) 36 | sale.payment.recurrent_payment = recurrent_payment 37 | sale.payment.credit_card = credit_card 38 | 39 | # Cria instância do controlador do ecommerce 40 | cielo_ecommerce = CieloEcommerce(merchant, environment) 41 | 42 | # Criar a venda e imprime o retorno 43 | response_create_sale = cielo_ecommerce.create_sale(sale) 44 | print '----------------------response_create_sale----------------------' 45 | print json.dumps(response_create_sale, indent=2) 46 | print '----------------------response_create_sale----------------------' 47 | -------------------------------------------------------------------------------- /example/saleCardToken.py: -------------------------------------------------------------------------------- 1 | #-*- coding: utf-8 -*-s 2 | 3 | import sys 4 | sys.path.insert(0, "./") 5 | 6 | from cieloApi3 import * 7 | 8 | import json 9 | 10 | # Configure o ambiente 11 | environment = Environment(sandbox=True) 12 | 13 | # Configure seu merchant, para gerar acesse: https://cadastrosandbox.cieloecommerce.cielo.com.br/ 14 | merchant = Merchant('MerchantId', 'MerchantKey') 15 | 16 | # Crie uma instância de Credit Card utilizando os dados de teste 17 | # esses dados estão disponíveis no manual de integração 18 | credit_card = CreditCard('123', 'Visa') 19 | credit_card.expiration_date = '12/2018' 20 | credit_card.card_number = '4532117080573700' 21 | credit_card.holder = 'Comprador T Cielo' 22 | credit_card.customer_name = 'Comprador Teste Cielo' 23 | 24 | # Cria instância do controlador do ecommerce 25 | cielo_ecommerce = CieloEcommerce(merchant, environment) 26 | 27 | # Criar a venda e imprime o retorno 28 | response_create_card_token = cielo_ecommerce.create_card_token(credit_card) 29 | print '----------------------response_create_card_token----------------------' 30 | print json.dumps(response_create_card_token, indent=2) 31 | print '----------------------response_create_card_token----------------------' 32 | 33 | # Com o cartão gerado token na Cielo, já temos o Token do cartão para uma futura cobrança 34 | new_card_token = credit_card.card_token 35 | print 'New Card Token:', new_card_token 36 | 37 | # Crie uma instância de Sale informando o ID do pagamento 38 | sale = Sale('456') 39 | 40 | # Crie uma instância de Customer informando o nome do cliente 41 | sale.customer = Customer('Comprador Teste') 42 | 43 | # Crie uma instância de Credit Card utilizando os dados de teste via token 44 | credit_card_token = CreditCard('123', 'Visa') 45 | credit_card_token.card_token = new_card_token 46 | 47 | # Crie uma instância de Payment informando o valor do pagamento 48 | sale.payment = Payment(100) 49 | sale.payment.credit_card = credit_card_token 50 | 51 | # Cria instância do controlador do ecommerce 52 | cielo_ecommerce = CieloEcommerce(merchant, environment) 53 | 54 | # Criar a venda e imprime o retorno 55 | response_create_sale = cielo_ecommerce.create_sale(sale) 56 | print '----------------------response_create_sale----------------------' 57 | print json.dumps(response_create_sale, indent=2) 58 | print '----------------------response_create_sale----------------------' 59 | -------------------------------------------------------------------------------- /requirements.txt: -------------------------------------------------------------------------------- 1 | appdirs==1.4.3 2 | future==0.16.0 3 | packaging==16.8 4 | pyparsing==2.2.0 5 | requests==2.13.0 6 | -------------------------------------------------------------------------------- /setup.cfg: -------------------------------------------------------------------------------- 1 | [metadata] 2 | description-file = README.md 3 | -------------------------------------------------------------------------------- /setup.py: -------------------------------------------------------------------------------- 1 | #!/usr/bin/env python 2 | # -*- coding: utf-8 -*- 3 | 4 | import os 5 | import sys 6 | 7 | try: 8 | from setuptools import setup, find_packages 9 | except ImportError: 10 | from distutils.core import setup 11 | 12 | settings = dict() 13 | 14 | 15 | # Publish Helper. 16 | if sys.argv[-1] == 'publish': 17 | os.system('python setup.py sdist upload') 18 | sys.exit() 19 | 20 | settings.update( 21 | name='cieloApi3', 22 | version='0.1.5', 23 | description='SDK API-3.0 Python Cielo', 24 | author='Thiago Malaquias', 25 | author_email='thiago.malaca@gmail.com', 26 | url='https://github.com/thiago-Malaca/API-3.0-Python', 27 | keywords='api3.0 cielo python sdk ecommerce', 28 | packages=find_packages(), 29 | install_requires=['requests', 'future'], 30 | license='MIT', 31 | classifiers=( 32 | # 'Development Status :: 5 - Production/Stable', 33 | 'Intended Audience :: Developers', 34 | 'Natural Language :: English', 35 | 'License :: OSI Approved :: MIT License', 36 | 'Programming Language :: Python', 37 | # 'Programming Language :: Python :: 2.5', 38 | 'Programming Language :: Python :: 2.6', 39 | 'Programming Language :: Python :: 2.7', 40 | 'Programming Language :: Python :: 3.4', 41 | 'Programming Language :: Python :: 3.5', 42 | ) 43 | ) 44 | 45 | 46 | setup(**settings) 47 | 48 | 49 | 50 | 51 | # # -*- coding: utf-8 -*- 52 | # from setuptools import setup 53 | 54 | # setup( 55 | # name='cieloApi3', 56 | # version='0.1.1', 57 | # url='', 58 | # license='MIT License', 59 | # author='Thiago Malaquias', 60 | # author_email='', 61 | # keywords='api3.0 cielo python sdk ecommerce', 62 | # description=u'', 63 | # packages=['cielo.api30'], 64 | # install_requires=['requests'], 65 | # ) 66 | --------------------------------------------------------------------------------