PHPackages                             coffee-pay/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. coffee-pay/sdk

ActiveLibrary[Payment Processing](/categories/payments)

coffee-pay/sdk
==============

PHP SDK for Coffee-Pay payment gateway

v1.0.0(3mo ago)00MITPHPPHP >=7.4

Since Feb 8Pushed 3mo agoCompare

[ Source](https://github.com/coffee-pay-co/sdk-php)[ Packagist](https://packagist.org/packages/coffee-pay/sdk)[ RSS](/packages/coffee-pay-sdk/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (2)Versions (2)Used By (0)

Coffee Pay PHP SDK
==================

[](#coffee-pay-php-sdk)

SDK oficial para la integración de pagos y suscripciones con Coffee Pay en aplicaciones PHP.

Características
---------------

[](#características)

- 🛡️ **Autenticación JWT**: Gestión automática de tokens HS256.
- 💳 **Suscripciones**: CRUD completo para planes de suscripción.
- 💰 **Monedas**: Consulta de monedas soportadas.
- 🔑 **Seguridad**: Utilidades para generación de firmas web para el Widget.
- 📦 **PSR-4**: Estructura moderna y compatible con Composer.

Requisitos
----------

[](#requisitos)

- PHP >= 7.4
- Composer

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

[](#instalación)

Instala el SDK usando Composer:

```
composer require coffee-pay/sdk
```

*(Nota: Si estás usando el SDK en desarrollo local, asegúrate de configurar el repositorio de tipo `path` en tu `composer.json`)*

Uso Básico
----------

[](#uso-básico)

### Inicialización del Cliente

[](#inicialización-del-cliente)

```
use CoffeePay\Sdk\CoffeeSDK;

$client = new CoffeeSDK([
    'apiKey'    => 'tu_api_key',
    'apiSecret' => 'tu_api_secret',
    'baseUrl'   => 'https://production.coffee-pay.co/api/v1' // Opcional, por defecto apunta a producción
]);
```

### Gestión de Planes de Suscripción

[](#gestión-de-planes-de-suscripción)

```
// Listar planes
$plans = $client->subscriptionsPlans->list(10, 1);

// Crear un nuevo plan
$newPlan = $client->subscriptionsPlans->create([
    'name' => 'Plan Mensual Premium',
    'price' => 50000,
    'currencyId' => 'UUID_DE_LA_MONEDA',
    'interval' => 'monthly',
    'intervalCount' => 1,
    // ... otros campos
]);

// Obtener un plan específico
$plan = $client->subscriptionsPlans->get('id-del-plan');
```

### Generación de Firma para el Widget

[](#generación-de-firma-para-el-widget)

El SDK incluye una utilidad para generar la firma necesaria para inicializar el `GatewayWidget` en el frontend:

```
use CoffeePay\Sdk\Utils\CryptoUtils;

$timestamp = time();
$signature = CryptoUtils::generateWebSignature(
    'tu_account_key',
    'tu_integrity_key',
    $timestamp
);
```

Estructura del Proyecto
-----------------------

[](#estructura-del-proyecto)

- `src/CoffeeSDK.php`: Punto de entrada principal.
- `src/Resources/`: Handlers para los diferentes endpoints de la API.
- `src/Utils/`: Herramientas de cifrado y autenticación.

Licencia
--------

[](#licencia)

MIT

###  Health Score

31

—

LowBetter than 68% of packages

Maintenance81

Actively maintained with recent releases

Popularity0

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity34

Early-stage or recently created project

 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

Unknown

Total

1

Last Release

99d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/27232581dd7a54a31638685580b9944d1feb461beabcc8e93041b23ac96a9406?d=identicon)[coffee-pay-co](/maintainers/coffee-pay-co)

---

Top Contributors

[![adolfocardona](https://avatars.githubusercontent.com/u/17135220?v=4)](https://github.com/adolfocardona "adolfocardona (1 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

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

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

###  Alternatives

[chargebee/chargebee-php

ChargeBee API client implementation for PHP

768.0M9](/packages/chargebee-chargebee-php)[imdhemy/google-play-billing

Google Play Billing

491.3M5](/packages/imdhemy-google-play-billing)[bitpay/sdk

Complete version of the PHP library for the new cryptographically secure BitPay API

42337.5k4](/packages/bitpay-sdk)[buckaroo/sdk

Buckaroo payment SDK

12189.1k9](/packages/buckaroo-sdk)[contica/facturador-electronico-cr

Un facturador de código libre para integrar facturación electrónica en Costa Rica a un proyecto PHP

2128.8k](/packages/contica-facturador-electronico-cr)[karson/mpesa-php-sdk

172.2k](/packages/karson-mpesa-php-sdk)

PHPackages © 2026

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