inter_api 1.0.2 → 1.0.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (4) hide show
  1. checksums.yaml +4 -4
  2. data/README.md +58 -5
  3. data/lib/inter_api/version.rb +1 -1
  4. metadata +8 -8
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 36661dd5aa68653e29608d07616fd26e0726640409f2188efaf99b8e3a44dcf4
4
- data.tar.gz: 94eb00f18a9a1191014047249ca1050ce720dde93f0836965ab078abb6800ad5
3
+ metadata.gz: 851ced5270a63cb3feea8a1d570c23918548e0fa8fd0ad4175ffd7faf9a87333
4
+ data.tar.gz: afb5f7ae4dc0455e34d2c584ffd832246015ef24495fd41df79d44a2829c662d
5
5
  SHA512:
6
- metadata.gz: 6a46510c801ffcba0d75ef5ca8bbea8d9b7d492b76957516a528dd8032b93d6440ebb8a6ee59ad629654991d7c14c0a0aecfb109148b6dbe76d67bbeedc10fd8
7
- data.tar.gz: c2edb6b9c990e8161d0d4e52137da8585cd615ed1e69ba92d89e25a66f9c7ee1aea94a9cea0c1cbaea0366533bd45c7bb2b972e65003f70e8638bfb2f075ec0e
6
+ metadata.gz: 7ef44ff9c60803a68fa10212ec3062af971c31f9cd891ae7e46d7e7811a901a3856e09fcfaacc103625c5b9f805662ec4ef18e7132c1f210332d3aff254350d5
7
+ data.tar.gz: 1aef7ac40411244ff0226ca03daee9a14b6af5c93ae0b1f238327889ed08f9d259c13fbdb5b40796b6de85cde1ce4329b95e72297ad57d1de369ded5f23d8c66
data/README.md CHANGED
@@ -1,19 +1,72 @@
1
1
  # InterApi
2
2
 
3
- ## Installation
3
+ Wrapper de integração com a API v2 do Banco Inter.
4
4
 
5
- Add inter_api to your Gemfile:
5
+ ### Funcionalidades:
6
+ - Autenticação
7
+ - Pagamento Pix: get, create, update, refund
8
+
9
+ ## Instalação
10
+
11
+ Adicionar inter_api no Gemfile:
6
12
 
7
13
  ```ruby
8
14
  gem 'inter_api'
9
15
  ```
16
+ ou
17
+ ```shell
18
+ bundle add inter_api
19
+ ```
10
20
 
11
- Bundle your dependencies and run the installation generator:
21
+ Instalar a gem:
12
22
 
13
23
  ```shell
14
24
  bin/rails generate inter_api:install
15
25
  ```
16
26
 
17
- ## License
27
+ ## Uso
28
+
29
+ ### Exemplo
30
+ #### Criar Pagamento PIX
31
+ ```ruby
32
+ # Instanciar o API client
33
+ 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")
34
+ # Ao instanciar o objeto, cria um access_token e/ou valida a partir da data de expiração
35
+
36
+ # Criar um pagamento
37
+ 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"])
38
+ # retorna um objeto <InterApi::Payment>
39
+ puts payment.txid # "123123"
40
+ puts payment.status # "ATIVA"
41
+
42
+ # Obter um pagamento a partir do id
43
+ payment = api_client.get_payment(payment.txid)
44
+ # retorna um objeto <InterApi::Payment>
45
+ puts payment.txid # "123123"
46
+ puts payment.status # "ATIVA"
47
+
48
+ # Atualizar um pagamento
49
+ body = { status: "REMOVIDA_PELO_USUARIO_RECEBEDOR" }
50
+ api_client.update(payment.txid, body)
51
+ # retorna o objeto <InterApi::Payment> atualizado
52
+ puts payment.status # "REMOVIDA_PELO_USUARIO_RECEBEDOR"
53
+
54
+ ```
55
+
56
+ #### Métodos do Pagamento
57
+ ```ruby
58
+ payment.valid? # true ou false
59
+
60
+ payment.paid? # true ou false
61
+
62
+ payment.qr_code # retorna o source do SVG
63
+
64
+ payment.reload! # retorna payment atualizado
65
+
66
+ payment.invalidate! # invalida e retorna o payment atualizado
18
67
 
19
- Copyright (c) 2023 ulysses-bull, released under the New BSD License.
68
+ # Reebolso de pagamento
69
+ reembolso = payment.refund(amount: 50.00, refund_nature: "ORIGINAL", description: "Reembolso")
70
+ # retorna o JSON da resposta
71
+ reembolso["status"] # "EM_PROCESSAMENTO"
72
+ ```
@@ -1,5 +1,5 @@
1
1
  # frozen_string_literal: true
2
2
 
3
3
  module InterApi
4
- VERSION = "1.0.2"
4
+ VERSION = "1.0.3"
5
5
  end
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: inter_api
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.0.2
4
+ version: 1.0.3
5
5
  platform: ruby
6
6
  authors:
7
- - ulysses
7
+ - Todas Essas Coisas
8
8
  autorequire:
9
9
  bindir: exe
10
10
  cert_chain: []
11
- date: 2024-06-03 00:00:00.000000000 Z
11
+ date: 2024-06-11 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: ac
@@ -85,13 +85,13 @@ files:
85
85
  - lib/inter_api/payment_error.rb
86
86
  - lib/inter_api/version.rb
87
87
  - sig/inter_api.rbs
88
- homepage: https://github.com/ulysses-bull/inter_api
88
+ homepage: https://github.com/todasessascoisas/inter_api
89
89
  licenses:
90
90
  - MIT
91
91
  metadata:
92
- homepage_uri: https://github.com/ulysses-bull/inter_api
93
- source_code_uri: https://github.com/ulysses-bull/inter_api
94
- changelog_uri: https://github.com/ulysses-bull/inter_api
92
+ homepage_uri: https://github.com/todasessascoisas/inter_api
93
+ source_code_uri: https://github.com/todasessascoisas/inter_api
94
+ changelog_uri: https://github.com/todasessascoisas/inter_api
95
95
  post_install_message:
96
96
  rdoc_options: []
97
97
  require_paths:
@@ -107,7 +107,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
107
107
  - !ruby/object:Gem::Version
108
108
  version: '0'
109
109
  requirements: []
110
- rubygems_version: 3.5.10
110
+ rubygems_version: 3.5.9
111
111
  signing_key:
112
112
  specification_version: 4
113
113
  summary: ''