Ödeme İşlemi Sorgulama
Ödeme işlemi hakkında detaylı bilgi edinin
Bu API hizmeti, Zotlo ile yapılmış bir ödeme işleminin detayları hakkında sizi bilgilendirir. Satın alma işlemlerinden sonra bu servis kullanılarak ödeme işlemi doğrulanabilir. Bu servis ile satın almaya ait detaylar ya da işlem logları kontrol edilebilir.
Request Parameters
transactionId: iade yapılmak istenen işlemin transactionId bilgisidir.
Örnek İstek
İşlem sorgulama servisine istek gönderirken gerekli olan Access Key ve Access Secret bilgilerine, Zotlo Panel'de yer alan Developer Tools/API Keys sayfasından ulaşabilirsiniz.
Application ID bilgisinin gönderilmesi zorunlu değildir.
GET https://api.zotlo.com/v1/transaction/detail?transactionId=TRANSACTION_ID HTTP/1.1
AccessKey: ••••••
AccessSecret: ••••••
Content-Type: application/json
ApplicationId: •
Language: ••Başarılı Cevap Örneği
{
"meta": {
"requestId": "Rhk8q8-REQ-676d1460b284f",
"httpStatus": 200
},
"result": {
"transaction": {
"id": 143199,
"payment_type": "consumable",
"original_transaction_id": "d8ff7792-1c63-4370-be93-447dacaa09ea",
"subscriber_id": "[email protected]",
"transaction_id": "0741a0ac-21d8-4750-941f-064f340700c3",
"provider_transaction_id": "863AB913JK7512U",
"package_id": "2",
"status": "consumable",
"purchase_date": "2024-12-25 11:16:36",
"expire_date": "2024-12-25 11:16:36",
"original_purchase_date": "2024-12-25 11:16:36",
"price": "1.49",
"currency": "USD",
"country": "US",
"provider_name": "PayPal",
"subscriptionId": 0,
"custom_parameters": {
"invoice": {
"invoiceName": null,
"invoiceProductTitle": "FitLife Tek Seferlik Satın Alma",
"invoiceStatus": false,
"receiptStatus": true,
"documentType": "receipt"
},
"clientUuid": "c941fc12-cac3-42f8-9790-8bb6e9f4793c",
"dataWarehouse": {
"paymentModule": "generate",
"siteId": 1367,
"flowId": 5413,
"appId": 1094,
"teamId": 189,
"acceptPolicy": false,
"fullName": null
},
"utm": {
"source": null,
"medium": null,
"campaign": null,
"term": null,
"content": null
},
"agreement": {
"company": {
"title": "Z3P Yazılım Anonim Şirketi",
"address": "Maslak Mah. Büyükdere Cad. USO Center No: 245 İç Kapı No: 27 Sarıyer/İstanbul",
"phone": "",
"email": "[email protected]",
"taxNumber": "9961398961",
"taxOffice": ""
},
"customer": {
"fullName": null,
"address": "United States",
"subscriberId": "[email protected]"
},
"product": {
"name": "FitLife",
"detail": "Premium123",
"quantity": 1,
"trialPrice": null,
"subTotal": "0.17",
"vatTotal": "0.01",
"includeVatTotal": "0.19",
"pricesCurrency": "USD"
}
},
"merchantParameters": [],
"cardBrand": "unknown",
"threeds": "0",
"installment": "1",
"bank": "paypal",
"subscriberIpAddress": "67.219.150.38",
"receiptDetail": {
"url": "https://dashboard.zotlo.com/receipt/ff388f17-b35d-4851-a59c-05ff64477d11"
}
},
"credit_card": "",
"checkout_type": "paypal",
"refund": null,
"detail": [
{
"key": "receiptUrl",
"value": "https://dashboard-zotlo.stage.mobylonia.com/receipt/ff388f17-b35d-4851-a59c-05ff64477d11"
}
],
"exchange": {
"status": false,
"detail": []
}
},
"transactionLog": [
{
"providerId": 3062,
"createDate": "2024-12-25 11:16:05",
"requestType": "transaction",
"requestData": "{\"requestType\":\"SALE\",\"transactionId\":\"0741a0ac-21d8-4750-941f-064f340700c3\",\"CARDTOKEN\":\"dffdc4d7-7d7c8-d2dad0c51fad\",\"cardCvv\":\"***\",\"price\":1.49,\"currency\":\"USD\",\"installment\":1}",
"responseData": "{\"isMockPayment\":true,\"success\":true}",
"subscriberId": "[email protected]",
"transactionId": "0741a0ac-21d8-4750-941f-064f340700c3",
"paymentType": "paypal",
"code": "S0000001",
"message": null
}
]
}
}Başarılı Cevap Parametreleri
payment_type
Ödeme işleminin tipidir. Abonelik ya da tek seferlik olabilir. subscription ödeme işleminin aboneliğe ait olduğunu, consumable ödeme işleminin tek seferlik olduğunu belirtir.
subscriber_id
Satın alma işlemi yapan kullanıcının id'sidir. Bu bilgi telefon numarası ya da e-posta olabilir.
transaction_id
Satın alma işlemine ait uniq id değeridir. İade işlemlerinde bu bilgi kullanılmaktadır.
status
İşleme ait durum değeridir.
trial : Kullanıcı deneme süresindedir. trial_to_paid : Deneme süresinin bittiğini ve asıl fiyat ile ödeme işleminin gerçekleştiğini belirtir.
renewal : Aboneye ait yenileme işlemi. reactive : Hesabı pasif olan bir kullanıcının ödeme yaparak hesabını aktif duruma getirdiği durumlarda gönderilir.
consumable : Tek seferlik paket satın alındığında gönderilir.
start_paid : Ücretli olarak yeni bir abonelik başlatıldığında gönderilir.
purchase_date
İşlem gerçekleşme tarihidir.
expire_date
Eğer abonelik ile ilgili bir satın alma ise ilgili satırın son geçerlilik tarihidir.
custom_parameters.paymentMethod
Ödeme yöntemini belirtir.
custom_parameters.cardBrand
Kart markasını belirtir.
transactionLog.code
Ödemeye ait durum kodudur. Ödeme kodlarına bu sayfadan bakabilirsiniz.
Başarısız Cevap Örneği
Servislerimizden HTTP status code olarak başarılı durumlarda 200 dönmektedir. Başarısız durumlarda ise 400 ya da 500 Http StatusCode dönmektedir. Örnek hata cevabı aşağıdaki şekildedir.
{
"meta": {
"requestId": "MacBook-Pro.local-REQ-5eb025e96f806",
"httpStatus": 200
},
"result": {
"transaction": null,
"transactionLog": [
{
"id": 98,
"team_id": 3,
"provider_id": 3,
"app_id": 2,
"create_date": "2020-04-06 06:10:11",
"request_type": "transaction",
"status": "fail",
"request_data": "\nCCProxySale20386ECCB3531A727428EBF394531********2283Test Test22115921a8b3951b512d54e1a880b57b30a1b321TRY159.146.13.1721ZotloTestZotloTest1zotlo-test-10\n",
"response_data": "{\"StatusCode\":\"1\",\"ResultCode\":\"59\",\"ResultMessage\":\"Message.\",\"OrderObjectId\":\"3fb29aed-f64a-4101-bd47-a35d670ee251\",\"LastTransactionDate\":\"4\\/6\\/2020 9:10:11 AM\",\"MaskedCreditCardNumber\":\"4531 44** **** 2283\",\"MPAY\":\"a8b3951b512d54e1a880b57b30a1b321\",\"CCTokenId\":\"00000000-0000-0000-0000-000000000000\",\"SubscriberId\":\"00000000-0000-0000-0000-000000000000\",\"SubscriberStarterDate\":\"1\\/1\\/0001 12:00:00 AM\",\"SubscriptionRequestId\":\"00000000-0000-0000-0000-000000000000\"}",
"subscriber_id": "zotlo-test-1",
"transaction_id": "3fb29aed-f64a-4101-bd47-a35d670ee251",
"payment_type": "non3d"
}
]
}
}Başarısız Cevap Parametreleri
requestId
Zotlo tarafından işleminiz için ü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.
errorCode
İlgili hatanın Zotlo'daki hata kodudur.
result
Bu alanın alabileceği değerler dinamiktir. Eğer hata sonucunda ilgili servisten bir cevap dönülmesi gerekiyorsa dolu gelecektir. Aksi durumlarda ise boş object olarak gelmektedir.
Last updated