Referans mimari: stablecoin ödeme gateway'i
Bir PSP için stablecoin tahsilatı üç işi aynı anda gerektirir: müşteriden USDT/USDC toplamak, gelen parayı compliance'tan geçirmek ve üye işyerine ödemek. Bu mimari checkout, tarama ve settlement'ı tek credit bakiyesi üzerinde birleştirir; onay mantığını idempotent olaylara bağlar ki aynı ödeme iki kez alacak yazılmasın.
Zorluk
Türkiye'de tahsilatların büyük kısmı USDT üzerinden döner, ama stablecoin kabul etmek sadece cüzdana bakmak değildir. Eksik ve fazla ödemeler, geç gelen onaylar ve tekrar teslim edilen webhook'lar muhasebeyi bozar. Ayrıca gelen her fonun KYT ve sanctions kontrolünden geçmesi gerekir. Bunları ayrı bir tarama tedarikçisi ve ayrı bir payout rail ile çözmek, tek bir ödeme akışını üç sözleşmeye dağıtır.
- Invoices / checkoutC2
- Transaction screening / KYTC3
- Sanctions check + feedC2
- Mass payout / settlementC2
Barındırılan checkout ve invoices ile tahsil et
Ödeme talebini invoices/checkout ile oluştur; müşteri barındırılan sayfada USDT ya da USDC gönderir. Eksik, fazla ve kısmi ödemeleri ayrı durumlar olarak izle, zincir onaylarını beklet, yalnızca kesinleşmiş ödemeyi 'ödendi' say.
Gelen fonu settle etmeden tara
Her gelen ödemede karşı cüzdana KYT ve sanctions taraması uygula. Riskli veya yaptırımlı kaynaklı fon üye işyeri bakiyesine geçmeden review kuyruğuna düşer; temiz fonlar akışa devam eder.
Üye işyerine tek bakiyeden öde
Onaylı tahsilatların settlement'ını aynı credit bakiyesinden yap. Olaylar imzalı ve idempotent olduğu için tekrar teslim edilen bir webhook çift alacak yazmaz — mutabakat deterministik kalır.
Bu mimari neyi teslim eder
- USDT/USDC tahsilatı barındırılan checkout ile tek entegrasyonda toplanır
- Gelen fonlar settle edilmeden önce KYT ve sanctions'tan geçer
- İmzalı idempotent olaylar sayesinde tekrar teslim çift alacak üretmez
Sıkça sorulanlar
Müşteri faturadan az veya çok gönderirse ne olur?
checkout eksik, fazla ve kısmi ödemeyi ayrı durumlar olarak takip eder. Fatura ancak beklenen tutar zincirde kesinleştiğinde 'ödendi' sayılır; fark durumları settlement kararını sizin kurallarınıza bırakır.
Aynı ödeme bildirimi iki kez gelirse muhasebe bozulur mu?
Hayır. Olaylar imzalı ve idempotent'tir; her ödemenin tekil bir kimliği vardır. Yinelenen teslimat aynı kimliği taşıdığından sistem tarafından tek kez işlenir, çift settlement oluşmaz.
Bakiye yükle, anahtarını al, yayına çık.
Self servis. Kripto ya da kartla öde. Krediyle ölçümlenir — ağır ilkel yapılar daha pahalı, basitler ucuz.
API anahtarı al