PHPackages                             transbank/transbank-sdk - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. transbank/transbank-sdk

ActiveLibrary[API Development](/categories/api)

transbank/transbank-sdk
=======================

Transbank SDK

5.1.0(11mo ago)62626.4k—6.3%3212BSD-3-ClausePHPPHP &gt;=8.2CI passing

Since Aug 1Pushed 10mo ago5 watchersCompare

[ Source](https://github.com/TransbankDevelopers/transbank-sdk-php)[ Packagist](https://packagist.org/packages/transbank/transbank-sdk)[ RSS](/packages/transbank-transbank-sdk/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (10)Dependencies (3)Versions (53)Used By (12)

[![Build Status](https://github.com/TransbankDevelopers/transbank-sdk-php/actions/workflows/build.yml/badge.svg?branch=master)](https://github.com/TransbankDevelopers/transbank-sdk-php/actions/workflows/build.yml/badge.svg?branch=master)[![Latest Stable Version](https://camo.githubusercontent.com/064acdde6577d046ff9cfd884e32a9a309bfa1c3e7cac05c63f30a6abe3da091/68747470733a2f2f706f7365722e707567782e6f72672f7472616e7362616e6b2f7472616e7362616e6b2d73646b2f762f737461626c65)](https://packagist.org/packages/transbank/transbank-sdk)

Transbank PHP SDK
=================

[](#transbank-php-sdk)

[![transbank-php-sdk](https://user-images.githubusercontent.com/1103494/113464583-14856a80-9404-11eb-947e-dd4dd4ff6510.png)](https://user-images.githubusercontent.com/1103494/113464583-14856a80-9404-11eb-947e-dd4dd4ff6510.png)

Requisitos:
-----------

[](#requisitos)

- PHP 8.2+

Dependencias
------------

[](#dependencias)

Para utilizar este SDK, debes tener las siguientes extensiones de PHP instaladas:

- ext-curl
- ext-json
- ext-mbstring

Instalación
===========

[](#instalación)

### Instalar con Composer

[](#instalar-con-composer)

Para usar el SDK en tu proyecto **debes** usar Composer (si no lo tienes instalado, puedes instalarlo [acá](https://getcomposer.org/)), añadiendo el SDK como dependencia a tu proyecto:

```
    "require": {
        ...
        "transbank/transbank-sdk": "~5.0"
    }
```

Luego debes correr

```
composer update

```

También puedes instalarlo directamente desde la consola:

```
composer require transbank/transbank-sdk:~5.0
```

#### Despues de instalar...

[](#despues-de-instalar)

Si es primera vez que usas composer en tu proyecto, se creará una carpeta `vendor/` con el SDK y todo lo necesario. Te recomendamos leer como funciona Composer, pero para comentar un punto importante, ahora asegúrate de que se incluye el archivo `vendor/autoload.php` en tu proyecto, idealmente al inicio de todo tu código.

Si tu proyecto ya usa composer, la librería ya estará disponible para ser usaada sin que tengas que hacer nada adicional.

#### Hosting compartido (no recomendado)

[](#hosting-compartido-no-recomendado)

Si usas un hosting compartido o un ambiente donde no tienes acceso para instalar Composer, no te preocupes: Puedes instalar composer en tu propio computador, instalar el paquete como se indica anteriormente, y luego subir por FTP, SSH o como sea, todos los archivos del proyecto. No es necesario tener instalado composer en el servidor. Solo es necesario que los archivos generados tras la instalación de composer si estén. De todas formas, te recomendamos usar algún servidor VPS o dedicado, donde tendrás mas control de tu sistema.

Ejemplos de código básicos
--------------------------

[](#ejemplos-de-código-básicos)

Dejamos **algunos** ejemplos básicos de código en la carpeta `examples` de este repositorio que te recomendamos revisar. Puedes ejecutar este ejemplo entrando a esta carpeta en tu terminal y ejecutando un servidor de PHP:

```
cd /path/to/this/sdk
cd examples
php -S 127.0.0.1:8000
```

Luego, solo abre \[\] en tu navegador web.

Proyecto de ejemplo completo
----------------------------

[](#proyecto-de-ejemplo-completo)

Adicionalmente, creamos un proyecto de ejemplo donde se implementan todos los productos y modalidades acá:

Documentación Transbank Developers
----------------------------------

[](#documentación-transbank-developers)

Puedes encontrar toda la documentación de cómo usar este SDK en el sitio .

La documentación relevante para usar este SDK es:

- Primeros pasos con [Webpay](https://www.transbankdevelopers.cl/documentacion/webpay)
- Documentación sobre [ambientes, deberes del comercio, puesta en producción, etc](https://www.transbankdevelopers.cl/documentacion/como_empezar#ambientes).

También puedes encontrar:

- Documentación general sobre los productos y sus diferencias: [Webpay](https://www.transbankdevelopers.cl/producto/webpay) y [Onepay](https://www.transbankdevelopers.cl/producto/onepay).
- Referencia detallada sobre [Webpay](https://www.transbankdevelopers.cl/referencia/webpay) y [Onepay](https://www.transbankdevelopers.cl/referencia/onepay).

Información para contribuir y desarrollar este SDK
--------------------------------------------------

[](#información-para-contribuir-y-desarrollar-este-sdk)

### Estándares

[](#estándares)

- Para los commits respetamos las siguientes normas:
- Usamos ingles, para los mensajes de commit.
- Se pueden usar tokens como WIP, en el subject de un commit, separando el token con `:`, por ejemplo: `WIP: This is a useful commit message`
- Para los nombres de ramas también usamos ingles.
- Se asume, que una rama de feature no mezclada, es un feature no terminado.
- El nombre de las ramas va en minúsculas.
- Las palabras se separan con `-`.
- Las ramas comienzan con alguno de los short lead tokens definidos, por ejemplo: `feat/tokens-configuration`

#### Short lead tokens

[](#short-lead-tokens)

##### Commits

[](#commits)

- WIP = Trabajo en progreso.

##### Ramas

[](#ramas)

- feat = Nuevos features
- chore = Tareas, que no son visibles al usuario.
- bug = Resolución de bugs.

### Todas las mezclas a master se hacen mediante Pull Request.

[](#todas-las-mezclas-a-master-se-hacen-mediante-pull-request)

### Test

[](#test)

Para ejecutar los test localmente debes ejecutar los siguientes comandos en una terminal.

```
make
```

Y luego ejecutar los test

```
make test
```

### Deploy de una nueva versión.

[](#deploy-de-una-nueva-versión)

Para generar una nueva versión, se debe crear un PR (con un título "Prepare release X.Y.Z" con los valores que correspondan para `X`, `Y` y `Z`). Se debe seguir el estándar semver 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).

En ese PR deben incluirse los siguientes cambios:

1. Modificar el archivo `CHANGELOG.md` para incluir una nueva entrada (al comienzo) para `X.Y.Z` que explique en español los cambios **de cara al usuario del SDK**.
2. Modificar este `README.md` para que los ejemplos usen la nueva versión `X.Y.Z`

Luego de obtener aprobación del pull request, debe mezclarse a master e inmediatamente generar un release en GitHub con el tag `X.Y.Z`. En la descripción del release debes poner lo mismo que agregaste al changelog.

Con eso Travis CI generará automáticamente una nueva versión de la librería y la publicará en Packagist.

### Vulnerabilidades de seguridad

[](#vulnerabilidades-de-seguridad)

Si descubres una falla de seguridad dentro de este proyecto, por favor, notifícanos por correo electrónico a . Tomaremos el caso con la mayor celeridad.

###  Health Score

60

—

FairBetter than 99% of packages

Maintenance52

Moderate activity, may be stable

Popularity52

Moderate usage in the ecosystem

Community36

Small or concentrated contributor base

Maturity88

Battle-tested with a long release history

 Bus Factor3

3 contributors hold 50%+ of commits

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~50 days

Recently: every ~210 days

Total

51

Last Release

335d ago

Major Versions

1.10.1 → 2.0-beta2021-04-06

1.10.2 → 2.0.72021-11-09

2.0.10 → 3.0.02022-09-07

1.10.3 → 4.0.02023-12-12

4.0.0 → 5.0.02025-05-05

PHP version history (5 changes)1.0.0PHP &gt;=5.4.0

1.4.0PHP &gt;=5.5.0

1.6.0PHP &gt;=5.6.0

2.0.1PHP &gt;=7.0

5.0.0PHP &gt;=8.2

### Community

Maintainers

![](https://www.gravatar.com/avatar/0de371c5c4674075bc272f2f1deb7810b683130beaca721f768a9b733095c00d?d=identicon)[TransbankDevelopers](/maintainers/TransbankDevelopers)

---

Top Contributors

[![eugenioLopezRamos](https://avatars.githubusercontent.com/u/17009559?v=4)](https://github.com/eugenioLopezRamos "eugenioLopezRamos (302 commits)")[![Matiasnickolas](https://avatars.githubusercontent.com/u/101830551?v=4)](https://github.com/Matiasnickolas "Matiasnickolas (222 commits)")[![gdespirito](https://avatars.githubusercontent.com/u/1103494?v=4)](https://github.com/gdespirito "gdespirito (186 commits)")[![gasspper](https://avatars.githubusercontent.com/u/59769869?v=4)](https://github.com/gasspper "gasspper (88 commits)")[![goncafa](https://avatars.githubusercontent.com/u/22456067?v=4)](https://github.com/goncafa "goncafa (82 commits)")[![mastudillot](https://avatars.githubusercontent.com/u/36648048?v=4)](https://github.com/mastudillot "mastudillot (78 commits)")[![mvarlic](https://avatars.githubusercontent.com/u/7391252?v=4)](https://github.com/mvarlic "mvarlic (51 commits)")[![themakunga](https://avatars.githubusercontent.com/u/235083?v=4)](https://github.com/themakunga "themakunga (47 commits)")[![isabellaahc](https://avatars.githubusercontent.com/u/16402208?v=4)](https://github.com/isabellaahc "isabellaahc (35 commits)")[![arturoflores03](https://avatars.githubusercontent.com/u/96386143?v=4)](https://github.com/arturoflores03 "arturoflores03 (32 commits)")[![tribiec](https://avatars.githubusercontent.com/u/16856300?v=4)](https://github.com/tribiec "tribiec (30 commits)")[![vutreras](https://avatars.githubusercontent.com/u/475840?v=4)](https://github.com/vutreras "vutreras (24 commits)")[![a1b4](https://avatars.githubusercontent.com/u/522832?v=4)](https://github.com/a1b4 "a1b4 (19 commits)")[![ffflabs](https://avatars.githubusercontent.com/u/238439?v=4)](https://github.com/ffflabs "ffflabs (15 commits)")[![saengate](https://avatars.githubusercontent.com/u/24316517?v=4)](https://github.com/saengate "saengate (10 commits)")[![leosoto](https://avatars.githubusercontent.com/u/123691?v=4)](https://github.com/leosoto "leosoto (8 commits)")[![RodrigoAyala](https://avatars.githubusercontent.com/u/518591?v=4)](https://github.com/RodrigoAyala "RodrigoAyala (7 commits)")[![DiegoHBustamante](https://avatars.githubusercontent.com/u/99495937?v=4)](https://github.com/DiegoHBustamante "DiegoHBustamante (6 commits)")[![victormendoza96](https://avatars.githubusercontent.com/u/26552874?v=4)](https://github.com/victormendoza96 "victormendoza96 (4 commits)")[![ffiebig](https://avatars.githubusercontent.com/u/737355?v=4)](https://github.com/ffiebig "ffiebig (4 commits)")

---

Tags

hacktoberfestapisdkpaymentstransbank

###  Code Quality

TestsPHPUnit

Code StylePHP\_CodeSniffer

### Embed Badge

![Health badge](/badges/transbank-transbank-sdk/health.svg)

```
[![Health](https://phpackages.com/badges/transbank-transbank-sdk/health.svg)](https://phpackages.com/packages/transbank-transbank-sdk)
```

###  Alternatives

[invoiced/invoiced

Invoiced PHP Library

14117.1k](/packages/invoiced-invoiced)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
