Ana içeriğe geç

Hesaplar

Ödeme hesabı, sipariş alırken ödeme alma yöntemidir. Farklı ödeme türleri için birden fazla hesap oluşturabilirsiniz, örneğin bir ödeme sistemi entegre edebilir veya nakit ödeme ekleyebilirsiniz.

Hesaplarla ilgili araçlar "Ödemeler" bölümündeki "Hesaplar" alt bölümünde bulunmaktadır. Zaten oluşturulmuş ödeme hesapları genel listede yer almaktadır. Aşağıda yeni ödeme hesapları oluşturmak için bir form bulunmaktadır.

Ödeme Hesabı Türleri​

Şu anda sistemde birkaç farklı ödeme hesabı türü mevcuttur.

Stripe​

OneEntry Platform, Stripe ödeme sistemi ile entegrasyonu desteklemektedir. Bu türü seçin, eğer projenize Stripe ödeme sistemini entegre etmek istiyorsanız. Stripe'ın OneEntry Platform'a entegrasyonu hakkında daha fazla bilgi burada (yeni sekmede açılır) bulunmaktadır.

Midtrans​

OneEntry Platform, Endonezyalı ödeme sistemi Midtrans ile entegrasyonu desteklemektedir. Midtrans'ın entegrasyonu hakkında daha fazla bilgi burada (yeni sekmede açılır) bulunmaktadır.

Xendit​

OneEntry Platform, Xendit ödeme sistemi ile entegrasyonu desteklemektedir. Xendit'ın entegrasyonu hakkında daha fazla bilgi burada (yeni sekmede açılır) bulunmaktadır.

Özel​

Eğer başka bir ödeme sistemi kullanmak veya nakit ödeme almak istiyorsanız, bu tür ödeme hesaplarını kullanın.

Ödeme Hesabı Oluşturma​

Ödeme hesabı oluşturma formunda belirtmeniz gerekenler:

  • İsim - Tekil olmayan bir dize
  • Tür - Aşağı açılır listeden bir değer. Stripe, Midtrans ve Xendit türündeki hesaplar projeye yalnızca bir kez oluşturulabilir; Özel türdeki hesapların sayısı sınırsızdır.
  • Anahtar - Benzersiz bir dize.

Formu doldurduktan sonra "Ekle" butonuna tıklayın. Tüm alanlar doğru bir şekilde doldurulmuşsa, ödeme hesabı oluşturulacak ve genel listeye eklenecektir.

Ödeme Hesabını Değiştirme​

Değiştirmek istediğiniz ödeme hesabını listeden seçin ve değişiklik simgesine tıklayın Düzenle.

Düzenleme modunda şunları değiştirebilirsiniz:

  • İsim
  • Tür
  • Anahtar

Stripe, Midtrans ve Xendit hesaplarının düzenleme modunda ayrıca ödeme sistemine bağlantı ayarları da bulunmaktadır. Bu ayarlar Stripe (yeni sekmede açılır), Midtrans (yeni sekmede açılır) ve Xendit (yeni sekmede açılır) sayfalarında açıklanmaktadır.

Düzenleme ekranında ayrıca hesap sürüm geçmişi tablosu bulunmaktadır (sütunlar Version, Değişikliği yapan, Tarih, Kaydedilen veri ve sürüm satırındaki Veriyi Geri Yükle simgesi; henüz kaydedilmiş bir veri yoksa, tablo yerine "Veri mevcut değil" yazısı görünmektedir): buradan önceki kayıtları görebilir ve gerekli olanı geri yükleyebilirsiniz. Daha fazla bilgi için Sürüm Geçmişi bölümüne bakın.

Değişiklikler otomatik olarak kaydedilecektir.

Ödeme API'si için Özel Parametreler​

Farklı ödeme sistemleriyle (örneğin, PayPal, Stripe ve diğerleri) esnek entegrasyon için ödeme hesabına özel parametreler ekleyebilirsiniz; bu parametreler belirli bir API'ye özgüdür.

Bu parametreler, ödeme oturumu başlatıldığında "anahtar-değer" çiftleri şeklinde iletilir. Örneğin, PayPal Orders API'sinde genellikle purchase_units, intent, application_context.return_url veya payer.email_address gibi alanlar gereklidir, oysa Stripe farklı parametreler kullanır, örneğin mode, line_items vb.

Bu Nasıl Çalışır​

