Ödeme bağlantıları

Bir faturanın içerdikleri#

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.

Genel açıklamalara asla şifreler, API anahtarları, kart bilgileri veya banka kodları eklemeyin. Müşterinin tanıdığı bir sipariş başlığı ve referansı kullanın.

• Mağaza adı, en fazla 120 karakterlik bir sipariş başlığı ve en fazla 500 karakterlik bir açıklama.
• Temel tutar ve açık bir USD, RUB veya USDT para birimi.
• Uyumlu yöntemler, ayrı ücret ve KDV payları, bir sipariş referansı ve bağlantı son kullanma süresi.
• Sahip yanıtları, mevcut bir işlemin kayıtlı durumuyla link.payment içerir; bu, bağlantının kullanılabilirlik durumundan ayrıdır.

Herhangi biri — müşteri seçer#

Herhangi biri, fatura para birimiyle uyumlu tüm yöntemleri seçer: USD için kartlar ve Alipay, RUB için SBP ve USDT için kripto. API, string any yerine somut bir yöntem dizisi alır. Her yöntemin kendi fiyat teklifi vardır.

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.

Bağlantı oluşturma#

1. 1

   Hesabınızda Ödeme bağlantılarını açın.

2. 2

   Bir başlık, tutar, para birimi ve açıklama girin. İki kontrol ile ücret ve KDV paylarını ayarlayın.

3. 3

   Müşterinin seçmesi için Herhangi biri seçeneğini bırakın veya belirli yöntemleri seçin. Son kullanma tarihini ayarlayın.

4. 4

   Her yöntem için toplamı karşılaştırın ve ödemeyi önizleyin.

5. 5

   Oluşturmanın hemen ardından hazır ödeme bağlantısını alın, ardından müşteriniz veya widget'ınız için kopyalayın.

Koşullar faturada kalır#

Kayıtlı bir fatura, mağaza ayarları değiştiğinde değişmez. Fiyatı, para birimi, ücret ve KDV payları, sipariş referansı ve meta verileri o siparişe aittir. Bu, bağlantıyı zaten açmış bir müşteri için toplamı tutarlı tutar.

Fiyat, açıklama veya maliyet dağılımı değiştiğinde yeni bir bağlantı oluşturun ve eskisini duraklatın. Bir URL tutarını düzenlemek sunucu hesaplamasını değiştiremez.

Özel bir ödeme sayfası#

Sunucu bağlantıları veritabanında kaydedilir ve tüccar hesabı erişimi olmadan /pay/… adresinde cihazlar arasında açılır. Bir müşterinin faturayı görüntülemek için kayıt olması gerekmez. Mağaza bakiyeleri, ayarlar ve diğer müşteri kayıtları özel kalır.

/pay/demo örneği, para çekmeden deneyimi önizler. Tarayıcı demo bağlantıları test verisidir ve gerçek fatura olarak sunulmamalıdır.

Kullanılabilirliği yönetme#

Bir bağlantıyı duraklatmak, iptal etmek veya süresini doldurmak yeni bir işlemi engeller. Gönderilmiş bir ödemeyi gizlemez: durum, mutabakat ve istenen banka kodu kullanılabilir kalır. Bağlantı kullanılabilirliği ve finansal durum ayrı ayrı kontrol edilir.

Devam ettirmek, koşulları değiştirmeden duraklatmayı kaldırır. İptal kesindir ve süresi dolmuş bir bağlantı uzatılamaz. Yeni bir sipariş veya değişen koşullar için yeni bir fatura oluşturun, sonucu bilinmeyen bir ödemeyi yeniden denemek için değil.

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.