Ana içeriğe geç

Ödeme ağ geçidi oluşturma

Emanetçi ödeme ağ geçitlerini kullanmak için doğrulanmış bir Volet.com hesabınız olmalıdır. Henüz yoksa Hesap oluşturma, Kurumsal doğrulama veya Bireysel doğrulama sayfasına bakın.

Emanetçi olmayan ödeme entegrasyonları Volet.com hesabı gerektirmez. Entegrasyon ayrıntıları için lütfen ekibimizle iletişime geçin.

Entegrasyon yönteminizi seçin​

  • Volet.com tarafından barındırılan hazır bir ödeme sayfasıyla en hızlı entegrasyonu istiyorsanız Hosted Checkout'u kullanın. Bu, Volet.com hesap bakiyelerinden ödemeleri destekleyen tek entegrasyon yöntemidir.
  • Kendi ödeme akışınızı oluşturmak ve müşteri deneyimini tamamen kontrol etmek istiyorsanız API'yi kullanın.

İşletmeniz için doğru entegrasyon yöntemini seçmek üzere API, Hosted Checkout ve akıllı sözleşmeleri karşılaştırın.

not

Bu ayarları ağ geçidini oluşturduktan sonra istediğiniz zaman değiştirebilirsiniz.

Seçenek 1: Hosted Checkout ağ geçidi oluşturma​

Adım 1: Hosted Checkout oluşturun​

Volet.com panelinize giriş yapın, Ödeme araçları bölümüne gidin ve Hosted Checkout bölümünde Oluştur'a tıklayın.

Adım 2: Ödeme yöntemlerini yapılandırın​

İlk sekmede kabul etmek istediğiniz ödeme yöntemlerini etkinleştirin:

YöntemAçıklama
Volet.com kullanıcılarıMüşteriler Volet.com hesaplarından öder.
Kripto cüzdanlarMüşteriler herhangi bir kripto cüzdandan BTC, ETH, USDT, USDC ve desteklenen diğer token'larla öder.

Her yöntem hakkında daha fazla bilgi:

Her yöntem için Komisyonu kim öder ayarını yapın: işlem komisyonunun alınan tutardan düşülmesini (Üye işyeri öder) veya müşteri için tutarın üzerine eklenmesini (Alıcı öder) seçin.

Adım 3: Ayarları yapılandırın​

Hosted Checkout sayfanızı ve callback URL'lerini yapılandırın.

Ödeme işleme seçenekleri​

  1. Hosted Checkout taleplerinde dijital imza kullan.

    Ödeme taleplerini ve callback bildirimlerini Hosted Checkout şifrenizle imzalar. Bu, taleplerin Volet.com'dan geldiğini ve iletim sırasında değiştirilmediğini doğrulamanıza yardımcı olur.

    Canlı ortamlarda bu seçeneği etkin tutmanızı öneririz.

  2. Eksik ödemeyi kabul et.

    Müşteri istenen tutardan daha az gönderdiğinde siparişlerin tamamlanmasına izin verir.

    Bu seçenek, ağ ücretleri, manuel hesaplamalar veya kur dalgalanmaları nedeniyle ödemenin beklenenden biraz düşük olabildiği kripto ödemelerde faydalı olabilir.

  3. Fazla ödemeyi kabul et.

    Müşteri istenen tutardan fazlasını gönderdiğinde siparişlerin tamamlanmasına izin verir.

    Bu seçenek, müşterilerin yanlışlıkla istenenden yüksek bir tutar gönderdiği durumlarda faydalı olabilir.

Hosted Checkout yapılandırması​

  1. Hosted Checkout adı. Bu Hosted Checkout'u Volet.com hesabınızda tanımlamak için kullanılan ad.

  2. Web sitesi, mobil uygulama, bot veya yapay zekâ ajanı URL'si. Bu ödeme ağ geçidiyle ilişkili herkese açık URL'yi girin. Bu URL ödeme sırasında müşterilere de gösterilir.

Örnekler:

  1. Bildirim e-postası. Bu Hosted Checkout yapılandırmasıyla işlenen işlemlerle ilgili bildirimleri alan isteğe bağlı e-posta adresi.

  2. Hosted Checkout'ta gösterilen e-posta. İleride kullanılmak üzere ayrılmıştır.

  3. Hosted Checkout şifresi. Ödeme taleplerini imzalamak ve callback bildirimlerini doğrulamak için kullanılan gizli anahtar. Gizli tutun ve istemci tarafı kodda açığa çıkarmayın.

Durum URL'lerinin yapılandırılması​

