Ön ödemeli hesap bakiyelerini yönetme

Apigee Edge belgelerini görüntülüyorsunuz.
Apigee X belgelerine gidin.
bilgi

Ön ödemeli hesaptaki bakiyeyi yönetmek için şunları yapabilirsiniz:

Kalan ön ödemeli hesap bakiyesini nasıl hesaplayabilirim?

Aşağıdaki bölümlerde açıklandığı gibi bir geliştirici veya şirketin ön ödemeli hesap bakiyesini görüntülerken yanıttan aşağıdaki değerleri almanız gerekir:

  • amount: Geçerli fatura dönemi için kullanılabilen toplam para miktarı. Bu değer, bu bölümde açıklanan yöntemleri kullanarak ön ödemeli hesabı yeniden yüklediğinizde güncellenir.
  • usage: Geçerli fatura dönemi boyunca kullanılan toplam para miktarı. Bu değer, her uygun para kazanma işlemiyle veya kredi verilerek (pozitif ya da negatif) güncellenir.

usage değerini amount değerinden çıkararak mevcut fatura dönemi için kalan ön ödemeli hesap bakiyesini hesaplayabilirsiniz. Örneğin, amount değeri 335, 50 ve usage değeri 34 ise kalan bakiye şu şekilde hesaplanır:

amount(335.50) - usage(34) = 229.50

API'yi kullanarak ön ödemeli hesap bakiyelerini görüntüleme

Aşağıdaki bölümlerde, API kullanılarak bir geliştirici veya şirketin ön ödemeli hesap bakiyelerinin nasıl görüntüleneceği açıklanmaktadır.

Geliştiricinin ön ödemeli hesap bakiyelerini görüntüleme

Bir geliştiricinin ön ödemeli hesap bakiyelerini görüntülemek için aşağıdaki API'lerden birine GET isteği gönderin. Burada {developer_id}, geliştiricinin e-posta adresidir:

  • /mint/organizations/{org_name}/developers/{developer_id}/developer-balances: Bir geliştiricinin ön ödemeli hesap bakiyesini ve yinelenen kurulum bilgilerini döndürür.
  • /mint/organizations/{org_name}/developers/{developer_id}/prepaid-developer-balances: Mevcut ve toplam bakiye, kullanım, para ekleme ve kullanım vergisi dahil olmak üzere ön ödemeli hesap bakiyesi bilgilerini döndürür.

Sonuçları filtrelemek için aşağıdaki sorgu parametrelerini iletebilirsiniz:

Sorgu Parametresi Açıklama
all Tüm API paketlerinin döndürülüp döndürülmeyeceğini belirten işaret. false olarak ayarlanırsa sayfa başına döndürülen API paketi sayısı size sorgu parametresiyle tanımlanır. Varsayılan olarak false değerine ayarlanır.
size Sayfa başına döndürülen API paketlerinin sayısı. Varsayılan değer 20'dir. all sorgu parametresi true olarak ayarlanırsa bu parametre yoksayılır.
page Dönmek istediğiniz sayfanın numarası (içerik sayfalandırılmışsa). all sorgu parametresi true olarak ayarlanırsa bu parametre yoksayılır.
currencyId Ön ödemeli hesap bakiyelerini görüntülemek istediğiniz para biriminin kimliği.

Örneğin:

$ curl -H "Accept:application/json" -X GET \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developers/{developer_id}/developer-balances" \
-u email:password

Aşağıda, yanıta dair bir örnek verilmiştir:

