# Changelog
Todos los cambios notables a este proyecto serán documentados en este archivo.

El formato está basado en [Keep a Changelog](http://keepachangelog.com/en/1.0.0/)
y este proyecto adhiere a [Semantic Versioning](http://semver.org/spec/v2.0.0.html).

## [5.1.0] - 2025-06-17

Esta versión agrega una clase para la nueva funcionalidad de la API de OneClick. Los métodos existentes no tienen cambios.

### Agrega
- Se agrega la clase `MallBinInfo` , la cual contiene el método `queryBin` para la consulta de información de una tarjeta registrada en Oneclick.

## [5.0.0] - 2025-05-05

Esta versión no tiene cambios en el comportamiento de las funcionalidades de la API.

¡Importante!
El SDK ya no apunta por defecto al ambiente de integración. Ahora es necesario configurar de forma explícita las credenciales. Para esto se debe inicializar explícitamente los objetos de los distintos productos, ya sea utilizando la clase Options o a través de los nuevos métodos buildForIntegration y buildForProduction. Además, notar que ahora la versión mínima de PHP soportada es 8.2.

### Agrega
- Se agrega el parámetro timeout para las peticiones a la API, para que pueda modificarse en todos los productos.
- Se agregan los métodos buildForIntegration y buildForProduction a todos los productos.

### Actualiza
- Se configura por defecto el timeout a 600 segundos para todas las peticiones.
- Se refina las respuestas de Oneclick y Transacción completa.
- Se actualizan los test.
- Se actualiza el valor de la constante STATUS_CAPTURED.
- La versión mínima de PHP soportada ahora es 8.2.
- Se actualiza la dependencia de guzzle a versión 7.
- Se actualiza el tipo de excepción lanzada por el método installments de Transacción completa mall.
- Se actualiza la respuesta de Oneclick al eliminar una inscripción. Cuando es exitosa retorna un booleano en true, de lo contrario lanza una excepción.

### Elimina
- Se remueve código sin uso.
- Se elimina el código que hace referencia al producto Webpay Modal.
- Se elimina el código que hace referencia al producto PatPass by Webpay.
- Se eliminan los métodos configureForTesting, configureForTestingNoCVV, configureForTestingDeferred, configureForTestingDeferredNoCVV, configureForTestingMallNoCVV, configureForTestingMall, configureForTestingMallDeferred, configureForTestingMallDeferredNoCVV, configureForIntegration, configureForProduction y getDefaultOptions, de todos los productos que los utilizaban.
- Se eliminan los métodos forProduction y forIntegration de la clase Options.

## [4.0.0] - 2023-12-12

### Changed
- Se hace el downgrade a la versión del API 1.2
- Se eliminan los métodos 'increaseAmount', 'increaseAuthorizationDate', 'reversePreAuthorizedAmount', 'deferredCaptureHistory' a las versiones diferidas de WebpayPlus, WebpayPlus Mall, Oneclick Mall, Transaccion Completa y Transaccion Completa Mall
- Se elimina el campo 'captureExpirationDate'

### Added
- Se agrega un párametro al constructor de la clase `WebpayRequestException`

### Fixed
- Se corrige el namespace en la clase `InscriptionStartException` 

## [3.0.0] - 2022-09-07
### Changed
- Se migra el API desde la versión 1.2 a la versión 1.3
### Added
- Se agrega los métodos 'increaseAmount', 'increaseAuthorizationDate', 'reversePreAuthorizedAmount', 'deferredCaptureHistory' a las versiones diferidas de WebpayPlus, WebpayPlus Mall, Oneclick Mall, Transaccion Completa y Transaccion Completa Mall
- Ahora los métodos status y commit de las versiones diferidas de WebpayPlus, WebpayPlus Mall, Transaccion Completa y Transaccion Completa Mall retornan el campo 'captureExpirationDate'. Para Oneclick Mall este campo también se agrega en los detalles de la autorización

## [2.0.10] - 2022-06-23
### Changed
- Se actualiza por seguridad las versiones minimas de la libreria 'guzzle' hacia '^5.3.1|^6.5.8|^7.4.5'

## [2.0.9] - 2022-04-20
### Fixed
- Se arregla retorno de método isApproved cuando la respuesta de la API es null

## [2.0.8] - 2021-11-29
### Fixed
- Se arregla retorno de método success en respuesta de reembolso en Webpay Plus

## [2.0.7] - 2021-11-09
### Fixed
- Se arreglan llamadas a Guzzle en versión 5. [PR #222](https://github.com/TransbankDevelopers/transbank-sdk-php/pull/222)

## [2.0.6] - 2021-07-12
### Fixed
- Si no se puede obtener la versión instalada del paquete a través de composer, el proceso ya no lanza una excepción. [PR #218](https://github.com/TransbankDevelopers/transbank-sdk-php/pull/218)

## [2.0.5] - 2021-07-06
### Fixed
- Se arregla _trailing comma_ al final de un método de Oneclick que provocaba problemas de compatibilidad con PHP 7.0 [PR #216](https://github.com/TransbankDevelopers/transbank-sdk-php/pull/216) 

## [2.0.4] - 2021-07-01
### Added
- Se agrega validación al parámetro de los métodos `Webpay/WebpayPlus/Transaction::commit($token)` y `Webpay/WebpayPlus/MallTransaction::commit($token)` para  evitar que lleguen token nulos, vacíos o distintos a string, en caso de no cumplir lanza la excepción `InvalidArgumentException`. 

### Fixed
- Se corrige parámetro de redirección `Webpay/Oneclick/Responses/InscriptionStartResponse::getRedirectUrl()`
- Se reordena el código en la clase `Onepay/BaseRequest`, declarando los atributos "$apiKey" y "$appKey"  como privados y se elimina el atributo "$generateOttQrCode" que ya existe en su clase hija `Onepay/BaseResponse`.
- Se reordena el código de la clase `Onepay/BaseResponse`, declarando los atributos "$responseCode" y "$description" como privados.
- Se reordena el código de la clase `Onepay/TransactionCreateRequest`, declarando los atributos "$issuedAt" y "$widthHeight" como privados.
- Se corrige el nombramiento del constructor `TransbankException` y la invocación del constructor del padre.
- Se corrige la invocación del constructor padre en las clases `Onepay/Exceptions/SignException`, `Onepay/Exceptions/TransactionCommitException`, `Onepay/Exceptions/TransactionCreateException`.
- Se elimina la coma sobrante en los arrays y se corrige el uso de la función `join` en el tratamiento de errores de la clase `Onepay/OnepayBase`.
- Se corrige comentarios en la clase `Utils/HasTransactionStatus` 
- Se corrige el trait ConfiguresEnvironment 

## [2.0.3] - 2021-05-10
- Se arreglan URL de Transacción Completa con un `/` extra.

## [2.0.2] - 2021-04-26
- Se arregla error cuando la clase 'InstalledVersion' de composer no existe
- Cambia self:: por static:: para mejorar extensión de clases a través de herencia. 

## [2.0.1] - 2021-04-14
- Se agrega campo CVV a creación de transacción completa mall
- Se mejora respuesta de Commit y Success de Transacción Completa
- Se define PHP 7.0 como versión mínima en composer.json

## [2.0] - 2021-04-13
- Se elimina el uso de métodos estáticos, en reemplazo del manejo de instancias de cada clase, para mejorar el testing e implementar un mejor patrón de diseño del código. Más detalles [aquí](https://github.com/TransbankDevelopers/transbank-sdk-php/pull/182)
- Se separa clase de Webpay Plus Mall. Ahora existe `WebpayPlus\Transaction` y `WebpayPlus\MallTransaction`
- Se mejoran los tests internos del código.
- Al no usar clases estáticas, permite mejorar la implementación de tests dentro del código donde se use, simulando el API de Transbank sin realizar las llamadas realmente (Mock)
- Todos los métodos apuntan a la versión 1.2 del API de Transbank, por lo que ahora las redirecciones de vuelta en el returnUrl serán por GET en vez de POST.
- Se mejoran los namespaces de las clases de respuesta que devuelven los métodos.
- Se optimiza y ordena mejor el código internamente.
- Se aplica _coding style_ de StyleCI en todo el repositorio.
- Se eliminan y dependencias relacionadas a la API SOAP de Transbank.
- Se añade soporte para el producto "Webpay Modal".
- Los productos que devuelven transacciones del tipo Mall, ahora cada detalle es un objeto `TransactionDetail` en vez de un array.
- Se crea interfaz que permite cambiar la implementación del HttpClient, en caso de no querer utilizar Guzzle.
- Se renombra en todos lados de `getStatus` a solo `status` en los métodos de los productos.
- Ahora cada método si falla, llama a su propia excepción. Todas las excepciones relacionadas con unn falló en algún método y que el API responda con un error, heredan de la clase `WebpayRequestException`.
- Ahora las excepciones contienen el detalle del request que se envió para poder "debugear" de mejor forma.
- Ahora cada excepción devuelve el mensaje de error más ordenado, con el detalle de la respuesta del API de Transbank.
- Se añade imagen al readme del proyecto [PR 184](https://github.com/TransbankDevelopers/transbank-sdk-php/pull/184)
- Se deja de dar soporte a PHP 5.6.


## [2.0-beta] - 2021-04-05
- Se elimina el uso de métodos estáticos, en reemplazo de el manejo de instancias de cada clase, para mejorar el testing e implementar un mejor patrón de diseño del código. Más detalles [aquí](https://github.com/TransbankDevelopers/transbank-sdk-php/pull/182)
- Se separa clase de Webpay Plus Mall. Ahora existe `WebpayPlus\Transaction` y `WebpayPlus\MallTransaction` 
- Se mejoran los tests internos del código. 
- El no uso de clases estáticas ahora permite mejorar la implementación de tests dentro del código donde se use, simulando el API de Transbank sin realizar las llamadas realmente (Mock)
- Todos los métodos apuntan a la versión 1.2 del API de Transbank, por lo que ahora las redirecciones de vuelta en el returnUrl serán por GET en vez de POST. 
- Se mejoran los namespaces de las clases de Respuesta que devuelen los métodos. 
- Se optimiza y ordena mejor el código internamente.
- Se aplica _coding style_ de StyleCI en todo el respositorio. 
- Se eliminan y dependencias relacionadas al API SOAP de Transbank. 
- Se añade soporte para el producto "Webpay Modal".
- Los productos que devuelven transaciones del tipo Mall, ahora cada detalle es un objeto `TransactionDetail` en vez de un array. 
- Se crea interfaz que permite cambiar la implementación del HttpClient, en caso de no querer utilizar Guzzle. 
- Se renombra en todos lados de `getStatus` a solo `status` en los métodos de los productos. 
- Ahora cada método si falla, llama a su propia excepción. Todas las exepciones relacionadas con unn falló en algún método y que el API responda con un error, heredan de la clase `WebpayRequestException`. 
- Ahora las excepciones contienen el detalle del request que se envió para poder "debugear" de mejor forma. 
- Ahora cada excepción devuelve el mensaje de error más ordenado, con el detalle de la respuesta del API de Transbank.
- Se añade imagen al readme del proyecto [PR 184](https://github.com/TransbankDevelopers/transbank-sdk-php/pull/184)
- Se deja de dar soporte a PHP 5.6. 

## [1.10.1] - 2020-12-21
### Fixed
- Se soluciona error de syntax en algunos archivos
- Se añade `TransaccionCompleta::configureMallForTesting()` 

## [1.10.0] - 2020-12-10
### Added
- Se agrega soporte para Oneclick Mall Captura Diferida
- Se agrega helper para pasar a produccion Oneclick `Oneclick::configureForProduction($commerceCode, $apiKeySecret)`

### Fixed
- El response code de la respuesta de una reversa en Oneclick ya no es ignorado por el SDK.

## [1.9.0] - 2020-12-09
### Added
- Se agrega método helper `WebpayPlus::configureForProduction($commerceCode, $apiKeySecret)` [PR #153](https://github.com/TransbankDevelopers/transbank-sdk-php/pull/153)
- Se añade travis para automatizar release en github - Se agrega método helper `WebpayPlus::configureForProduction($commerceCode, $apiKeySecret)` [PR #147](https://github.com/TransbankDevelopers/transbank-sdk-php/pull/147)

### Fixed
- Se mejora el formato del código (PSR-2) [PR #156](https://github.com/TransbankDevelopers/transbank-sdk-php/pull/156)
- Se mejora orden de archivos y carpetas para ser compatible con PSR-4 y evitar problema al instalar SDK usando composer2 [PR #157](https://github.com/TransbankDevelopers/transbank-sdk-php/pull/157)
- Se resuelve error con parámetro `installments_number` que venía vacío al hacer un `commit` en Webpay Plus - Se agrega método helper `WebpayPlus::configureForProduction($commerceCode, $apiKeySecret)` [PR #150](https://github.com/TransbankDevelopers/transbank-sdk-php/pull/150)

## [1.8.2] - 2020-11-20
### Fixed
- Ahora el SDK soporta tres versiones de Guzzle, para evitar conflictos de versiones: Guzzle 5.X, 6.X y 7.X. [PR #144](https://github.com/TransbankDevelopers/transbank-sdk-php/pull/144)      

## [1.8.1] - 2020-10-26
### Fixed
- Se resuelve error de autoloading en clase TransaccionCompleta [PR #142](https://github.com/TransbankDevelopers/transbank-sdk-php/pull/142)   

## [1.8.0] - 2020-10-19
### Added
- Se publican clases y métodos para integrar nueva API REST.  

## [1.7.3] - 2020-10-14
### Fixed
- Soluciona error que producía que la clase Oneclick (REST) no se encontrara [PR #132](https://github.com/TransbankDevelopers/transbank-sdk-php/pull/132)
- Se actualizan dependencias [PR #133](https://github.com/TransbankDevelopers/transbank-sdk-php/pull/133)

## [1.7.2] - 2020-08-06
### Fixed
- Arreglo error que se ocasionaba al tratar de leer el serial number de un certificado usando PHP 5.6 [PR #130](https://github.com/TransbankDevelopers/transbank-sdk-php/pull/130)

## [1.7.1] - 2020-07-09
### Fixed
- Se arregló llamada a método de clase que había sido previamente eliminada

## [1.7.0] - 2020-06-22
### Fixed
- Se arregló error de opciones por defecto en Oneclick Mall REST [PR #123](https://github.com/TransbankDevelopers/transbank-sdk-php/pull/123)
- Se arregló forma en que se retornan los errores en Oneclick Mall REST [PR #124](https://github.com/TransbankDevelopers/transbank-sdk-php/pull/124)
- Importante: se arregla error "For input string 0xAB" al user certificados generados con OpenSSL 1.1 [PR #125](https://github.com/TransbankDevelopers/transbank-sdk-php/pull/125)

### Added
- Se agregaron validaciones numéricas y de decimales a Webpay Plus `init Transaction` [PR #122](https://github.com/TransbankDevelopers/transbank-sdk-php/pull/122)

## [1.6.1] - 2020-02-20
### Fixed
- Se agrega soporte a las versiones de guzzle superiores a >= 6 y < 7 [https://github.com/TransbankDevelopers/transbank-sdk-php/pull/113].
- Se sube el soporte de la versión de php a 7.4 [https://github.com/TransbankDevelopers/transbank-sdk-php/pull/117].
- Se crea el archivo security.md [https://github.com/TransbankDevelopers/transbank-sdk-php/pull/115].
- La extensión SOAP de PHP es requerida [https://github.com/TransbankDevelopers/transbank-sdk-php/pull/99].

## [1.6.0] - 2019-12-26
### Added
- Se agrega soporte para Oneclick Mall y Transacción Completa en sus versiones REST.

## [1.5.3] - 2019-10-17
### Fixed
- Se corrige utilización de puerto 80 en las peticiones SOAP.

## [1.5.2] - 2019-05-22
### Fixed
- Se corrige asignación de certificado de Webpay cuando no es asignado en la configuración, se asigna automáticamente en base al entorno.

## [1.5.1] - 2019-01-08
### Changed
- Se elimina la condición de `VCI == "TSY" || VCI == ""` para evaluar la respuesta de `getTransactionResult` debido a que
esto podría traer problemas con transacciones usando tarjetas internacionales.

## [1.5.0] - 2018-12-20
### Added
- Se agrega soporte para poder configurar `$commerceLogoUrl` y `$qrWidthHeight`. El primero entrega soporte para que el 
app de onepay pueda mostrar el logo de comercio, mientras que el segundo entrega la posibilidad de pedir que la imagen 
QR venga en un tamaño especifico (útil para la modalidad de QR directo.)

## [1.4.4] - 2018-12-12
### Fixed
- Se corrige un problema con los nombres de archivos de varias clases que provocaba errores principalmente en Linux. Esto corrige además el problema reportado con Larabel.

## [1.4.3] - 2018-11-06
### Fixed
- Se actualiza certificado de producción requerido para que webpay funcione correctamente.

## [1.4.2] - 2018-10-31
### Added
- Soporte PHP 7+ para Webpay.
### Fixed
- Se estaba usando buy order como monto y monto como buy order en webpay mall normal. 

## [1.4.1] - 2018-10-27
### Fixed
- Se corrige carga de extensiones en Onepay, no requiere tener extensiones que usa
Webpay SOAP.

## [1.4.0] - 2018-10-25
### Added
- Incorpora soporte Webpay SOAP en PHP 5.x (No soporta PHP 7 aún)
### Changed
- El carro de compras soporta agregar items con valores negativos. Útil en caso
de necesitar incluir descuentos.

## [1.3.2] - 2018-10-03
### Fixed
- Se corrige el orden de clases cargadas en el archivo init.php para ser usado sin problemas
cuando no se usa composer.

## [1.3.1] - 2018-09-11
### Fixed
- `OnepayRequestBuilder::buildOptions` no setea el appKey correcto en caso que se entregue como base
un `options` nulo. Se corrige este error seteando en el constructor de `options` el appKey
correcto en vez de dejarlo null.

## [1.3.0] - 2018-09-10
### Added
- Configuración de las credenciales de integración por defecto. Ya no será necesario que
configures API_KEY o SHARED_SECRET si quieres trabajar en ambiente TEST.

## [1.2.2] - 2018-08-30
### Changed
- Apunta entornos a los servidores oficiales para `TEST` y `LIVE`. De ahora en
adelante, el SDK puede ser usado para validaciones oficiales y será
interoperable con las herramientas provistas por Transbank para ayudar esa
integración y validación (como el dashboard para simular transacciones).
