Apigee Edge belgelerini görüntülüyorsunuz.
Apigee X belgelerine gidin. info
Ön ödemeli bir hesapta bakiyeyi yönetmek için şunları yapabilirsiniz:
- Mevcut ön ödemeli hesap bakiyesini görüntüleyin. 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ı kullanarak hesap bakiyesine gerektiği kadar para ekleyin (para ekleyin). Üçüncü taraf ödeme sağlayıcı kullanarak ön ödemeli bakiyeleri yönetme başlıklı makaleyi inceleyin.
Alternatif olarak, ödemeleri manuel olarak veya entegre bir faturalandırma sistemi aracılığıyla izleyerek ve ardından Ön ödemeli bakiyeleri manuel olarak yönetme bölümünde açıklandığı gibi, para kazanma API'sini çağırarak hesabı yeniden yüklemeyi yönetebilirsiniz.
- Para kazanma API'sini ve Worldpay gibi bir üçüncü taraf ödeme sağlayıcıyı kullanarak, ön ödemeli hesap bakiyesi belirli bir eşiğin altına düştüğünde otomatik olarak yeniden yükleme ayarlayın. Bu seçenek, ücret planları için yinelenen ödemeleri yönetmek amacıyla kullanışlıdır. Bilgi için API'yi kullanarak ön ödemeli hesap bakiyelerinin otomatik olarak yeniden yüklenmesini ayarlama başlıklı makaleyi inceleyin.
Ö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.
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:
|
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ı ile satıcı hesabı oluşturma
- Edge'de ödeme sağlayıcıyı yapılandırma
- Kuruluşunuz için yapılandırılan ödeme sağlayıcıları görüntüleme
- Gerekli modülleri geliştirici portalında etkinleştirme ve yapılandırma
- Ödeme sağlayıcı kullanarak ön ödemeli hesaba ödeme başlatma
- API'yi kullanarak ön ödemeli hesap bakiyesini yeniden yükleme
- Üçüncü taraf ödeme sağlayıcıyı silme
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:
- 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 Şifresi alanında ayarlayın.
- MAC gizli yönlendirmesi alanına 20 ila 30 karakter uzunluğunda 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 adresini girin.
- Kaydet'i tıklayın.
- Satıcı URL'sini, yöntem kimlik doğrulama kodu (MAC) dahil olmak üzere Worldpay parametrelerini ekleyecek şekilde 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üzenleme bölümünde, Kanal seç 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 True olarak ayarlayın.
- Yayınla sekmesini tıklayın.
- 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
|
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: |
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 ( |
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:
- 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.
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.- 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.
- Ö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.