Ödeme Geçmişi Sorgulama

Ödeme işlemlerinizi Zotlo ile kontrol edin

Bu API hizmeti Zotlo'daki abonelerinizin ödeme işlemleri veya tek seferlik ödemeleri hakkında bilgi sağlar. Ödeme Geçmişi Sorgulama hizmeti GET metodunu kullanarak çalışır. Ödeme işlemlerini almak için SubscriberId parametresi zorunludur.

Method	GET
URL	https://api.zotlo.com/v1/transaction?subscriberId=&paymentType=&startDate=&endDate=&packageId=
İstek Parametreleri	subscriberId: Abonelik başlatılırken kullanıcının kullandığı e-posta adresi veya telefon numarasıdır. paymentType: Bu parametre, ödeme türünü tanımlar. subscription veya consumable değerlerini alabilir. Consumable, tek seferlik ödemeleri ifade eder.Bu parametre isteğe bağlıdır. startDate : Belirli bir tarihten sonra ödeme gerekiyorsa, tarih bu parametrede 2024-01-15 biçiminde belirtilmelidir. Bu parametre isteğe bağlıdır. endDate:Belirli bir tarihten önce ödeme gerekiyorsa, tarih bu parametrede 2024-01-30 biçiminde belirtilmelidir. Bu parametre isteğe bağlıdır.

Örnek İstek

Ödeme geçmişi sorgulama servisine istek gönderirken, Zotlo Panelindeki Geliştirici Araçları/API Anahtarları sayfasından gerekli Erişim Anahtarı ve Erişim Gizli bilgilerini alabilirsiniz.

GET https://api.zotlo.com/v1/transaction?subscriberId=&paymentType=&startDate=&endDate=&packageId= HTTP/1.1
AccessKey: ••••••
AccessSecret: ••••••
Content-Type: application/json
ApplicationId: •
Language: ••

Başarılı Yanıt Örneği

{
    "meta": {
        "requestId": "246a8e676214-REQ-659565f64ef8e",
        "httpStatus": 200
    },
    "result": {
        "transactions": [
            {
                "id": 57097,
                "payment_type": "subscription",
                "original_transaction_id": "48e39b30-2820-4d77-9699-221c896fca55",
                "transaction_id": "02c88e3a-f358-4adc-9c21-b979fb698e85",
                "provider_transaction_id": "b9b84a68-980e-404b-a705-45e5d327fdba",
                "package_id": "premium",
                "status": "renewal",
                "purchase_date": "2024-01-02 08:24:14",
                "expire_date": "2024-01-30 07:50:34",
                "original_purchase_date": "2023-11-30 07:50:34",
                "price": "49.00",
                "currency": "TRY",
                "country": "TR",
                "provider_name": "Zotlopos",
                "subscriptionId": 8260,
                "refund": null,
                "exchange": {
                    "status": false,
                    "detail": []
                }
            },
            {
                "id": 55001,
                "payment_type": "subscription",
                "original_transaction_id": "48e39b30-2820-4d77-9699-221c896fca55",
                "transaction_id": "48e39b30-2820-4d77-9699-221c896fca55",
                "provider_transaction_id": "b793670e-57d1-49df-8dcf-8d14426bd039",
                "package_id": "premium",
                "status": "start_paid",
                "purchase_date": "2023-11-30 07:50:34",
                "expire_date": "2023-12-30 07:50:34",
                "original_purchase_date": "2023-11-30 07:50:34",
                "price": "49.00",
                "currency": "TRY",
                "country": "TR",
                "provider_name": "Zotlopos",
                "subscriptionId": 8260,
                "refund": null,
                "exchange": {
                    "status": false,
                    "detail": []
                }
            }
        ]
    }
}

Başarısız Yanıt Örneği

Başarılı yanıtlar için 200 HTTP durum kodu döndürür. Başarısız durumlar için 400 veya 500 HTTP durum kodları döndürülür. Örnek bir hata yanıtı aşağıdaki gibidir:

{
  "meta": {
    "requestId": "246a8e676214-REQ-6595662ae067d",
    "httpStatus": 200
  },
  "result": {
    "transactions": []
  }
}

Başarısız Yanıt Parametreleri

Aşağıda başarısız yanıtlara dahil edilen parametreler yer almaktadır.

Alan	Açıklama
requestId	Zotlo tarafından üretilen ve saklanan benzersiz istek parametresidir.
httpStatus	İlgili cevaba ait HttpStatus kodudur. Standart kodlar olan, 400 ya da 500 dönmektedir.
errorMessage	Alınan hatanın detayıdır. Hata mesajı, gönderdiğiniz dil parametresine göre her dile özel verilmektedir. 404001 : Geçersiz endpoint 401002: AccessKey, AccessSecret parametreleri hatalı. 400008: subscriberId parametresi hatalı. 400009: Subscriber profili bulunamadı. 500000: Sunucu hatası.
errorCode	İlgili hatanın Zotlo'daki hata kodudur. Zotlo'da her hataya özel tekil hata kodları yer almaktadır. Aşağıdaki hata kodlarını alabilir. 404001 : Geçersiz endpoint 401002: AccessKey, AccessSecret parametreleri hatalı. 400008: subscriberId parametresi hatalı. 400009: Kullanıcı profili bulunamadı. 500000: Sunucu hatası.
result	Bu alanın alabileceği değer dinamik olarak değişebilir. Hata durumunda ilgili servisten bir cevap dönerken dolu olarak gelebilir. Aksi durumda ise boş bir obje olarak dönebilir.