Değişiklikler

Artık her blog yazısı, dokümantasyon sayfası ve API referansı, tek tıklamayla ChatGPT, Claude veya tercih ettiğiniz IDE aracısına verebileceğiniz temiz bir Markdown kopyasına sahip.

LLM için kopyalayın

Her blog yazısında ve dokümantasyon sayfasında başlığın yanında yeni bir düğme bulunuyor. Bu düğme dört kısayol içeren bir açılır menü sunuyor: sayfayı Markdown olarak kopyalayın, Markdown olarak görüntüleyin, ChatGPT’de açın veya Claude’da açın. Son iki seçenek, sohbete Markdown sürümünün URL’sini otomatik olarak ekliyor. Böylece model, bir HTML sayfasının ekran görüntüsü yerine doğrudan içerikle çalışabiliyor.

Markdown olarak API referansı

API referansının tamamına artık canlı OpenAPI tanımından oluşturulan /api/docs.md adresinden ulaşabilirsiniz. URL’yi herhangi bir LLM’e yapıştırıp “kanal ilişkilendirmesiyle nasıl ödeme oluşturabilirim?” diye sorun. Uydurma bir yanıt yerine kaynağa dayalı bir yanıt alırsınız.

Dokümantasyon sayfalarının Markdown sürümleri, aynı yolun sonuna .md eklenerek sunulur. Örneğin: /docs/getting-started.md. IDE aracıları için tümü llms.txt içinde indekslenmiştir.

Bu sürüm, doğrudan transferler için manuel gönderim, e-posta bildirimleri ve kesintiye uğrayan oturumlar için ödeme kurtarma özelliklerini sunar.

Doğrudan transferler için manuel gönderim

Müşteriler artık satıcının adresini kopyalayıp herhangi bir cüzdandan tam tutarı göndererek ödeme yapabilir, cüzdan bağlantısı gerekli değildir. Tüm EVM zincirlerinde ve TON’da aynı token, aynı zincir ödemeleri için çalışır. Sistem her ödeme için benzersiz bir tutar (rastgele dust basamaklarıyla) oluşturur ve transferi zincir üzerinde otomatik olarak algılar.

Bu, donanım cüzdanı kullanan, borsadan çekim yapan veya cüzdanlarını bir web sitesine bağlamak istemeyen müşteriler için kullanışlıdır.

E-posta bildirimleri

Müşteriler ödemeleri onaylandığında e-posta almayı tercih edebilir, böylece gönderdikten sonra sayfayı güvenle kapatabilirler. Satıcılar da panel Ayarlarından tamamlanan ödemeler, başarısızlıklar veya diğer olaylar için e-posta uyarılarını etkinleştirebilir.

Ödeme kurtarma

Ödeme sırasında sayfa yenilenirse veya cüzdan bağlantısı kesilirse, ödeme artık otomatik olarak kurtarılır. Manuel gönderim ödemeleri, tam tutar hâlâ görünür şekilde yatırma ekranını sürdürür. Cüzdan bağlantılı ödemeler, müşterinin işlem hash’ini yapıştırabileceği veya yeniden başlayabileceği bir kurtarma ekranı gösterir.

Müşteri zaten göndermişse ama işlem hash’ini bulamıyorsa, arka plan monitörü ödemeyi yine de algılayıp otomatik olarak tamamlar.

Bu sürüm, programatik göndericiler için yeni bir headless API ekler ve ödeme sayfasını ile satıcı panelini beş dile getirir.

Headless ödeme API’si

Yeni POST /api/payments/headless endpoint’i tek bir çağrıda bir yatırma adresi ve tam tutar döndürür. Hangi zincirden ve hangi token ile ödeme yapacağını zaten bilen göndericiler için tasarlanmıştır: otomatik ödeme sistemleri, partner platformları, scriptler ve kendi arayüzünü kontrol eden cüzdan uygulamaları.

Doğrudan (aynı token, aynı zincir) ve yatırma tabanlı swap/bridge rotalarını destekler. İmzalı sipariş akışları (EIP-712 intent’leri, zincir üstü swap işlemleri) headless modda desteklenmez, entegrasyonlar bu rotalar için barındırılan /pay/{id} sayfasına geri dönmelidir.

Ödeme sayfası ve pano 5 dilde

