Yazılım

CREEM Laravel Paketi Oluşturma: Küresel Ödemeleri Dakikalar İçinde Kabul Etme

Son güncelleme: 20 Şubat 2026 12:46

teknomers

Paylaş

Paylaş

Neden CREEM?

SaaS, dijital ürünler veya yazılım lisansları satıyorsanız, küresel ödemeleri yönetmek zorlayıcı olabilir. Aşağıdaki unsurlar ile başa çıkmanız gerekiyor:

• 190’dan fazla ülkede KDV/GST/satış vergisi
• Ödeme işlemcisi entegrasyonu
• Abonelik yaşam döngüsü yönetimi
• Lisans anahtarı dağıtımı
• İade ve anlaşmazlıklar

CREEM, bunların hepsini 3.9% + 30 cent ile işleme alırken, aylık herhangi bir ücret almıyor. Ürün geliştirmenize odaklanabilmeniz için vergi uyumluluğundan yasallık yükümlülüğünü üstleniyor.

Tek eksik? Doğru bir Laravel paketi.

<h2><a name="what-i-built" href="#what-i-built"></a> Neyi İnşa Ettim</h2>
<p><strong><a href="https://github.com/Haniamin90/creem-laravel" target="_blank" rel="noopener noreferrer">creem/laravel</a></strong>, CREEM API'sinin tüm fonksiyonlarını Laravel yerel kalıpları ile saran kapsamlı bir Laravel paketidir:</p>

<h3><a name="26-api-methods-via-facade" href="#26-api-methods-via-facade"></a> Facade ile 26 API Metodu</h3>
<div class="highlight js-code-highlight">
    <pre class="highlight php"><code>use Creem\Laravel\Facades\Creem;

// Tek satırda bir checkout oluşturun
$checkout = Creem::createCheckout(‘prod_abc123’, [
‘success_url’ => route(‘checkout.success’),
‘customer’ => [
’email’ => $user->email,
],
]);

return redirect($checkout[‘checkout_url’]);

Her CREEM API uç noktası kapsanmıştır: Ürünler, Checkout’lar, Abonelikler, Müşteriler, İşlemler, Lisanslar ve İndirimler.

<h3><a name="billable-trait-laravel-cashierstyle" href="#billable-trait-laravel-cashierstyle"></a> Billable Trait (Laravel Cashier Tarzı)</h3>
<p>Facade'ı doğrudan çağırmak yerine, <code>Billable</code> trait'ini User modelinize ekleyin:</p>
<div class="highlight js-code-highlight">
    <pre class="highlight php"><code>use Creem\Laravel\Traits\Billable;

class User extends Authenticatable
{
use Billable;
}

Artık faturalama yöntemleri doğrudan modelinizde yer alıyor:

$user->checkout('prod_abc123', [
    'success_url' => '/thanks',
]);
$user->creemSubscriptions();
$user->cancelSubscription('sub_xyz', 'scheduled');
$user->billingPortalUrl();

<h3><a name="15-webhook-events" href="#15-webhook-events"></a> 15 Webhook Olayı</h3>
<p>Paket, <code>POST /creem/webhook</code> adresinde HMAC-SHA256 imza doğrulaması ile otomatik olarak bir webhook uç noktası kaydeder. Her webhook türü, tipli Laravel olayına karşılık gelir:</p>
<div class="highlight js-code-highlight">
    <pre class="highlight php"><code>// EventServiceProvider'ınızda

CheckoutCompleted::class => [GrantAccessListener::class],
SubscriptionCanceled::class => [RevokeAccessListener::class],

<p>Ayrıca CREEM'in TypeScript SDK deseninden ilham alarak <code>AccessGranted</code> ve <code>AccessRevoked</code> kolaylık olayları ekledim. Bunlar otomatik olarak doğru webhook kombinasyonlarında tetiklenir, böylece "erişim ver" ile "erişimi iptal et" olaylarını hatırlamanıza gerek kalmaz:</p>
<div class="highlight js-code-highlight">
    <pre class="highlight php"><code>Event::listen(AccessGranted::class, function ($event) {
// checkout.completed, subscription.active, subscription.paid olaylarında tetiklenir
$user = User::where('email', $event->payload['customer']['email'])->first();
$user->update(['has_access' => true]);

});

<h3><a name="auto-sandbox-detection" href="#auto-sandbox-detection"></a> Otomatik Sandbox Tespiti</h3>
<p>Test API anahtarı (<code>creem_test_*</code>) kullandığınızda paket, otomatik olarak sandbox API'sine yönlendirir. Üretime geçmek için (<code>creem_*</code>) uygulandığında canlı API'yi kullanır. Hiçbir yapılandırma değişikliği gerekmez.</p>

<h3><a name="full-test-suite" href="#full-test-suite"></a> Tam Test Seti</h3>
<p>73 test, 137 doğrulama ile her API metodunu, webhook imza doğrulamasını, olay gönderimini ve kenar durumlarını kapsar. CI matrisi <strong>PHP 8.1-8.4</strong> ve <strong>Laravel 10, 11, 12</strong> üzerinde çalışır.</p>

