PHPackages                             place-to-pay/php-sdk-pse - 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. place-to-pay/php-sdk-pse

ActiveLibrary

place-to-pay/php-sdk-pse
========================

Una simple libreria para conectarse al webservice SOAP suministrado por Place To Pay

v1.1.1(9y ago)2841MITPHPPHP &gt;=5.6.0

Since Jan 11Pushed 9y ago1 watchersCompare

[ Source](https://github.com/okarook/php-sdk-pse)[ Packagist](https://packagist.org/packages/place-to-pay/php-sdk-pse)[ Docs](https://github.com/okarook/php-sdk-pse)[ RSS](/packages/place-to-pay-php-sdk-pse/feed)WikiDiscussions master Synced 2mo ago

READMEChangelogDependencies (1)Versions (5)Used By (0)

Place To Pay php-sdk-pse
========================

[](#place-to-pay-php-sdk-pse)

Una simple libreria para conectarse al webservice PSE suministrado por Place To Pay

Requerimientos
--------------

[](#requerimientos)

Puedes elegir [`Memcached`](http://php.net/manual/es/book.memcached.php) o [`APCu`](http://php.net/manual/es/book.apcu.php) para almacenar los datos en caché.

Si elige [`APCu`](http://php.net/manual/es/book.apcu.php) Tenga en cuenta que hay varios casos en los que la caché APCu no persiste y todos los valores establecidos se pierden después de que existe el proceso PHP. P.ej. CLI de PHP: las sucesivas ejecuciones de CLI de la misma secuencia de comandos encontrarán la caché APCu vacía.

En proximas versiones se adicionan mas sistemas de caché

```
- PHP >= 5.6.0
- Memcached >= 1.4.25

```

Instalación
-----------

[](#instalación)

Se Instala vía composer

```
composer require place-to-pay/php-sdk-pse

```

Configuración
-------------

[](#configuración)

Al instanciar el objeto `PlaceToPay\SDKPSE\SDKPSE` debe pasar por parametro un array con la siguiente configuración:

```
	$config = array(
		"login" => "",
		"tran_key" => "",
		"cache" => array(
	 		"type" => "",
	 		"memcached" => array(
	 			"host" => "",
	 			"port" => ""
			)
		)
	)

	$obj = new SDKPSE($config);
```

### 1. Datos suministrados por Place To Pay

[](#1-datos-suministrados-por-place-to-pay)

1. `login:` Login para la autenticación
2. `tran_key:` Llave transaccional

### 1. Datos sistema de caché

[](#1-datos-sistema-de-caché)

1. `type:` Nombre del sistema de caché a utilizar, puede ser `memcached` o `apcu`

De acuerdo al sistema de caché indicado debe realizar su respectiva configuración

#### 1.1. Configuración sistema `memcached:`

[](#11-configuración-sistema-memcached)

1. `host:` Dirección del servidor
2. `port:` Puerto del servidor

Versión
-------

[](#versión)

v1.0.0

Licencia
--------

[](#licencia)

[MIT License](LICENSE)

Documentación
=============

[](#documentación)

Excepciones
-----------

[](#excepciones)

Los metodos pueden generar excepciones de tipo `\Exception`

#### Ejemplos:

[](#ejemplos)

> Cuando no se envian los parametros de configuracion

> Cuando no se puede agregar el servidor memcached

> Cuando el tipo o longitud del atributo del [objeto](#tipos-de-datos-o-estructuras) es incorrecto

> Cuando no se puede consumir el webservice PSE

Métodos disponibles
-------------------

[](#métodos-disponibles)

A continuación se describen las operaciones (métodos) que la libreria brinda

Los metodos se encuentran en el namespace `PlaceToPay\SDKPSE\SDKPSE`

#### `getBankList()`

[](#getbanklist)

Obtiene la lista de los bancos disponibles

La petición al webservice se realiza una vez al día para almacenar los datos en la cache

> **Valor devuelto:**Devuelve un array con objetos [`Bank`](#bank) o `false` cuando no existen resultados

#### `createTransaction()`

[](#createtransaction)

Solicita la creacion de una transacción

> **Parametros:**

NombreTipoDescripción$transaction[PSETransactionRequest](#psetransactionrequest)Datos de la solicitud> **Valor devuelto:**Devuelve la creacion de la transacción [`PSETransactionResponse`](#psetransactionresponse) o `false` cuando no existen resultados

#### `createTransactionMultiCredit()`

[](#createtransactionmulticredit)

Solicita la creacion de una transacción con dispersión de fondos

> **Parametros:**

NombreTipoDescripción$transaction[PSETransactionMultiCreditRequest](#psetransactionmulticreditrequest)Datos de la solicitud> **Valor devuelto:**Devuelve la creacion de la transacción [`PSETransactionResponse`](#psetransactionresponse) o `false` cuando no existen resultados

#### `getTransactionInformation()`

[](#gettransactioninformation)

Obtiene la información de una transacción

> **Parametros:**

NombreTipoDescripción$transactionIDintIdentificador único de la transacción, equivale al retornado en la```
 *                            	creacion de la transaccion  |

```

> **Valor devuelto:**Devuelve la informacion de la transacción [`TransactionInformation`](#transactioninformation) o `false` cuando no existen resultados

Tipos de datos o estructuras
----------------------------

[](#tipos-de-datos-o-estructuras)

En este apartado se describen cada una de las estructuras de datos usadas por los métodos

Estas clases se encuentran en el namespace `PlaceToPay\SDKPSE\Structures`

#### `Attribute`

[](#attribute)

Estructura para almacenar información extendida

NombreTipoLongDescripciónnamestring30Código para referenciar el atributovaluestring128Valor que asume el atributo#### `Person`

[](#person)

Estructura para reflejar la información de una persona involucrada en una transacción

NombreTipoLongDescripcióndocumentstring12Número de identificación de la personadocumentTypestring3Tipo de documento de identificación de la persona:
 CC = Cédula de ciudanía colombiana
 CE = Cédula de extranjería
 TI = Tarjeta de identidad
 PPN = Pasaporte
 NIT = Número de identificación tributaria
 SSN = Social Security NumberfirstNamestring60NombreslastNamestring60Apellidoscompanystring60Nombre de la compañía en la cual labora o representaemailAddressstring80Correo electrónicoaddressstring100Dirección postal completacitystring50Nombre de la ciudad coincidente con la direcciónprovincestring50Nombre de la provincia o departamento coincidente con la direccióncountrystring2Código internacional del país que aplica a la dirección física acorde a ISO 3166-1, mayúscula sostenidaphonestring30Número de telefonía fijamobilestring30Número de telefonía móvil o celular#### `Bank`

[](#bank)

Estructura para reflejar la información de una entidad bancaria

NombreTipoLongDescripciónbankCodestring4Código de la entidad financierabankNamestring60Nombre de la entidad financiera#### `CreditConcept`

[](#creditconcept)

Estructura que representa el concepto del crédito a favor de un tercero

NombreTipoLongDescripciónentityCodestring12Código de la entidad del tercero para dispersiónserviceCodestring12Código del servicio del terceroamountValuefloatValor total a recaudar a favor de la entidadtaxValuefloatDiscriminación del impuesto aplicado a favor de la entidaddescriptionstring60Descripción el concepto cobrado#### `PSETransactionRequest`

[](#psetransactionrequest)

Estructura que representa una solicitud de transacción con débitos a cuenta PSE

NombreTipoLongDescripciónbankCodestring4Código de la entidad financiera con la cual realizar la transacciónbankInterfacestring1Tipo de interfaz del banco a desplegar \[0 = PERSONAS, 1 = EMPRESAS\]returnURLstring255URL de retorno especificada para la entidad financierareferencestring32Referencia única de pagodescriptiopstring255Descripción del pagolanguagestring2Idioma esperado para las transacciones acorde a ISO 631-1, mayúscula sostenidacurrencystring3Moneda a usar para el recaudo acorde a ISO 4217totalAmountfloatValor total a recaudartaxAmountfloatDiscriminación del impuesto aplicadodevolutionBasefloatBase de devolución para el impuestotipAmountfloatPropina u otros valores exentos de impuesto (tasa aeroportuaria) y que deben agregarse al valor total a pagarpayer[Person](#person)Información del pagadorbuyer[Person](#person)Información del compradorshipping[Person](#person)Información del receptoripAddressstring15Dirección IP desde la cual realiza la transacción el pagadoruserAgentstring255Agente de navegación utilizado por el pagadoradditionalData[Attribute](#attribute)Datos adicionales para ser almacenados con la transacción#### `PSETransactionMultiCreditRequest`

[](#psetransactionmulticreditrequest)

Estructura que representa una solicitud de transacción con débitos a cuenta PSE

NombreTipoLongDescripciónbankCodestring4Código de la entidad financiera con la cual realizar la transacciónbankInterfacestring1Tipo de interfaz del banco a desplegar \[0 = PERSONAS, 1 = EMPRESAS\]returnURLstring255URL de retorno especificada para la entidad financierareferencestring32Referencia única de pagodescriptiopstring255Descripción del pagolanguagestring2Idioma esperado para las transacciones acorde a ISO 631-1, mayúscula sostenidacurrencystring3Moneda a usar para el recaudo acorde a ISO 4217totalAmountfloatValor total a recaudartaxAmountfloatDiscriminación del impuesto aplicadodevolutionBasefloatBase de devolución para el impuestotipAmountfloatPropina u otros valores exentos de impuesto (tasa aeroportuaria) y que deben agregarse al valor total a pagarpayer[Person](#person)Información del pagadorbuyer[Person](#person)Información del compradorshipping[Person](#person)Información del receptoripAddressstring15Dirección IP desde la cual realiza la transacción el pagadoruserAgentstring255Agente de navegación utilizado por el pagadoradditionalDataarray([Attribute](#attribute))Datos adicionales para ser almacenados con la transaccióncreditsarray([CreditConcept](#creditconcept))Detalle de la dispersión a realizar#### `PSETransactionResponse`

[](#psetransactionresponse)

Estructura con la información de respuesta para la creación de una transacción

NombreTipoLongDescripcióntransactionIDintIdentificador único de la transacción en PlacetoPaysessionIDstring32Identificador único de la sesión en PlacetoPayreturnCodestring30Código de respuesta de la transacción, uno de los siguientes valores:
 SUCCESS
FAIL\_ENTITYNOTEXISTSORDISABLED
FAIL\_BANKNOTEXISTSORDISABLED
FAIL\_SERVICENOTEXISTS
FAIL\_INVALIDAMOUNT
FAIL\_INVALIDSOLICITDATE
FAIL\_BANKUNREACHEABLE
FAIL\_NOTCONFIRMEDBYBANK
FAIL\_CANNOTGETCURRENTCYCLE
FAIL\_ACCESSDENIED
FAIL\_TIMEOUT
FAIL\_DESCRIPTIONNOTFOUND
FAIL\_EXCEEDEDLIMIT
FAIL\_TRANSACTIONNOTALLOWED
FAIL\_RISK
FAIL\_NOHOST
FAIL\_NOTALLOWEDBYTIME
FAIL\_ERRORINCREDITS
trazabilityCodestring40Código único de seguimiento para la operación dado por la red ACHtransactionCycleintCiclo de compensación de la redbankCurrencystring3Moneda aceptada por el banco acorde a ISO 4217bankFactorfloatFactor de conversión de la monedabankURLstring255URL a la cual remitir la solicitud para iniciar la interfaz del banco, sólo disponible cuando returnCode = SUCCESSresponseCodeintEstado de la operación en PlacetoPay \[ 0 = FAILED, 1 = APPROVED, 2 = DECLINED, 3 = PENDING \]responseReasonCodestring3Código interno de respuesta de la operación en PlacetoPayresponseReasonTextstring255Mensaje asociado con el código de respuesta de la operación en PlacetoPay#### `TransactionInformation`

[](#transactioninformation)

Estructura con la respuesta a una solicitud de información de transacción

NombreTipoLongDescripcióntransactionIDintIdentificador único de la transacción en PlacetoPaysessionIDstring32Identificador único de la sesión en PlacetoPayreferencestring32Referencia única de pagorequestDatestringFecha de solicitud o creación de la transacción acorde a ISO 8601bankProcessDatestringFecha de procesamiento de la transacción acorde a ISO 8601onTestbooleanIndicador de si la transacción es en modo de pruebas o noreturnCodestring30Código de respuesta de la transacción, uno de los siguientes:
 SUCCESS
FAIL\_INVALIDTRAZABILITYCODE
FAIL\_ACCESSDENIED
FAIL\_INVALIDSTATE
FAIL\_INVALIDBANKPROCESSINGDATE
FAIL\_INVALIDAUTHORIZEDAMOUNT
FAIL\_INCONSISTENTDATA
FAIL\_TIMEOUT
FAIL\_INVALIDVATVALUE
FAIL\_INVALIDTICKETID
FAIL\_INVALIDSOLICITEDATE
FAIL\_INVALIDAUTHORIZATIONID
FAIL\_TRANSACTIONNOTALLOWED
FAIL\_ERRORINCREDITS
FAIL\_EXCEEDEDLIMITtrazabilityCodestring40Código único de seguimiento para la operación dado por la red ACHtransactionCycleintCiclo de compensación de la redtransactionStatestring20Información del estado de la transacción \[ OK, NOT\_AUTHORIZED, PENDING, FAILED \]responseCodeintEstado de la operación en PlacetoPayresponseReasonCodestring3Código interno de respuesta de la operación en PlacetoPayresponseReasonTextstring255Mensaje asociado con el código de respuesta de la operación en PlacetoPay

###  Health Score

28

—

LowBetter than 54% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity13

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity61

Established project with proven stability

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

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 ~0 days

Total

3

Last Release

3407d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/33d25e4fc640211cc55387b49768f898ef4b99b87a71152cde9abb3e8717a393?d=identicon)[okarook](/maintainers/okarook)

---

Top Contributors

[![okarook](https://avatars.githubusercontent.com/u/4731245?v=4)](https://github.com/okarook "okarook (3 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/place-to-pay-php-sdk-pse/health.svg)

```
[![Health](https://phpackages.com/badges/place-to-pay-php-sdk-pse/health.svg)](https://phpackages.com/packages/place-to-pay-php-sdk-pse)
```

PHPackages © 2026

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