{
    "developerBalance": [
        {
            "amount": 2005,
            "chargePerUsage": false,
            "id": "your-provider-id",
            "isRecurring": false,
            "supportedCurrency": {
                "description": "United States Dollars",
                "displayName": "United States Dollars",
                "id": "usd",
                "name": "USD",
                "organization": {
                    "address": [
                        {
                            "address1": "10 Almaden Blvd.",
                            "city": "San Jose",
                            "country": "US",
                            "id": "32e808d8-3a3c-4d76-a0ae-17d70a982c61",
                            "isPrimary": true,
                            "state": "CA",
                            "zip": "95113"
                        }
                    ],
                    "approveTrusted": false,
                    "approveUntrusted": false,
                    "billingCycle": "CALENDAR_MONTH",
                    "country": "US",
                    "currency": "USD",
                    "description": "my-org",
                    "groupOrganization": false,
                    "hasBillingAdjustment": false,
                    "hasBroker": false,
                    "hasSelfBilling": false,
                    "hasSeparateInvoiceForProduct": false,
                    "id": "my-org",
                    "issueNettingStmt": false,
                    "name": "my-org",
                    "nettingStmtPerCurrency": false,
                    "selfBillingAsExchOrg": false,
                    "selfBillingForAllDev": false,
                    "separateInvoiceForFees": false,
                    "status": "ACTIVE",
                    "supportedBillingType": "BOTH",
                    "taxModel": "HYBRID",
                    "timezone": "UTC"
                },
                "status": "ACTIVE",
                "virtualCurrency": false
            },
            "usage": 2.1572
        }
    ],
    "totalRecords": 1
}

Bir şirketin ön ödemeli hesap bakiyelerini görüntüleme

Bir şirketin ön ödemeli hesap bakiyelerini görüntülemek için /mint/organizations/{org_name}/companies/{company_id}/developer-balances adresine bir GET isteği gönderin. Burada {company_id}, şirketin kimliğidir. Şirket ön ödemeliyse istek, mevcut ön ödemeli hesap bakiyesini alır. Şirket faturalıysa istek, mevcut kredi limitini alır.

Sonuçları filtrelemek için aşağıdaki sorgu parametrelerini iletebilirsiniz:

Sorgu Parametresi Açıklama
all Tüm API paketlerinin döndürülüp döndürülmeyeceğini belirten işaret. false olarak ayarlanırsa sayfa başına döndürülen API paketi sayısı size sorgu parametresiyle tanımlanır. Varsayılan olarak false değerine ayarlanır.
size Sayfa başına döndürülen API paketlerinin sayısı. Varsayılan değer 20'dir. all sorgu parametresi true olarak ayarlanırsa bu parametre yoksayılır.
page Dönmek istediğiniz sayfanın numarası (içerik sayfalandırılmışsa). all sorgu parametresi true olarak ayarlanırsa bu parametre yoksayılır.
currencyId Ön ödemeli hesap bakiyelerini görüntülemek istediğiniz para biriminin kimliği.

Örneğin:

$ curl -H "Accept:application/json" -X GET \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/companies/{company_id}/developer-balances" \
-u email:password

Yanıt, bir geliştiricinin ön ödemeli hesap bakiyelerini görüntülerken yukarıda gösterilen yanıta benzer.

Ödeme sağlayıcı kullanarak ön ödemeli hesap bakiyelerini yönetme

Worldpay gibi bir üçüncü taraf ödeme sağlayıcıyla satıcı hesabı oluşturarak ön ödemeli hesap bakiyelerini yönetin. Aşağıdaki şekilde, Worldpay ödeme sağlayıcısı kullanılarak ön ödemeli hesap bakiyelerinin nasıl yönetildiği gösterilmektedir.

Worldpay ödeme sağlayıcı akışı

Aşağıdaki tabloda, yukarıda gösterilen ön ödemeli hesap bakiyesi yönetimi akışındaki her adım açıklanmaktadır.

Adım Açıklama
0 Ön koşul adımları
API sağlayıcı olarak Worldpay gibi bir üçüncü taraf ödeme sağlayıcıyı ayarlamak için:
1 Akışı tetiklemek için bir API tüketicisi, geliştirici portalında aşağıdaki görevlerden birini gerçekleştirir:
  • Hesaba para ekler.
  • Yetersiz bakiye içeren bir ücret planını kabul etme
