Ödeme ve faturalama

Damga'da işlemler kredi harcar (imzalama, mühürleme, İmzalat alıcısı, SMS kodu, API isteği, e-posta mühürü). Krediyi panelden kartla (PayTR) ya da havale / EFT ile alırsınız. Bu sayfa satın alma akışını ve sunucuyu kuranlar için PayTR ile banka ayarlarını anlatır.

#Ne satın alınır?

Fiyatlar fiyat listesinde KDV hariçtir; siparişte KDV (%20) eklenir. 12 aylık planda 2 ay bedavadır (10 ay ücreti). Planlar yalnız kurum hesapları içindir ve kurumun sahibi ya da yöneticileri satın alır.

Krediler siparişi verdiğiniz bağlamın cüzdanına yüklenir: kişisel hesabınızdayken kişisel bakiyenize, kurum hesabındayken kurumun ortak bakiyesine.

#Plan kredisi ve devir

• Plan başlarken ilk ayın kredisi hemen yüklenir; sonraki aylar başlangıç gününün yıldönümünde yüklenir (31 Ocak'ta başlayan plan Şubat'ta 28'inde).
• Harcamalar önce plan kredisinden düşer. Kullanılmayan plan kredisi devreder; ama aylık yüklemeden sonra plan kredisi en fazla iki aylık tutar olabilir, fazlası "devretmeyen plan kredisi" satırıyla düşülür. Satın aldığınız paket kredileri bu sınırdan etkilenmez.
• Kartta ödeme bilgisi saklanmaz, plan kendiliğinden yenilenmez. Bitişe 7 ve 1 gün kala kurumun sahip ve yöneticilerine e-posta gider; yenilemek planı yeniden satın almaktır (aynı plan etkinse süre uzar, başka plan hemen başlar ve kalan süre aktarılmaz).
• Plan bitince aylık kredi yüklenmez, kalan krediler kullanılmaya devam eder; kullanıcı sınırı plansız kurum sınırına iner (mevcut üyeler çıkarılmaz, yeni davet gönderilemez).

#Kartla ödeme (PayTR)

1. Siparişi verirsiniz; Damga PayTR'den bir ödeme anahtarı alır ve PayTR'nin güvenli ödeme sayfasını panelin içinde açar. Kart bilgileri PayTR'ye girilir, Damga'ya hiç gelmez.
2. Ödeme bitince PayTR sonucu Damga sunucusuna bildirir; krediler bu bildirimle, ödeme doğrulanınca yüklenir ve e-posta gider. Ödeme sayfasından dönüş yalnız siparişin kayıttaki durumunu gösterir (dönüşe göre kredi yüklenmez).
3. Kart ödemesi olmazsa sipariş "Başarısız" olur ve nedeni sipariş sayfasında görünür; yeniden sipariş verebilirsiniz.

#Havale / EFT

1. Siparişi verirsiniz; sipariş sayfasında ve e-postanızda banka hesabı (IBAN) ve ödeme kodu (ör. DMG-7K2Q9X) yazar.
2. Tutarı havale / EFT ile gönderin; açıklama alanına yalnız ödeme kodunu yazın.
3. Sipariş sayfasında Ödemeyi yaptım'a basın; isterseniz dekontu (PDF, JPG, PNG; en fazla 5 MB) yükleyin.
4. Ödeme hesaba ulaştığında yönetim onaylar: krediler yüklenir, e-posta gider. Ödeme bulunamazsa sipariş gerekçesiyle reddedilir ve size e-posta gelir.

Bildirilmeyen havale siparişi 7 gün sonra kendiliğinden iptal edilir (bildirilenler yönetimin kararını bekler).

#Makbuz ve fatura

Ödenen her siparişin sayfasında yazdırılabilir ödeme makbuzu vardır. Makbuz ödemenin alındığını gösterir, fatura yerine geçmez.

Resmi fatura ödeme alındıktan sonra kesilir: bireysel alıcıya ve e-Fatura mükellefi olmayan şirketlere e-Arşiv fatura, e-Fatura mükellefi şirketlere e-Fatura. Fatura gönderildiğinde PDF'i fatura bilgilerindeki e-posta adresine gelir; sipariş sayfasından PDF'i ve UBL-TR XML'ini indirirsiniz. T.C. kimlik numarası yazmayan bireysel alıcıya fatura GİB kuralı gereği 11111111111 kimlik numarasıyla kesilir. İade edilen siparişin faturası yasal süre içindeyse iptal edilir. Ayrıntılar ve sunucu ayarları: e-Arşiv ve e-Fatura.

Fatura bilgileri (bireysel: ad soyad ve T.C. kimlik no; kurumsal: unvan, vergi dairesi, VKN; adres, ilçe, il, e-posta, telefon) siparişe o anki haliyle kaydedilir ve bir sonraki sipariş için saklanır.

#Sunucu kurulumu: PayTR

1. PayTR Mağaza Paneli → Bilgi sayfasından Mağaza No, Mağaza Parola (merchant_key) ve Mağaza Gizli Anahtar (merchant_salt) değerlerini alın ve config.php'ye yazın:

'paytr' => [
    'merchant_id' => '123456',
    'merchant_key' => '…',
    'merchant_salt' => '…',
    'test_mode' => true,          // canlıya geçerken false
    'no_installment' => 1,        // 1: taksit yok
    'max_installment' => 0,       // en fazla taksit (0: PayTR'nin izin verdiği)
    'timeout' => 30,              // ödeme sayfasının geçerliliği (dakika)
],

2. PayTR Mağaza Paneli → Destek & Kurulum → Ayarlar → Bildirim URL alanına şunu yazın ve kaydedin:

https://damga.ondiso.net/odeme/paytr/bildirim

Bu adres oturum ve CSRF istemez; her bildirim PayTR'nin özetiyle (HMAC-SHA256, merchant_key ve merchant_salt) doğrulanır, doğru bildirime düz metin OK döner. Aynı bildirim tekrar gelirse kredi ikinci kez yüklenmez. Tutar siparişle tutmazsa sipariş "Onay bekliyor"a düşer ve yönetimde incelenir. 3. Damga'nın ödeme sayfası PayTR çerçevesini (https://www.paytr.com/odeme/guvenli/…) gösterir; içerik güvenliği politikası yalnız o sayfada frame-src https://www.paytr.com izni verir. PayTR'nin iframeResizer betiği kullanılmaz (çerçeve sabit yüksekliktedir). 4. test_mode açıkken PayTR'nin test kartlarıyla deneyin; mağazanız PayTR'de canlıya alındıktan sonra test_mode değerini false yapın. 5. Sunucunuz bir ters vekil sunucunun (Cloudflare vb.) arkasındaysa PayTR'ye gönderilen user_ip müşterinin dış IP'si olmalıdır; PayTR yerel adresleri (127.0.0.1) reddeder.

Üç değerden biri boşsa kartla ödeme seçeneği gösterilmez.

#Sunucu kurulumu: havale / EFT

'billing' => [
    'vat_rate' => 20,
    'annual_free_months' => 2,
    'havale_cancel_days' => 7,
    'notify_email' => 'muhasebe@alanadiniz',   // "ödemeyi yaptım" bildirimleri (isteğe bağlı)
    'bank' => [
        'name' => 'Ziraat Bankası', 'holder' => 'Ondiso Yazılım Ltd. Şti.', 'iban' => 'TR00 0000 …',
        'second' => ['name' => '', 'holder' => '', 'iban' => ''],   // isteğe bağlı ikinci hesap
    ],
    // makbuzda ve faturada görünen satıcı; fatura için ayrıntılı alanlar: /belgeler/fatura
    'seller' => ['name' => 'Ondiso Yazılım Ltd. Şti.', 'address' => '…', 'district' => '…', 'city' => '…', 'tax_office' => '…', 'tax_id' => '…', 'email' => '…'],
],

IBAN boşsa havale seçeneği gösterilmez. Bekleyen havaleler yönetimde listelenir: dekontu görür, onaylar (krediler yüklenir / plan etkinleşir, üyeye e-posta gider) ya da gerekçeyle reddedersiniz. Onaylanan siparişin faturası invoicing.auto_issue açıksa kendiliğinden, kapalıysa sipariş sayfasındaki Fatura kes ile kesilir (e-Arşiv ve e-Fatura); Damga dışında kestiğiniz faturanın numarasını ve PDF'ini de siparişe elle ekleyebilirsiniz. Para iade edilirse sipariş "iade edildi" işaretlenir, yüklenen kredi bakiyede kaldığı kadarıyla geri alınır ve fatura sayfasından fatura iptal edilir ya da iade belgesi not edilir.

Plan kredileri, bitiş hatırlatmaları, havale iptalleri ve fatura gönderim denemeleri zamanlanmış görevle çalışır (/cron/<token>, dakikada bir; kurulum).