TRtrytoku
Transactions

Obtener Transaction

Devuelve una Transaction de la Organization autenticada a partir de su identificador.

Se usa para consultar el detalle de un cobro puntual: la respuesta trae la Transaction con su Customer, sus Payment Intents y el medio de pago con que se cobró.

Responde 404 cuando la Transaction no existe, y 400 cuando su tipo no es PAYMENT, REVERSED ni CHARGEBACK.

Límite de tasa: 1 solicitud por segundo. Al superarlo, la API responde 429. Ver Límites de tasa.

get/transactions/{public_id_transaction}

Request

  • Base URL
    https://api.trytoku.com
  • URL
    https://api.trytoku.com/transactions/{public_id_transaction}
  • Auth
    API key in header x-api-key

Path parameters

public_id_transactionstring required

Identificador de la Transaction que se quiere consultar.

Headers

x-api-versionstring date

Versión del API para esta petición, como cualquier fecha YYYY-MM-DD. Fija el contrato de la respuesta; si se omite, se deriva de la fecha de creación de la organización.

Example:2026-10-08
x-account-keystring

Llave de API de una Account, para operar sobre esa Account en lugar de la principal.

Response

Transaction con su Customer, sus Payment Intents y su medio de pago.

Example response

{
  "transaction": {
    "additional_data": {
      "refund": {
        "id": "re_D8kR2mV5xQ0pT7yN4wZbL1eJsH6cF3uG",
        "reason": "Cobro duplicado"
      },
      "transaction": {
        "id": "trs_7QpK4mZ0RbS2vXhTyLnE9wJdA3cF6uGx",
        "type": "PAYMENT"
      }
    },
    "amount": 19990,
    "expiration_date": "2025-03-17T14:31:58.204671Z",
    "external_id": "cobro-marzo-2025-000123",
    "gateway": "transbank_oneclick",
    "id": "trs_7QpK4mZ0RbS2vXhTyLnE9wJdA3cF6uGx",
    "id_account": "acc_gzD0XoUTFxbUFcItpWOCqN686noSd9HQ",
    "id_charge_scheduled_date": "csd_9Kq2LwZ7pR4tV1xB6nM3cH8yJ0dF5sGa",
    "id_checkout_session": "cs_bT5xN2wQ8gLpH0vYzK4mR7eJdF1sUcA3qW9tXbNv",
    "id_organization": "org_dhn3lnrfAjFyWuyEz8Q3DFaFPnzc9bXk",
    "id_payout": "pyt_L3vQ9xW1sT6yB0nZmK8pR4eJdH2cF5uG",
    "initialization_date": "2025-03-10T14:31:58.204671Z",
    "installment_amount": 1000,
    "number_of_installments": 12,
    "original_response_message": "[51] EXCEDE SALDO MAXIMO. Intente de nuevo mas tarde",
    "provider_external_id": "123456789012345678901234567890",
    "remediation_detail": "Cobro reprocesado tras corregir el medio de pago",
    "response_code": "SUTOK0000",
    "toku_product": "toku_card_on_file",
    "transaction_date": "2025-03-10T14:32:05.482913Z",
    "transaction_metadata": {
      "card_type": "credit"
    }
  }
}

Changes

No recorded changes to this operation across all 2 revisions of this API.