2 Geliştirici portalı, Edge üzerinden geliştirici için ödeme başlatır. Bu ödemede sağlayıcı kimliği, yeniden yükleme tutarı ve para birimi bilgileri yer alır. Ödeme başlatmak için API'yi kullanma hakkında bilgi edinmek üzere Ödeme sağlayıcı kullanarak ön ödemeli hesaba ödeme başlatma başlıklı makaleyi inceleyin.
3 Edge, kimliğe göre sağlayıcıyı bulur ve bunun bir Worldpay hesabı olduğunu belirler.
4 Edge, bir sipariş kodu oluşturur.
5 Edge, Worldpay'de ödeme emri oluşturur.
6 Worldpay, sipariş için bir referans kimliği ve siparişi karşılamak üzere sınırlı süreli bir URL döndürür.
7 Worldpay'in yanıtı, genel bir Edge /payment API yanıtına dönüştürülür. Bu yanıt, 2. adımda başlatılan çağrıyı tamamlamak için geliştirici portalına geri döndürülür. Örneğin:
{
    "isRecurring": "false",
    "orderCode": "1234",
    "referenceId": "3042815493",
    "referenceUrl": "https://secure.worldpay.com/wcc/dispatcher?OrderKey=MERCH_CODE_FROM_PROVIDER%5E1234",
    "success": "true"
}
8 Geliştirici portalı, geri çağırma URL'lerini (başarı, hata vb. için) URL'ye sorgu parametreleri olarak ekler.
9 Geliştirici portalı, API tüketicisinin tarayıcısını değiştirilmiş URL'ye yönlendirerek 1. adımdaki isteğe yanıt verir.
10 API tüketicisi, başvuru formunu doldurur ve Worldpay ile işlem başlatır.
11 Worldpay, fatura bilgilerini alır ve ödemeyi işler. İşlem başarılı olduğunda Worldpay, hem Worldpay hem de geliştirici portalında yapılandırılan MAC gizli anahtarını kullanarak bir Mesaj Doğrulama Kodu (MAC) oluşturur.
12 Worldpay, API tüketicisinin tarayıcısını başarılı geri çağırma URL'sine (8. adımdan) yönlendirir ve MAC'yi sorgu parametresi olarak, tutarı da ekler.
13 Tarayıcı, geliştirici portalında istenen tutar ve MAC ile URL'yi çağırır.
14 Portal, MAC adresini MAC gizli anahtarıyla karşılaştırarak doğrular. MAC, başarılı ödemelerin yapıldığını keyfi olarak iddia etmeyi önler.
15 Geliştirici portalı, ön ödemeli hesap bakiyesinin yeniden yüklenmesi için Edge'e istek gönderir. Hesap bakiyesini yeniden yüklemek için API'yi kullanma hakkında bilgi edinmek istiyorsanız API'yi kullanarak ön ödemeli hesap bakiyesini yeniden yükleme başlıklı makaleyi inceleyin.

Aşağıdaki bölümlerde, üçüncü taraf ödeme sağlayıcı kullanarak ön ödemeli bakiyeleri yönetmek için gereken adımlar açıklanmaktadır:

Worldpay ödeme sağlayıcısı ile satıcı hesabı oluşturma

Başlamadan önce satıcı hesaplarınızı oluşturmak için üçüncü taraf ödeme sağlayıcı (Worldpay) ile iletişime geçmeniz gerekir. Biri test, diğeri üretim için olmak üzere iki hesap oluşturmanız önerilir. Worldpay satıcı hesapları hakkında daha fazla bilgi için www.worldpay.com ve wp-support.crm.worldpay.com (Worldpay destek merkezi) adreslerini ziyaret edin.

