getnet_api 1.0.2 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: d03fd2ae26025e8728fca764861e8f328fe9b5af
-  data.tar.gz: 8b0af9f78626a13ab70a4e2272fc90526887cead
+SHA256:
+  metadata.gz: fe142d6c121ad9f8648364f3e45fafd1acd9ebfe369a87bad034db9cf0223a55
+  data.tar.gz: 3ef9013855d1149c71d5c21f542b25e441e2f6f40d61266e32e301633e7ac8af
 SHA512:
-  metadata.gz: 8b755becd2cc848759b252d2a15bf9326ba31cd88dddd0fbd934aaec1bff8629acecaf2a2457904a61bba9110bea7c28b10f15c27dc9399dbe1e4b79c49fa572
-  data.tar.gz: 093fcda3eb0c2554d0c1c910bcca079ef8282ecc053ae7b65e3f3db081ba17c04145c14195c4a579907f823675425d2d0249ed8a53682be26b14a1e7a6514bd5
+  metadata.gz: d80a89c714e683e9437ae27a5839738cca9f54c9e6950a6bb3f096476d0b7ad895bef4c6a910bb4e971a6d322473c1e3f56f2be0edbd11837f863347aa4f1f55
+  data.tar.gz: f898d223eb7ec5629ca087e488ef3b4cede019ba5ca472fcbf0ad9394bada97ce8782ec9201188aebe25f900d8e3cbea469c2066ce4b3adec989b043d92a769b

data/.github/workflows/ruby.yml

@@ -0,0 +1,40 @@
+# This workflow uses actions that are not certified by GitHub.
+# They are provided by a third-party and are governed by
+# separate terms of service, privacy policy, and support
+# documentation.
+# This workflow will download a prebuilt Ruby version, install dependencies and run tests with Rake
+# For more information see: https://github.com/marketplace/actions/setup-ruby-jruby-and-truffleruby
+
+name: Ruby
+
+on:
+  push:
+    branches: [ master ]
+  pull_request:
+    branches: [ master ]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v2
+
+    - uses: actions/setup-ruby@v1
+      with:
+        ruby-version: '2.6' 
+
+    - uses: actions/cache@v2
+      name: Fetching cache for bundle
+      with:
+        path: vendor/bundle
+        key: ${{ runner.os }}-gems-${{ hashFiles('**/Gemfile.lock') }}
+        restore-keys: |
+          ${{ runner.os }}-gems-
+
+    - name: Install dependencies
+      run: |
+          bundle config path vendor/bundle
+          bundle install --jobs 4 --retry 3
+
+    - name: Run tests
+      run: bundle exec rspec

data/.gitignore

@@ -49,5 +49,7 @@ build-iPhoneSimulator/
 # unless supporting rvm < 1.11.0 or doing something fancy, ignore this:
 .rvmrc
 
+coverage
+.idea
 
 to_do

data/.rspec

@@ -0,0 +1 @@
+--require spec_helper

data/Gemfile

@@ -1,2 +1,12 @@
-source "https://rubygems.org"
+# frozen_string_literal: true
+
+source 'https://rubygems.org'
 gemspec
+gem 'activemodel'
+
+group :test do
+  gem 'pry', '~> 0.13.1'
+  gem 'rspec'
+  gem 'vcr'
+  gem 'webmock'
+end

data/Gemfile.lock

@@ -1,33 +1,86 @@
 PATH
   remote: .
   specs:
-    getnet_api (0.1.1)
+    getnet_api (1.1.0)
       rest-client (>= 1.7.3)
 
 GEM
   remote: https://rubygems.org/
   specs:
-    domain_name (0.5.20180417)
+    activemodel (6.1.3.1)
+      activesupport (= 6.1.3.1)
+    activesupport (6.1.3.1)
+      concurrent-ruby (~> 1.0, >= 1.0.2)
+      i18n (>= 1.6, < 2)
+      minitest (>= 5.1)
+      tzinfo (~> 2.0)
+      zeitwerk (~> 2.3)
+    addressable (2.8.0)
+      public_suffix (>= 2.0.2, < 5.0)
+    coderay (1.1.3)
+    concurrent-ruby (1.1.8)
+    crack (0.4.3)
+      safe_yaml (~> 1.0.0)
+    diff-lcs (1.4.4)
+    domain_name (0.5.20190701)
       unf (>= 0.0.5, < 1.0.0)
