Pular para o conteúdo principal

Ruby

Saiba como instalar e configurar nossa SDK de Ruby para utilizar as APIs da Efí

Atenção!

As requisições feitas às APIs da Efí, utilizando a sdk de Ruby precisam do certificado gerado em sua conta Efí no formato .pem.

Confira aqui o passo a passo para converter seu certificado P12 para o formato PEM.


Instalação via RubyGems

Adicione esta linha ao Gemfile da sua aplicação:

gem 'sdk_ruby_apis_efi'

E então execute:

$ bundle

Ou instale-o como:

$ gem install sdk_ruby_apis_efi

Instalação via Git

Nossa SDK também está disponível em nosso repositório no Github da Efí.

$ git clone https://github.com/efipay/sdk-ruby-apis-efi.git

Testado com

  • Ruby 2.1.0
  • Ruby 2.7.0
  • Ruby 3.0.4

Uso básico

require 'sdk_ruby_apis_efi'
require_relative "../../credentials"

options = {
client_id: CREDENTIALS::CLIENT_ID,
client_secret: CREDENTIALS::CLIENT_SECRET,
sandbox: CREDENTIALS::SANDBOX
}

body = {
items: [{
name: "Product 1",
value: 1000,
amount: 2
}],
shippings: [{
name: "Default Shipping Cost",
value: 100
}]
}

efipay = SdkRubyApisEfi.new(options)
puts efipay.create_charge(body: body)

Exemplos

Você pode executar os exemplos dentro do diretório examples com:

$ ruby examples/create_charge.rb

Lembre-se de definir as credenciais corretas dentro de examples/credentials.rb antes de executar.


Testes

Para executar os testes, basta executar rspec:

$ rspec

Ou usar guard para monitorar arquivos e executar automaticamente rspec:

$ guard -n false -c