Satıcı hesabınızı oluşturup hesap kimlik bilgilerinizi aldıktan sonra satıcı hesabınızı Worldpay ile yapılandırmak için:

  1. https://secure.worldpay.com/sso/public/auth/login.html adresine gidin.
  2. Worldpay tarafından size sağlanan kimlik bilgilerini kullanarak Worldpay hesabınıza giriş yapın.
  3. XML şifresini ve mesaj doğrulama kodu (MAC) gizli anahtarını ayarlayın:
    1. Profil'i tıklayın.
    2. Edge'de Worldpay ödeme sağlayıcısını yapılandırırken kullanılacak şifreyi XML Password (XML Şifresi) alanına girin.
    3. Yönlendirme MAC gizli anahtarı alanına 20-30 karakterlik bir MAC gizli anahtarı girin.
    4. Profili Kaydet'i tıklayın.
  4. Apigee Edge yönetim sunucusunu satıcı IP'leri listesine (izin verilenler listesi) ekleyin:
    1. Profil > Satıcı Ortamı'nı tıklayın.
    2. Yeni Test IP'si'ni tıklayın.
    3. Apigee Edge yönetim sunucusunun IP'sini girin.
    4. Kaydet'i tıklayın.
  5. Yöntem kimlik doğrulama kodu (MAC) dahil olmak üzere Worldpay parametrelerini eklemek için satıcı URL'sini yapılandırın:
    1. Yüklemeler > Barındırılan Ödeme Sayfaları > Ödeme Sayfası Tasarımcısı'nı tıklayın.
    2. Ödeme Sayfalarını Düzenle bölümünde, Kanal seçin açılır listesinden yükleme kimliğinizi seçin.
    3. Özellikler sekmesinde Satıcı yapılandırmasını düzenle'yi seçin.
    4. URL parametrelerini gönder değerini Doğru olarak ayarlayın.
    5. Yayınla sekmesini tıklayın.
    6. Değişiklikleri aşağıdaki şekilde tanıtın:
      • Test ortamları için Tasarım'dan Korumalı Alan'a yükseltmek üzere Tasarım bölümünde Yükselt'i tıklayın.
      • Üretim ortamları için Sandbox'tan üretime yükseltmek üzere Sandbox bölümünde Yükselt'i tıklayın.

Edge'de ödeme sağlayıcıyı yapılandırma

Bir sonraki adım, ödeme sağlayıcıyı Edge'de yapılandırmaktır.

Aşağıdaki API'yi kullanarak ödeme sağlayıcınızı belirli bir kuruluş için yapılandırabilirsiniz:

/organizations/{org-name}/providers

Yalnızca sistem yöneticisi ayrıcalıklarına sahip Apigee Edge Private Cloud müşterileri, aşağıdaki API'yi kullanarak isteğe bağlı olarak bir küresel ödeme sağlayıcı yapılandırabilir:

/config/providers

Her API'yi çağırırken istek gövdesinde aşağıdaki bilgileri belirtmeniz gerekir:

Parametre Açıklama Zorunlu
authType Ödeme sağlayıcı tarafından sağlanan yükleme kimliği. Evet
credential Worldpay satıcı hesabınız için Base64 kodlu kimlik bilgileri (username:XMLpassword); username, satıcı koduna (tümü büyük harflerle) eşdeğerdir ve XMLpassword, Worldpay satıcı hesabınızı ayarlarken önceki adımda belirlediğiniz XML şifresini belirtir. Evet
description Ödeme sağlayıcının açıklaması. Hayır
endpoint Ödeme sağlayıcıya erişmek için kullanılan uç nokta
  • Test hesapları için şunları kullanın: https://secure-test.worldpay.com/jsp/merchant/xml/paymentService.jsp
  • Üretim hesapları için şunu kullanın: https://secure.worldpay.com/jsp/merchant/xml/paymentService.jsp
Evet
merchantCode Ödeme sağlayıcı tarafından API tüketicisine sağlanan satıcı kodu Evet
name Sağlayıcı için kullanılacak ad.

Yalnızca Apigee Edge Private Cloud müşterileri: Küresel ödeme sağlayıcılar için adın tüm Edge kuruluşlarında benzersiz olduğundan emin olun. Kolayca tanımlanabilmesi için sağlayıcı adına WorldPay'i (büyük/küçük harfe duyarlı değil) eklemeniz önerilir. Örneğin: WorldPay test veya WorldPay prod. Sağlayıcı adlarındaki boşluklar alt çizgiye dönüştürülür.

Evet

Örneğin, aşağıdakiler Worldpay-myorg adlı Worldpay ile bir satıcı hesabı oluşturur:

$ curl  -H "Content-Type:application/json" -X POST -d \
'{
    "name": "Worldpay-myorg",
    "description": "Worldpay payment provider",
    "endpoint": "https://secure.worldpay.com/jsp/merchant/xml/paymentService.jsp",
    "authType": "123456",
    "credential": "dXNlcm5hbWU6cGFzc3dvcmQ=",
    "merchantCode": "myMerchantCode"
  }' \
"https://api.enterprise.apigee.com/v1/organizations/myOrg/providers" \
-u email:password 

