Ödeme Sorgulama

Bir transactionId değerine ait ödeme detaylarını sorgulamak için kullanılır..
GET  https://api.zotlo.com/v1/transaction/detail?transactionId=TRANSACTION_ID
Satın alma işlemlerinden sonra bu servis kullanılarak ödeme işlemi doğrulabilir. Bu servis ile satın almaya ait detaylar ya da işlem logları kontrol edilebilir.
Ödeme sorgulama servisi için gönderilmesi gereken parametreler şunlardır.
Alan
Açıklama
transactionId
Cevabının kontrol edilmesi istenilen transactionId değeridir.
Örnek İstek
Curl
Php
Swift
Java
Python
C#
curl --location --request GET 'https://api.zotlo.com/v1/transaction/detail?transactionId=5e6b9a02e71dd803d6420663' \
--header 'AccessKey: ***' \
--header 'AccessSecret: ***' \
--header 'ApplicationId: 2' \
--header 'Language: tr'
$curl = curl_init();
​
curl_setopt_array($curl, array(
  CURLOPT_URL => "https://api.zotlo.com/v1/transaction/detail?transactionId=5e6b9a02e71dd803d6420663",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => array(
    "AccessKey: ***",
    "AccessSecret: ***",
    "ApplicationId: 2",
    "Language: tr"
  ),
));
​
$response = curl_exec($curl);
​
curl_close($curl);
echo $response;
import Foundation
​
var semaphore = DispatchSemaphore (value: 0)
​
var request = URLRequest(url: URL(string: "https://api.zotlo.com/v1/transaction/detail?transactionId=5e6b9a02e71dd803d6420663")!,timeoutInterval: Double.infinity)
request.addValue("***", forHTTPHeaderField: "AccessKey")
request.addValue("***", forHTTPHeaderField: "AccessSecret")
request.addValue("2", forHTTPHeaderField: "ApplicationId")
request.addValue("tr", forHTTPHeaderField: "Language")
​
request.httpMethod = "GET"
​
let task = URLSession.shared.dataTask(with: request) { data, response, error in
  guard let data = data else {
    print(String(describing: error))
    return
  }
  print(String(data: data, encoding: .utf8)!)
  semaphore.signal()
}
​
task.resume()
semaphore.wait()
OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
Request request = new Request.Builder()
  .url("https://api.zotlo.com/v1/transaction/detail?transactionId=5e6b9a02e71dd803d6420663")
  .method("GET", null)
  .addHeader("AccessKey", "***")
  .addHeader("AccessSecret", "***")
  .addHeader("ApplicationId", "2")
  .addHeader("Language", "tr")
  .build();
