Apigee Edge belgelerini görüntülüyorsunuz.
Apigee X belgelerine gidin. bilgi
Ön ödemeli hesaptaki bakiyeyi yönetmek için şunları yapabilirsiniz:
- Mevcut ön ödemeli hesap bakiyesini görüntüleme API'yi kullanarak ön ödemeli hesap bakiyelerini görüntüleme başlıklı makaleyi inceleyin.
- Worldpay gibi bir üçüncü taraf ödeme sağlayıcısını kullanarak hesap bakiyesine gerektiği kadar para ekleyin. Üçüncü taraf ödeme sağlayıcı kullanarak ön ödemeli bakiyeleri yönetme başlıklı makaleye göz atın.
Alternatif olarak, ödemeleri manuel olarak veya entegre bir faturalandırma sistemi aracılığıyla takip ederek yeniden yüklemeyi yönetebilir ve ardından hesabı yeniden yüklemek için para kazanma API'sini çağırabilirsiniz. Bu işlem, Ön ödemeli bakiyeleri manuel olarak yönetme başlıklı makalede açıklanmıştır.
- Monetization API'yi ve Worldpay gibi üçüncü taraf bir ödeme sağlayıcıyı kullanarak ön ödemeli hesap bakiyesi belirli bir eşiğin altına düştüğünde otomatik para yükleme özelliğini ayarlayın. Bu seçenek, ücret planları için yinelenen ödemeleri yönetmek açısından faydalıdır. Daha fazla bilgi için API'yi kullanarak ön ödemeli hesap bakiyelerine otomatik para yükleme ayarlama başlıklı makaleyi inceleyin.
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.50API'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.

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:
|
| 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
- Edge'de ödeme sağlayıcıyı yapılandırma
- Kuruluşunuz için yapılandırılmış ödeme sağlayıcıları görüntüleme
- Geliştirici portalında gerekli modülleri etkinleştirme ve yapılandırma
- Ödeme sağlayıcı kullanarak ön ödemeli hesaba ödeme başlatma
- API'yi kullanarak ön ödemeli hesap bakiyesine yeniden yükleme yapma
- Üçüncü taraf ödeme sağlayıcıyı silme
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:
- https://secure.worldpay.com/sso/public/auth/login.html adresine gidin.
- Worldpay tarafından size sağlanan kimlik bilgilerini kullanarak Worldpay hesabınıza giriş yapın.
- XML şifresini ve mesaj doğrulama kodu (MAC) gizli anahtarını ayarlayın:
- Profil'i tıklayın.
- Edge'de Worldpay ödeme sağlayıcısını yapılandırırken kullanılacak şifreyi XML Password (XML Şifresi) alanına girin.
- Yönlendirme MAC gizli anahtarı alanına 20-30 karakterlik bir MAC gizli anahtarı girin.
- Profili Kaydet'i tıklayın.
- Apigee Edge yönetim sunucusunu satıcı IP'leri listesine (izin verilenler listesi) ekleyin:
- Profil > Satıcı Ortamı'nı tıklayın.
- Yeni Test IP'si'ni tıklayın.
- Apigee Edge yönetim sunucusunun IP'sini girin.
- Kaydet'i tıklayın.
- Yöntem kimlik doğrulama kodu (MAC) dahil olmak üzere Worldpay parametrelerini eklemek için satıcı URL'sini yapılandırın:
- Yüklemeler > Barındırılan Ödeme Sayfaları > Ödeme Sayfası Tasarımcısı'nı tıklayın.
- Ödeme Sayfalarını Düzenle bölümünde, Kanal seçin açılır listesinden yükleme kimliğinizi seçin.
- Özellikler sekmesinde Satıcı yapılandırmasını düzenle'yi seçin.
- URL parametrelerini gönder değerini Doğru olarak ayarlayın.
- Yayınla sekmesini tıklayın.
- 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}/providersYalnı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
|
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: |
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/idYalnı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
supportedCurrencyIDsorgu 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
supportedCurrencyIDsorgu 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 ( |
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:
- 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.
- Ö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
authTypealanına iletin. - 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.
- Ö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.