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 seçebileceğiniz birkaç ödeme hesabı türü bulunmaktadır.

Stripe​

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

Midtrans​

OneEntry Platform, Endonezyalı ödeme sistemi Midtrans ile entegrasyonu desteklemektedir. Midtrans entegrasyonu hakkında daha fazla bilgi burada ele alınmaktadır.

Xendit​

OneEntry Platform, Xendit ödeme sistemi ile entegrasyonu desteklemektedir. Xendit entegrasyonu hakkında daha fazla bilgi burada ele alınmaktadı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 şunları belirtin:

  • İsim - Tekil olmayan bir dize
  • Tür - Açılır listeden bir değer.
  • Anahtar - Benzersiz bir dize.

Formu doldurduktan sonra "Ekle" butonuna tıklayın. Tüm alanlar doğru bir şekilde doldurulursa, ö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 Edit.

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

  • İsim
  • Tür
  • Anahtar

Değişiklikler otomatik olarak kaydedilecektir.

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

Farklı ödeme sistemleri (örneğin, PayPal, Stripe ve diğerleri) ile esnek entegrasyon için ödeme hesabına özel parametreler eklenebilir; 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 sıklıkla 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.

Nasıl Çalışır​

Temel alanların (İsim, Tür, Anahtar) yanı sıra, "Ödeme API'si için Özel Parametreler" tablosunu göreceksiniz. Tablo, Ayarlar modülünden gelen özellik setlerinin bir derlemesidir ve 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, ayar setini düzenlemek üzere Edit 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 aşağıdaki yapıyı içeren JSON türünde items özelliğini eklersiniz:

    {
      "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": "Süper Ferah Tişört",
          "unit_amount": {
            "currency_code": "USD",
            "value": "20.00"
          },
          "quantity": "1",
          "category": "FİZİKSEL_ÜRÜNLER",
          "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": "Ayakkabılar",
          "description": "Koşu, Beden 10.5",
          "sku": "sku02",
          "unit_amount": {
            "currency_code": "USD",
            "value": "100.00"
          },
          "quantity": "2",
          "category": "FİZİKSEL_ÜRÜNLER",
          "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"
          }
        }
      ]
}

Daha sonra ödeme hesabı ayarlarında şunları bağlarsınız:

Anahtar: purchase_units Değer: "PayPal Purchase Unit" setinden 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 — ödemenin iptal edileceği URL

Bu mekanizma, ödeme entegrasyonlarını dış API'lerin özel gereksinimlerine uyacak şekilde platform kodunu değiştirmeden uyarlamayı sağlar.

Ödeme Hesabını Gizleme​

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

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

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 Edit.

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