Ardından callback ve yönlendirme URL'lerini yapılandırın. Bu parametreleri boş bırakabilir ve/veya ödeme talebi formunda belirtebilirsiniz.

  1. Success URL. Başarılı bir ödemeden sonra müşterilerin yönlendirildiği URL.

  2. Failed URL. Ödeme başarısız olursa veya iptal edilirse müşterilerin yönlendirildiği URL.

  3. Status URL. Ödeme durumu bildirimlerini alan sunucu uç noktası. Sisteminizdeki sipariş durumlarını otomatik güncellemek için bu bildirimleri kullanın.

Success URL, Failed URL ve Status URL için HTTP yöntemini seçebilirsiniz:

  • GET — parametreler sorgu dizesinde (query string) gönderilir.
  • POST — parametreler istek gövdesinde gönderilir.

Adım 4: Görünümü özelleştirin (isteğe bağlı)​

İsteğe bağlıdır, daha sonra da ayarlanabilir.

Hosted Checkout sayfasını logonuz ve marka renklerinizle özelleştirebilirsiniz.

Adım 5: Onay​

Yeni oluşturulan ağ geçitlerinin gerçek ödemeleri kabul edebilmesi için yönetici onayı gerekir.

Onay genellikle birkaç saat sürer.

Ağ geçidiniz onaylanıp kullanıma hazır olduğunda e-posta bildirimi alırsınız.

not

Ağ geçidiniz onaylanana kadar gerçek ödemeleri işleyemezsiniz. Bu süreyi sitenizdeki entegrasyonu tamamlamak için kullanın.

Adım 6: Hosted Checkout'u entegre edin​

Onaydan sonra Hosted Checkout'u web sitenize, uygulamanıza, botunuza veya yapay zekâ ajanınıza entegre edebilirsiniz.

Bkz.: Hosted Checkout entegrasyonu

Seçenek 2: API ağ geçidi oluşturma​

Adım 1: API ağ geçidi oluşturun​

Volet.com panelinize giriş yapın, Ödeme araçları bölümüne gidin ve API bölümünde Oluştur'a tıklayın.

Adım 2: API ayarlarını yapılandırın​

Temel API ayarlarını yapılandırın.

  1. API adı. API ağ geçidinin dahili adı. Bu ad yalnızca Volet.com hesabınızda kullanılır.

  2. IP beyaz listesi. API'ye erişmesine izin verilen IP adreslerinin listesi.

    Şunları yapabilirsiniz:

    • Bir veya daha fazla IP adresini manuel olarak girin.
    • Mevcut IP adresinizi otomatik eklemek için Mevcut IP'yi ekle'ye tıklayın.
    • IP kısıtlamalarını kaldırmak için Tüm IP'lere izin ver seçeneğini etkinleştirin (canlı ortamlar için önerilmez).

  3. API şifresi. API isteklerinin kimliğini doğrulamak için kullanılan gizli anahtar. Gizli tutun ve istemci tarafı kodda açığa çıkarmayın.

  4. Web sitesi, mobil uygulama, bot veya yapay zekâ ajanı URL'si. Bu API entegrasyonuyla ilişkili herkese açık URL'yi girin.

Örnekler:

  1. Bildirim e-postası. Bu API ağ geçidiyle işlenen işlemlerle ilgili bildirimleri alan isteğe bağlı e-posta adresi.

Adım 3: API izinlerini yapılandırın​

Bu API ağ geçidi için hangi izinlerin kullanılabileceğini seçin.

Ödeme kabul entegrasyonları için şunları etkinleştirin:

  • İşlem yapma
    • Kripto ödemeleri kabul et — uygulamanızın ödeme faturaları oluşturmasına ve kripto cüzdanlardan kripto para ödemelerini kabul etmesine izin verir.
  • İşlem bulma — fatura oluşturulduktan sonra uygulamanızın ödeme durumunu ve işlem ayrıntılarını almasına izin verir.

API entegrasyonları callback URL'leri kullanmaz. Fatura oluşturduktan sonra uygulamanız güncel ödeme durumunu kontrol etmek için İşlem bulma iznini kullanmalıdır.

Bakiye sorgulama, işlem geçmişi, dönüştürme ve toplu ödemeler gibi ek izinler, entegrasyonunuz gerektirirse daha sonra etkinleştirilebilir. Daha fazla bilgi için API referansına bakın.

Adım 4: Onay​

Yeni oluşturulan API ağ geçitlerinin gerçek işlemleri işleyebilmesi için yönetici onayı gerekir.

Onay genellikle birkaç saat sürer.

API ağ geçidiniz onaylanıp kullanıma hazır olduğunda e-posta bildirimi alırsınız.

not

API ağ geçidi onaylanana kadar gerçek işlemleri işleyemezsiniz.

Adım 5: Entegre edin​

Onaydan sonra API üzerinden ödeme kabul etmeye başlayabilirsiniz.

Bkz.:

  • API entegrasyonu — API ödeme ağ geçidi entegrasyonu için adım adım kılavuz.
  • API referansı — yöntemler, parametreler ve yanıtlarla ilgili eksiksiz dokümantasyon.