Üçüncü taraf ödeme sağlayıcıları görüntüleme

Aşağıdaki kaynağa GET isteği göndererek Edge kuruluşunuz için yapılandırılmış üçüncü taraf ödeme sağlayıcılarını görüntüleyin ve onaylayın:

/mint/organizations/{org-name}/providers

Örneğin, aşağıda şu anda myorg için yapılandırılmış üçüncü taraf ödeme sağlayıcıları gösterilmektedir:

$ curl  -X GET \
"https://api.enterprise.apigee.com/v1/mint/organizations/myorg/providers" \
-u email:password

Aşağıda, biri test, diğeri üretim için olmak üzere iki satıcı hesabını gösteren yanıt örneği verilmiştir.

{
  "provider" : [ {
    "authType" : "123456",
    "credential" : "dXNlcm5hbWU6cGFzc3dvcmQ=",
    "description" : "Worldpay payment provider",
    "endpoint" : "https://secure.worldpay.com/jsp/merchant/xml/paymentService.jsp",
    "id" : "worldpay-myorg",
    "merchantCode" : "MERCH_CODE",
    "name" : "Worldpay-myorg"
  }, {
    "authType" : "123456",
    "credential" : "dXNlcm5hbWU6cGFzc3dvcmQ=",
    "description" : "Worldpay payment provider",
    "endpoint" : "https://secure-test.worldpay.com/jsp/merchant/xml/paymentService.jsp",
    "id" : "worldpay-test",
    "merchantCode" : "MERCH_CODE_FROM_PROVIDER",
    "name" : "Worldpay-test"
  } ]
}

Geliştirici portalında para kazanma ve Worldpay modüllerini etkinleştirme ve yapılandırma

Geliştirici portalında gerekli para kazanma ve Worldpay modüllerini etkinleştirin. Ayrıntılar için Geliştirici Portalında Para Kazanma Ayarlarını Yapılandırma başlıklı makaleyi inceleyin.

Ödeme sağlayıcıyı kullanarak ön ödemeli bir hesaba ödeme başlatma

Ön ödemeli hesap yönetimi akışının 2. adımında gösterildiği gibi, bir ödeme sağlayıcı kullanarak ön ödemeli hesaba ödeme, API tüketicileri tarafından geliştirici portalı başlatıldığında yapılır:

  • Bir fiyat planını kabul eder ancak ön ödemeli hesabında yeterli bakiye bulunmaz.
  • Ön ödemeli hesaplarına para ekleme isteği

API'yi kullanarak üçüncü taraf ödeme sağlayıcıdan ödeme başlatmak için aşağıdaki kaynağa bir POST isteği gönderin. Burada {developer_id}, geliştiricinin e-posta adresidir.

/mint/organizations/{org_name}/developers/{developer_id}/payment?amount={amount}&provider={providerId}&supportedCurrencyId={currency}

İsteği gönderirken aşağıdaki değerleri sorgu parametreleri olarak belirtmeniz gerekir:

  • Ön ödemeli hesap bakiyesine eklenecek tutar (amount={amount})
  • Ödeme sağlayıcı kimliği (provider={providerId})
  • Desteklenen para birimi (supportedCurrencyId={currency})

Ayrıca, şirket fatura adresi gibi temel hesap ayrıntılarını da iletmeniz gerekir.

Örneğin, aşağıda Worldpay ödeme sağlayıcısı kullanılarak ön ödemeli hesap bakiyesine yeniden yükleme yapılması gösterilmektedir. Ön ödemeli hesabınıza yapılacak ilk transfer 10 ABD doları (amount sorgu parametresi 10 olarak ayarlanır) olacaktır.

$ curl  -H "Content-Type:application/xml" -X POST -d \
'{
    "address1": "5115 Hopyard Ave.",
    "city": "Pleasanton",
    "country": "US",
    "state": "CA",
    "zip": "58158"
}'
' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developers/{developer_id}/payment?amount=10&provider=worldpay-myorg&supportedCurrencyId=usd" \
-u email:password

