Ön ödemeli hesap bakiyelerini yönetme

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

Ön ödemeli bir hesapta 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 şu değerleri almanız gerekir:

  • amount: Geçerli fatura dönemi için kullanılabilen toplam para tutarı. Bu değer, ön ödemeli hesabı bu bölümde açıklanan yöntemler kullanılarak yeniden yüklediğinizde güncellenir.
  • usage: Geçerli fatura döneminde kullanılan toplam para tutarı. Bu değer, her nitelikli para kazanılan işlemle veya kredi vererek (pozitif veya negatif) güncellenir.

Geçerli fatura dönemi için kalan ön ödemeli hesap bakiyesini, usage değerini amount değerinden çıkararak hesaplayabilirsiniz. Ö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 kullanan bir geliştirici veya şirketin ön ödemeli hesap bakiyelerini nasıl görüntüleyeceğiniz açıklanmaktadır.

Bir 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 ({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 aktarabilirsiniz:

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 tanımlanır. 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 olarak ayarlanırsa bu parametre yok sayılır.
page Döndürmek istediğiniz sayfanın sayısı (içerik sayfalara ayrılmışsa). all sorgu parametresi true olarak ayarlanırsa bu parametre yok sayı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ıtla ilgili bir örnek yer almaktadır:

{
    "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. Burada {company_id}, şirketin kimliğidir. Şirket ön ödemeliyse istek, mevcut ön ödemeli hesap bakiyesini alır. Şirket sonradan ödeme yapıyorsa istek, geçerli kredi limitini alır.

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

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 tanımlanır. 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 olarak ayarlanırsa bu parametre yok sayılır.
page Döndürmek istediğiniz sayfanın sayısı (içerik sayfalara ayrılmışsa). all sorgu parametresi true olarak ayarlanırsa bu parametre yok sayı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

Yukarıda gösterilen bir geliştirici için ön ödemeli hesap bakiyelerini görüntülerken verilen yanıta benzer bir yanıt verilir.

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

Worldpay gibi üçüncü taraf bir ödeme sağlayıcıda satıcı hesabı oluşturarak ön ödemeli hesap bakiyelerini yönetebilirsiniz. Aşağıdaki şekilde, ön ödemeli hesap bakiyesinin Worldpay ödeme sağlayıcı 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çıklanmaktadır.

Adım Açıklama
0 Ön koşul adımları
API sağlayıcısı olarak Worldpay gibi bir üçüncü taraf ödeme sağlayıcı ayarlamak için şunları yapmanız gerekir:
1 API tüketicisi, akışı tetiklemek için geliştirici portalında aşağıdaki görevlerden birini gerçekleştirir:
  • Hesaba para ekler
  • Yetersiz bakiye bulunan bir ücret planı kabul ediliyor
2 Geliştirici portalı; sağlayıcı kimliği, yeniden yükleme tutarı ve para birimi ile birlikte geliştirici için Edge üzerinden ödeme başlatır. Ödeme başlatmak için API'yi kullanma hakkında bilgi edinmek istiyorsanız Ödeme sağlayıcı kullanarak ön ödemeli hesaba ödeme başlatma bölümüne bakın.
3 Edge, sağlayıcıyı kimliğe göre bulup bu hesabın bir Worldpay hesabı olduğunu belirler.
4 Edge bir sipariş kodu oluşturur.
5 Edge, ödeme siparişini Worldpay'de oluşturur.
6 Worldpay, sipariş için bir referans kimliği ve siparişi karşılamak için 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) sorgu parametreleri olarak URL'ye ekler.
9 Geliştirici portalı, 1. adımdaki isteğe, API tüketicisinin tarayıcısını değiştirilen URL'ye yönlendirerek yanıt verir.
10 API tüketicisi, başvuru formunu doldurur ve Worldpay ile işleme süreci başlatır.
11 Worldpay fatura bilgilerini toplar ve ödemeyi işleme koyar. Başarıyla Worldpay, hem Worldpay'de hem de geliştirici portalında yapılandırılan MAC Secret'ı kullanarak bir Mesaj Kimlik 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, MAC'yi sorgu parametresi olarak ve tutarı ekler.
13 Tarayıcı, geliştirici portalındaki URL'yi istenen tutar ve MAC ile çağırır.
14 Portal, MAC'yi MAC gizli anahtarına göre doğrular. MAC, bir kişinin rastgele ödeme yapıldığını iddia etmesini engeller.
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 ödeme bakiyelerini yönetmek için gereken adımlar açıklanmaktadır:

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

Başlamadan önce, satıcı hesaplarınızı oluşturmak için bir üçüncü taraf ödeme sağlayıcıyla (Worldpay) 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 verilen kimlik bilgilerini kullanarak Worldpay hesabınıza giriş yapın.
  3. XML şifresini ve mesaj kimlik doğrulama kodu (MAC) gizli anahtarını ayarlayın:
    1. Profil'i tıklayın.
    2. Edge'deki XML Şifresi alanında, Worldpay ödeme sağlayıcısını yapılandırırken kullanılacak şifreyi belirleyin.
    3. MAC gizli anahtarını yönlendirme alanına 20 ila 30 karakter uzunluğunda bir MAC gizli anahtarı girin.
    4. Profili kaydet'i tıklayın.
  4. Apigee Edge Management sunucusunu satıcı IP'leri (izin verilenler listesi) listesine ekleyin:
    1. Profil > Satıcı Ortamı'nı tıklayın.
    2. New Test IP'yi (Yeni Test IP'si) tıklayın.
    3. Apigee Edge yönetim sunucusunun IP'sini 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üzenle altında, 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 True 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 geçiş yapmak üzere Tasarım'ın altındaki Tanıt'ı tıklayın.
      • Üretim ortamları için Korumalı Alan'dan Üretim'e yükseltme yapmak üzere Korumalı Alan'ın altındaki 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 isteğe bağlı olarak aşağıdaki API'yi kullanarak 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ı koduyla (büyük harfle) 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 şunu 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ı genelinde 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ğıda belirtilen şekilde Worldpay ile Worldpay-myorg adlı bir satıcı hesabı oluşturulur:

$ 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ını görüntüleme

Aşağıdaki kaynağa bir GET isteği göndererek Edge kuruluşunuz için yapılandırılan üçü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 myorg için şu anda yapılandırılmış olan üçü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 amaçlı olmak üzere iki satıcı hesabının gösterildiği bir 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 Monetization ve Worldpay modüllerini etkinleştirme ve yapılandırma

Geliştirici portalında gerekli Monetization 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 hesaba ödeme başlatma

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

  • Bir ücret planını kabul etme ancak ön ödemeli hesabında yeterli bakiye olmaması
  • Ön ödemeli hesaplarına para ekleme isteğinde bulunma

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. {developer_id}, geliştiricinin e-posta adresidir.

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

İsteği gönderdiğinizde 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, şirketin fatura adresi gibi temel hesap ayrıntılarını iletmeniz gerekir.

Örneğin, aşağıda ön ödemeli hesap bakiyesi, Worldpay ödeme sağlayıcı aracılığıyla yeniden yüklenir. Ön ödemeli hesabınıza ilk aktarım 10 ABD doları olur (amount sorgu parametresi 10 olarak ayarlandı).

$ 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ıtla ilgili bir örnek yer almaktadır:

{
    "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 eklenerek sorgu parametresi olarak referenceUrl içinde 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şlemin başarıyla tamamlandığını doğruladıktan sonra, Edge'e ön ödemeli hesabı yeniden yüklemesi için bir istek gönderir.

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

Geliştirici için ön ödemeli hesap bakiyesini yeniden yükleme

API'yi kullanan bir geliştirici için ön ödemeli hesap bakiyesini yeniden yüklemek üzere /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önderdiğinizde, bakiyeye eklenecek tutarı ve kullanılan para birimini istek gövdesinde belirtmeniz gerekir.

Örneğin, aşağıdaki istek bir geliştiricinin ö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}/developers/{developer_id}/developer-balances" \
-u email:password

İstek özelliklerinin açıklaması için Ön ödemeli bir hesabı yeniden yüklemeyle ilgili istek özelliklerinin özeti bölümüne bakın.

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

API'yi kullanan 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. {company_id}, şirketin kimliğidir. İsteği gönderdiğinizde, bakiyeye eklenecek tutarı ve kullanılan para birimini istek gövdesinde 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 bir hesabı yeniden yüklemeyle ilgili istek özelliklerinin özeti bölümüne bakın.

Ön ödemeli bir hesabı yeniden yüklemeyle ilgili istek özelliklerinin özeti

Ön ödemeli hesap bakiyeleri API kullanılarak 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 paketinde plan için ayarlanan para birimidir.

Yok Evet

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

Aşağıdaki kaynağa 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şun ödeme sağlayıcısını silmek için aşağıdaki API'yi kullanın:

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

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 global ödeme sağlayıcıyı silebilir:

/config/providers/id

Örneğin, aşağıdakiler şu anda kuruluşum 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, API'yi kullanarak ön ödemeli hesap bakiyesini yeniden yükleme bölümünde açıklandığı gibi, ödemeleri manuel olarak veya entegre bir faturalandırma sistemi üzerinden takip edip daha sonra para kazanma API'sini çağırarak hesabı yeniden yükleyebilirsiniz.

Ön ödemeli hesap bakiyelerinin API'yi 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 bakiyelerini otomatik olarak yeniden yükleme işleminin nasıl yapılacağı 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

Bakiye belirli bir eşiğin altına düştüğünde geliştirici için ön ödemeli hesap bakiyesinin otomatik olarak yeniden yüklenmesini ayarlamak istiyorsanız /mint/organizations/{org_name}/developers/{developer_id}/developer-balances/recurring-setup adresine POST isteği gönderin. Burada {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şiği (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 eklenecektir.

$ 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 bölümüne bakın.

Şirketlerin ön ödemeli hesap bakiyelerini otomatik olarak yeniden yükleme

Bakiye belirli bir tutarın altına düştüğünde bir şirketin ön ödemeli hesap bakiyesinin 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} burada ş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üklemeyi tetiklemek için ön ödemeli hesap bakiyesinin altına düşmesi gereken eşiği (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 eklenecektir.

$ 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 ayarlamayla ilgili istek özelliklerinin özeti bölümüne bakın.

Ön ödemeli hesapların otomatik olarak yeniden yüklenmesini ayarlamayla ilgili istek özelliklerinin özeti

Ön ödemeli hesap bakiyelerini API kullanarak otomatik olarak yeniden yüklerken aşağıdaki özellikler belirtilebilir.

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

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

Yok Evet
chargePerUsage false Hayır
isRecurring

Otomatik yeniden yüklemenin etkin olup olmadığını (true) belirten işaret. 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 bu eşiğin altına düşmesi gerekir.

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şlemi akışını, Barındırılan Ödeme Sayfaları adı verilen yeni bir sayfa grubunu kullanacak şekilde güncelledi.

WorldPay ödeme sağlayıcılarınızı, desteği sonlandırılmış güvenli ödeme işlemi 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çiş yapmak 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. Yeni WorldPay ödeme sağlayıcılarını Edge'de ödeme sağlayıcıyı yapılandırma bölümünde açıklandığı şekilde, authType alanına kurulum kimliğini ileterek yapılandırın.
  3. Geliştirici portalınızda yeni ödeme sağlayıcılarını Geliştirici Portalı'nda Para Kazanma'yı yapılandırma bölümünde açıklandığı şekilde yapılandırın.
  4. Ödeme sağlayıcıyı kullanarak ön ödemeli bir hesabın otomatik olarak yeniden yüklenmesini ayarlarsanız API'yi kullanarak ön ödemeli hesap bakiyelerinin otomatik olarak yeniden yüklenmesini ayarlama bölümünde açıklandığı şekilde, yeni sağlayıcı kimliğini kullanmak için otomatik yeniden yükleme işlemini yeniden yapılandırmanız gerekir.

Sonraki adımlar

Faturalı geliştiricilerin her biri için kredi limiti belirleyebilirsiniz. Faturalı bakiyeleri yönetme başlıklı makaleden bunu nasıl yapacağınızı öğrenebilirsiniz.