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 iki tür ödeme hesabı seçeneği 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.

Ö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 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 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 başka parametreler kullanır, örneğin mode, line_items vb.

Bu 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 gerekli değeri girin.

⚠️ Önemli: Özellik setleri ve içerikleri ayrı olarak yapılandırılır ve farklı türde alanlar içerebilir: dize, sayı, boolean değeri, 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 değer girersiniz:

    {
      "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" 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 — ödeme iptali URL'si

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 artık bir ödeme hesabını 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 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. Ardından, ödeme hesabı silinecek ve genel listeden kaybolacaktır.