Aşağıda, yanıta dair bir örnek verilmiştir:

{
    "isRecurring": "false",
    "orderCode": "1234",
    "referenceId": "3042815493",
    "referenceUrl": "https://secure.worldpay.com/wcc/dispatcher?OrderKey=MERCH_CODE_FROM_PROVIDER%5E1234",
    "success": "true"
}

Worldpay Secure Payment sayfasının URL'si, referenceUrl içinde döndürülür. Bu URL'ye, sorgu parametresi olarak benzersiz sipariş anahtarınız eklenir.

API'yi kullanarak ön ödemeli hesap bakiyesini yeniden yükleme

Ön ödemeli hesap yönetimi akışının 15. adımında gösterildiği gibi, ödeme sağlayıcı tarafından başarılı bir şekilde işlendiği doğrulandıktan sonra geliştirici portalı, ön ödemeli hesabın yeniden yüklenmesi için Edge'e bir istek gönderir.

Aşağıdaki bölümlerde açıklandığı gibi, bir geliştirici veya şirket için API'yi kullanarak ön ödemeli hesap bakiyesini yeniden yükleyebilirsiniz.

Geliştiriciler için ön ödemeli hesap bakiyesine yeniden yükleme yapma

API'yi kullanarak bir geliştiricinin ön ödemeli hesap bakiyesini yeniden yüklemek için /mint/organizations/{org_name}/developers/{developer_id}/developer-balances adresine bir POST isteği gönderin. Burada {developer_id}, geliştiricinin e-posta adresidir. İsteği gönderirken istek gövdesinde bakiyeye eklenecek tutarı ve kullanılan para birimini belirtmeniz gerekir.

Örneğin, aşağıdaki istek bir geliştiricinin ön ödemeli hesap bakiyesine 1.000 TL ekler:

$ curl -H "Content-Type:application/json" -X POST -d \
'{
  "amount": 1000,
  "supportedCurrency": {
      "id": "usd" 
  } 
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developers/{developer_id}/developer-balances" \
-u email:password

İstek özelliklerinin açıklaması için Ön ödemeli hesabı yeniden yükleme isteği özelliklerinin özeti başlıklı makaleyi inceleyin.

Bir şirket için ön ödemeli hesap bakiyesine yeniden yükleme yapma

API'yi kullanarak bir şirketin ön ödemeli hesap bakiyesini yeniden yüklemek için /mint/organizations/{org_name}/companies/{company_id}/developer-balances adresine bir POST isteği gönderin. Burada {company_id}, şirketin kimliğidir. İsteği gönderirken istek gövdesinde bakiyeye eklenecek tutarı ve kullanılan para birimini belirtmeniz gerekir.

Örneğin, aşağıdaki istek bir şirketin ön ödemeli hesap bakiyesine 1.000 ABD doları ekler:

$ curl -H "Content-Type:application/json" -X POST -d \
'{
  "amount": 1000,
  "supportedCurrency": {
      "id": "usd" 
  } 
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/companies/{company_id}/developer-balances" \
-u email:password

İstek özelliklerinin açıklaması için Ön ödemeli hesabı yeniden yükleme isteği özelliklerinin özeti başlıklı makaleyi inceleyin.

Ön ödemeli hesabı yeniden yükleme isteği özelliklerinin özeti

API kullanılarak ön ödemeli hesap bakiyeleri yeniden yüklenirken aşağıdaki özellikler belirtilmelidir:

Ad Açıklama Varsayılan Zorunlu mu?
amount

Ön ödeme bakiyesine uygulanan tutar (geçerli para biriminde).

Yok Evet
supportedCurrency

Ön ödeme bakiyesi için kullanılan para birimi. Bu, geliştiricinin satın aldığı API paketindeki plan için ayarlanan para birimidir.

Yok Evet

Üçüncü taraf ödeme sağlayıcılarını silme

Aşağıdaki kaynağa bir DELETE isteği göndererek Edge kuruluşunuz için yapılandırılmış bir üçüncü taraf ödeme sağlayıcıyı silebilirsiniz:

Belirli bir kuruluş için ödeme sağlayıcıyı silmek üzere aşağıdaki API'yi kullanın:

/mint/organizations/{org-name}/providers/id

Yalnızca sistem yöneticisi ayrıcalıklarına sahip Apigee Edge Private Cloud müşterileri, aşağıdaki API'yi kullanarak isteğe bağlı olarak küresel ödeme sağlayıcıyı silebilir:

/config/providers/id

Örneğin, aşağıdaki komut, şu anda myorg için yapılandırılmış üçüncü taraf ödeme sağlayıcılarını siler:

$ curl  -X DELETE \
"https://api.enterprise.apigee.com/v1/mint/organizations/myorg/providers/worldpay-myorg" \
-u email:password

Ön ödemeli hesap bakiyelerini manuel olarak yönetme

Alternatif olarak, ödemeleri manuel olarak veya entegre bir faturalandırma sistemi aracılığıyla takip ederek ön ödemeli bakiyelerin yeniden yüklenmesini yönetebilir ve ardından hesabı yeniden yüklemek için para kazanma API'sini çağırabilirsiniz. Bu işlem, API kullanarak ön ödemeli hesap bakiyesini yeniden yükleme başlıklı makalede açıklanmıştır.

API'yi kullanarak ön ödemeli hesap bakiyelerinin otomatik olarak yeniden yüklenmesini ayarlama

Aşağıdaki bölümlerde, üçüncü taraf ödeme sağlayıcı kullanan bir geliştirici veya şirket için ön ödemeli hesap bakiyelerinin otomatik olarak yeniden yüklenmesinin nasıl ayarlanacağı açıklanmaktadır. Bu seçenek, fiyat planları için yinelenen ödemeleri yönetmek açısından kullanışlıdır.

Geliştiriciler için ön ödemeli hesap bakiyelerinin otomatik olarak yeniden yüklenmesini ayarlama

Bakiyenin belirli bir eşiğin altına düşmesi durumunda geliştiricinin ön ödemeli hesap bakiyesine otomatik olarak para yüklenmesini ayarlamak için /mint/organizations/{org_name}/developers/{developer_id}/developer-balances/recurring-setup adresine bir POST isteği gönderin. {developer_id}, geliştiricinin e-posta adresidir.

İsteği gönderirken aşağıdakileri belirtmeniz gerekir:

  • Hesaba yeniden yükleme yapmak için kullanılacak ödeme sağlayıcının kimliği (providerID)
  • Otomatik yeniden yüklemeyi etkinleştiren işaret (isRecurring)
  • Otomatik para yüklemeyi tetiklemek için ön ödemeli hesap bakiyesinin düşmesi gereken eşik (replenishAmount)
  • Hesaba otomatik olarak eklenecek tutar (recurringAmount)
  • Para birimini belirtmek için supportedCurrencyID sorgu parametresi.

Aşağıdaki örnekte, geliştiricinin ön ödemeli hesap bakiyesi 5 ABD dolarının altına düştüğünde hesaba otomatik olarak 10 ABD doları daha eklenir.

$ curl -H "Content-Type:application/json" -X POST -d \
'{
    "providerId": "worldpay-myorg",
    "isRecurring" : true,
    "replenishAmount" : 5,
    "recurringAmount" : 10
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developers/{developer_id}/developer-balances/recurring-setup?supportedCurrencyId=usd" \
-u email:password

İstek özelliklerinin açıklaması için Ön ödemeli hesapların otomatik olarak yeniden yüklenmesini ayarlamaya yönelik istek özelliklerinin özeti başlıklı makaleyi inceleyin.

Şirketler için ön ödemeli hesap bakiyelerinin otomatik olarak yeniden yüklenmesini ayarlama

Bir şirketin ön ödemeli hesap bakiyesi belirli bir tutarın altına düştüğünde otomatik olarak yeniden yüklenmesini ayarlamak için /mint/organizations/{org_name}/companies/{company_id}/developer-balances/recurring-setup adresine bir POST isteği gönderin. {company_id}, şirketin kimliğidir.