-    http-cookie (1.0.3)
+    hashdiff (1.0.0)
+    http-accept (1.7.0)
+    http-cookie (1.0.8)
       domain_name (~> 0.5)
-    mime-types (3.2.2)
+    i18n (1.8.10)
+      concurrent-ruby (~> 1.0)
+    logger (1.6.5)
+    method_source (1.0.0)
+    mime-types (3.6.0)
+      logger
       mime-types-data (~> 3.2015)
-    mime-types-data (3.2018.0812)
+    mime-types-data (3.2025.0107)
+    minitest (5.14.4)
     netrc (0.11.0)
-    rest-client (2.0.2)
+    pry (0.13.1)
+      coderay (~> 1.1)
+      method_source (~> 1.0)
+    public_suffix (4.0.6)
+    rest-client (2.1.0)
+      http-accept (>= 1.7.0, < 2.0)
       http-cookie (>= 1.0.2, < 2.0)
       mime-types (>= 1.16, < 4.0)
       netrc (~> 0.8)
-    unf (0.1.4)
-      unf_ext
-    unf_ext (0.0.7.5)
+    rspec (3.10.0)
+      rspec-core (~> 3.10.0)
+      rspec-expectations (~> 3.10.0)
+      rspec-mocks (~> 3.10.0)
+    rspec-core (3.10.1)
+      rspec-support (~> 3.10.0)
+    rspec-expectations (3.10.1)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.10.0)
+    rspec-mocks (3.10.2)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.10.0)
+    rspec-support (3.10.2)
+    safe_yaml (1.0.5)
+    tzinfo (2.0.4)
+      concurrent-ruby (~> 1.0)
+    unf (0.2.0)
+    vcr (6.0.0)
+    webmock (3.7.1)
+      addressable (>= 2.3.6)
+      crack (>= 0.3.2)
+      hashdiff (>= 0.4.0, < 2.0.0)
+    zeitwerk (2.4.2)
 
 PLATFORMS
   ruby
 
 DEPENDENCIES
+  activemodel
   getnet_api!
+  pry (~> 0.13.1)
+  rspec
+  vcr
+  webmock
 
 BUNDLED WITH
-   1.16.4
+   1.17.3

data/README.md

@@ -1,4 +1,6 @@
 # Gem Getnet API - Meios de Pagamento
