inter_api 2.0.0 → 3.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 916894b13dfca9706d937b33783c82abadfa0b38cd8e453c16cf38722cbf91bd
-  data.tar.gz: cfe2a096a7ff9b744e30710f750caac01a29b32d84e8bbe9a55d2d062650967f
+  metadata.gz: 9b9bc4efa4928bc559eb90959ecbcdc3b5b389c3bcbb226f440ba01c29970b35
+  data.tar.gz: 486818dd33835e598952b289f82bc798857a2268e091d8829de8de39e93bafd6
 SHA512:
-  metadata.gz: c7767f24ea9c94da6f4fba3e5a8e11b5314999a897fcd04c36470dcf8bf5c9da6154ebdc4fb8501cf339c3746c6f3d86e2ae9aadfbb1379b37268751de7b4151
-  data.tar.gz: 3d2be806b3bc8c4ce6323bebc0a64d19ed2050e373ef785da9d9292b690016843cdb8c76a7a0e618a597f857751bb5a12c90500113ad615611dc7eb67d68aa1d
+  metadata.gz: 6bd1dff9e43c35e4455254d3c47156110d4972eb83e6d0dc33df49dba850adcd3b723242afa2acc41ef4e720fb323a8353c5b9f68b4d962a4ff646aafa096825
+  data.tar.gz: 14fa2a073a1b0a34cbc28860f1d6e333175e6b3cbf76c56d7014387e8e14936697a16009558e9a5472548d96c86a79e8366610cfd38bac79a722fc600c3f4072

data/README.md

