Apigee Edge belgelerini görüntülüyorsunuz.
Apigee X belgelerine gidin. bilgi
Ön ödemeli bir hesapta 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 bölümüne bakın.
- Worldpay gibi bir üçüncü taraf ödeme sağlayıcıyı kullanarak hesap bakiyesini gerektiği şekilde yeniden yükleyin (para ekleyin). Üçüncü taraf ödeme sağlayıcı kullanarak ön ödeme bakiyelerini yönetme bölümüne göz atın.
Alternatif olarak, Ön ödeme bakiyelerini manuel olarak yönetme bölümünde açıklandığı gibi, ödemeleri manuel olarak veya entegre bir faturalandırma sistemi aracılığıyla izleyip ardından para kazanma API'sini çağırarak hesabı yeniden yükleyerek yeniden yükleme işlemini yönetebilirsiniz.
- Para kazanma API'sini 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 yeniden yükleme özelliğini ayarlayın. Bu seçenek, ücret planları için yinelenen ödemeleri yönetmek amacıyla kullanışlıdır. Daha fazla bilgi edinmek için API'yi kullanarak ön ödemeli hesap bakiyelerini otomatik olarak yeniden yüklemeyi ayarlama bölümüne bakın.
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.
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:
|
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
- Edge'de ödeme sağlayıcıyı yapılandırma
- Kuruluşunuz için yapılandırılmış ödeme sağlayıcılarını 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 bakiyesini yeniden yükleme
- Üçüncü taraf ödeme sağlayıcılarını silme
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:
- https://secure.worldpay.com/sso/public/auth/login.html adresine gidin.
- Worldpay tarafından size verilen kimlik bilgilerini kullanarak Worldpay hesabınıza giriş yapın.
- XML şifresini ve mesaj kimlik doğrulama kodu (MAC) gizli anahtarını ayarlayın:
- Profil'i tıklayın.
- Edge'deki XML Şifresi alanında, Worldpay ödeme sağlayıcısını yapılandırırken kullanılacak şifreyi belirleyin.
- MAC gizli anahtarını yönlendirme alanına 20 ila 30 karakter uzunluğunda bir MAC gizli anahtarı girin.
- Profili kaydet'i tıklayın.
- Apigee Edge Management sunucusunu satıcı IP'leri (izin verilenler listesi) listesine ekleyin:
- Profil > Satıcı Ortamı'nı tıklayın.
- New Test IP'yi (Yeni Test IP'si) tıklayın.
- Apigee Edge yönetim sunucusunun IP'sini 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üzenle altında, 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 True 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 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
|
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: |
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ı ( |
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:
- 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.
- 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. - 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.
- Ö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.