---
title: "Get full internal detail for a transaction (admin/debug): merchant, payment-request and provider references, fees, refunds/reversals, and an optional unified event timeline."
method: GET
path: "/api/v1/admin/transactions/{transactionId}"
tags: ["Transactions", "Admin"]
---

# Get full internal detail for a transaction (admin/debug): merchant, payment-request and provider references, fees, refunds/reversals, and an optional unified event timeline.

`GET /api/v1/admin/transactions/{transactionId}`

Get full internal detail for a transaction (admin/debug): merchant, payment-request and provider references, fees, refunds/reversals, and an optional unified event timeline.

## Path parameters

- `transactionId` string, uuid, required — Transaction ID

## Query parameters

- `include_timeline` boolean — Include the unified, event-ordered timeline across the payment and its refunds/reversals
- `include_payloads` boolean — Include raw webhook/provider payloads in timeline event details

## Response `200`

Success

- TransactionAdminDetailResponse — Full internal detail for a transaction (admin/debug only): merchant, payment-request and provider references, fees, refunds/reversals, and an optional unified event timeline.
  - `success` boolean, required
  - `data` object, required
    - `transaction` object, required
      - `id` string, uuid, required
      - `transaction_number` string, required
      - `transaction_type` 'payment' | 'refund' | 'reversal', required
      - `status` string, required
      - `status_message` string, nullable, required
      - `target_status` string, nullable, required
      - `amount` number, required — Amount in decimal format
      - `currency` object, required
        - `code` string, required — ISO 4217 currency code
        - `symbol` string, required — Currency symbol
        - `name` string, required — Currency name
        - `minor_unit` number, required — Number of decimal places
      - `cross_border` boolean, required
      - `cross_border_provider` string, nullable, required
      - `deposit_country` string, required
      - `payout_country` string, required
      - `payout_currency` object, nullable, required
        - `code` string, required — ISO 4217 currency code
        - `symbol` string, required — Currency symbol
        - `name` string, required — Currency name
        - `minor_unit` number, required — Number of decimal places
      - `exchange_rate` number, nullable, required
      - `converted_amount` number, nullable, required
      - `tpp_transaction_id` string, nullable, required
      - `bank_provider_transaction_id` string, nullable, required
      - `tpp_created_at` string, date-time, nullable, required
      - `tpp_updated_at` string, date-time, nullable, required
      - `payment_scheme` string, nullable, required
      - `remittance_information` string, nullable, required
      - `customer_account` string, nullable, required
      - `customer_account_type` string, nullable, required
      - `customer_bank_name` string, nullable, required
      - `customer_name` string, nullable, required
      - `destination_account` string, nullable, required
      - `destination_account_type` string, nullable, required
      - `destination_account_holder_name` string, nullable, required
      - `payout_at` string, date-time, nullable, required
      - `payout_batch_id` string, nullable, required
      - `invoice_id` string, nullable, required
      - `settled_at` string, date-time, nullable, required
      - `webhook_status` string, nullable, required
      - `webhook_error_message` string, nullable, required
      - `related_transaction` object, nullable, required
        - `id` string, uuid, required
        - `transaction_number` string, required
      - `test` boolean, nullable, required
      - `platform` string, nullable, required
      - `created_at` string, date-time, required
      - `updated_at` string, date-time, required
      - `problems` object[]
        - `code` string, required — Error code identifying the problem
        - `message` string, required — Human-readable description of the problem
        - `label` string, required — Display label for the problem
        - `is_resolvable` boolean, required — Whether the problem can be resolved by providing additional data
      - `refund_status` union, required — Current refund status for payment transactions
        - 'refunding'
        - 'refunding_stuck'
        - 'refunding_failed'
        - 'partially_refunded'
        - 'fully_refunded'
      - `payment_request` object, nullable, required
        - `id` string, uuid, required
        - `order_id` string, nullable, required
        - `status` string, required
        - `external_payment_request_id` string, nullable, required
        - `provider_name` string, nullable, required
        - `provider_environment` string, nullable, required
        - `tink_request_id` string, nullable, required
        - `provider_request_id` string, nullable, required
        - `payment_token` string, nullable, required
        - `payment_token_expires_at` string, date-time, nullable, required
        - `payment_reference` string, nullable, required
        - `selected_bank_id` string, nullable, required
        - `payment_link_id` string, nullable, required
        - `session_id` string, nullable, required
        - `locale` string, nullable, required
        - `original_amount` string, nullable, required
        - `original_currency` string, nullable, required
        - `display_exchange_rate` union, required
          - string
          - number
        - `authorization_agreement_record_id` string, nullable, required
        - `merchant` object, nullable, required
          - `id` string, uuid, required
          - `brand_name` string, required
          - `uri` string, required
          - `mode` string, required
          - `country` string, nullable, required
          - `partner` object, nullable, required
            - `id` string, uuid, required
        - `customer` object, nullable, required
          - `id` string, uuid, required
          - `name` string, required
          - `email` string, nullable, required
          - `customer_identifier` string, nullable, required
          - `provider_ids` unknown
      - `fees` object, required
        - `total` number, required — Total fees in decimal format
        - `currency` object, required
          - `code` string, required — ISO 4217 currency code
          - `symbol` string, required — Currency symbol
          - `name` string, required — Currency name
          - `minor_unit` number, required — Number of decimal places
        - `items` object[], required
          - `id` string, uuid, required
          - `amount` number, required — Fee amount in decimal format
          - `currency` object, required
            - `code` string, required — ISO 4217 currency code
            - `symbol` string, required — Currency symbol
            - `name` string, required — Currency name
            - `minor_unit` number, required — Number of decimal places
          - `fee_type` string, required
          - `rate_type` string, required
          - `rate_value` string, required
          - `rate_unit` string, required
          - `rate_base` string, required
          - `notes` string, nullable, required
          - `settlement_status` string, required
          - `invoice_id` string, uuid, nullable, required
          - `settled_at` string, date-time, nullable, required
          - `created_at` string, date-time, required
          - `updated_at` string, date-time, required
      - `can_refund` boolean, required
      - `provider_status_events` object[], required
        - `id` string, uuid, required
        - `source` 'webhook' | 'polling' | 'finalization' | 'admin', required
        - `provider_name` string, required
        - `provider_status` string, required
        - `processing_status` 'received' | 'processed' | 'ignored' | 'failed' | 'conflict' | 'stale', required
        - `provider_updated_at` string, date-time, nullable, required
        - `created_at` string, date-time, required
        - `observed_at` string, date-time, required
        - `signature_valid` boolean, required
        - `event_id` string
        - `event_type` string
        - `processing_error` string
        - `provider_request_id` string
      - `merchant_webhook_deliveries` object[], required
        - `id` string, uuid, required
        - `payment_provider_status_id` string, uuid, nullable, required — Optional ID of the PaymentProviderStatus event that triggered this delivery
        - `webhook_url` string, required — The URL the webhook was sent to
        - `platform` 'embedded' | 'shopify' | 'woocommerce', required — Platform type
        - `event_type` string, required — Event type sent
        - `status` 'delivered' | 'failed', required — Delivery status
        - `response_status_code` number, nullable, required — HTTP response status code from merchant endpoint
        - `error_message` string — Error message if delivery failed
        - `duration_ms` number, nullable, required — Request duration in milliseconds
        - `created_at` string, date-time, required
      - `refunds` object[]
        - `id` string, uuid, required
        - `transaction_number` string, required
        - `transaction_type` 'payment' | 'refund' | 'reversal', required
        - `status` string, required
        - `status_message` string, nullable, required
        - `target_status` string, nullable, required
        - `amount` number, required — Amount in decimal format
        - `currency` object, required
          - `code` string, required — ISO 4217 currency code
          - `symbol` string, required — Currency symbol
          - `name` string, required — Currency name
          - `minor_unit` number, required — Number of decimal places
        - `cross_border` boolean, required
        - `cross_border_provider` string, nullable, required
        - `deposit_country` string, required
        - `payout_country` string, required
        - `payout_currency` object, nullable, required
          - `code` string, required — ISO 4217 currency code
          - `symbol` string, required — Currency symbol
          - `name` string, required — Currency name
          - `minor_unit` number, required — Number of decimal places
        - `exchange_rate` number, nullable, required
        - `converted_amount` number, nullable, required
        - `tpp_transaction_id` string, nullable, required
        - `bank_provider_transaction_id` string, nullable, required
        - `tpp_created_at` string, date-time, nullable, required
        - `tpp_updated_at` string, date-time, nullable, required
        - `payment_scheme` string, nullable, required
        - `remittance_information` string, nullable, required
        - `customer_account` string, nullable, required
        - `customer_account_type` string, nullable, required
        - `customer_bank_name` string, nullable, required
        - `customer_name` string, nullable, required
        - `destination_account` string, nullable, required
        - `destination_account_type` string, nullable, required
        - `destination_account_holder_name` string, nullable, required
        - `payout_at` string, date-time, nullable, required
        - `payout_batch_id` string, nullable, required
        - `invoice_id` string, nullable, required
        - `settled_at` string, date-time, nullable, required
        - `webhook_status` string, nullable, required
        - `webhook_error_message` string, nullable, required
        - `related_transaction` object, nullable, required
          - `id` string, uuid, required
          - `transaction_number` string, required
        - `test` boolean, nullable, required
        - `platform` string, nullable, required
        - `created_at` string, date-time, required
        - `updated_at` string, date-time, required
        - `problems` object[]
          - `code` string, required — Error code identifying the problem
          - `message` string, required — Human-readable description of the problem
          - `label` string, required — Display label for the problem
          - `is_resolvable` boolean, required — Whether the problem can be resolved by providing additional data
        - `refund_status` union, required — Current refund status for payment transactions
          - 'refunding'
          - 'refunding_stuck'
          - 'refunding_failed'
          - 'partially_refunded'
          - 'fully_refunded'
        - `payment_request` object, nullable, required
          - `id` string, uuid, required
          - `order_id` string, nullable, required
          - `status` string, required
          - `external_payment_request_id` string, nullable, required
          - `provider_name` string, nullable, required
          - `provider_environment` string, nullable, required
          - `tink_request_id` string, nullable, required
          - `provider_request_id` string, nullable, required
          - `payment_token` string, nullable, required
          - `payment_token_expires_at` string, date-time, nullable, required
          - `payment_reference` string, nullable, required
          - `selected_bank_id` string, nullable, required
          - `payment_link_id` string, nullable, required
          - `session_id` string, nullable, required
          - `locale` string, nullable, required
          - `original_amount` string, nullable, required
          - `original_currency` string, nullable, required
          - `display_exchange_rate` union, required
            - string
            - number
          - `authorization_agreement_record_id` string, nullable, required
          - `merchant` object, nullable, required
            - `id` string, uuid, required
            - `brand_name` string, required
            - `uri` string, required
            - `mode` string, required
            - `country` string, nullable, required
            - `partner` object, nullable, required
              - …
          - `customer` object, nullable, required
            - `id` string, uuid, required
            - `name` string, required
            - `email` string, nullable, required
            - `customer_identifier` string, nullable, required
            - `provider_ids` unknown
        - `fees` object, required
          - `total` number, required — Total fees in decimal format
          - `currency` object, required
            - `code` string, required — ISO 4217 currency code
            - `symbol` string, required — Currency symbol
            - `name` string, required — Currency name
            - `minor_unit` number, required — Number of decimal places
          - `items` object[], required
            - `id` string, uuid, required
            - `amount` number, required — Fee amount in decimal format
            - `currency` object, required
              - …
            - `fee_type` string, required
            - `rate_type` string, required
            - `rate_value` string, required
            - `rate_unit` string, required
            - `rate_base` string, required
            - `notes` string, nullable, required
            - `settlement_status` string, required
            - `invoice_id` string, uuid, nullable, required
            - `settled_at` string, date-time, nullable, required
            - `created_at` string, date-time, required
            - `updated_at` string, date-time, required
      - `reversals` object[]
        - `id` string, uuid, required
        - `transaction_number` string, required
        - `transaction_type` 'payment' | 'refund' | 'reversal', required
        - `status` string, required
        - `status_message` string, nullable, required
        - `target_status` string, nullable, required
        - `amount` number, required — Amount in decimal format
        - `currency` object, required
          - `code` string, required — ISO 4217 currency code
          - `symbol` string, required — Currency symbol
          - `name` string, required — Currency name
          - `minor_unit` number, required — Number of decimal places
        - `cross_border` boolean, required
        - `cross_border_provider` string, nullable, required
        - `deposit_country` string, required
        - `payout_country` string, required
        - `payout_currency` object, nullable, required
          - `code` string, required — ISO 4217 currency code
          - `symbol` string, required — Currency symbol
          - `name` string, required — Currency name
          - `minor_unit` number, required — Number of decimal places
        - `exchange_rate` number, nullable, required
        - `converted_amount` number, nullable, required
        - `tpp_transaction_id` string, nullable, required
        - `bank_provider_transaction_id` string, nullable, required
        - `tpp_created_at` string, date-time, nullable, required
        - `tpp_updated_at` string, date-time, nullable, required
        - `payment_scheme` string, nullable, required
        - `remittance_information` string, nullable, required
        - `customer_account` string, nullable, required
        - `customer_account_type` string, nullable, required
        - `customer_bank_name` string, nullable, required
        - `customer_name` string, nullable, required
        - `destination_account` string, nullable, required
        - `destination_account_type` string, nullable, required
        - `destination_account_holder_name` string, nullable, required
        - `payout_at` string, date-time, nullable, required
        - `payout_batch_id` string, nullable, required
        - `invoice_id` string, nullable, required
        - `settled_at` string, date-time, nullable, required
        - `webhook_status` string, nullable, required
        - `webhook_error_message` string, nullable, required
        - `related_transaction` object, nullable, required
          - `id` string, uuid, required
          - `transaction_number` string, required
        - `test` boolean, nullable, required
        - `platform` string, nullable, required
        - `created_at` string, date-time, required
        - `updated_at` string, date-time, required
        - `problems` object[]
          - `code` string, required — Error code identifying the problem
          - `message` string, required — Human-readable description of the problem
          - `label` string, required — Display label for the problem
          - `is_resolvable` boolean, required — Whether the problem can be resolved by providing additional data
        - `refund_status` union, required — Current refund status for payment transactions
          - 'refunding'
          - 'refunding_stuck'
          - 'refunding_failed'
          - 'partially_refunded'
          - 'fully_refunded'
        - `payment_request` object, nullable, required
          - `id` string, uuid, required
          - `order_id` string, nullable, required
          - `status` string, required
          - `external_payment_request_id` string, nullable, required
          - `provider_name` string, nullable, required
          - `provider_environment` string, nullable, required
          - `tink_request_id` string, nullable, required
          - `provider_request_id` string, nullable, required
          - `payment_token` string, nullable, required
          - `payment_token_expires_at` string, date-time, nullable, required
          - `payment_reference` string, nullable, required
          - `selected_bank_id` string, nullable, required
          - `payment_link_id` string, nullable, required
          - `session_id` string, nullable, required
          - `locale` string, nullable, required
          - `original_amount` string, nullable, required
          - `original_currency` string, nullable, required
          - `display_exchange_rate` union, required
            - string
            - number
          - `authorization_agreement_record_id` string, nullable, required
          - `merchant` object, nullable, required
            - `id` string, uuid, required
            - `brand_name` string, required
            - `uri` string, required
            - `mode` string, required
            - `country` string, nullable, required
            - `partner` object, nullable, required
              - …
          - `customer` object, nullable, required
            - `id` string, uuid, required
            - `name` string, required
            - `email` string, nullable, required
            - `customer_identifier` string, nullable, required
            - `provider_ids` unknown
        - `fees` object, required
          - `total` number, required — Total fees in decimal format
          - `currency` object, required
            - `code` string, required — ISO 4217 currency code
            - `symbol` string, required — Currency symbol
            - `name` string, required — Currency name
            - `minor_unit` number, required — Number of decimal places
          - `items` object[], required
            - `id` string, uuid, required
            - `amount` number, required — Fee amount in decimal format
            - `currency` object, required
              - …
            - `fee_type` string, required
            - `rate_type` string, required
            - `rate_value` string, required
            - `rate_unit` string, required
            - `rate_base` string, required
            - `notes` string, nullable, required
            - `settlement_status` string, required
            - `invoice_id` string, uuid, nullable, required
            - `settled_at` string, date-time, nullable, required
            - `created_at` string, date-time, required
            - `updated_at` string, date-time, required
    - `timeline` object[] — Unified, chronological lifecycle events across the payment and its refunds/reversals. Present when include_timeline=true.
      - `id` string, required
      - `type` union, required — The type of lifecycle event
        - 'provider_status'
        - 'merchant_webhook'
        - 'tm_webhook'
        - 'tm_post_processor'
        - 'payout_batch'
        - 'refund_session'
        - 'fee'
        - 'payment_request_update'
        - 'refund'
        - 'reversal'
      - `timestamp` string, date-time, required
      - `summary` string, required — Human-readable one-line description of the event
      - `details` object, required — Event-type-specific fields
      - `source` object — The transaction this event belongs to, when the timeline is unified across a payment and its refunds/reversals
        - `kind` union, required
          - 'payment'
          - 'refund'
          - 'reversal'
        - `transaction_id` string, uuid, required
        - `transaction_number` string, required

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found

---

[API](https://skmtc.net/banqzinc/apis/quidkey-api.md) · [All operations](https://skmtc.net/banqzinc/apis/quidkey-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/banqzinc/quidkey-api/revisions/f86d2bdbcb08/schema)