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:

Efí Pay

gem 'sdk_ruby_apis_efi'

E então execute:

$ bundle

Ou instale-o como:

Efí Pay

$ 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í.

Efí Pay

$ 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

Efí Pay

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