Response response = client.newCall(request).execute();
import requests
​
url = "https://api.zotlo.com/v1/transaction/detail?transactionId=5e6b9a02e71dd803d6420663"
​
payload = {}
headers = {
  'AccessKey': '***',
  'AccessSecret': '***',
  'ApplicationId': '2',
  'Language': 'tr'
}
​
response = requests.request("GET", url, headers=headers, data = payload)
​
print(response.text.encode('utf8'))
var client = new RestClient("https://api.zotlo.com/v1/transaction/detail?transactionId=5e6b9a02e71dd803d6420663");
client.Timeout = -1;
var request = new RestRequest(Method.GET);
request.AddHeader("AccessKey", "***");
request.AddHeader("AccessSecret", "***");
request.AddHeader("ApplicationId", "2");
request.AddHeader("Language", "tr");
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);
Servis Cevapları
Eğer Satın Alma Başarılı İse :
{
    "meta": {
        "requestId": "MacBook-Pro.local-REQ-5ead62f83fff3",
        "httpStatus": 200
    },
    "result": {
        "transaction": {
            "id": 169,
            "payment_type": "subscription",
            "original_transaction_id": "f1ebc9a8-b1ed-43a7-bcad-e196515599f3",
            "transaction_id": "87999971-702d-46e0-8086-2be89cd0691f",
            "provider_transaction_id": 1.16631000000105e+24,
            "package_id": "ZotloTest",
            "status": "trial_to_paid",
            "purchase_date": "2020-05-02 00:29:55",
            "expire_date": "2020-05-29 21:18:03",
            "original_purchase_date": "2020-04-26 21:18:03",
            "price": 1,
            "currency": "USD",
            "country": "US",
            "provider_name": "Zotlopay",
            "refund": null
        },
        "transactionLog": [
            {
                "id": 226,
                "team_id": 3,
                "provider_id": 5,
                "app_id": 2,
                "create_date": "2020-05-02 00:29:55",
                "request_type": "renewal",
                "status": "success",
                "request_data": "{\"cardPaymentMethodSpecificInput\":{\"paymentProductId\":1,\"token\":\"7c2cd83e-0dc3-49f6-a628-e774f8d5be3f\",\"unscheduledCardOnFileRequestor\":\"merchantInitiated\",\"unscheduledCardOnFileSequenceIndicator\":\"subsequent\"},\"fraudFields\":{\"customerIpAddress\":\"127.0.0.1\",\"userData\":[{\"Retry\":\"Y\"}]},\"order\":{\"amountOfMoney\":{\"amount\":100,\"currencyCode\":\"USD\"},\"customer\":{\"merchantCustomerId\":1588379394,\"billingAddress\":{\"countryCode\":\"US\"}}}}",
                "response_data": "{\"hostedCheckoutSpecificOutput\":null,\"paymentOutput\":{\"amountPaid\":null,\"amountReversed\":null,\"bankTransferPaymentMethodSpecificOutput\":null,\"cardPaymentMethodSpecificOutput\":{\"authorisationCode\":\"654321\",\"card\":{\"cardNumber\":\"************1111\",\"expiryDate\":\"1220\"},\"fraudResults\":{\"avsResult\":\"0\",\"cvvResult\":\"0\",\"fraugster\":null,\"retailDecisions\":{\"fraudCode\":\"0100\",\"fraudNeural\":null,\"fraudRCF\":null},\"fraudServiceResult\":\"accepted\",\"inAuth\":null},\"initialSchemeTransactionId\":null,\"schemeTransactionId\":null,\"threeDSecureResults\":null,\"token\":\"7c2cd83e-0dc3-49f6-a628-e774f8d5be3f\",\"paymentProductId\":1},\"cashPaymentMethodSpecificOutput\":null,\"directDebitPaymentMethodSpecificOutput\":null,\"eInvoicePaymentMethodSpecificOutput\":null,\"invoicePaymentMethodSpecificOutput\":null,\"mobilePaymentMethodSpecificOutput\":null,\"paymentMethod\":\"card\",\"redirectPaymentMethodSpecificOutput\":null,\"sepaDirectDebitPaymentMethodSpecificOutput\":null,\"amountOfMoney\":{\"amount\":100,\"currencyCode\":\"USD\"},\"references\":{\"merchantOrderId\":null,\"merchantReference\":null,\"paymentReference\":\"0\",\"providerId\":null,\"providerReference\":null,\"referenceOrigPayment\":null}},\"status\":\"CAPTURE_REQUESTED\",\"statusOutput\":{\"isAuthorized\":true,\"isRefundable\":false,\"threeDSecureStatus\":null,\"errors\":null,\"isCancellable\":true,\"statusCategory\":\"PENDING_CONNECT_OR_3RD_PARTY\",\"statusCode\":800,\"statusCodeChangeDateTime\":\"20200502022955\"},\"id\":\"000001166310000001050000100001\"}",
                "subscriber_id": "adassdfsdfdsfsdfdasd22",
                "transaction_id": "87999971-702d-46e0-8086-2be89cd0691f",
                "payment_type": "non3d"
            }
        ]
    }
}
Eğer Satınalma Başarısız İse :
{
    "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\":\"Doland?r?c?l?k ?\üphesi.\",\"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"
            }
        ]
    }
}
Servislerinden 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": "app2.localdomain-REQ-5e7da3a811d5d",
        "httpStatus": 400,
        "errorMessage": "Kullanıcı abonelik profili bulunamadı.",
        "errorCode": 400009
    },
    "result": []
}
Cevap
Açıklama
requestId
Her istek için sistem tarafından atanan id değeridir. Sistemsel hatalarda log'lardan hata yakalamak için kullanılır.
httpStatus
Hatanın HTTP durum kodu değeri
errorMessage
Hata mesajı. Tüm hata kodlarına "Hata Kodları" menüsünden ulaşabilirsiniz.
errorCode
İlgili hata için Zotlo tarafından verilen hata kodu
Ödeme Servisleri - Previous
Ödeme Formları Listesi
Next - Abonelik Servisleri
Abonelik Profili Sorgulama
Last modified 11mo ago
Copy link
Outline
Örnek İstek
Servis Cevapları