Ö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.

Method	GET
URL	https://api.zotlo.com/v1/transaction/detail?transactionId=TRANSACTION_ID
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": "[e-mail]",
      "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": "[e-mail]",
            "taxNumber": "9961398961",
            "taxOffice": ""
          },
          "customer": {
            "fullName": null,
            "address": "United States",
            "subscriberId": "[e-mail]"
          },
          "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": "[e-mail]",
        "transactionId": "0741a0ac-21d8-4750-941f-064f340700c3",
        "paymentType": "paypal",
        "code": "S0000001",
        "message": null
      }
    ]
  }
}

Başarılı Cevap Parametreleri

Alan	Açıklama
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

Alan	Açıklama
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.