Hızlı başlangıç

1. Ürünü keşfedin#

Test siparişi oluşturmak, ödeme bağlantılarını keşfetmek ve ücret hesaplamasını kontrol etmek için demo çalışma alanını açın. Demo ayrı test verileri kullanır. Banka ödemesi oluşturmaz veya bir cüzdana para aktarmaz.

2. Telegram ile hesap oluşturun#

Telegram girişinden sonra satıcı hesabı açılır. Web sitesi kayıt süreci /account#applications adresindedir; hem form hem de bireysel takip /account#applications/{id} adresinde uygulama içinde kalır.

Yeni bir ödeme ve kart niyeti, satıcının en son web sitesi inceleme başvurusunun onaylanmasını gerektirir. Onay tek başına ödeme ağ geçidini bağlamaz. İnceleme gönderimden sonra değişirse, mevcut işlem durum okumaları, mutabakat ve talep edilen banka kodu için kullanılabilir kalır.

3. Mağazanızı kurun#

1. 1

   Müşterinizin tanıyacağı bir mağaza adı seçin.

2. 2

   Varsayılan bir KDV kuralı seçin. Her yeni fatura, müşteri ücreti ve KDV paylarını ayrı ayrı %0 ile %100 arasında kabul eder.

3. 3

   Telegram'da almak istediğiniz bildirimleri seçin.

4. 4

   Tipik bir sipariş tutarını kontrol etmek için hesap makinesini kullanın.

4. Ödeme bağlantısı hazırlayın#

Net bir sipariş başlığı, tutar ve para birimi girin. Müşteri, satın alma ayrıntıları ve ödenmesi gereken toplam tutar ile özel bir sayfa alır. Mevcut bir fatura, mağaza ayarlarınız değiştiğinde orijinal koşullarını korur.

5. Ödeme kullanılabilirliğini kontrol edin#

Hesabınızdan faturaları, API anahtarlarını, araçları ve webhook'ları yönetin. Ödemeden önce Kevmi, ağ geçidi yapılandırmasını, satıcı onayını, tutarı ve fatura koşullarını kontrol eder. Seçilen yöntem kullanılamıyorsa, ödeme sayfası nedenini açıklar.

Yeni çalışma alanı faturaları USD taban fiyat kullanır ve Any dört yöntemin tümünü sunar. SBP, donmuş Rusya Merkez Bankası referans kuru üzerinden RUB'a çevrilir; kripto, açık 1:1 USD/USDT fatura kuralını kullanır. Eski yerel fiyatlandırma, eski faturalar ve pricingMode=universal olmayan API istekleri için kullanılabilir durumda kalır. Aşağıdaki çoklu mağaza ve USD fiyatlandırma bölümüne bakın.

Yeni bir canlı kart veya Alipay ödemesi için mevcut ağ geçidi yalnızca feeCustomerPercent=0 ve vatCustomerPercent=100'ü destekler: satıcı tüm işlem ücretini karşılar ve KDV müşteri için tam olarak eklenir. Diğer paylar bir faturada kaydedilip hesaplanabilir, ancak yürütme unsupported_allocation ile engellenir. Sunucu kaydedilmiş koşulları sessizce asla değiştirmez. SBP ve USDT kripto ödemeleri tüm işlem ücreti paylarını destekler ve KDV içermez.

Birden fazla mağaza ve tek USD taban fiyat#

Toplu analiz ve işlemler için Tüm mağazaları seçin veya kendi kayıtları için bir mağaza seçin. Her mağazanın ayrı bir storeId'si, adı, varsayılan KDV'si, faturaları, API anahtarları, webhook uç noktaları, olay geçmişi ve web sitesi uygulaması vardır. Bildirimler ve destek talepleri hesaba aittir. Bir hesap en fazla 100 mağaza oluşturabilir. Mevcut kayıtlar ilk mağazasında kalır.

Yeni çalışma alanı faturaları pricingMode="universal" ve USD taban fiyat kullanır. Any, kart, alipay, sbp ve kriptoyu içerir; bir satıcı bir alt küme seçebilir. Kartlar ve Alipay USD tahsil eder. SBP, Rusya Merkez Bankası USD/RUB referans kurunu kullanarak RUB tahsil eder. Kripto, açık fatura kuralı 1 USD = 1 USDT kapsamında USDT tahsil eder. Bu bir fatura dönüştürme kuralıdır, piyasa USDT kotasyonu değildir. Ağ geçidi, transferden önce seçilen coin'in kurunu, tam transfer tutarını ve talimatlarını sağlar.

Referans kuru ve her iki tutar oluşturma sırasında dondurulur. RUB dönüştürmesi içeren faturalar 24 saat içinde sona erer. Referans kuru alınamazsa, oluşturma FX_UNAVAILABLE ile başarısız olur; uydurulmuş veya bayat yedek kur kullanılmaz. Sahip yanıt tutarı ve kotasyonlar USD muhasebe para birimini kullanır. quotes[method].settlement, yerel tahsil kotasyonunu içerir. Genel ödeme sayfası, seçilen tahsil para birimini currency içinde, orijinal fiyatı baseAmountMinor/baseCurrency içinde ve referans kurunu fx içinde gösterir. Bir ödeme gönderildikten sonra yöntemi değiştirilemez; bir faturanın tek ağ geçidi işlemi vardır.

Amaçlanan mağaza içinde bir API anahtarı oluşturun ve sunucunuzdan Authorization: Bearer <key> gönderin. Mağaza bağlaması değişmezdir; X-Kevmi-Store, anahtara başka bir mağazaya erişim izni veremez. Tarayıcı oturumları X-Kevmi-Store: <storeId> seçer; atlanırsa ilk mağaza seçilir. all değeri yalnızca GET /api/account/dashboard ve GET /api/payment-links tarafından kabul edilir. Değişiklikler seçili bir mağaza, Origin ve X-CSRF-Token gerektirir. Hesap kimlikleri ve mağaza kimlikleri farklı tanımlayıcılardır.

Uyumluluk için, pricingMode="universal" içermeyen API istekleri yerel fiyatlandırmayı ve orijinal para birimi kısıtlamalarını korur. Mevcut faturalar asla yeniden hesaplanmaz. Analizlerdeki onaylanmış tahsilatlar, doğrulanmış ödemelerden kaydedilmiş fatura giderlerinin düşülmesiyle elde edilir; bunlar çekilebilir bakiye değildir. Eski fatura para birimleri ayrı kalır ve ödemeler destek ile düzenlenir. Bir siparişi yalnızca sunucu API'si, olay geçmişi veya imzalı bir webhook üzerinden payment.fulfillmentReady=true ve payment.status="succeeded" durumunu kontrol ettikten sonra yerine getirin.