Skip to main content
GET
/
transactions
/
{transaction_id}
Get Transaction Status
curl --request GET \
  --url https://stage.tonder.io/api/v1/transactions/{transaction_id}/ \
  --header 'Authorization: <api-key>'
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "operation_type": "payment",
  "status": "success",
  "amount": 150,
  "currency": "MXN",
  "merchant_reference": "order-789",
  "created_at": "2024-07-26T10:30:00Z",
  "updated_at": "2024-07-26T10:32:15Z",
  "completion_details": {
    "completed_at": "2024-07-26T10:32:15Z",
    "authorization_code": "AUTH123456"
  }
}
The Authorization needs to be in the following format:Authorization: Token <YOUR_API_KEY>
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.

Authorizations

​
Authorization
string
header
required

Path Parameters

​
transaction_id
string<uuid>
required

The unique transaction identifier returned from the /process/ endpoint

Example:

"550e8400-e29b-41d4-a716-446655440000"

Response

Transaction status retrieved successfully

​
id
string<uuid>

Unique transaction identifier

​
operation_type
enum<string>

Type of transaction

Available options:
payment,
withdrawal
​
status
enum<string>

Current transaction status

Available options:
pending,
on_hold,
processing,
sent_to_provider,
success,
paid_full,
in_transit,
authorized,
canceled,
declined,
rejected,
failed,
Unknown,
expired
​
amount
number<decimal>

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
object
​
payment_instructions
object
​
updated_at
string<date-time>

ISO 8601 timestamp of last update

​
completion_details
object
​
transfer_details
object