inter_api 1.0.1 → 1.0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '00359604a49c1e13d27dc95669f21d4de43530b5d1101d0945cb5c33d90517f0'
-  data.tar.gz: 6c7565195e26b407c1a0bb08a0a2188da5fe1f04b20c85319b4a9aca5ef16cd6
+  metadata.gz: 851ced5270a63cb3feea8a1d570c23918548e0fa8fd0ad4175ffd7faf9a87333
+  data.tar.gz: afb5f7ae4dc0455e34d2c584ffd832246015ef24495fd41df79d44a2829c662d
 SHA512:
-  metadata.gz: 0b91d9df2cd30a8c8109f02fe4676618c817df5599cefceb25178656565dc8da277766f9196ba633760c4f918c6ef350c2cba7e6906857b8dc34f515a4184af1
-  data.tar.gz: c5f479d4773e988e80a5de2eaa8565c45142b8a062e44c073f09a43b0622ae02590964af25857c929f49dc33a78a236a99f26906cf3b6c199c2298b1e2ec2a0c
+  metadata.gz: 7ef44ff9c60803a68fa10212ec3062af971c31f9cd891ae7e46d7e7811a901a3856e09fcfaacc103625c5b9f805662ec4ef18e7132c1f210332d3aff254350d5
+  data.tar.gz: 1aef7ac40411244ff0226ca03daee9a14b6af5c93ae0b1f238327889ed08f9d259c13fbdb5b40796b6de85cde1ce4329b95e72297ad57d1de369ded5f23d8c66

data/README.md

@@ -1,19 +1,72 @@
 # InterApi
 
-## Installation
+Wrapper de integração com a API v2 do Banco Inter.
 
-Add inter_api to your Gemfile:
+### Funcionalidades:
+- Autenticação
+- Pagamento Pix: get, create, update, refund
+
+## Instalação
+
+Adicionar inter_api no Gemfile:
 
 ```ruby
 gem 'inter_api'
 ```
+ou
+```shell
+bundle add inter_api
+```
 
-Bundle your dependencies and run the installation generator:
+Instalar a gem:
 
 ```shell
 bin/rails generate inter_api:install
 ```
 
-## License
+## Uso
+
+### Exemplo
+#### Criar Pagamento PIX
+```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")
+# 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"
+
+# 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"
+
+# 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"
+
+```
+
+#### 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
 
-Copyright (c) 2023 ulysses-bull, released under the New BSD License.
+# Reebolso de pagamento
+reembolso = payment.refund(amount: 50.00, refund_nature: "ORIGINAL", description: "Reembolso")
+# retorna o JSON da resposta
+reembolso["status"] # "EM_PROCESSAMENTO"
+```

data/lib/inter_api/client.rb

@@ -84,12 +84,12 @@ module InterApi
     end
 
     def update_payment(payment_id, body)
-      response = update_payment_request(payment_id, body).run
+      response = patch("/pix/v2/cob/#{payment_id}", headers: build_headers, sslcert: @crt, sslkey: @key, body: JSON.dump(body)) { |response| validate_response(response, "txid") }
       InterApi::Payment.new(response.json, self)
     end
 
     def get_refund(end_to_end_id, id)
-      response = get("/pix/v2/pix/#{end_to_end_id}/devolucao/#{id}", headers: build_headers, sslcert: @crt, sslkey: @key)
+      response = get("/pix/v2/pix/#{end_to_end_id}/devolucao/#{id}", headers: build_headers, sslcert: @crt, sslkey: @key) { |response| validate_response(response, "id") }
       response.json
     end
 
@@ -100,7 +100,7 @@ module InterApi
         natureza: refund_nature,
         descricao: description
       }
-      response = put("/pix/v2/pix/#{end_to_end_id}/devolucao/#{id}", headers: build_headers, sslcert: @crt, sslkey: @key, body: JSON.dump(body))
+      response = put("/pix/v2/pix/#{end_to_end_id}/devolucao/#{id}", headers: build_headers, sslcert: @crt, sslkey: @key, body: JSON.dump(body)) { |response| validate_response(response, "id") }
       response.json
     end
 

data/lib/inter_api/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: inter_api
 version: !ruby/object:Gem::Version
-  version: 1.0.1
+  version: 1.0.3
 platform: ruby
 authors:
-- ulysses
+- Todas Essas Coisas
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2024-06-03 00:00:00.000000000 Z
+date: 2024-06-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ac
@@ -85,13 +85,13 @@ files:
 - lib/inter_api/payment_error.rb
 - lib/inter_api/version.rb
 - sig/inter_api.rbs
-homepage: https://github.com/ulysses-bull/inter_api
+homepage: https://github.com/todasessascoisas/inter_api
 licenses:
 - MIT
 metadata:
-  homepage_uri: https://github.com/ulysses-bull/inter_api
-  source_code_uri: https://github.com/ulysses-bull/inter_api
-  changelog_uri: https://github.com/ulysses-bull/inter_api
+  homepage_uri: https://github.com/todasessascoisas/inter_api
+  source_code_uri: https://github.com/todasessascoisas/inter_api
+  changelog_uri: https://github.com/todasessascoisas/inter_api
 post_install_message: 
 rdoc_options: []
 require_paths:
@@ -107,7 +107,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.10
+rubygems_version: 3.5.9
 signing_key: 
 specification_version: 4
 summary: ''