Ön ödemeli hesap bakiyelerini yönetme

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

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

Ön ödemeli hesapta kalan bakiyeyi nasıl hesaplayabilirim?

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

  • amount: Geçerli fatura dönemi için kullanılabilen toplam para tutarı. 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öneminde kullanılan toplam para tutarı. Bu değer, para kazanılan her uygun işlemle veya kredi verilerek (pozitif veya negatif) güncellenir.

Mevcut faturalandırma dönemi için kalan ön ödemeli hesap bakiyesini hesaplamak isterseniz usage değerini amount değerinden çıkarabilirsiniz. Örneğin, amount değeri 335, 50 ve usage değeri 34 ise kalan bakiye aşağıdaki gibi 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'yi kullanarak bir geliştiricinin 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: 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 parametresi tarafından belirlenir. Varsayılan olarak false (yanlış) değerine ayarlanır.
size Sayfa başına döndürülen API paketi sayısı. Varsayılan değer 20'dir. all sorgu parametresi true değerine ayarlanmışsa bu parametre yoksayılır.
page Döndürmek istediğiniz sayfanın numarası (içerik sayfalara ayrı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ıtın bir örneği 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 GET isteği gönderin. Bu adreste {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 parametresi tarafından belirlenir. Varsayılan olarak false (yanlış) değerine ayarlanır.
size Sayfa başına döndürülen API paketi sayısı. Varsayılan değer 20'dir. all sorgu parametresi true değerine ayarlanmışsa bu parametre yoksayılır.
page Döndürmek istediğiniz sayfanın numarası (içerik sayfalara ayrı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, ön ödemeli hesap bakiyesinin Worldpay ödeme sağlayıcısı kullanılarak 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çıklanmıştır.

Step Açıklama
0 Ön koşul adımlar
API sağlayıcısı olarak Worldpay gibi bir üçüncü taraf ödeme sağlayıcısı oluşturmak için:
1 API tüketicisi, akışı tetiklemek için geliştirici portalında aşağıdaki görevlerden birini gerçekleştirir:
  • Hesaba para eklendiğinde
  • Yetersiz bakiyeyle ücret planı kabul etme
2 Geliştirici portalı, sağlayıcı kimliği, yeniden yükleme tutarı ve para birimi ile geliştirici için Edge üzerinden ödemeyi başlatır. Ödeme başlatmak için API'yi kullanma hakkında bilgi edinmek isterseniz Ödeme sağlayıcı kullanarak ön ödemeli bir hesaba ödeme başlatma bölümüne bakın.
3 Edge, sağlayıcıyı kimliğe göre bulur ve bunun bir Worldpay hesabı olduğunu belirler.
4 Edge bir sipariş kodu oluşturur.
5 Edge, Worldpay'de ödeme emrini oluşturur.
6 Worldpay, sipariş için bir referans kimliği ve siparişi karşılamak için sınırlı bir URL döndürür.
7 Worldpay'in yanıtı, 2. adımda başlatılan çağrıyı tamamlamak için geliştirici portalına döndürülen genel bir Edge /ödeme API yanıtına dönüştü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ı, başarısızlık vb. için) URL'ye sorgu parametresi olarak ekler.
9 Geliştirici portalı, API tüketicisinin tarayıcısını değiştirilen URL'ye yönlendirerek 1. adımdaki isteğe yanıt verir.
10 API tüketicisi, başvuru formunu doldurur ve Worldpay ile işlemeyi başlatır.
11 Worldpay, fatura bilgilerini yakalar ve ödemeyi işler. İşlem başarılı olduğunda Worldpay, hem Worldpay hem de geliştirici portalında yapılandırılmış 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 itibaren) yönlendirir. Bu işlem sırasında MAC'yi sorgu parametresi olarak ve tutarı ekler.
13 Tarayıcı, geliştirici portalında istenen tutar ve MAC ile URL'yi çağırır.
14 Portal, MAC'yi MAC gizli koduna göre doğrular. MAC, kişilerin rastgele bir şekilde başarılı ödeme yapıldığını iddia etmesini önler.
15 Geliştirici portalı, ön ödemeli hesap bakiyesini yeniden yüklemek için Edge'e istek gönderir. Hesap bakiyesini yeniden yüklemek için API'yi kullanma hakkında bilgi edinmek isterseniz 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ıyla satıcı hesabı oluşturma

Başlamadan önce, satıcı hesaplarınızı oluşturmak için bir üçüncü taraf ödeme sağlayıcı (Worldpay) ile iletişime geçmeniz gerekir. Biri test, biri ü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) adresini ziyaret edin.

Satıcı hesabınızı oluşturduktan ve 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 Şifresi alanında ayarlayın.
    3. MAC gizli yönlendirmesi alanına 20 ila 30 karakter uzunluğunda 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 adresini girin.
    4. Kaydet'i tıklayın.
  5. Satıcı URL'sini, yöntem kimlik doğrulama kodu (MAC) dahil olmak üzere Worldpay parametrelerini ekleyecek şekilde 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üzenleme bölümünde, Kanal seç 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 True olarak ayarlayın.
    5. Yayınla sekmesini tıklayın.
    6. Değişiklikleri aşağıdaki şekilde tanıtın:
      • Test ortamlarında, Tasarım'dan Korumalı Alana tanıtım yapmak için Tasarım bölümünde Tanıt'ı tıklayın.
      • Üretim ortamlarında, Korumalı Alan'dan Üretim'e tanıtım yapmak için Korumalı Alan'ın altında Tanıt'ı tıklayın.

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

Bir sonraki adım, Edge'de ödeme sağlayıcıyı 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 sys yönetici 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ı yapılandırabilir:

/config/providers

Her bir 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 kurulum kimliği. Evet
credential Worldpay satıcı hesabınız için Base64 kodlamalı kimlik bilgileri (username:XMLpassword); username, satıcı koduna (büyük harflerle) eşdeğerdir ve XMLpassword, Worldpay satıcı hesabınızı oluştururken ö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 uç nokta
  • Test hesapları için: https://secure-test.worldpay.com/jsp/merchant/xml/paymentService.jsp
  • Üretim hesapları için: 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ı genelinde benzersiz olduğundan emin olun. Kolayca tanımlanabilmesi için sağlayıcı adına WorldPay'i (büyük/küçük harf duyarlı değildir) 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ğıdaki kod, Worldpay'de Worldpay-myorg adlı 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ğıdaki ekranda ş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 için 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 Kazanmayı Yapılandırma bölümüne bakın.

Ö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, ödeme sağlayıcı kullanılarak ön ödemeli hesaba yapılan ödemeler, API tüketicileri aşağıdaki durumlarda geliştirici portalı tarafından başlatılır:

  • Ücret planı kabul etme ancak ön ödemeli hesabında yeterli bakiye olmaması
  • Ön ödemeli hesabına para eklemesini isteyin.

API'yi kullanarak üçüncü taraf bir ö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 bilgilerini de iletmeniz gerekir.

Örneğin, aşağıdaki kodda Worldpay ödeme sağlayıcısı kullanılarak ön ödemeli hesap bakiyesi yeniden yüklenir. Ön ödemeli hesabınıza yapılacak ilk transfer 10 ABD doları olacaktır (amount sorgu parametresi 10 olarak ayarlanmıştı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, benzersiz sipariş anahtarınız sorgu parametresi olarak eklenmiş şekilde referenceUrl biçiminde döndürülür.

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

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

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

Geliştiricinin ön ödemeli hesap bakiyesini yeniden yükleme

API'yi kullanan bir geliştirici için ön ödemeli hesap bakiyesini yeniden yüklemek isterseniz /mint/organizations/{org_name}/developers/{developer_id}/developer-balances adlı alıcıya 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 istek özelliklerinin özeti başlıklı makaleyi inceleyin.

Bir şirketin ön ödemeli hesap bakiyesini yeniden yükleme

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. Bu adreste {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 1000 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 istek ö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ı silme

Aşağıdaki kaynağa DELETE (SİL) isteği göndererek, Edge kuruluşunuz için yapılandırılmış bir üçüncü taraf ödeme sağlayıcısını silebilirsiniz:

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

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

Sistem yöneticisi ayrıcalıklarına sahip yalnızca Apigee Edge Private Cloud müşterileri, isteğe bağlı olarak aşağıdaki API'yi kullanarak küresel ödeme sağlayıcıları 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 izleyerek ve ardından API'yi kullanarak ön ödemeli hesap bakiyesini yeniden yükleme bölümünde açıklandığı gibi, hesabı yeniden yüklemek için para kazanma API'sini çağırarak ön ödemeli bakiyelerin yeniden yüklenmesini yönetebilirsiniz.

Ön ödemeli hesap bakiyelerinin API kullanarak 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, ücret planları için yinelenen ödemeleri yönetmek amacıyla kullanışlıdır.

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

Bakiyenin belirli bir eşiğin altına düştüğünde geliştiricinin ön ödemeli hesap bakiyesini otomatik olarak yeniden yüklemek için /mint/organizations/{org_name}/developers/{developer_id}/developer-balances/recurring-setup adresine bir POST isteği gönderin. Bu adreste {developer_id}, geliştiricinin e-posta adresidir.

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

  • Hesabı yeniden yüklemek için kullanılacak ödeme sağlayıcının kimliği (providerID)
  • Otomatik yeniden yüklemeyi etkinleştiren işaret (isRecurring)
  • Otomatik yeniden yüklemeyi tetiklemek için ön ödemeli hesap bakiyesinin altına 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 ayarlamayla ilgili istek özelliklerinin özeti başlıklı makaleyi inceleyin.

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

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

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

  • Hesabı yeniden yüklemek için kullanılacak ödeme sağlayıcının kimliği (providerID)
  • Otomatik yeniden yüklemeyi etkinleştiren işaret (isRecurring)
  • Otomatik yeniden yüklemenin tetiklenmesi için ön ödemeli hesap bakiyesinin altına 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 ayarlamak için istek özelliklerinin özeti bölümüne bakın.

Peşin ödenen hesapların otomatik olarak yeniden yüklenmesini ayarlamayla ilgili istek özelliklerinin özeti

API kullanılarak otomatik olarak ön ödemeli hesap bakiyeleri 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 yeniden yüklemeyi tetiklemek için ön ödemeli hesap bakiyesinin altına 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ı, Barındırılan Ödeme Sayfaları olarak adlandırılan yeni bir sayfa grubunu kullanacak şekilde güncelledi.

WorldPay ödeme sağlayıcılarınızı desteği sonlandırılan güvenli ödeme işleme akışını kullanarak yapılandırdıysanız (Ağustos 2017'den önce) 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. authType alanında yükleme kimliğini ileterek yeni WorldPay ödeme sağlayıcılarını Edge'de ödeme sağlayıcıyı yapılandırma bölümünde açıklandığı gibi yapılandırın.
  3. Geliştirici portalınızdaki yeni ödeme sağlayıcılarını, Geliştirici Portalı'nda Para Kazanmayı Yapılandırma bölümünde açıklandığı şekilde yapılandırın.
  4. Ödeme sağlayıcıyı kullanarak ön ödemeli 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, otomatik yeniden yüklemeyi yeni sağlayıcı kimliğini kullanacak şekilde yeniden yapılandırmanız gerekir.

Sonraki adımlar

Kredi limitlerini, faturalı geliştiriciler için ayrı ayrı ayarlayabilirsiniz. Bunu nasıl yapacağınızı Son ödemeli bakiyeleri yönetme başlıklı makalede bulabilirsiniz.