Kripto Fatura Geçerlilik Süresi: 30 Dakikadan 24 Saate Rehber
Kripto fatura geçerlilik süresi nasıl belirlenir? 30 dakika ile 24 saat arası seçenekler, kur kilidi, son saniye ödemeleri, iptal ve geç ödeme kuralları.
Kripto fatura geçerlilik süresi, küçük bir ayar gibi görünse de hem dönüşüm oranınızı hem de kur riskinizi doğrudan etkiler. Süre çok kısaysa müşteri borsasından çekim yapmaya yetişemez, çok uzunsa fiyatı değişken coinlerde eski kurla ödeme riski doğar. Bu yazıda MercanPay'de fatura süresinin nasıl çalıştığını, hangi senaryoda hangi sürenin mantıklı olduğunu ve süre dolduğunda ya da fatura iptal edildiğinde neler olduğunu anlatıyoruz.
Kripto fatura geçerlilik süresi nasıl belirlenir?
Her MercanPay faturasının bir son geçerlilik zamanı (expires_at) vardır ve bir fatura en fazla 24 saat açık kalabilir.
Panelden fatura oluştururken "Geçerlilik" alanında dört seçenek bulunur:
- 30 dakika
- 1 saat (varsayılan seçim)
- 6 saat
- 24 saat
API ile fatura oluştururken expires_in_minutes alanına 5 ile 1440 (24 saat) arasında bir değer verebilirsiniz:
$invoice = $zp->createUsdInvoice('49.90', [
'order_id' => 'order-1001',
'expires_in_minutes' => 60,
]);
Python'da aynı alan create_invoice(price_usd="49.90", order_id="order-1001", expires_in_minutes=60) şeklinde verilir. Ödeme sayfası kalan süreyi bir geri sayımla gösterir. Geri sayım sunucu saatine göre hesaplanır; müşterinin cihaz saati yanlış olsa bile doğru süreyi görür.
Hangi senaryoda hangi süre?
| Senaryo | Önerilen süre | Neden |
|---|---|---|
| Web sitesinde anlık ödeme (e-ticaret, dijital ürün) | 30 dk – 1 saat | Müşteri zaten ödeme niyetinde; kısa süre kur riskini azaltır |
| Borsadan ödeme yapacak müşteriler | 1 – 6 saat | Borsa çekim onayları zaman alabilir |
| DM ya da e-postayla gönderilen ödeme linki | 6 – 24 saat | Müşteri linki hemen açmayabilir |
| B2B ödemeler, onay süreci olan müşteriler | 24 saat | İç onay adımları için zaman tanır |
Sosyal medya üzerinden satışta link kullanımını Telegram ve Instagram satıcıları için kripto ödeme linki yazımızda ayrıca ele aldık.
Kur kilidi ve süre ilişkisi
USD fiyatlı faturalarda (müşterinin coin seçtiği faturalarda) kur, müşteri coin seçtiği anda kilitlenir ve faturanın süresi boyunca geçerli kalır. Burada küçük ama önemli bir ayrıntı var: müşteri coin seçtiğinde faturanın kalan süresi çok azsa, süre müşterinin ödeme yapabileceği kadar uzatılır. Sizin belirlediğiniz süre hiçbir zaman kısaltılmaz.
Müşteri henüz ödeme yapmadıysa coin seçimini değiştirebilir; yeni seçimde kur yeniden hesaplanır.
Kur kilidinin kur riskine etkisini kripto ödemede kur riski yazımızda ayrıntılı anlattık. Kısaca: USDT'de süre seçimi kur açısından pek önemli değildir, TRX'te ise kısa süre riski azaltır.
Son saniye ödemeleri: süre dolarken ne olur?
Müşteri ödemeyi süre bitmeden birkaç saniye önce gönderdiyse ne olur? Blok onayları yaklaşık bir dakika sürdüğü için ödeme henüz kesinleşmemiş olabilir.
MercanPay bu durumu iki şekilde ele alır:
- Zincirde görülen ödeme varsa fatura hemen "süresi doldu" yapılmaz. Ödeme sayfası müşteriye "Süre doldu — son anda gönderilen ödeme kontrol ediliyor…" mesajını gösterir. Onaylar tamamlanınca fatura normal şekilde ödenir.
- Geç olup olmadığına blok zamanı karar verir. Ödemenin geç sayılıp sayılmadığı, onayın tamamlandığı ana göre değil, işlemin blokzincire girdiği zamana göre belirlenir. Son saniyede ödeyen müşteri onay gecikmesi yüzünden cezalandırılmaz.
Kısmi ödemede ek süre
Müşteri eksik gönderirse fatura partial durumuna geçer ve faturaya en az 30 dakika ek süre verilir. Böylece müşteri kalan tutarı gönderirken süre dolmaz. Kısmi ödemeleri ve toleransı eksik, fazla ve geç ödemeler yazımızda anlattık.
Süre dolduktan sonra gelen ödemeler
Fatura süresi dolduktan sonra gelen ödeme kaybolmaz, bakiyenize yazılır. Webhook'ta data.payment.late alanı true olur.
USD fiyatlı bir faturada fiyatı değişken bir coinle (TRX) geç ödeme yapıldıysa, tutar o anki kurla yeniden fiyatlanır. Aksi hâlde müşteri, coinin düşmesini bekleyip eski ve artık daha ucuz tutarı ödeyebilirdi. Yeniden fiyatlama yapıldığında webhook'taki ödeme nesnesi şu bilgiyi taşır:
"payment": {
"txid": "a3f9…",
"amount": "310.5",
"late": true,
"repriced": {
"previous_amount": "298.2",
"amount": "305.9",
"rate_usd": "0.3269"
}
}
previous_amount eski tutarı, amount yeni kurla hesaplanan tutarı, rate_usd da kullanılan kuru gösterir. Fatura durumu, gelen ödemenin bu yeni tutara göre eksik mi, tam mı, fazla mı olduğuna göre belirlenir. USDT gibi dolara sabitlenmeye çalışan coinlerde yeniden fiyatlama yapılmaz.
Geç ödemeler için kendi iş kuralınızı belirleyin: stoğu sınırsız bir dijital ürünse teslim edebilir, stok ya da kampanya fiyatı söz konusuysa müşteriyle iletişime geçebilirsiniz.
Faturayı iptal etmek
Bazen bir faturayı süresi dolmadan kapatmak istersiniz: müşteri siparişten vazgeçti, fiyat yanlış girildi ya da stok bitti. Bunun iki yolu var:
- Panelden: Faturalar sayfasında faturanın detayından Faturayı iptal et butonuyla.
- API ile:
POST /v1/invoices/{id}/cancelisteğiyle.
curl -X POST https://mercanpay.com/v1/invoices/7b0c1f7e-…/cancel \
-H "Authorization: Bearer $MERCANPAY_API_KEY"
Kurallar net:
- Yalnızca hâlâ bekleyen ve hiç ödeme almamış faturalar iptal edilebilir. Kısmi ödeme almış bir fatura iptal edilemez; bu durumda istek
not_cancellablehatasıyla reddedilir. - İptal edilen faturada ödeme sayfası müşteriye "Fatura iptal edildi" uyarısı gösterir ve bu adrese ödeme göndermemesini söyler.
invoice.cancelledwebhook'u gönderilir.- Yine de müşteri iptalden sonra ödeme gönderirse, alınan tutar bakiyenize yazılır.
İptal ettiğiniz bir sipariş için yeniden fatura gerekirse yeni bir order_id kullanın; aynı numarayla yapılan istek iptal edilmiş faturayı döndürür. Mantığını order_id ile fatura sipariş eşleştirme yazımızda anlattık.
Süre dolan faturayla ne yapmalı?
Süre dolup ödeme gelmediğinde fatura expired olur ve invoice.expired webhook'u gönderilir. Ödeme sayfası müşteriye bu adrese ödeme göndermemesini ve satıcıdan yeni bir link istemesini söyler. Sizin tarafınızda yapılacaklar:
- Siparişi kapatın ya da stok rezervasyonunu serbest bırakın.
- Müşteri hâlâ almak istiyorsa yeni bir fatura oluşturun.
- Sık süre dolması yaşıyorsanız süreyi uzatmayı ya da müşterilere kısa bir "nasıl ödenir" rehberi sunmayı düşünün. İpuçları için ödeme sayfası ile dönüşüm oranını artırmak yazısına göz atın.
Sık sorulan sorular
Fatura süresini sonradan uzatabilir miyim?
Hayır, süre fatura oluşturulurken belirlenir. Sistem yalnızca kur kilidi ve kısmi ödeme gibi durumlarda süreyi kendiliğinden uzatır. Daha uzun süre gerekiyorsa yeni bir fatura oluşturun.
24 saatten uzun geçerli fatura oluşturabilir miyim?
Hayır. Bir fatura en fazla 24 saat açık kalabilir. Bu, kur riskini ve eski linklerin kullanılmasını sınırlar.
Müşteri süre dolduktan sonra ödedi, siparişi teslim etmeli miyim?
Ödeme bakiyenize yazılmıştır; teslim kararı sizin iş kuralınıza bağlıdır. Webhook'taki late alanı bu durumu ayırt etmenizi sağlar.
Kısmi ödeme almış faturayı neden iptal edemiyorum?
Faturaya para gelmiş olduğu için iptal edilemez. Kalan tutar gelmezse fatura süresi dolduğunda expired olur; alınan tutar yine bakiyenizdedir.
MercanPay ile başlayın
Doğru kripto fatura geçerlilik süresi, hem müşterinize hem kasanıza zaman kazandırır. Satıcı başvurunuzu yapın, ilk faturanızı panelden ya da API'den oluşturun ve tüm alanlar için dokümantasyonu inceleyin.
