DeveloperCielo/API-3.0-Ruby

Name: API-3.0-Ruby

Owner: Cielo Developers

Description: SDK Ruby da API 3.0 da Cielo

Created: 2016-11-23 17:36:16.0

Updated: 2017-10-24 21:34:50.0

Pushed: 2017-11-10 19:20:37.0

Homepage: null

Size: 40

Language: Ruby

GitHub Committers

UserMost Recent Commit# Commits
Hugo Maia Vieira2017-01-18 17:34:02.010
João Batista Neto2018-03-14 16:06:04.06
João Carreira de Oliveira e Mello2017-01-17 17:00:57.02
Oscar Costa2018-01-27 15:52:29.01
Felipe Frizzo2017-08-24 17:43:18.01

Other Committers

UserEmailMost Recent Commit# Commits
Fabio Mussifabio@ecocentauro.com.br2018-02-28 12:37:41.01

README

SDK Ruby Cielo

Principais recursos
Limitações

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.

Instalação

gem install cielo-api30

Utilizando o SDK

Para criar um pagamento simples com cartão de crédito com o SDK, basta fazer:

Criando um pagamento com cartão de crédito
ire "cielo/api30"

nfigure seu merchant
hant = Cielo::API30.merchant("MERCHANT-ID", "MERCHANT-KEY")

ie uma instância de Sale informando o ID do pagamento
 = Cielo::API30::Sale.new("123")

ie uma instância de Customer informando o nome do cliente
.customer = Cielo::API30::Customer.new("Fulano de Tal")

ie uma instância de Payment informando o valor do pagamento
.payment = Cielo::API30::Payment.new(15700)

forme o tipo de pagamento que será utilizado
.payment.type = Cielo::API30::Payment::PAYMENTTYPE_CREDITCARD

ie  uma instância de Credit Card utilizando os dados de teste
.payment.credit_card = Cielo::API30::CreditCard.new(security_code: "123", brand: "Visa")
.payment.credit_card.expiration_date = "12/2018"
.payment.credit_card.holder = "Fulano de Tal"
.payment.credit_card.card_number = "0000000000000001"

nfigure o SDK com seu merchant e o ambiente apropriado para criar a venda
o_api = Cielo::API30.client(merchant, Cielo::API30::Environment::sandbox)

ie a venda na Cielo
 = cielo_api.create_sale(sale)

m a venda criada, já temos o ID do pagamento, TID e demais dados retornados pela Cielo
ent_id = sale.payment.payment_id

m o ID do pagamento, podemos fazer sua captura, se ela não tiver sido capturada ainda
o_api.capture_sale(payment_id)

também podemos fazer seu cancelamento, se for o caso
o_api.cancel_sale(payment_id)

This work is supported by the National Institutes of Health's National Center for Advancing Translational Sciences, Grant Number U24TR002306. This work is solely the responsibility of the creators and does not necessarily represent the official views of the National Institutes of Health.