<h2><a name="5minute-quick-start" href="#5minute-quick-start"></a> 5 Dakikada Hızlı Başlangıç</h2>
<p><strong>1. Kurulum</strong><br/></p>
<div class="highlight js-code-highlight">
    <pre class="highlight shell"><code>composer require creem/laravel

php artisan vendor:publish –tag=creem-config
php artisan vendor:publish –tag=creem-migrations
php artisan migrate

<p><strong>2. Yapılandırma</strong><br/></p>
<div class="highlight js-code-highlight">
    <pre class="highlight plaintext"><code>CREEM_API_KEY=creem_test_your_key

CREEM_WEBHOOK_SECRET=whsec_your_secret

<p><strong>3. Kullanıcıya Billable Ekle</strong><br/></p>
<div class="highlight js-code-highlight">
    <pre class="highlight php"><code>use Creem\Laravel\Traits\Billable;

class User extends Authenticatable
{
use Billable;
}

<p><strong>4. Checkout Oluştur</strong><br/></p>
<div class="highlight js-code-highlight">
    <pre class="highlight php"><code>Route::post('/buy', function (Request $request) {
$checkout = $request->user()->checkout('prod_your_product', [
    'success_url' => url('/thanks'),
]);
return redirect($checkout['checkout_url']);

});

<p><strong>5. Webhook'ları Yönet</strong><br/></p>
<div class="highlight js-code-highlight">
    <pre class="highlight php"><code>// app/Listeners/GrantAccess.php

use Creem\Laravel\Events\AccessGranted;

class GrantAccess
{
public function handle(AccessGranted $event): void
{
$email = $event->payload[‘customer’][’email’] ?? null;
User::where(’email’, $email)->update([‘is_premium’ => true]);
}
}

<p>Bu kadar. CREEM ödeme sayfasını, vergi hesaplamasını ve makbuzu yönetiyor. Webhook dinleyiciniz, ödeme başarılı olduğunda erişim verir.</p>

<h2><a name="live-demo" href="#live-demo"></a> Canlı Demo</h2>
<p>Canlı olarak deneyin: <strong><a href="https://creem.h90.space" target="_blank" rel="noopener noreferrer">https://creem.h90.space</a></strong></p>
<p>Demo, CREEM sandbox API'sine bağlı olan dahil edilen Docker uygulamasını çalıştırıyor. Canlı bir gösterge paneli, webhook olay takibi, ürün listesinin CREEM API'sinden çekilmesi ve tam bir checkout akışını içeriyor — tümü şık bir kullanıcı arayüzü ile.</p>
<p>Kendiniz çalıştırmak mı istiyorsunuz? Repo her şeyi içeriyor:<br/></p>
<div class="highlight js-code-highlight">
    <pre class="highlight shell"><code>cd examples/demo

cp .env.example .env

CREEM API anahtarınızı ekleyin

docker compose up -d –build

<h2><a name="package-highlights" href="#package-highlights"></a> Paket Özellikleri</h2>
<div class="table-wrapper-paragraph">
    <table>
        <thead>
            <tr>
                <th>Özellik</th>
                <th>Detaylar</th>
            </tr>
        </thead>
        <tbody>
            <tr>
                <td>API Metotları</td>
                <td>26 (tam CREEM API kapsamı)</td>
            </tr>
            <tr>
                <td>Webhook Olayları</td>
                <td>15 tipli Laravel olayı</td>
            </tr>
            <tr>
                <td>Testler</td>
                <td>73 test, 137 doğrulama</td>
            </tr>
            <tr>
                <td>PHP Desteği</td>
                <td>8.1, 8.2, 8.3, 8.4</td>
            </tr>
            <tr>
                <td>Laravel Desteği</td>
                <td>10, 11, 12</td>
            </tr>
            <tr>
                <td>Kod Stili</td>
                <td>Laravel Pint zorunlu</td>
            </tr>
            <tr>
                <td>CI/CD</td>
                <td>GitHub Actions matrisi</td>
            </tr>
            <tr>
                <td>Artisan Komutları</td>
                <td><code>creem:webhook-secret</code>, <code>creem:sync-products</code></td>
            </tr>
            <tr>
                <td>Hata Yönetimi</td>
                <td>4 tipli istisna sınıfı ve izleme kimlikleri</td>
            </tr>
        </tbody>
    </table>
</div>

<h2><a name="links" href="#links"></a> Bağlantılar</h2>
<hr/>
<p><em>CREEM için <a href="https://x.com/HaniAmin90" target="_blank" rel="noopener noreferrer">Hani Amin</a> (Discord: <code>xh90</code>) tarafından oluşturulmuştur. <a href="https://creem.io/scoops" target="_blank" rel="noopener noreferrer">CREEM Scoops</a> Laravel entegrasyon ödülü için.</em></p>