İsteği gönderirken aşağıdakileri belirtmeniz gerekir:

  • Hesaba yeniden yükleme yapmak için kullanılacak ödeme sağlayıcının kimliği (providerID)
  • Otomatik para yüklemeyi etkinleştiren işaret (isRecurring)
  • Otomatik para yüklemeyi tetiklemek için ön ödemeli hesap bakiyesinin düşmesi gereken eşik (replenishAmount)
  • Hesaba otomatik olarak eklenecek tutar (recurringAmount)
  • Para birimini belirtmek için supportedCurrencyID sorgu parametresi.

Aşağıdaki örnekte, şirketin ön ödemeli hesap bakiyesi 5 ABD dolarının altına düştüğünde hesaba otomatik olarak 10 ABD doları daha eklenir.

$ curl -H "Content-Type:application/json" -X POST -d \
'{
    "providerId": "worldpay-myorg",
    "isRecurring" : true,
    "replenishAmount" : 5,
    "recurringAmount" : 10
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/companies/{company_id}/developer-balances/recurring-setup?supportedCurrencyId=usd" \
-u email:password

İstek özelliklerinin açıklaması için Ön ödemeli hesapların otomatik olarak yeniden yüklenmesini ayarlamaya yönelik istek özelliklerinin özeti başlıklı makaleyi inceleyin.

Ön ödemeli hesaplara otomatik yeniden yükleme ayarlama ile ilgili istek özelliklerinin özeti

API kullanılarak ön ödemeli hesap bakiyeleri otomatik olarak yeniden yüklenirken aşağıdaki özellikler belirtilebilir.

Ad Açıklama Varsayılan Zorunlu mu?
providerId

Ödeme sağlayıcının kimliği.

Yok Evet
chargePerUsage yanlış Hayır
isRecurring

Otomatik yeniden yüklemenin etkin olup olmadığını belirten işaret (true). Otomatik yeniden yüklemeyi devre dışı bırakmak için bu işareti false olarak ayarlayın.

Yok Evet
replenishAmount

Otomatik para yüklemeyi tetiklemek için ön ödemeli hesap bakiyesinin düşmesi gereken eşik.

Yok Evet
recurringAmount

Otomatik yeniden yükleme tetiklendiğinde ön ödemeli hesap bakiyesine eklenecek tutar.

Yok Evet

WorldPay'in barındırılan ödeme sayfalarına geçiş

WorldPay, güvenli ödeme işleme akışını, Hosted Payment Pages olarak adlandırılan yeni bir sayfa grubu kullanacak şekilde güncelledi.

WorldPay ödeme sağlayıcılarınızı, kullanımdan kaldırılan güvenli ödeme işleme akışını (Ağustos 2017'den önce) kullanarak yapılandırdıysanız Ocak 2018'den önce WorldPay'in yeni barındırılan ödeme sayfalarına geçmeniz gerekir.

WorldPay'in barındırılan ödeme sayfalarına geçmek için:

  1. Mevcut hesabınızı yeni barındırılan ödeme sayfalarını kullanacak şekilde taşımak ve hesabınız için yeni bir yükleme kimliği almak üzere WorldPay ile iletişime geçin.
  2. Ödeme sağlayıcıyı Edge'de yapılandırma bölümünde açıklandığı gibi yeni WorldPay ödeme sağlayıcılarını yapılandırın ve yükleme kimliğini authType alanına iletin.
  3. Geliştirici Portalında Para Kazanmayı Yapılandırma bölümünde açıklandığı gibi, geliştirici portalınızda yeni ödeme sağlayıcılarını yapılandırın.
  4. Ödeme sağlayıcıyı kullanarak ön ödemeli bir hesabın otomatik olarak yeniden yüklenmesini ayarladıysanız API'yi kullanarak ön ödemeli hesap bakiyelerinin otomatik olarak yeniden yüklenmesini ayarlama bölümünde açıklandığı gibi, yeni sağlayıcı kimliğini kullanmak için otomatik yeniden yüklemeyi yeniden yapılandırmanız gerekir.

Sonraki adımlar

Bireysel sonradan ödemeli geliştiriciler için kredi limitleri belirleyebilirsiniz. Nasıl yapılacağını Faturalı bakiye yönetimi başlıklı makaleden öğrenebilirsiniz.