/pay/:id sayfası ve tam satıcı panosu artık İngilizce, İspanyolca, Türkçe, Ermenice ve Rusça dillerinde kullanılabilir. Arayüz tarayıcı dilini otomatik algılar ve seçimi ziyaretler arasında hatırlar. Dil seçicileri ödeme sayfası altbilgisinde, Pay Me sayfası altbilgisinde ve pano kenar çubuğunda yer alır.

Güvenilirlik iyileştirmeleri

Ödeme izleme, takılı kalan yatırımlar ve cüzdan bağlantı sorunlarında bir dizi düzeltme.

Bu sürüm tarayıcısız programatik erişim, kesin ödeme tutarı takibi, depozit ödemeleri için QR kodları ve bir dizi güvenlik iyileştirmesi ekliyor.

Önemli değişiklik: API yolları yeniden adlandırıldı

Tüm satıcı paneli endpointleri /api/dashboard/* adresinden /api/merchant/* adresine taşındı. Eski yollar artık çalışmıyor. Entegrasyonlarınızı güncelleyin.

Ana API anahtarı

Satıcılar artık Panel → Ayarlar’dan bir ana API anahtarı (msk_ öneki) oluşturabilir. Bu anahtar tüm /api/merchant/* endpointlerinde kimlik doğrulaması yapar, ödeme oluşturma, kanal yönetimi, ödeme ayarları, tarayıcı oturumu gerekmeden. Backend servisleri, scriptler ve CI pipeline’ları için kullanışlı.

Ana anahtar yönetimi (oluşturma, döndürme, iptal) tarayıcı girişi gerektirir. Bir ana anahtar kendisini döndüremez veya iptal edemez.

Webhook’larda ödeme tutarı

Webhook payload’ları artık dest_amount ve dest_decimals içerir, cüzdanınıza ulaşan tam token sayısı. Bu, stablecoin olmayan ödemelerde (örn. TON) kritik öneme sahip çünkü amount_usd token miktarını belirtmez. Okunabilir rakam için dest_amount değerini 10^dest_decimals ile bölün.

Depozit ödemelerinde QR kod

Depozit yoluyla ödeme yapan müşteriler (Rubic zincirler arası rotalar, TON, Tron) artık kopyalama alanlarının üzerinde taranabilir bir QR kod görür. Zincire özel URI’lar: EVM için EIP-681, TON için memo ile ton://transfer, Solana için Solana Pay, BTC için BIP-21.

Kanal düzenleme sayfası

Her kanalın artık /dashboard/channels/:id adresinde özel bir düzenleme sayfası var: markalama, webhook URL, ödeme override’ı, API anahtarı döndürme ve erişimi iptal etmek için tehlike bölgesi bölümleriyle.

Bana Öde sayfası kanalı

Bir Bana Öde sayfası ayarlamak artık otomatik olarak ona özel bir kanal oluşturur. Bu, sayfanıza kendi markalaması, ödeme hedefi ve webhook URL’si verir, diğer kanallarınızdan bağımsız.

Webhook güvenilirliği

Yeni bir cron görevi, satır içi durum sorgulaması yoluyla tamamlanan ancak webhook’u sessizce atlanan tüm ödemeler için webhook tetikler. Artık kaçırılan bildirim yok.

Güvenlik

• Yönetici girişinde hız sınırlaması (IP başına 15 dakikada 5 deneme)
• CORS mutopay.com + localhost ile sınırlandırıldı
• Tüm sayfalarda Content-Security-Policy başlığı
• Saklanan API anahtarları için AES-256-GCM şifreleme
• Dönüş URL’lerinde açık yönlendirme koruması

Satıcılar artık API kanallarını doğrudan panelden oluşturup yönetebilir, WooCommerce eklentisi gerekmez. Her kanal ayrıca hesap varsayılanından bağımsız olarak kendi ödeme hedefine sahip olabilir.

Panelden kanal oluşturma

Ayarlar’daki yeni + Yeni kanal butonu saniyeler içinde manuel bir API kanalı oluşturmanızı sağlar. Bir isim verin, isteğe bağlı olarak bir webhook URL’si ekleyin ve isteğe bağlı olarak bu kanala özel bir ödeme override’ı ayarlayın. Tam API anahtarı oluşturma sırasında bir kez gösterilir, sayfadan ayrılmadan önce kopyalayın.

Bu, MutoPay’i herhangi bir özel mağazaya, mobil uygulamaya veya backend servisine OAuth akışından geçmeden entegre etmenin en kolay yoludur.

Kanal bazlı ödeme override’ı

Her kanal artık kendi ödeme zinciri, tokeni ve cüzdan adresine sahip olabilir. Override ayarlanmazsa kanal, hesap düzeyindeki varsayılanı kullanır. Override’lar kanal kartında doğrudan yönetilir, bir tane ayarlamak için Override’a, düzenlemek için kalem simgesine, hesap varsayılanına dönmek için Override’ı Kaldır’a tıklayın.

Üç alan, zincir, token ve cüzdan adresi, her zaman bir paket olarak kaydedilir ve silinir. Bu, bir zincirin ayarlanıp eşleşen cüzdanın bulunmaması gibi uyumsuzlukları önler.

Satır içi kanal düzenleme

Kanal adları ve webhook URL’leri artık satır içi düzenlenebilir, herhangi bir alanın yanındaki kalem simgesine tıklayın, değişikliğinizi yapın ve sayfadan ayrılmadan kaydedin.

Webhook secret artık mevcut Test Webhook butonunun yanında her kanal kartında Kopyala butonuyla birlikte görünür.

Basitleştirilmiş kurulum

Yeni satıcı kurulum akışı, zincir/token ve cüzdan adresi adımlarını tek bir Ödemeyi Ayarla adımında birleştirir. Zincir, token ve cüzdan tek bir formda birlikte yapılandırılır ve tek bir API çağrısıyla kaydedilir.

API

Dört yeni panel endpointi bu özellikleri destekler:

Metot	Endpoint	Açıklama
POST	/api/dashboard/channels	Manuel kanal oluştur; { channel, api_key } döndürür
PATCH	/api/dashboard/channels/:id/webhook-url	Webhook URL’sini güncelle
PUT	/api/dashboard/channels/:id/settlement	Kanal bazlı ödeme override’ı ayarla
DELETE	/api/dashboard/channels/:id/settlement	Override’ı kaldır (varsayılana dön)

MutoPay’in satıcı ve müşteri arayüzleri tamamen yeniden tasarlandı; satıcılar artık herhangi bir tutarı kabul eden kişisel bir ödeme sayfasına sahip, sabit fatura gerekmez.

Bana Öde bağlantıları

Her satıcı mutopay.com/pay/@adınız adresinde kişisel bir sayfa alır. Ziyaretçiler istedikleri tutarı ve isteğe bağlı bir not girerler, bahşiş, serbest çalışma faturaları ve açık uçlu siparişler için kullanışlı. Sayfanızı Panel → Ayarlar → Bana Öde Sayfası’ndan ayarlayın.

Yeniden tasarım

Müşteriye yönelik ve satıcıya yönelik tüm sayfalar artık tutarlı bir tasarım dili paylaşıyor: ödeme sayfası, satıcı paneli, yönetici paneli ve Bana Öde sayfası genelinde birleşik kartlar, tipografi ve renk sistemi.

Mobil uyumlu

Her sayfa, ödeme kasası, satıcı paneli ve yönetici paneli, artık tamamen duyarlı. Müşteriler ve satıcılar MutoPay’i her cihazda kullanabilir.

Ödeme açıklaması

Satıcılar ödeme oluştururken insan tarafından okunabilir bir açıklama ekleyebilir (örn. “Sipariş #1042 – Mavi Widget”). Müşterinin ödeme sayfasında ne için ödeme yaptığına dair bağlam olarak görünür.

Kanal markalaması

Her satıcı kanalı artık müşterilere gösterilen varsayılan işletme adını ve sloganı geçersiz kılabilir. Tek hesapta birden fazla mağazası olan satıcılar için kullanışlı. Panel → Kanallar → kanal düzenle’den yönetilir.

MutoPay artık üç büyük EVM-dışı zinciri kapsıyor. Müşteriler TON, Solana ve Tron cüzdanlarından ödeme yapabilir, satıcılar ise bu zincirlerin yerel tokenleriyle tahsilat yapabilir.

Yeni zincirler

• TON: TON veya TON üzerindeki USDT’yi kabul edin. Alıcılar Tonkeeper, MyTonWallet veya TonConnect uyumlu herhangi bir cüzdana tek dokunuşla bağlanır. Telegram botları ve mini uygulamalar için ideal.
• Solana: herhangi bir SPL token ile ödeme yapın, Solana üzerindeki yerel USDC ile tahsilat yapın. Phantom ve Backpack desteklenir.
• Tron: gelişen pazarların en yaygın stablecoin rayı olan USDT-TRC20’yi kabul edin ve tahsilat yapın.

Rota karşılaştırma

Birden fazla rota mevcut olduğunda, ödeme sayfası artık bunları yan yana gösterir: köprü adı, varış tutarı ve tahmini süre; alıcılar hız veya fiyatı seçebilsin diye.

Manuel yatırma akışı

Doğrudan imzalayamadığımız rotalar için (NEAR Intents ve diğer niyet tabanlı köprüler), ödeme sayfası kopyalanabilir bir yatırma adresi ve tam tutar gösterir, yatırma geldiğinde otomatik olarak ilerler.

Yeni webhook olayları

• payment.kyc_required, alıcı kimliğini doğrularken rota sağlayıcısı geçici bir tutma koydu. Satıcıdan eylem gerekmez; nihai payment.completed veya payment.failed olayı son sinyaldir.
• payment.needs_manual_check, sağlayıcı beklenmedik bir durum döndürdü. MutoPay operasyonları, ödeme nihai bir duruma ulaşmadan önce araştıracaktır.

Her ödeme artık belirleyici bir sonuca ulaşır, hiçbir ödeme pending durumunda sessizce takılı kalamaz.

Ödeme sayfası

Cüzdan bağlantısı doğrudan ödemeye akar. Bağlandıktan sonra ikinci bir tıklama yok.

Ödemeler artık 50’den fazla fiat para biriminden herhangi birinde oluşturulabilir. Tutar, ödeme oluşturulduğunda gerçek zamanlı merkez bankası döviz kurlarıyla USD’ye çevrilir.

Özellikler

• 50’den fazla fiat para birimi: EUR, GBP, SAR, AED, JPY, AMD ve daha fazlasında fiyatlandırın. Dönüşüm, 30’dan fazla merkez bankasından alınan Frankfurter API kurları kullanılarak sunucu tarafında gerçekleşir.
• Denetlenebilir döviz kurları: her ödeme orijinal tutarı, para birimini ve oluşturma anında kullanılan döviz kurunu saklar. Kontrol paneli, yönetici paneli ve webhook payload’larında görüntülenebilir.
• WooCommerce otomatik para birimi: MutoPay eklentisi artık mağazanızın yapılandırılmış para birimini otomatik olarak gönderir. EUR mağazası herhangi bir ek yapılandırma olmadan EUR ödemeleri oluşturur.
• Geriye dönük uyumlu API: mevcut amount_usd alanı çalışmaya devam eder. Yeni amount + currency alanları ek niteliktedir.
• Dayanıklı kur önbelleği: döviz kurları Cloudflare KV’de 2 saatlik taze pencere ve 24 saatlik eski veri yedekleme ile önbelleğe alınır, böylece üst kur sağlayıcısı geçici olarak kullanılamasa bile ödemeler çalışmaya devam eder.

MutoPay v1.0’ı yayınlamaktan büyük heyecan duyuyoruz: herhangi bir tokeni stablecoine dönüştüren kripto ödeme altyapısı.

Özellikler

• Ödeme API’si: tek bir POST isteğiyle ödeme bağlantıları oluşturun
• Çoklu zincir desteği: Ethereum, Polygon, Arbitrum, Base, Optimism, Avalanche, BNB Chain
• 1.000’den fazla token: herhangi bir tokeni kabul edin, her zaman USDC, USDT veya DAI alın
• Zincirler arası köprüleme: en iyi mevcut protokol üzerinden otomatik yönlendirme
• Satıcı kontrol paneli: ödemeleri izleyin, API anahtarlarını yönetin, webhook’ları yapılandırın
• Yönetici paneli: platform genelinde analitik, satıcı yönetimi, ücret yapılandırması
• Webhook bildirimleri: HMAC-SHA256 imzalı, otomatik yeniden deneme ve üstel geri çekilme ile
• Kendi saklama hakkınız: fonlar doğrudan satıcının cüzdanına aktarılır