LogoLogo
English
English
  • 👉Welcome
    • Overview
    • Quickstart Guide
  • 🌐Services
    • Sales Site Builder
    • Global Payments
    • Subscription Management
    • Onboarding Quizzes
    • Web-To-App
  • 🚀Getting Started
    • Adding A Project
      • Create A New Project
      • Project Settings
      • Payment Methods Configuration
      • Adding Social Login
    • Adding Sales Packages
      • Create A Sales Package
      • Package Settings
      • Price Settings
    • Designing Flows
      • Create A Flow
      • Configure Pages In Flows
      • Configure Languages
      • Designing Pages
      • Configuring Payment Options
      • User Registration Options
      • User Activation Options
      • Review Process
    • Managing Sales Sites
      • Create A Sales Site
      • Configuring Site Content
      • Domain Configuration
      • Configuring Integrations
      • Site Activation
      • Site Statistics
  • ⚙️Integrations
    • Webhooks
      • Subscription Status
      • Payments
      • Quiz Responses
      • Refunds
      • Registered Users
    • Google Analytics
    • Ad Platforms
    • Custom Integrations
    • Login SDK
    • API Services
      • Subscription Status Inquiry
      • Payment History Inquiry
      • Transaction Refund
      • Payment Transaction Inquiry
        • Payments Status Codes
      • Package Upgrade/Downgrade
  • 👫Customers
    • Tracking Subscribers
    • Tracking Payments
    • Cancellations and Refunds
  • 🔐Account
    • Account Settings
    • Users and Access
    • Payments and Pricing
  • Sign Up Now
  • Sign In
Powered by GitBook
On this page
  • Sample Request
  • Sample Successful Response
  • Successful Response Parameters
  • Failed Example Response
  • Failed Example Response Parameters
  1. Integrations
  2. API Services

Payment Transaction Inquiry

Get detailed information about a payment transaction.

PreviousTransaction RefundNextPayments Status Codes

Last updated 4 months ago

This service provides detailed information about a payment transaction made through Zotlo. It can be used to verify payment transactions after purchases. With this service, you can check payment details or transaction logs.

Method
GET

URL

Request Parameters

transactionId: The transactionId is for the transaction you want to refund.

Sample Request

You can find the required Access Key and Access Secret for sending a request to the transaction inquiry service on the Developer Tools > API Keys page in the Zotlo Panel.

Sending the Application ID is not required.

GET https://api.zotlo.com/v1/transaction/detail?transactionId=TRANSACTION_ID HTTP/1.1
AccessKey: ••••••
AccessSecret: ••••••
Content-Type: application/json
ApplicationId: •
Language: ••

Sample Successful Response

{
  "meta": {
    "requestId": "Rhk8q8-REQ-676d1460b284f",
    "httpStatus": 200
  },
  "result": {
    "transaction": {
      "id": 143199,
      "payment_type": "consumable",
      "original_transaction_id": "d8ff7792-1c63-4370-be93-447dacaa09ea",
      "subscriber_id": "liteye2440@rabitex.com",
      "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": "info@zotlo.com",
            "taxNumber": "9961398961",
            "taxOffice": ""
          },
          "customer": {
            "fullName": null,
            "address": "United States",
            "subscriberId": "liteye2440@rabitex.com"
          },
          "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": "liteye2440@rabitex.com",
        "transactionId": "0741a0ac-21d8-4750-941f-064f340700c3",
        "paymentType": "paypal",
        "code": "S0000001",
        "message": null
      }
    ]
  }
}

Successful Response Parameters

Parameter
Description

payment_type

Type of payment transaction. Can be subscription or consumable ( one-time)

subscriber_id

ID of the user making the purchase, which could be a phone number or email.

transaction_id

Unique ID of the purchase transaction used in refund transactions.

status

Contains the transaction types, possible values :

trial : A trial started

trial_to_paid : Trial converted to paid subscription

start_paid : A paid subscription started (no trial package)

renewal : Subscription renewed

reactive : User reactivated a passive subscription with a payment

consumable :Purchased a one-time package

purchase_date

Transaction execution date.

expire_date

Expiry date of the subscription purchase if applicable.

custom_parameters.paymentMethod

Specifies the payment method.

custom_parameters.cardBrand

Indicates the card brand.

transactionLog.code

It is the status code of the payment. You can view the payment codes on this page.

Failed Example Response

{
  "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"
      }
    ]
  }
}

Failed Example Response Parameters

Parameter
Description

requestId

It is the unique request parameter generated and stored by Zotlo for your transaction.

httpStatus

It is the HTTP status code related to the response. The standard codes 400 or 500 are returned.

errorMessage

It is the detail of the received error. The error message is provided in the language specific to the parameter you sent.

errorCode

It is the error code from Zotlo.

result

The values this field can take are variable.If there’s an error, it will include data; otherwise, it will return as an empty object.

⚙️
https://api.zotlo.com/v1/transaction/detail?transactionId=TRANSACTION_ID