@@ -31,42 +31,32 @@ bin/rails generate inter_api:install
 ```ruby
 # Instanciar o API client
 api_client = InterApi::Client.new(crt: "./certificado_api_inter.crt", key: "./chave_api_inter.key", client_id: "123456", client_secret: "abcde", chave_pix: "1011121314", conta_corrente: "9876", scopes: "cobv.write cobv.read cob.write cob.read pix.write pix.read")
+# É possível passar o parâmetro "test_mode" na instanciação do client, que vai definir se ele vai usar ambiente de teste ou produção. Por padrão é "false" (produção).
 # Ao instanciar o objeto, cria um access_token e/ou valida a partir da data de expiração
 
-# Criar um pagamento 
-payment = api_client.create_payment(amount: 50.00, payer_tax_id: "123.123.123-01", payer_name: "João da Silva", expiration: 3600, solicitacao_pagador: "Compra de produto", info_adicionais: [ nome: "Produto", valor: "Produto 1"])
-# retorna um objeto <InterApi::Payment>
-puts payment.txid # "123123"
-puts payment.status # "ATIVA"
+# Criar um pagamento
+response = api_client.create_payment(amount: 50.00, payer_tax_id: "123.123.123-01", payer_name: "João da Silva", expiration: 3600, solicitacao_pagador: "Compra de produto", info_adicionais: [ nome: "Produto", valor: "Produto 1"])
+# retorna um objeto <Ac::AcObject>
+puts response.txid # "123123"
+puts response.status # "ATIVA"
 
 # Obter um pagamento a partir do id
-payment = api_client.get_payment(payment.txid)
-# retorna um objeto <InterApi::Payment>
-puts payment.txid # "123123"
-puts payment.status # "ATIVA"
+response = api_client.get_payment(payment.txid)
+# retorna um objeto <Ac::AcObject>
+puts response.txid # "123123"
+puts response.status # "ATIVA"
 
 # Atualizar um pagamento
-body = { status: "REMOVIDA_PELO_USUARIO_RECEBEDOR" }
-api_client.update(payment.txid, body)
-# retorna o objeto <InterApi::Payment> atualizado
-puts payment.status # "REMOVIDA_PELO_USUARIO_RECEBEDOR"
+response = api_client.update_payment(payment_id: payment.txid, status: "REMOVIDA_PELO_USUARIO_RECEBEDOR")
+# retorna o objeto <Ac::AcObject> com o pagamento atualizado
+puts response.status # "REMOVIDA_PELO_USUARIO_RECEBEDOR"
 
 ```
 
 #### Métodos do Pagamento
 ```ruby
-payment.valid? # true ou false
-
-payment.paid? # true ou false
-
-payment.qr_code # retorna o source do SVG
-
-payment.reload! # retorna payment atualizado
-
-payment.invalidate! # invalida e retorna o payment atualizado
-
 # Reebolso de pagamento
-reembolso = payment.refund(amount: 50.00, refund_nature: "ORIGINAL", description: "Reembolso")
-# retorna o JSON da resposta
-reembolso["status"] # "EM_PROCESSAMENTO"
-```
+response = api_client.refund_payment(end_to_end_id: "123", amount: 50.00, refund_nature: "ORIGINAL", description: "Reembolso")
+# retorna um objeto <Ac::AcObject>
+response.status # "EM_PROCESSAMENTO"
+```

data/lib/inter_api/client_production.rb

@@ -5,8 +5,7 @@ module InterApi
     SAVE_RESPONSES = true
 
     attr_reader :crt, :key, :client_id, :client_secret, :chave_pix, :conta_corrente, :scopes
-    attr_accessor :access_token, :token_expires_at
-    def initialize(crt:, key:, client_id:, client_secret:, chave_pix:, conta_corrente:, scopes: "cobv.write cobv.read cob.write cob.read pix.write pix.read webhook.read webhook.write", access_token: nil, token_expires_at: nil)
+    def initialize(crt:, key:, client_id:, client_secret:, chave_pix:, conta_corrente:, scopes: "cobv.write cobv.read cob.write cob.read pix.write pix.read webhook.read webhook.write", access_token: nil, token_expires_at: nil, test_mode: false)
       @crt = crt
       @key = key
       @client_id = client_id
@@ -16,15 +15,7 @@ module InterApi
       @scopes = scopes
       @access_token= access_token
       @token_expires_at = token_expires_at
-    end
-
-    def access_token
-      authorize if should_refresh?
-      @access_token
-    end
-
-    def should_refresh?
-      @access_token.blank? || @token_expires_at&.past?
+      @test_mode = test_mode
     end
 
     def default_options
@@ -38,7 +29,7 @@ module InterApi
       }
     end
 
-    def authorize
+    def refresh_token
       headers = {
         "Content-Type" => "application/x-www-form-urlencoded"
       }
@@ -53,37 +44,12 @@ module InterApi
       @token_expires_at = Time.now + response.expires_in
     end
 
-    def get_payment_request(payment_id)
-      get("/pix/v2/cob/#{payment_id}")
-    end
-
-    def get_payment(payment_id)
-      response = get("/pix/v2/cob/#{payment_id}")
-      InterApi::Payment.new(response, self)
-    end
-
-    def create_payment_request(**args_body)
-      body = {
-        calendario: {
-          expiracao: args_body[:expiration]
-        },
-        devedor: build_devedor(args_body[:payer_tax_id], args_body[:payer_name]),
-        valor: {
-          original: format("%.2f", args_body[:amount]),
-          modalidadeAlteracao: 0
-        },
-        chave: @chave_pix,
-        solicitacaoPagador: args_body[:solicitacao_pagador],
-        infoAdicionais: args_body[:info_adicionais]
-      }
-      post("/pix/v2/cob", body:)
-    end
-
-    def create_payment(amount:, payer_tax_id: nil, payer_name: nil, expiration: 3600, solicitacao_pagador: nil, info_adicionais: [])
+    def create_payment(expiration: 3600, payer_tax_id: nil, payer_name: nil, amount:, solicitacao_pagador: nil, info_adicionais: [])
       body = {
         calendario: {
           expiracao: expiration
         },
+        devedor: build_devedor(payer_tax_id, payer_name),
         valor: {
           original: format("%.2f", amount),
           modalidadeAlteracao: 0
@@ -91,33 +57,33 @@ module InterApi
         chave: @chave_pix,
         solicitacaoPagador: solicitacao_pagador,
         infoAdicionais: info_adicionais
-      }
-      body[:devedor] = build_devedor(payer_tax_id, payer_name) if payer_tax_id && payer_name
+      }.compact
 
-      response = post("/pix/v2/cob", body:)
-      InterApi::Payment.new(response, self)
+      post("/pix/v2/cob", body:)
     end
 
-    def update_payment_request(payment_id, body)
-      patch("/pix/v2/cob/#{payment_id}", body:)
+    def get_payment(payment_id)
+      get("/pix/v2/cob/#{payment_id}")
     end
 
-    def update_payment(payment_id, body)
-      response = patch("/pix/v2/cob/#{payment_id}", body:)
-      InterApi::Payment.new(response, self)
+    def update_payment(payment_id:, status:)
+      body = {
+        status: status
+      }
+      patch("/pix/v2/cob/#{payment_id}", body:)
     end
 
-    def get_refund(end_to_end_id, id)
+    def get_refund(end_to_end_id:, id:)
       get("/pix/v2/pix/#{end_to_end_id}/devolucao/#{id}")
     end
 
-    def refund_payment(end_to_end_id, amount, refund_nature, description)
+    def refund_payment(end_to_end_id:, amount: nil, refund_nature: nil, description: nil)
       id = SecureRandom.hex(10)
       body = {
         valor: format("%.2f", amount),
         natureza: refund_nature,
         descricao: description
-      }
+      }.compact
       put("/pix/v2/pix/#{end_to_end_id}/devolucao/#{id}", body:)
     end
 
@@ -135,6 +101,7 @@ module InterApi
     private
 
     def build_devedor(payer_tax_id, payer_name)
+      return unless payer_tax_id && payer_name
       formatted_tax_id = payer_tax_id.gsub(/\D/, "")
       document_type = (formatted_tax_id.length == 11) ? "cpf" : "cnpj"
       {

data/lib/inter_api/client_sandbox.rb

@@ -0,0 +1,12 @@
+module InterApi
+  class ClientSandbox < ClientProduction
+    BASE_URL = "https://cdpj-sandbox.partners.uatinter.co/"
+
+    def pay_pix payment_id:, amount:
+      body = {
+        valor: format("%.2f", amount)
+      }
+      post("/pix/v2/cob/pagar/#{payment_id}", body:)
+    end
+  end
+end

data/lib/inter_api/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module InterApi
-  VERSION = "2.0.0"
+  VERSION = "3.0.0"
 end

data/lib/inter_api.rb

@@ -2,34 +2,24 @@
 
 require "bigdecimal/util"
 require "securerandom"
-require "rqrcode"
-# require "debug"
 require "ac"
 
 require_relative "inter_api/version"
 require "inter_api/client_production"
-require "inter_api/payment"
+require "inter_api/client_sandbox"
 
 module InterApi
   Typhoeus::Config.timeout = 10
 
   class Error < StandardError; end
 
-  class ClientTeste < ClientProduction
-    BASE_URL = "https://cdpj-sandbox.partners.uatinter.co/"
-
-    def pay_pix payment_id, amount
-      body = {
-        valor: format("%.2f", amount)
-      }
-      post("/pix/v2/cob/pagar/#{payment_id}", body:)
-    end
+  class ClientSandbox < ClientProduction
   end
 
   class Client
     def self.new **args
-      if args.delete(:test_mode)
-        ClientTeste.new(**args)
+      if args[:test_mode]
+        ClientSandbox.new(**args)
       else
         ClientProduction.new(**args)
       end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: inter_api
 version: !ruby/object:Gem::Version
-  version: 2.0.0
+  version: 3.0.0
 platform: ruby
 authors:
 - Todas Essas Coisas
@@ -80,7 +80,7 @@ files:
 - Rakefile
 - lib/inter_api.rb
 - lib/inter_api/client_production.rb
-- lib/inter_api/payment.rb
+- lib/inter_api/client_sandbox.rb
 - lib/inter_api/version.rb
 - sig/inter_api.rbs
 homepage: https://github.com/todasessascoisas/inter_api

data/lib/inter_api/payment.rb

@@ -1,103 +0,0 @@
-module InterApi
-  class Payment
-    attr_reader :response, :txid, :end_to_end_id, :devolucoes, :copia_e_cola, :status, :solicitacao, :info_adicionais, :valor_original, :valor_pago, :criacao, :expiracao, :pago_em, :devedor_nome, :devedor_tax_id
-    def initialize(response, client)
-      @client = client
-      @response = response
-      @txid = response.txid
-      @end_to_end_id = end_to_end
-      @devolucoes = devolutions
-      @copia_e_cola = response.pixCopiaECola
-      @status = response.status
-      @solicitacao = response["solicitacaoPagador"]
-      @info_adicionais = response.infoAdicionais
-      @valor_original = response.valor.original
-      @valor_pago = total_paid
-      @criacao = creation_date
-      @expiracao = expiration_date
-      @pago_em = paid_date
-      @devedor_nome = debtor_name
-      @devedor_tax_id = debtor_tax_id
-    end
-
-    def paid? external_value = nil
-      external_value = @valor_original if external_value.nil?
-      @status == "CONCLUIDA" && @valor_original.to_d == @valor_pago.to_d && external_value.to_d == @valor_pago.to_d
-    end
-
-    def valid?
-      @status == "ATIVA" && @expiracao > Time.now
-    end
-
-    def reload!
-      new_payment = @client.get_payment(@txid)
-      instance_variables.each do |variable|
-        instance_variable_set(variable, new_payment.instance_variable_get(variable))
-      end
-      self
-    end
-
-    def update(body)
-      @client.update_payment(@txid, body)
-    end
-
-    def invalidate!
-      update({status: "REMOVIDA_PELO_USUARIO_RECEBEDOR"})
-      reload!
-    end
-
-    def refund(amount: nil, refund_nature: nil, description: nil)
-      amount ||= @valor_pago
-      refund_nature ||= "ORIGINAL"
-      @client.refund_payment(@end_to_end_id, amount, refund_nature, description)
-    end
-
-    def qr_code(module_size: 4)
-      return false unless @copia_e_cola
-      qr = RQRCode::QRCode.new(@copia_e_cola, size: 10, level: :l)
-      qr.as_svg(module_size: module_size)
-    end
-
-    private
-
-    def creation_date
-      return nil unless @response.calendario.criacao
-      Time.new(@response.calendario.criacao)
-    end
-
-    def expiration_date
-      return nil unless @response.calendario.criacao
-      Time.new(@response.calendario.criacao) + @response.calendario.expiracao
-    end
-
-    def paid_date
-      return nil unless @response["pix"] && @response.pix.any? && @response.pix[0].horario
-      Time.new(@response.pix[0].horario)
-    end
-
-    def debtor_name
-      return nil unless @response["devedor"]
-      @response.devedor.nome
-    end
-
-    def debtor_tax_id
-      return nil unless @response["devedor"]
-      @response.devedor.cpf || @response.devedor.cnpj
-    end
-
-    def end_to_end
-      return nil unless @response["pix"] && @response.pix.any?
-      @response.pix[0].endToEndId
-    end
-
-    def devolutions
-      return nil unless @response["pix"] && @response.pix.any?
-      @response.pix[0].devolucoes
-    end
- 
-    def total_paid
-      return nil unless @response["pix"] && @response.pix.any?
-      @response.pix[0].valor
-    end
-  end
-end