---
title: "Get Transaction Status"
method: GET
path: "/transactions/{transaction_id}/"
tags: ["Direct Integration"]
---

# Get Transaction Status

`GET /transactions/{transaction_id}/`

Retrieve the current status and details of any transaction (payment or withdrawal). 
This is essential for monitoring transaction progress, especially for asynchronous 
payment methods like SPEI transfers and cash payments.

## Path parameters

- `transaction_id` string, uuid, required

## Response `200`

Transaction status retrieved successfully

- DirectTransactionStatusResponse
  - `id` string, uuid — Unique transaction identifier
  - `operation_type` 'payment' | 'withdrawal' — Type of transaction
  - `status` 'pending' | 'on_hold' | 'processing' | 'sent_to_provider' | 'success' | 'paid_full' | 'in_transit' | 'authorized' | 'canceled' | 'declined' | 'rejected' | 'failed' | 'Unknown' | 'expired' — Current transaction status
  - `amount` number — Transaction amount
  - `currency` string — Currency code
  - `client_reference` string — Your reference identifier
  - `payment_id` integer — Payment ID (for payments)
  - `transaction_id` string — Provider transaction ID
  - `provider` string — Payment provider used
  - `created_at` string, date-time — ISO 8601 timestamp of creation
  - `status_code` integer — HTTP status code
  - `next_action` DirectNextAction
    - `redirect_to_url` object
      - `url` string, uri — URL to redirect customer for 3DS authentication
      - `return_url` string, uri — URL to return after 3DS completion
      - `verify_transaction_status_url` string — URL to check transaction status after 3DS
  - `payment_instructions` DirectPaymentInstructions
    - `reference` string — Payment reference code
    - `account_number` string — Account number for transfer
    - `bank_name` string — Bank name
    - `amount` number — Amount to pay
    - `expires_at` string, date-time — Payment expiration time
    - `reference_code` string — Reference code for cash payments
    - `barcode` string — Barcode for cash payments
    - `store_name` string — Store name for cash payments
    - `expiration_date` string, date-time — Payment expiration date
    - `instructions` string[] — Payment instructions
    - `voucher_pdf` string, uri — URL to payment voucher PDF
  - `updated_at` string, date-time — ISO 8601 timestamp of last update
  - `completion_details` DirectCompletionDetails
    - `completed_at` string, date-time — Completion timestamp
    - `authorization_code` string — Authorization code
  - `transfer_details` DirectTransferDetails
    - `transfer_method` 'SPEI' | 'DEBIT_CARD' — Transfer method used
    - `beneficiary_account` string — Masked beneficiary account
    - `estimated_completion` string, date-time — Estimated completion time

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Transaction Not Found
- `500` — Server Error

---

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