Temel alanların (İsim, Tür, Anahtar) yanı sıra, Stripe, Midtrans ve Xendit türündeki hesaplarda "Ödeme API'si için Özel Parametreler" tablosunu göreceksiniz. Özel türdeki hesaplarda bu tablo yoktur. Tabloda Ayarlar → Özellikler bölümünden gelen özellik setleri görüntülenir. Tablo, aşağıdakiler arasında bir eşleşme belirlemenizi sağlar:

  • Anahtar (API'deki parametre adı) (örneğin, PayPal için purchase_units veya Stripe için line_items)
  • Değer, ödeme oluşturulurken yerleştirilecek olan

Değeri ayarlamak için, seti düzenlemek üzere Ayarlar butonuna tıklamanız gerekir. Ardından, önceden ayarlanmış setten gerekli özelliği seçin ve özellik türüne uygun olarak gerekli değeri girin.

⚠️ Önemli: Özellik setleri ve içerikleri ayrı ayrı ayarlanır ve farklı türde alanlar içerebilir: dize, sayı, boolean, JSON vb.

PayPal ile kullanım örneği Diyelim ki, PayPal'a sipariş detaylarını purchase_units alanı aracılığıyla iletmek istiyorsunuz. "PayPal Purchase Unit" adında bir özellik seti oluşturursunuz, içine JSON türünde items özelliğini ekleyerek aşağıdaki yapıyı içeren bir dizi oluşturursunuz:

    {
      "invoice_id": "90210",
      "amount": {
        "currency_code": "USD",
        "value": "230.00",
        "breakdown": {
          "item_total": {
            "currency_code": "USD",
            "value": "220.00"
          },
          "shipping": {
            "currency_code": "USD",
            "value": "10.00"
          }
        }
      },
      "items": [
        {
          "name": "T-Shirt",
          "description": "Super Fresh Shirt",
          "unit_amount": {
            "currency_code": "USD",
            "value": "20.00"
          },
          "quantity": "1",
          "category": "PHYSICAL_GOODS",
          "sku": "sku01",
          "image_url": "https://example.com/static/images/items/1/tshirt_green.jpg",
          "url": "https://example.com/url-to-the-item-being-purchased-1",
          "upc": {
            "type": "UPC-A",
            "code": "123456789012"
          }
        },
        {
          "name": "Shoes",
          "description": "Running, Size 10.5",
          "sku": "sku02",
          "unit_amount": {
            "currency_code": "USD",
            "value": "100.00"
          },
          "quantity": "2",
          "category": "PHYSICAL_GOODS",
          "image_url": "https://example.com/static/images/items/1/shoes_running.jpg",
          "url": "https://example.com/url-to-the-item-being-purchased-2",
          "upc": {
            "type": "UPC-A",
            "code": "987654321012"
          }
        }
      ]
}

Ardından, ödeme hesabı ayarlarında şunları bağlarsınız:

Anahtar: purchase_units Değer: "PayPal Purchase Unit" setindeki items özelliği Sipariş oluşturulduğunda, sistem bu özelliğin güncel değerini PayPal API'sine yapılan isteğin gövdesine otomatik olarak yerleştirecektir.

Diğer sık kullanılan PayPal parametreleri:

intent — örneğin, "CAPTURE" veya "AUTHORIZE" application_context.return_url — başarılı bir ödeme sonrası geri dönüş URL'si application_context.cancel_url — ödeme iptali URL'si

Bu mekanizma, ödeme entegrasyonlarını dış API'lerin gereksinimlerine uyacak şekilde uyarlamayı sağlar.

Ödeme Hesabı Verilerini Dışa Aktarma​

Hesap satırında, gizleme, değiştirme ve silmenin yanı sıra, veri dışa aktarma butonu bulunmaktadır (bu sürümdeki ipucu "Ayarlar" olarak görünmektedir). Bu, dışa aktarma penceresini açar: dosya formatını seçin — csv veya xml — ve dışa aktarmayı onaylayın, dosya tarayıcıya indirilecektir. Dışa aktarma yetkisi olan bir yönetici için bu buton mevcuttur.

Ödeme Hesabını Gizleme​

Eğer ödeme hesabını artık kullanmak istemiyorsanız ve onu silemiyorsanız çünkü proje içinde kullanılıyorsa, gizleyebilirsiniz.

Bunun için, seçilen hesapta "göz" simgesine tıklayın Gizle.

Gizli ödeme hesapları, sipariş deposu ayarları sırasında sistem tarafından seçim için önerilmeyecektir.

Ödeme Hesabını Silme​

Silmek istediğiniz ödeme hesabını listeden seçin ve silme simgesine tıklayın Sil.

Eylemi onaylayın. Daha sonra ödeme hesabı silinecek ve genel listeden kaybolacaktır.