PHPackages                             addonpayments/php-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. [Payment Processing](/categories/payments)
4. /
5. addonpayments/php-sdk

ActiveLibrary[Payment Processing](/categories/payments)

addonpayments/php-sdk
=====================

SDK de PHP para procesar pagos con su terminal de Addon Payments

2.2.0(5y ago)2144.4k↓37.5%4GPL-2.0-or-laterHackPHP &gt;= 5.5.9CI failing

Since Nov 8Pushed 5y ago2 watchersCompare

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

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

[ ![Addon Payments logo](https://camo.githubusercontent.com/1545d167bf62c2894a41a496fcb155dd424a281afcf2b472004ddbae2009462c/68747470733a2f2f6465736172726f6c6c61646f7265732e6164646f6e7061796d656e74732e636f6d2f6173736574732f696d616765732f6272616e64696e672f636f6d65726369612f6c6f676f2e7376673f763d3f763d312e31342e31 "Addon Payments")](https://desarrolladores.addonpayments.com/)SDK de PHP Comercia Global Payments
===================================

[](#sdk-de-php-comercia-global-payments)

Este SDK ha sido adaptado por Comercia Global Payments para facilitar la integración de su terminal Addon Payments en su servidor PHP.

Soluciones
----------

[](#soluciones)

### General

[](#general)

- Procesamiento de pagos API
- Apple Pay y Google Pay (en desarrollo)
- Almacenamiento seguro de tarjetas y gestión de clientes
- Pagos recurrentes
- Crédito y Débito
- Minimizar los requisitos de cumplimiento de PCI con las soluciones de HPP
- 140+ Monedas de autorización y 16 Monedas de liquidación
- Normas incorporadas para la prevención del fraude
- Comprobaciones 3D Secure, AVS y CVV
- Cifrado seguro de extremo a extremo
- Compatible con la versión 2 de 3D Secure

Requisitos
----------

[](#requisitos)

- PHP 5.5.9+
- OpenSSL 1.0.1+
- PHP Curl extension
- PHP DOM extension
- PHP OpenSSL extension

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

[](#instalación)

La instalación del SDK en su solución se realiza normalmente utilizando Composer/Packagist, o añadiendo el proyecto a su solución y haciendo referencia a él directamente.

Para instalar vía [Composer/Packagist](https://packagist.org/packages/addonpayments/php-sdk), debe introducir los siguientes comandos en su consola:

```
composer require addonpayments/php-sdk

```

Para instalar a través de una descarga directa:

Puede descargar y descomprimir la librería, o usando Git puede [clonar el repositorio](https://github.com/addonpayments/php-sdk) desde GitHub.

```
git clone https://github.com/addonpayments/php-sdk

```

*Ver más sobre [cómo clonar repositorios](https://help.github.com/articles/cloning-a-repository/).*

Documentación y ejemplos
------------------------

[](#documentación-y-ejemplos)

Puede encontrar una documentación adaptada a cada operativa de pago, ejecutando el archivo "index.php" desde su servidor.

La documentación contiene las validaciones del proyecto oficial de [JavaScript](https://github.com/AddonPayments/js-sdk) Addon Payments. También las puede encontrar en la ruta del proyecto "[test/assets/js](https://github.com/AddonPayments/php-sdk/tree/master/test/assets/js)".

Este archivo se encuentra dentro de la carpeta "test" del SDK. Si lo prefiere, también puede ver nuestra documentación oficial en la página web de desarrolladores de [Addon Payments](https://desarrolladores.addonpayments.com) donde encontrará además tarjetas con las que realizar pruebas de compra y el resto de librerías disponibles.

*Consejo rápido*: ¡[El paquete de pruebas incluido](https://github.com/addonpayments/php-sdk/tree/master/test) puede ser una gran fuente de ejemplos de código para usar el SDK!

#### Procesar un pago

[](#procesar-un-pago)

```
$card = new CreditCardData();
$card->number = "4111111111111111";
$card->expMonth = "12";
$card->expYear = "2025";
$card->cvn = "123";

try {
    $response = $card->charge(129.99)
        ->withCurrency("EUR")
        ->execute();

    $result = $response->responseCode; // 00 == Autorizado
    $message = $response->responseMessage; // [ sistema de pruebas ] AUTHORISED
} catch (ApiException $e) {
    // Manejar errores
}
```

#### Datos de tarjeta de prueba

[](#datos-de-tarjeta-de-prueba)

NombreNúmeroExp MesExp AñoCVNVisa4263970000005262122025123MasterCard2223000010005780122019900MasterCard5425230000004415122025123Discover6011000000000087122025123Amex3741010000006081220251234JCB3566000000000000122025123Diners Club36256000000725122025123#### Tarjetas de prueba para 3DS2

[](#tarjetas-de-prueba-para-3ds2)

TipoNúmeroExp MesExp AñoCVNFrictionless4263970000005262122025123Challenge Required4012001038488884122025123#### Excepciones

[](#excepciones)

Durante su integración usted podrá probar las respuestas específicas del emisor tales como "Tarjeta Rechazada".

Debido a que nuestros entornos de pruebas no llegan a los bancos emisores para obtener autorizaciones, existen números de tarjeta que activarán las respuestas del banco emisor.

En la documentación de la carpeta "test" podrá encontrar un buscador de errores dinámico donde se muestra una descripción detallada de cada error y su posible solución.

Póngase en contacto con el equipo de soporte de Addon Payments para obtener una lista completa de los valores utilizados y simular los resultados de la transacción AVS/CVV.

Ejemplo de código de manejo de errores:

```
try {
    $response = $card->charge(129.99)
        ->withCurrency("EUR")
        ->execute();
} catch (BuilderException $e) {
    // Errores del constructor
} catch (ConfigurationException $e) {
    // Errores referentes a la configuración de los servicios
} catch (GatewayException $e) {
    // Errores/excepciones de la pasarela de pagos
} catch (UnsupportedTransactionException $e) {
    // Manejar errores cuando la pasarela de pagos no soporta el tipo de transacción
} catch (ApiException $e) {
    // Manejar otros errores
}
```

Soporte
-------

[](#soporte)

En caso de que quiera hablar con un especialista de Addon Payments, deberá llamar al teléfono 914 353 028 o enviar un email a .

Contribuyendo
-------------

[](#contribuyendo)

¡Todo nuestro código es de código abierto y animamos a otros desarrolladores a contribuir y ayudar a mejorarlo!

1. Fork it
2. Cree su rama de características (`git checkout -b mi-nueva-feature`)
3. Asegúrese de que las pruebas de SDK son correctas
4. Confirme sus cambios (`git commit -am 'Añadir un commit'`)
5. Empujar a la rama (`git push origin mi-nueva-feature`)
6. Crear una nueva solicitud de extracción

Licencia
--------

[](#licencia)

Este proyecto está licenciado bajo la GNU General Public License v2.0. Consulte el archivo ["LICENSE.md"](LICENSE.md) ubicado en la raíz del proyecto para obtener más detalles.

###  Health Score

34

—

LowBetter than 77% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity35

Limited adoption so far

Community12

Small or concentrated contributor base

Maturity56

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 83.3% 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 ~183 days

Total

4

Last Release

1834d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/21d1d03545ad7c2e65ad53b84bf8d9352d8a58cfb431f5583f922c2c8f010269?d=identicon)[AddonPayments](/maintainers/AddonPayments)

---

Top Contributors

[![VictorACH](https://avatars.githubusercontent.com/u/18118735?v=4)](https://github.com/VictorACH "VictorACH (10 commits)")[![AddonPayments](https://avatars.githubusercontent.com/u/53935205?v=4)](https://github.com/AddonPayments "AddonPayments (2 commits)")

###  Code Quality

TestsPHPUnit

Code StylePHP\_CodeSniffer

### Embed Badge

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

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

###  Alternatives

[omnipay/paypal

PayPal gateway for Omnipay payment processing library

3156.8M53](/packages/omnipay-paypal)[eduardokum/laravel-boleto

Biblioteca com boletos para o laravel

626351.9k2](/packages/eduardokum-laravel-boleto)[tbbc/money-bundle

This is a Symfony bundle that integrates moneyphp/money library (Fowler pattern): https://github.com/moneyphp/money.

1961.9M](/packages/tbbc-money-bundle)[2checkout/2checkout-php

2Checkout PHP Library

83740.3k2](/packages/2checkout-2checkout-php)[smhg/sepa-qr-data

Generate QR code data for SEPA payments

61717.2k5](/packages/smhg-sepa-qr-data)[omnipay/dummy

Dummy driver for the Omnipay payment processing library

271.2M33](/packages/omnipay-dummy)

PHPackages © 2026

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