+[![GetnetApi Master Actions Status](https://github.com/minestore/getnet_api/workflows/Ruby/badge.svg)](https://github.com/minestore/getnet_api/actions)
+<a href="https://codeclimate.com/github/minestore/getnet_api/maintainability"><img src="https://api.codeclimate.com/v1/badges/779e36dcfce7e558f24b/maintainability" /></a>
 
 ## Versão Beta
 
@@ -39,7 +41,7 @@ GetnetApi.configure do |config|
   #
   # Código que identifica o seller_id dentro da Getnet
   # Enviado pela Getnet
-  config.seller_id = '5c89ec4a-db89-45a6-8c96-5b0b72907ef5'
+  config.seller_id = '5c89ec4a-db89-45a6-8c96-5b0b72907ef5' 
 
   #
   # Código que identifica o client_id dentro da Getnet
@@ -109,7 +111,6 @@ obj_pagamento = GetnetApi::Payment.new ({
   amount:           100,        # Quantidade em centavos
   order:            obj_pedido, # Objeto da classe GetnetApi::Order
   customer:         obj_cliente, # Objeto da classe GetnetApi::Customer
-  billing_address:  obj_endereco, # Objeto da classe GetnetApi::Address
 })
 ```
 ## Criando um pagamento na GetNet do tipo Credit
@@ -157,6 +158,26 @@ obj_boleto = GetnetApi::Boleto.new ({
 novo_pagamento = GetnetApi::Payment.create obj_pagamento, obj_boleto, :boleto
 ```
 
+---
+
+## Criando um pagamento na GetNet do tipo Pix
+
+### Montar [Pix](https://www.rubydoc.info/gems/getnet_api/GetnetApi/Pix)
+https://developers.getnet.com.br/api#tag/PIX%2Fpaths%2F~1v1~1payments~1qrcode~1pix%2Fpost
+
+```ruby
+obj_pix = GetnetApi::Pix.new ({
+  order_id: "6598",
+  customer_id: "1234"
+})
+```
+
+```ruby
+# No Caso de pagamento de Pix
+# GetnetApi::Payment.create(GetnetApi::Payment, GetnetApi::Pix, tipo)
+novo_pagamento = GetnetApi::Payment.create obj_pagamento, obj_pix, :pix
+```
+
 ## Criando um cancelamento de cartão de crédito
 
 ### Montar [Cancelamento](https://www.rubydoc.info/gems/getnet_api/GetnetApi/PaymentCancel)
@@ -177,18 +198,22 @@ cancelamento = GetnetApi::PaymentCancel.create obj_cancelamento
 
 - [QW3 Software & Marketing](http://qw3.com.br)
 - [Leandro dos Santos Falcão](https://www.linkedin.com/in/lsfalcao)
+
+## Contributors
+
 - [Victor Barreiros](www.linkedin.com/in/victor-barreiros)
 - [Daniel B. Brumazzi](https://www.linkedin.com/in/daniel-brumazzi-2153707b/)
+- [eduardosleite](https://github.com/eduardosleite)
 
 ## Copyright
 
-[QW3 Software & Marketing](http://qw3.com.br)
+[Falcão Tecnologias Digitais](http://qw3.com.br)
 
-![QW3 Logo](http://qw3.com.br/qw3_logo.png)
+![FalcãoTD Logo](https://falcaotd.com.br/assets/icons/logo-tarja.svg)
 
 MIT License
 
-Copyright (c) 2018 QW3 - Software, Marketing e Consultoria
+Copyright (c) 2025 FalcãoTD - Software, Marketing e Consultoria
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
@@ -206,4 +231,4 @@ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+SOFTWARE.

data/lib/getnet_api/base.rb

@@ -1,10 +1,9 @@
 module GetnetApi
   class Base
-    require 'uri'
-    require 'net/http'
-
-    def self.build_request endpoint, metodo, body=nil
+    require "uri"
+    require "net/http"
 
+    def self.build_request endpoint, metodo, body = nil
       url = URI("#{GetnetApi.base_uri}/#{endpoint}")
 
       http = Net::HTTP.new(url.host, url.port)
@@ -23,14 +22,14 @@ module GetnetApi
       request = GetnetApi::Base.default_headers request
 
       request.body = body.to_json
-      return http.request(request)
+      http.request(request)
     end
 
     def self.default_headers request
       request["authorization"] = "Bearer #{GetnetApi::Base.valid_bearer}"
       request["Content-Type"] = "application/json"
-      request["seller_id"] = "#{GetnetApi.seller_id}"
-      return request
+      request["seller_id"] = GetnetApi.seller_id.to_s
+      request
     end
 
     def self.get_token_de_bearer
@@ -38,27 +37,24 @@ module GetnetApi
       http = Net::HTTP.new(url.host, url.port)
       http.use_ssl = true
       request = Net::HTTP::Post.new(url)
-      request.basic_auth "#{GetnetApi.client_id}", "#{GetnetApi.client_secret}"
+      request.basic_auth GetnetApi.client_id.to_s, GetnetApi.client_secret.to_s
       request["Content-Type"] = "application/x-www-form-urlencoded"
-      hash =  {
-                "scope" => 'oob',
-                "grant_type" => 'client_credentials',
-              }
+      hash = {
+        "scope" => "oob",
+        "grant_type" => "client_credentials"
+      }
       request.body = hash.to_query
-      response =  http.request(request)
+      response = http.request(request)
       result = JSON.parse(response.read_body)
       GetnetApi.access_token = result["access_token"]
       GetnetApi.expires_in = DateTime.now + result["expires_in"].to_i.seconds - 60.seconds
     end
 
     def self.valid_bearer
-      if GetnetApi.expires_in > DateTime.now
-        return GetnetApi.access_token
-      else
+      unless GetnetApi.expires_in > DateTime.now
         GetnetApi::Base.get_token_de_bearer
-        return GetnetApi.access_token
       end
+      GetnetApi.access_token
     end
-
   end
 end

data/lib/getnet_api/boleto.rb

@@ -29,7 +29,6 @@ module GetnetApi
 
     # validates :valor_total, length: { maximum:  }
     # validates :expiration_date, length: { maximum:  }
-    validates :moeda, length: { maximum: 3 }
     validates :our_number , length: { maximum: 12 }
     validates :document_number, length: { maximum: 15 }
     validates :instructions, length: { maximum: 1000 }

data/lib/getnet_api/configure.rb

@@ -98,7 +98,7 @@ module GetnetApi
     end
 
     def base_uri
-      return "#{self.endpoint}/#{self.api_version}/"
+      return "#{self.endpoint}/#{self.api_version}"
     end
 
   end

data/lib/getnet_api/customer.rb

@@ -9,7 +9,7 @@ module GetnetApi
     }
 
     # Código que identifica o cliente no estabelecimento.
-    # Alfa Numérico - Até 20 caracteres
+    # Alfa Numérico - Até 100 caracteres
     attr_accessor :customer_id
 
     # Nome do comprador
@@ -106,10 +106,10 @@ module GetnetApi
       }
 
       if tipo == :customer
-          customer.merge!({"address" => address.to_request,})
+          customer.merge!({address: address.to_request})
       elsif tipo == :payment
-          customer.merge!({"name" => self.name.to_s,})
-          customer.merge!({"billing_address" => address.to_request,})
+          customer.merge!({name: self.name.to_s})
+          customer.merge!({billing_address: address.to_request})
       end
 
       return customer
@@ -128,7 +128,7 @@ module GetnetApi
     private
 
     def self.endpoint
-      return "/customers"
+      return "customers"
     end
 
   end

data/lib/getnet_api/payment.rb

@@ -23,7 +23,6 @@ module GetnetApi
     # Validações do Rails 3
     include ActiveModel::Validations
 
-    validates :amount, length: { maximum: 3 }
     validates :currency, length: { maximum: 3 }
 
     validates_each [:order] do |record, attr, value|
@@ -36,16 +35,6 @@ module GetnetApi
       end
     end
 
-    validates_each [:boleto] do |record, attr, value|
-      if value.is_a? GetnetApi::Boleto
-        if value.invalid?
-          value.errors.full_messages.each { |msg| record.errors.add(attr, msg) }
-        end
-      else
-        record.errors.add(attr, 'deve ser um objeto GetnetApi::Boleto.')
-      end
-    end
-
     validates_each [:customer] do |record, attr, value|
       if value.is_a? GetnetApi::Customer
         if value.invalid?
@@ -74,41 +63,46 @@ module GetnetApi
     # Montar o Hash de dados do usuario no padrão utilizado pela Getnet
     def to_request obj, type
       payment = {
-        seller_id:        GetnetApi.seller_id.to_s,
-        amount:           self.amount.to_i,
-        currency:         self.currency.to_s,
-        order:            self.order.to_request,
-        customer:         self.customer.to_request(:payment),
+        seller_id: GetnetApi.seller_id.to_s,
+        amount: amount.to_i,
+        currency: currency.to_s,
+        order: order.to_request,
+        customer: customer.to_request(:payment)
       }
 
+      if type == :boleto || type == :credit
+        payment[:order] = order.to_request
+        payment[:customer] = customer.to_request(:payment)
+      end
+
       if type == :boleto
-          payment.merge!({"boleto" => obj.to_request,})
-      elsif :credit
-          payment.merge!({"credit" => obj.to_request,})
+        payment[:boleto] = obj.to_request
+      elsif type == :credit
+        payment[:credit] = obj.to_request
+      elsif type == :pix
+        payment.merge!(obj.to_request)
       end
 
-      return payment
+      payment
     end
 
     # a = GetnetApi::Payment.create pagamento, boleto, :boleto
     def self.create(payment, obj, type)
-
       hash = payment.to_request(obj, type)
 
-      response = self.build_request self.endpoint(type), "post", hash
+      response = build_request(endpoint(type), "post", hash)
 
-      return JSON.parse(response.read_body)
+      JSON.parse(response.read_body)
     end
 
-    private
-
     def self.endpoint type
       if type == :boleto
-        return "payments/boleto"
-      elsif :credit
-        return "payments/credit"
+        "payments/boleto"
+      elsif type == :credit
+        "payments/credit"
+      elsif type == :pix
+        "payments/qrcode/pix"
       end
     end
-
   end
 end

data/lib/getnet_api/payment_cancel.rb

@@ -42,7 +42,7 @@ module GetnetApi
 
     private
       def self.endpoint payment_id
-        "payments/cancel/request"
+        "payments/credit/#{payment_id}/cancel"
       end
   end
 end

data/lib/getnet_api/pix.rb

@@ -0,0 +1,35 @@
+module GetnetApi
+  class Pix
+    # string 200 characters
+    # Código de identificação da compra utilizado pelo e-commerce. Caso seja informado ele será repassado na Notificação de Pagamento PIX.
+    attr_accessor :order_id
+
+    # string 36 characters
+    # Identificador do comprador utilizado pelo e-commerce. Caso seja informado ele será repassado na Notificação de Pagamento PIX.
+    attr_accessor :customer_id
+
+    # Validações do Rails 3
+    include ActiveModel::Validations
+
+    validates :order_id, length: {maximum: 200}
+    validates :customer_id, length: {maximum: 36}
+
+    # Nova instancia da classe Pix
+    # @param [Hash] campos
+    def initialize(campos = {})
+      campos.each do |campo, valor|
+        if GetnetApi::Pix.public_instance_methods.include? "#{campo}=".to_sym
+          send "#{campo}=", valor
+        end
+      end
+    end
+
+    # Montar o Hash de dados do pagamento no padrão utilizado pela Getnet
+    def to_request
+      {
+        order_id: order_id,
+        customer_id: customer_id
+      }
+    end
+  end
+end

data/lib/getnet_api/version.rb

@@ -2,8 +2,8 @@
 module GetnetApi
   module Version
     MAJOR = 1
-    MINOR = 0
-    PATCH = 2
+    MINOR = 1
+    PATCH = 0
     STRING = "#{MAJOR}.#{MINOR}.#{PATCH}"
   end
 end

data/lib/getnet_api.rb

@@ -1,6 +1,7 @@
-# -*- encoding : utf-8 -*-
-require 'rubygems'
-require 'active_model'
+require "rubygems"
+require "active_model"
+require "active_support/time"
+require "json"
 
 require "getnet_api/version"
 require "getnet_api/configure"
@@ -15,10 +16,9 @@ require "getnet_api/boleto"
 require "getnet_api/credit"
 require "getnet_api/payment"
 require "getnet_api/payment_cancel"
-
+require "getnet_api/pix"
 
 # -*- encoding : utf-8 -*-
 module GetnetApi
   extend GetnetApi::Configure
-
 end

data/spec/lib/getnet_api/address_spec.rb

@@ -0,0 +1,77 @@
+# frozen_string_literal: true
+
+describe GetnetApi::Address do
+  let(:address) do
+    GetnetApi::Address.new(
+      street: 'Nome da Rua',
+      number: '123',
+      complement: 'Complemento',
+      district: 'Nome do Bairro',
+      city: 'São Paulo',
+      state: 'SP',
+      country: 'Brasil',
+      postal_code: '01010010'
+    )
+  end
+
+  it 'is valid with valid attributes' do
+    expect(address).to be_valid
+  end
+
+  it 'is not valid with street length > 60' do
+    address.street = 'A' * 61
+    expect(address).not_to be_valid
+    expect(address.errors.messages[:street]).to be_present
+  end
+
+  it 'is not valid with number length > 10' do
+    address.number = '1' * 11
+    expect(address).not_to be_valid
+    expect(address.errors.messages[:number]).to be_present
+  end
+
+  it 'is not valid with complement length > 60' do
+    address.complement = 'A' * 61
+    expect(address).not_to be_valid
+    expect(address.errors.messages[:complement]).to be_present
+  end
+
+  it 'is not valid with district length > 40' do
+    address.district = 'A' * 41
+    expect(address).not_to be_valid
+    expect(address.errors.messages[:district]).to be_present
+  end
+
+  it 'is not valid with city length > 40' do
+    address.city = 'A' * 41
+    expect(address).not_to be_valid
+    expect(address.errors.messages[:city]).to be_present
+  end
+
+  it 'is not valid with state length > 20' do
+    address.state = 'A' * 21
+    expect(address).not_to be_valid
+    expect(address.errors.messages[:state]).to be_present
+  end
+
+  it 'is not valid with country length > 20' do
+    address.country = 'A' * 21
+    expect(address).not_to be_valid
+    expect(address.errors.messages[:country]).to be_present
+  end
+
+  it 'is not valid with postal code length > 8' do
+    address.postal_code = '1' * 9
+    expect(address).not_to be_valid
+    expect(address.errors.messages[:postal_code]).to be_present
+  end
+
+  context '#to_request' do
+    it 'returns address object as a hash' do
+      address_hash = address.to_request
+      address_hash.keys.each do |key|
+        expect(address_hash[key]).to eq address.send(key)
+      end
+    end
+  end
+end