transbank-sdk 5.0.0 → 5.1.0
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.
- checksums.yaml +4 -4
- data/.github/workflows/build.yml +54 -0
- data/CHANGELOG.md +8 -0
- data/README.md +46 -32
- data/lib/transbank/sdk/version.rb +1 -1
- data/lib/transbank/sdk/webpay/oneclick/mall_bin_info.rb +48 -0
- data/lib/transbank/sdk.rb +1 -1
- data/sonar-project.properties +7 -0
- data/transbank-sdk.gemspec +2 -0
- metadata +33 -2
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
SHA256:
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
3
|
+
metadata.gz: 17224cebe57ae3aefb293a9a5abd2b424eb8dc46c7f5ca7a153efce70b00db5d
|
|
4
|
+
data.tar.gz: 9cb85dec83cdf31ab6c0b7cb461fd386f6efb4c16c3a36a57c3eedb124c40d51
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
6
|
+
metadata.gz: de1b9c69dd772317fad521375cb47c9ea4188db9d029a57ca294f12fdd07c9c212ff69ed5f9b82255d3c99da148829b8efd1b121492ee6e082323e796ef4c436
|
|
7
|
+
data.tar.gz: dbb0d99de1dcc0aa8a14a4e6d17749c01927e6b7a8bcf867ffc1b5e7181fe8ea1dce40fd1a1c08b3a0f14b5935864b3cf800d096c5cf42675e3bfc2826b3ff39
|
|
@@ -0,0 +1,54 @@
|
|
|
1
|
+
name: Ruby CI
|
|
2
|
+
|
|
3
|
+
on:
|
|
4
|
+
pull_request:
|
|
5
|
+
types: [synchronize, opened, reopened]
|
|
6
|
+
|
|
7
|
+
jobs:
|
|
8
|
+
build:
|
|
9
|
+
runs-on: ubuntu-latest
|
|
10
|
+
|
|
11
|
+
steps:
|
|
12
|
+
- uses: actions/checkout@v4
|
|
13
|
+
with:
|
|
14
|
+
fetch-depth: 0
|
|
15
|
+
|
|
16
|
+
- name: Set up Ruby
|
|
17
|
+
uses: ruby/setup-ruby@v1
|
|
18
|
+
with:
|
|
19
|
+
ruby-version: '3.1'
|
|
20
|
+
|
|
21
|
+
- name: Install dependencies
|
|
22
|
+
run: |
|
|
23
|
+
gem install bundler
|
|
24
|
+
bundle install
|
|
25
|
+
|
|
26
|
+
- name: Run tests
|
|
27
|
+
run: bundle exec rake test
|
|
28
|
+
|
|
29
|
+
sonar-cloud-check:
|
|
30
|
+
runs-on: ubuntu-latest
|
|
31
|
+
|
|
32
|
+
steps:
|
|
33
|
+
- uses: actions/checkout@v4
|
|
34
|
+
with:
|
|
35
|
+
fetch-depth: 0
|
|
36
|
+
|
|
37
|
+
- name: Set up Ruby
|
|
38
|
+
uses: ruby/setup-ruby@v1
|
|
39
|
+
with:
|
|
40
|
+
ruby-version: '3.1'
|
|
41
|
+
|
|
42
|
+
- name: Install dependencies
|
|
43
|
+
run: |
|
|
44
|
+
gem install bundler
|
|
45
|
+
bundle install
|
|
46
|
+
|
|
47
|
+
- name: Run tests with coverage
|
|
48
|
+
run: bundle exec rake test
|
|
49
|
+
|
|
50
|
+
- name: SonarQube Scan
|
|
51
|
+
uses: sonarsource/sonarqube-scan-action@master
|
|
52
|
+
env:
|
|
53
|
+
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
|
|
54
|
+
SONAR_TOKEN: ${{ secrets.SONAR_TOKEN }}
|
data/CHANGELOG.md
CHANGED
|
@@ -5,6 +5,14 @@ Todos los cambios notables a este proyecto serán documentados en este archivo.
|
|
|
5
5
|
El formato está basado en [Keep a Changelog](http://keepachangelog.com/en/1.0.0/)
|
|
6
6
|
y este proyecto adhiere a [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
|
|
7
7
|
|
|
8
|
+
## [5.1.0] - 2025-06-23
|
|
9
|
+
|
|
10
|
+
Esta versión agrega una clase para la nueva funcionalidad de la API de OneClick. Los métodos existentes no tienen cambios.
|
|
11
|
+
|
|
12
|
+
### Agrega
|
|
13
|
+
|
|
14
|
+
- Se agrega la clase `MallBinInfo` , la cual contiene el método `query_bin` para la consulta de información de una tarjeta registrada en Oneclick.
|
|
15
|
+
|
|
8
16
|
## [5.0.0] - 2025-05-05
|
|
9
17
|
|
|
10
18
|
Esta versión no tiene cambios en el comportamiento de las funcionalidades de la API.
|
data/README.md
CHANGED
|
@@ -4,7 +4,7 @@ SDK Oficial de Transbank
|
|
|
4
4
|
|
|
5
5
|
## Requisitos:
|
|
6
6
|
|
|
7
|
-
- Ruby 2.
|
|
7
|
+
- Ruby 2.7+
|
|
8
8
|
|
|
9
9
|
# Instalación
|
|
10
10
|
|
|
@@ -26,6 +26,12 @@ y luego ejecutar
|
|
|
26
26
|
bundle install
|
|
27
27
|
```
|
|
28
28
|
|
|
29
|
+
## Ejecutar Test
|
|
30
|
+
|
|
31
|
+
```bash
|
|
32
|
+
bundle exec rake test
|
|
33
|
+
```
|
|
34
|
+
|
|
29
35
|
## Documentación
|
|
30
36
|
|
|
31
37
|
Puedes encontrar toda la documentación de cómo usar este SDK en el sitio https://www.transbankdevelopers.cl.
|
|
@@ -35,9 +41,22 @@ La documentación relevante para usar este SDK es:
|
|
|
35
41
|
- Documentación sobre [ambientes, deberes del comercio, puesta en producción,
|
|
36
42
|
etc](https://www.transbankdevelopers.cl/documentacion/como_empezar#ambientes).
|
|
37
43
|
|
|
38
|
-
## Información para contribuir y desarrollar este SDK
|
|
39
44
|
|
|
40
|
-
|
|
45
|
+
## Información para contribuir a este proyecto
|
|
46
|
+
|
|
47
|
+
### Forma de trabajo
|
|
48
|
+
|
|
49
|
+
- Para los mensajes de commits, nos basamos en las [Git Commit Guidelines de Angular](https://github.com/angular/angular.js/blob/master/DEVELOPERS.md#commits).
|
|
50
|
+
- Usamos inglés para los nombres de ramas y mensajes de commit.
|
|
51
|
+
- Los mensajes de commit no deben llevar punto final.
|
|
52
|
+
- Los mensajes de commit deben usar un lenguaje imperativo y estar en tiempo presente, por ejemplo, usar "change" en lugar de "changed" o "changes".
|
|
53
|
+
- Los nombres de las ramas deben estar en minúsculas y las palabras deben separarse con guiones (-).
|
|
54
|
+
- Todas las fusiones a la rama principal se deben realizar mediante solicitudes de Pull Request(PR). ⬇️
|
|
55
|
+
- Se debe emplear tokens como "WIP" en el encabezado de un commit, separados por dos puntos (:), por ejemplo, "WIP: this is a useful commit message".
|
|
56
|
+
- Una rama con nuevas funcionalidades que no tenga un PR, se considera que está en desarrollo.
|
|
57
|
+
- Los nombres de las ramas deben comenzar con uno de los tokens definidos. Por ejemplo: "feat/tokens-configurations".
|
|
58
|
+
|
|
59
|
+
### Short lead tokens permitidos
|
|
41
60
|
|
|
42
61
|
`WIP` = En progreso.
|
|
43
62
|
|
|
@@ -61,45 +80,40 @@ La documentación relevante para usar este SDK es:
|
|
|
61
80
|
|
|
62
81
|
`release` = Para liberar una nueva versión.
|
|
63
82
|
|
|
64
|
-
###
|
|
65
|
-
|
|
66
|
-
- Para los commits respetamos las siguientes normas: https://chris.beams.io/posts/git-commit/
|
|
67
|
-
- Usamos ingles, para los mensajes de commit.
|
|
68
|
-
- Se pueden usar tokens como WIP, en el subject de un commit, separando el token con `:`, por ejemplo:
|
|
69
|
-
`WIP: This is a useful commit message`
|
|
70
|
-
- Para los nombres de ramas también usamos ingles.
|
|
71
|
-
- Se asume, que una rama de feature no mezclada, es un feature no terminado.
|
|
72
|
-
- El nombre de las ramas va en minúsculas.
|
|
73
|
-
- Las palabras se separan con `-`.
|
|
74
|
-
- Las ramas comienzan con alguno de los short lead tokens definidos, por ejemplo: `feat/tokens-configuration`
|
|
83
|
+
### Creación de un Pull Request
|
|
75
84
|
|
|
76
|
-
|
|
85
|
+
- El PR debe estar enfocado en un cambio en concreto, por ejemplo, agregar una nueva funcionalidad o solucionar un error, pero un solo PR no puede agregar una nueva funcionalidad y arreglar un error.
|
|
86
|
+
- El título del los PR y mensajes de commit no debe comenzar con una letra mayúscula.
|
|
87
|
+
- No se debe usar punto final en los títulos.
|
|
88
|
+
- El título del PR debe comenzar con el short lead token definido para la rama, seguido de ":"" y una breve descripción del cambio.
|
|
89
|
+
- La descripción del PR debe detallar los cambios que se están incorporando.
|
|
90
|
+
- La descripción del PR debe incluir evidencias de que los test se ejecutan de forma correcta o incluir evidencias de que los cambios funcionan y no afectan la funcionalidad previa del proyecto.
|
|
91
|
+
- Se pueden agregar capturas, gif o videos para complementar la descripción o demostrar el funcionamiento del PR.
|
|
77
92
|
|
|
78
|
-
|
|
79
|
-
2. El PR debe tener 2 o más aprobaciones para poder mezclarse.
|
|
80
|
-
3. Si un commit revierte un commit anterior deberá comenzar con "revert:" seguido del mensaje del commit anterior.
|
|
93
|
+
#### Flujo de trabajo
|
|
81
94
|
|
|
82
|
-
|
|
95
|
+
1. Crea tu rama desde develop.
|
|
96
|
+
2. Haz un push de los commits y publica la nueva rama.
|
|
97
|
+
3. Abre un Pull Request apuntando tus cambios a develop.
|
|
98
|
+
4. Espera a la revisión de los demás integrantes del equipo.
|
|
99
|
+
5. Para poder mezclar los cambios se debe contar con 2 aprobaciones de los revisores y no tener alertas por parte de las herramientas de inspección.
|
|
83
100
|
|
|
84
|
-
|
|
85
|
-
- El título del los PR y mensajes de commit no pueden comenzar con una letra mayúscula.
|
|
86
|
-
- No se debe usar punto final en los títulos o descripción de los commits.
|
|
87
|
-
- El título del PR debe comenzar con el short lead token definido para la rama, seguido de : y una breve descripción del cambio.
|
|
88
|
-
- La descripción del PR debe detallar los cambios.
|
|
89
|
-
- La descripción del PR debe incluir evidencias de que los test se ejecutan de forma correcta.
|
|
90
|
-
- Se pueden usar gif o videos para complementar la descripción o evidenciar el funcionamiento del PR.
|
|
101
|
+
### Esquema de flujo con git
|
|
91
102
|
|
|
92
|
-
|
|
103
|
+
|
|
93
104
|
|
|
94
|
-
|
|
105
|
+
## Generar una nueva versión
|
|
95
106
|
|
|
96
|
-
Para generar una nueva versión, se debe crear un PR (con un título "
|
|
107
|
+
Para generar una nueva versión, se debe crear un PR (con un título "release: prepare release X.Y.Z" con los valores que correspondan para `X`, `Y` y `Z`). Se debe seguir el estándar [SemVer](https://semver.org/lang/es/) para determinar si se incrementa el valor de `X` (si hay cambios no retrocompatibles), `Y` (para mejoras retrocompatibles) o `Z` (si sólo hubo correcciones a bugs).
|
|
97
108
|
|
|
98
109
|
En ese PR deben incluirse los siguientes cambios:
|
|
99
110
|
|
|
100
|
-
1. Modificar el archivo `CHANGELOG.md` para incluir una nueva entrada (al comienzo) para `X.Y.Z` que explique en español los cambios
|
|
101
|
-
2. Modificar [version.rb](./lib/transbank/sdk/version.rb)
|
|
111
|
+
1. Modificar el archivo `CHANGELOG.md` para incluir una nueva entrada (al comienzo) para `X.Y.Z` que explique en español los cambios.
|
|
112
|
+
2. Modificar el archivo [version.rb](./lib/transbank/sdk/version.rb) y modificar la versión.
|
|
102
113
|
|
|
103
|
-
Luego de obtener aprobación del
|
|
114
|
+
Luego de obtener aprobación del PR, debe mezclarse a master e inmediatamente generar un release en GitHub con el tag `vX.Y.Z`. En la descripción del release debes poner lo mismo que agregaste al changelog.
|
|
104
115
|
|
|
105
116
|
Con eso Github Actions generará automáticamente una nueva versión de la librería y la publicará en RubyGems.
|
|
117
|
+
|
|
118
|
+
|
|
119
|
+
Posterior a la liberación debes mezclar la rama release en develop, finalmente realizar un rebase de la rama develop utilizando como base la rama main.
|
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
module Transbank
|
|
2
|
+
module Webpay
|
|
3
|
+
module Oneclick
|
|
4
|
+
class MallBinInfo < ::Transbank::Common::BaseTransaction
|
|
5
|
+
private_class_method :new
|
|
6
|
+
RESOURCES_URL = ::Transbank::Common::ApiConstants::ONECLICK_ENDPOINT
|
|
7
|
+
QUERY_BIN_ENDPOINT = (RESOURCES_URL + '/bin_info').freeze
|
|
8
|
+
|
|
9
|
+
def initialize(options)
|
|
10
|
+
super
|
|
11
|
+
end
|
|
12
|
+
|
|
13
|
+
def self.new(options)
|
|
14
|
+
super(options)
|
|
15
|
+
end
|
|
16
|
+
|
|
17
|
+
def self.build_for_integration(commerce_code, api_key)
|
|
18
|
+
options = Options.new(
|
|
19
|
+
commerce_code,
|
|
20
|
+
api_key,
|
|
21
|
+
:integration
|
|
22
|
+
)
|
|
23
|
+
|
|
24
|
+
new(options)
|
|
25
|
+
end
|
|
26
|
+
|
|
27
|
+
def self.build_for_production(commerce_code, api_key)
|
|
28
|
+
options = Options.new(
|
|
29
|
+
commerce_code,
|
|
30
|
+
api_key,
|
|
31
|
+
:production
|
|
32
|
+
)
|
|
33
|
+
new(options)
|
|
34
|
+
end
|
|
35
|
+
|
|
36
|
+
def query_bin(tbk_user)
|
|
37
|
+
Transbank::Common::Validation.has_text_with_max_length(tbk_user, Transbank::Common::ApiConstants::TBK_USER_LENGTH, "tbk_user")
|
|
38
|
+
|
|
39
|
+
request_service = ::Transbank::Shared::RequestService.new(
|
|
40
|
+
@environment, QUERY_BIN_ENDPOINT, @commerce_code, @api_key, @timeout
|
|
41
|
+
)
|
|
42
|
+
request_service.post({ tbk_user: tbk_user })
|
|
43
|
+
end
|
|
44
|
+
|
|
45
|
+
end
|
|
46
|
+
end
|
|
47
|
+
end
|
|
48
|
+
end
|
data/lib/transbank/sdk.rb
CHANGED
|
@@ -20,9 +20,9 @@ require 'transbank/sdk/webpay/webpay_plus/mall_transaction'
|
|
|
20
20
|
|
|
21
21
|
require 'transbank/sdk/webpay/oneclick/mall_transaction'
|
|
22
22
|
require 'transbank/sdk/webpay/oneclick/mall_inscription'
|
|
23
|
+
require 'transbank/sdk/webpay/oneclick/mall_bin_info'
|
|
23
24
|
|
|
24
25
|
require 'transbank/sdk/webpay/transaccion_completa/transaction'
|
|
25
26
|
require 'transbank/sdk/webpay/transaccion_completa/mall_transaction'
|
|
26
27
|
|
|
27
28
|
require 'transbank/sdk/patpass/patpass_comercio/inscription'
|
|
28
|
-
|
data/transbank-sdk.gemspec
CHANGED
|
@@ -34,4 +34,6 @@ Gem::Specification.new do |spec|
|
|
|
34
34
|
spec.add_development_dependency 'byebug', "~> 11.1"
|
|
35
35
|
spec.add_development_dependency 'pry-byebug', "~> 3.9"
|
|
36
36
|
spec.add_development_dependency 'webmock', "~> 3.19"
|
|
37
|
+
spec.add_development_dependency "simplecov", "~> 0.22"
|
|
38
|
+
spec.add_development_dependency "simplecov_json_formatter", "~> 0.1.4"
|
|
37
39
|
end
|
metadata
CHANGED
|
@@ -1,14 +1,14 @@
|
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
|
2
2
|
name: transbank-sdk
|
|
3
3
|
version: !ruby/object:Gem::Version
|
|
4
|
-
version: 5.
|
|
4
|
+
version: 5.1.0
|
|
5
5
|
platform: ruby
|
|
6
6
|
authors:
|
|
7
7
|
- Transbank Developers
|
|
8
8
|
autorequire:
|
|
9
9
|
bindir: exe
|
|
10
10
|
cert_chain: []
|
|
11
|
-
date: 2025-
|
|
11
|
+
date: 2025-06-23 00:00:00.000000000 Z
|
|
12
12
|
dependencies:
|
|
13
13
|
- !ruby/object:Gem::Dependency
|
|
14
14
|
name: json
|
|
@@ -150,6 +150,34 @@ dependencies:
|
|
|
150
150
|
- - "~>"
|
|
151
151
|
- !ruby/object:Gem::Version
|
|
152
152
|
version: '3.19'
|
|
153
|
+
- !ruby/object:Gem::Dependency
|
|
154
|
+
name: simplecov
|
|
155
|
+
requirement: !ruby/object:Gem::Requirement
|
|
156
|
+
requirements:
|
|
157
|
+
- - "~>"
|
|
158
|
+
- !ruby/object:Gem::Version
|
|
159
|
+
version: '0.22'
|
|
160
|
+
type: :development
|
|
161
|
+
prerelease: false
|
|
162
|
+
version_requirements: !ruby/object:Gem::Requirement
|
|
163
|
+
requirements:
|
|
164
|
+
- - "~>"
|
|
165
|
+
- !ruby/object:Gem::Version
|
|
166
|
+
version: '0.22'
|
|
167
|
+
- !ruby/object:Gem::Dependency
|
|
168
|
+
name: simplecov_json_formatter
|
|
169
|
+
requirement: !ruby/object:Gem::Requirement
|
|
170
|
+
requirements:
|
|
171
|
+
- - "~>"
|
|
172
|
+
- !ruby/object:Gem::Version
|
|
173
|
+
version: 0.1.4
|
|
174
|
+
type: :development
|
|
175
|
+
prerelease: false
|
|
176
|
+
version_requirements: !ruby/object:Gem::Requirement
|
|
177
|
+
requirements:
|
|
178
|
+
- - "~>"
|
|
179
|
+
- !ruby/object:Gem::Version
|
|
180
|
+
version: 0.1.4
|
|
153
181
|
description:
|
|
154
182
|
email:
|
|
155
183
|
- transbankdevelopers@continuum.cl
|
|
@@ -160,6 +188,7 @@ files:
|
|
|
160
188
|
- ".built"
|
|
161
189
|
- ".bundled"
|
|
162
190
|
- ".github/ISSUE_TEMPLATE/reporte-de-error.md"
|
|
191
|
+
- ".github/workflows/build.yml"
|
|
163
192
|
- ".github/workflows/publish-lib.yml"
|
|
164
193
|
- ".gitignore"
|
|
165
194
|
- ".rakeTasks"
|
|
@@ -181,6 +210,7 @@ files:
|
|
|
181
210
|
- lib/transbank/sdk/shared/request_service.rb
|
|
182
211
|
- lib/transbank/sdk/shared/transbank_error.rb
|
|
183
212
|
- lib/transbank/sdk/version.rb
|
|
213
|
+
- lib/transbank/sdk/webpay/oneclick/mall_bin_info.rb
|
|
184
214
|
- lib/transbank/sdk/webpay/oneclick/mall_inscription.rb
|
|
185
215
|
- lib/transbank/sdk/webpay/oneclick/mall_transaction.rb
|
|
186
216
|
- lib/transbank/sdk/webpay/options.rb
|
|
@@ -188,6 +218,7 @@ files:
|
|
|
188
218
|
- lib/transbank/sdk/webpay/transaccion_completa/transaction.rb
|
|
189
219
|
- lib/transbank/sdk/webpay/webpay_plus/mall_transaction.rb
|
|
190
220
|
- lib/transbank/sdk/webpay/webpay_plus/transaction.rb
|
|
221
|
+
- sonar-project.properties
|
|
191
222
|
- transbank-sdk.gemspec
|
|
192
223
|
homepage: https://www.transbankdevelopers.cl/
|
|
193
224
|
licenses:
|