Web sitenize ödemeyi gömün
Ödemeyi bir modal içinde açın, bir sayfaya gömün veya müşteriyi özel bir ödeme sayfasına yönlendirin. Widget, herkese açık bir ödeme URL'si kullanır ve tarayıcıda asla bir tüccar API anahtarı gerektirmez.
Bu sayfada
Faturadan ödemeye#
/account#links içinde bir fatura oluşturun ve anında checkoutUrl alın. /account#widget adresini açın, bağlantıyı yapıştırın ve modal, satır içi blok veya yönlendirme seçin. Anahtarlar ve webhook'lar komşu hesap bölümlerinde mevcuttur.
Oluşturucu önizlemesi her zaman ücret talep etmeden bir demo siparişi kullanır. Oluşturulan widget kodu, canlı bağlantınızı korur; koşulları kayıtlı sunucu faturasından gelir.
Arayüzdeki yeni bir fatura için USD, kartları ve Alipay'ı sunar; RUB, SBP'yi sunar; USDT, kriptoyu sunar. API, uyumluluk için USD + kripto kaydedebilir, ancak canlı kripto ödemesi crypto_requires_usdt ile engellenir. USD ve USDT farklıdır; otomatik dönüştürme veya varsayılan 1:1 oran yoktur. Kripto ödemesi ayrı bir USDT faturası gerektirir.
Normal bağlantı yedeği olan bir düğme#
Bu örnek, para talep etmeden bir demo açar. Her iki URL değerini, fatura yanıtınızdaki checkoutUrl ile değiştirin. Betiği ödeme URL'siyle aynı Kevmi kaynağından yükleyin.
href, JavaScript kullanılamadığında ödemeyi açar. data-kevmi-label, iframe'e erişilebilir bir ad verir. Betiği sayfa başına bir kez ekleyin.
<script src="https://kevmi.maxeevmax1.chatgpt.site/widgets/kevmi.js" defer></script>
<a href="https://kevmi.maxeevmax1.chatgpt.site/en/pay/demo"
data-kevmi-checkout="https://kevmi.maxeevmax1.chatgpt.site/en/pay/demo"
data-kevmi-mode="modal"
data-kevmi-label="Order checkout">Pay securely</a>Ödemeyi açmanın üç yolu#
Satır içi mod için div gibi bir kapsayıcı kullanın ve CHECKOUT_URL_FROM_API değerini gerçek bir URL ile değiştirin. Çerçeve, kapsayıcı genişliğine uyum sağlar; ödeme mesajları yüksekliğini sınırlı bir aralık içinde yeniden boyutlandırabilir.
Modal, düğmesi, Escape veya arka plan tıklamasıyla kapanır. Kapanıştan sonra odak orijinal tetikleyiciye döner. Azaltılmış hareket ayarları geçişi kısaltır.
| data-kevmi-mode | Davranış | Şunlar için yararlı |
|---|---|---|
| modal | Bir kaplama iletişim kutusu; varsayılan mod | Sipariş düzeyinde bir ödeme düğmesi |
| satır içi | Seçili kapsayıcı içinde bir iframe | Sitenizde bir ödeme adımı |
| yönlendirme | Geçerli sekmede Kevmi'ye gezinme | Tam bir ödeme sayfası |
<div data-kevmi-checkout="CHECKOUT_URL_FROM_API"
data-kevmi-mode="inline"
data-kevmi-label="Order checkout"></div>Arayüzünüzden ödemeyi açın#
kevmi:opened ve kevmi:closed belge olayları, arayüzünüzün açılma ve kapanmaya tepki vermesini sağlar. Tetikleyici üzerindeki bir kevmi:error olayı, geçersiz bir ödeme URL'si bildirir. Hiçbiri ödemeyi kanıtlamaz. Widget betiği yüklendikten sonra JavaScript API'sini çağırın.
window.Kevmi.open(checkoutUrl, {
mode: 'modal',
label: 'Order checkout',
closeLabel: 'Close checkout'
});
// Inline blocks added after page load are detected automatically.
// You may also request mounting explicitly:
window.Kevmi.mount(document);Başarılı bir ödemeyi ne kanıtlar#
HTML içine API anahtarları veya imzalama sırları koymayın. Widget yalnızca bir faturaya giden herkese açık bir bağlantı alır. Checkout, kart ayrıntılarını ve banka kodlarını ağ geçidi anahtarıyla şifreler; Kevmi sunucusu bunları düz metin olarak kabul etmez.
postMessage arayüz durumunu günceller, sipariş yerine getirmeyi değil. İşlemeden önce mesaj kaynağını ve kaynak pencereyi kontrol edin. Nihai sonuç için doğrulanmış bir payment.succeeded olayı veya sunucunun GET link.payment özetindeki succeeded durumunu kullanın.
Widget'ı üretime eklemeden önce#
- İçerik Güvenliği Politikanızın script-src ve frame-src yönergelerinde Kevmi kaynağına izin verin; ilgisiz politikaları genişletmeden.
- Dar ekranları, klavye erişimini ve açık ile koyu temaları kontrol edin.
- Faturanın etkin, süresi dolmamış ve doğru fiyat ile maliyet paylarına sahip olduğunu doğrulayın.
- Yedek olarak sıradan bir ödeme bağlantısı bulundurun.
- Başarısız teslimatları ve yinelenen webhook olaylarını, bir siparişi iki kez vermeden test edin.