clonixdev/billcommerce-laravel

Laravel integration client for Billcommerce (Elafact) billing API

dev-master 2026-05-22 07:59 UTC

Requires

• php: ^8.1
• illuminate/contracts: ^10.0
• illuminate/database: ^10.0
• illuminate/http: ^10.0
• illuminate/routing: ^10.0
• illuminate/support: ^10.0

MIT

• Clonixdev

README

Cliente Laravel para integrar aplicaciones con Billcommerce (API tenant tipo Elafact).

Instalación

composer require clonixdev/billcommerce-laravel
php artisan vendor:publish --tag=billcommerce-config
php artisan vendor:publish --tag=billcommerce-migrations
php artisan migrate

Repositorio local (desarrollo)

"repositories": [
    {
        "type": "path",
        "url": "../billcommerce-laravel",
        "options": { "symlink": true }
    }
],
"require": {
    "clonixdev/billcommerce-laravel": "@dev"
}

Variables de entorno

BILLCOMMERCE_URL=https://tenant.billcommerce.test
BILLCOMMERCE_MASTER_TOKEN=
BILLCOMMERCE_WEBHOOK_SECRET=
BILLCOMMERCE_ORIGIN=deploy-app

Compatibilidad con nombres legacy: BILLING_URL, BILLING_MASTER_TOKEN, etc.

Eventos webhook

Registra listeners en tu EventServiceProvider:

use Clonixdev\Billcommerce\Events\BillcommerceInvoicePaid;
use Clonixdev\Billcommerce\Events\BillcommerceSubscriptionCancelled;

protected $listen = [
    BillcommerceInvoicePaid::class => [
        \App\Listeners\HandleYourAppPayment::class,
    ],
    BillcommerceSubscriptionCancelled::class => [
        \App\Listeners\HandleYourAppSuspended::class,
    ],
];

Filtra por SKU con Clonixdev\Billcommerce\Support\BillcommerceProductMatcher.

Compatibilidad nix (tablas legacy)

En config/billcommerce.php:

'tables' => [
    'tokens' => 'billing_tokens',
    'configs' => 'billing_configs',
    'products' => 'billing_hosting_products',
],
'models' => [
    'product' => \App\Models\BillingHostingProduct::class,
],

Rutas incluidas

• POST api/v1/webhooks/billcommerce (y alias webhooks/billing)
• Proxy api/v1/billing/orders|invoices|payments
• Admin api/v1/admin/billcommerce/config|products