Commet
  • Pricing
Log InTry out
Introducción

Inicio rápido

Integrar con PHPIntegrar con LaravelIntegrar con Symfony

Aprender

Recursos

Referencia del SDKVersionado de APIManejo de erroresTestingCLI

Plugins

Better Auth
DocumentaciónRecursosConstruir con AIAPI ReferenceWebhooks

Integrar con Symfony

Agrega cobros y pagos a tu aplicación de Symfony.

Instalar

composer require commet/commet-php

Configurar

.env
COMMET_API_KEY=ck_sandbox_xxx
COMMET_WEBHOOK_SECRET=whsec_xxx
config/services.yaml
services:
    Commet\Commet:
        factory: ['@App\Factory\CommetFactory', 'create']

    App\Factory\CommetFactory:
        arguments:
            $apiKey: '%env(COMMET_API_KEY)%'
src/Factory/CommetFactory.php
<?php

namespace App\Factory;

use Commet\Commet;

class CommetFactory
{
    public function __construct(
        private string $apiKey,
    ) {}

    public function create(): Commet
    {
        return new Commet(
            apiKey: $this->apiKey,
        );
    }
}

Suscribir

src/Controller/BillingController.php
<?php

namespace App\Controller;

use Commet\Commet;
use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
use Symfony\Component\HttpFoundation\JsonResponse;
use Symfony\Component\HttpFoundation\Request;
use Symfony\Component\Routing\Attribute\Route;

class BillingController extends AbstractController
{
    public function __construct(
        private Commet $commet,
    ) {}

    #[Route('/billing/subscribe', methods: ['POST'])]
    public function subscribe(Request $request): JsonResponse
    {
        $data = $request->toArray();

        $this->commet->customers->create(
            email: $data['email'],
            id: $data['customer_id'],
        );

        $subscription = $this->commet->subscriptions->create(
            customerId: $data['customer_id'],
            planCode: 'pro',
        );

        return $this->json([
            'checkout_url' => $subscription->data['checkout_url'],
        ]);
    }
}

Verificar acceso

src/Controller/BillingController.php
#[Route('/billing/subscription/{customerId}', methods: ['GET'])]
public function getSubscription(string $customerId): JsonResponse
{
    $subscription = $this->commet->subscriptions->get($customerId);

    return $this->json([
        'status' => $subscription->data['status'],
    ]);
}

#[Route('/billing/features/{feature}/{customerId}', methods: ['GET'])]
public function checkFeature(string $feature, string $customerId): JsonResponse
{
    $result = $this->commet->features->check(code: $feature, customerId: $customerId);

    return $this->json([
        'allowed' => $result->data['allowed'],
    ]);
}

Trackear uso

src/Controller/BillingController.php
#[Route('/billing/usage', methods: ['POST'])]
public function trackUsage(Request $request): JsonResponse
{
    $data = $request->toArray();

    $this->commet->usage->track(
        customerId: $data['customer_id'],
        feature: 'api_calls',
        value: 1,
    );

    return $this->json(['tracked' => true]);
}

El uso se agrega y se cobra al final del período.

Portal del Cliente

src/Controller/BillingController.php
use Symfony\Component\HttpFoundation\RedirectResponse;

#[Route('/billing/portal', methods: ['GET'])]
public function portal(): RedirectResponse
{
    $result = $this->commet->portal->getUrl(customerId: 'user_123');

    return $this->redirect($result->data['portal_url']);
}

Webhooks

src/Controller/WebhookController.php
<?php

namespace App\Controller;

use Commet\Webhooks;
use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
use Symfony\Component\DependencyInjection\Attribute\Autowire;
use Symfony\Component\HttpFoundation\JsonResponse;
use Symfony\Component\HttpFoundation\Request;
use Symfony\Component\HttpFoundation\Response;
use Symfony\Component\Routing\Attribute\Route;

class WebhookController extends AbstractController
{
    public function __construct(
        #[Autowire(env: 'COMMET_WEBHOOK_SECRET')]
        private string $webhookSecret,
    ) {}

    #[Route('/webhooks/commet', methods: ['POST'])]
    public function handle(Request $request): JsonResponse|Response
    {
        $webhooks = new Webhooks();

        $payload = $webhooks->verifyAndParse(
            rawBody: $request->getContent(),
            signature: $request->headers->get('x-commet-signature'),
            secret: $this->webhookSecret,
        );

        if ($payload === null) {
            return new Response('Invalid signature', 401);
        }

        match ($payload['event']) {
            'subscription.activated' => $this->handleActivated($payload),
            'subscription.canceled' => $this->handleCanceled($payload),
            default => null,
        };

        return $this->json(['ok' => true]);
    }

    private function handleActivated(array $payload): void
    {
        // manejar activación
    }

    private function handleCanceled(array $payload): void
    {
        // manejar cancelación
    }
}

Relacionado

  • Suscripciones
  • Trackear Uso
  • Portal del Cliente
  • Referencia del SDK

¿Cómo está esta guía?

Integrar con Laravel

Agrega cobros y pagos a tu aplicación de Laravel.

Gestionar Clientes

Crea y gestiona clientes con el SDK de Commet y el dashboard.

En esta página

Instalar
Configurar
Suscribir
Verificar acceso
Trackear uso
Portal del Cliente
Webhooks
Relacionado