Get Payment Details

This endpoint returns the detailed information about a payment processed through Zotlo. It returns the full transaction record, including payment metadata, provider response, logs, and refund information.

It is commonly used to verify purchase results, diagnose failed payments, or fetch receipt details.

Use the GET method to query a payment and transactionId is required.

Method	GET
URL	https://api.zotlo.com/v1/transaction/detail?transactionId=TRANSACTION_ID

Request Parameters

Field	Type	Description
transactionId	Required	The ID of the transaction you want to query.
isSandbox	Required	Indicates whether the subscription was created in sandbox or live mode.Send: true → sandbox false → live

Sample Request

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

You can find your AccessKey and AccessSecret in the Zotlo Panel under Developer Tools → API Keys

Sending ApplicationId is optional.

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": "[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": { ... },
        "clientUuid": "c941fc12-cac3-42f8-9790-8bb6e9f4793c",
        "dataWarehouse": { ... },
        "utm": { ... },
        "agreement": { ... },
        "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.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\", ...}",
        "responseData": "{\"isMockPayment\":true,\"success\":true}",
        "subscriberId": "[e-mail]",
        "transactionId": "0741a0ac-21d8-4750-941f-064f340700c3",
        "paymentType": "paypal",
        "code": "S0000001",
        "message": null
      }
    ]
  }
}

Key Response Fields

Field	Description
payment_type	Type of payment. subscription or consumable (one-time).
subscriber_id	The email or phone number of the user who made the purchase.
transaction_id	Unique ID of the transaction.
status	Payment or subscription action type. Possible values: trial, trial_to_paid, start_paid, renewal, reactive, consumable.
purchase_date	When the transaction was processed.
expire_date	Expiration date (for subscription transactions).
custom_parameters.paymentMethod	The payment method used.
transactionLog.code	Standardized payment status or error code. (See Payment Status Codes)

Failed Response

All failed responses follow the same standard error format. (See: Error Handling)