PHPackages                             emm/culqi-cashier - 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. emm/culqi-cashier

ActiveLibrary[Payment Processing](/categories/payments)

emm/culqi-cashier
=================

culqi cashier

0.2.1(5y ago)0381[1 PRs](https://github.com/emmanuelbarturen/culqi-cashier/pulls)MITPHPPHP >=7.0.0

Since Nov 17Pushed 5y ago1 watchersCompare

[ Source](https://github.com/emmanuelbarturen/culqi-cashier)[ Packagist](https://packagist.org/packages/emm/culqi-cashier)[ RSS](/packages/emm-culqi-cashier/feed)WikiDiscussions master Synced yesterday

READMEChangelog (2)Dependencies (3)Versions (4)Used By (0)

CulqiCashier for Laravel
========================

[](#culqicashier-for-laravel)

Paquete para la integración de Culqi enfocado en el usuario para el framework Laravel.

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

[](#instalación)

```
composer install emm/culqi-cashier

```

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

[](#configuración)

Correr migraciones
------------------

[](#correr-migraciones)

```
  php artisan migrate

```

### Modelo Facturable

[](#modelo-facturable)

Antes de utilizar el paquete agrega el trait `Facturable` a tu modelo e implementa la función `culqiAntiFraud` con los parámetros que se muestran en este ejemplo.

```
   use Emm\CulqiCashier\Facturable;

   class User extends Authenticatable
   {
       use Facturable;

       /**
       * @return array
       */
       public function culqiAntiFraud(): array
       {
           return [
               "first_name" => $this->names,
               "last_name" => $this->last_names,
               "email" => $this->email,
               "address" => $this->address,
               "address_city" => $this->city',
               "country_code" => $this->country_code,
               "phone" => $this->mobile_phone,
               "metadata" => [], // opcional
           ];
       }
   }

```

### API Keys

[](#api-keys)

```
CULQI_SECRET=
CULQI_PUBLIC=

```

### Configuración de moneda

[](#configuración-de-moneda)

Por defecto Culqi Cashier utiliza el Sol (PEN) como moneda. Para cambiar la moneda debes asignarlo en `.env`

```
CULQI_CURRENCY=USD

```

Clientes
--------

[](#clientes)

### Obteniendo todos los clientes

[](#obteniendo-todos-los-clientes)

Puedes obtener todos los clientes, llamando a la función `list` del scope `Customer`. La respuesta sera una instancia de la clase `Illuminate\Support\Collection`

```
use Emm\CulqiCashier\CulqiCashier;

$customers = CulqiCashier::Customer()->list();

```

### Creando un nuevo cliente

[](#creando-un-nuevo-cliente)

La forma más simple es usando el método `createCulqiCustomer`. Recuerda que debes tener implementado `culqiAntiFraud`

```
$user->createCulqiCustomer()

```

### Actualizando los datos de un cliente

[](#actualizando-los-datos-de-un-cliente)

```
 $newData = ['email' => 'newemail@mail.com'];
$user->updateCulqiCustomer($newData)

```

Métodos de pago
---------------

[](#métodos-de-pago)

### Cargo

[](#cargo)

```
    $description = 'Venta de Prueba';
    $sourceId = request()->get('culqi_token');//ID del objeto Token u objeto Tarjeta que se va usar para realizar el cargo.
    $antifraud = []; //opcional, si quieres reemplazar algunos datos de `culqiAntiFraud`
    $user->charge($amount, $description,$sourceId, $antifraud);

```

### Suscripción

[](#suscripción)

Las suscripciones deben ser configuradas en el [panel de culqi](https://integ-panel.culqi.com/#/login).

```
 $planId = 'plan_1'; // Nombre del plan que asignaste en el panel de culqi
 $sourceId = request()->get('culqi_token');//ID del objeto Token u objeto Tarjeta que se va usar para realizar el cargo.
 $user->newSubscription($planId', $sourceId);

```

License
-------

[](#license)

CulqiCashier is open-sourced software licensed under the [MIT license](http://opensource.org/licenses/MIT).

###  Health Score

21

—

LowBetter than 19% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity8

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity41

Maturing project, gaining track record

 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

2

Last Release

2003d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/67997529044855ebf48d055ab407242720cbaa0b9ebb40601d6679995a80c38b?d=identicon)[temet\_nosce](/maintainers/temet_nosce)

---

Top Contributors

[![emmanuelbarturen](https://avatars.githubusercontent.com/u/11076563?v=4)](https://github.com/emmanuelbarturen "emmanuelbarturen (7 commits)")

---

Tags

laravelcashierculqiperu

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/emm-culqi-cashier/health.svg)

```
[![Health](https://phpackages.com/badges/emm-culqi-cashier/health.svg)](https://phpackages.com/packages/emm-culqi-cashier)
```

###  Alternatives

[maartenpaauw/filament-cashier-billing-provider

Filament billing provider for Laravel Cashier

10228.1k](/packages/maartenpaauw-filament-cashier-billing-provider)

PHPackages © 2026

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