TRtrytoku
Transactions

Listar Transactions

Changed on

Lista las Transactions de la Organization autenticada según los filtros recibidos.

Se usa para revisar el historial de cobros: devuelve una página de Transactions con su Customer, sus Payment Intents y el medio de pago con que se cobraron, más la cantidad total de resultados que cumplen los filtros.

Solo devuelve Transactions de tipo PAYMENT, REVERSED y CHARGEBACK; el filtro types puede acotar entre esos tipos y rechaza cualquier otro con 422. Para avanzar de página se incrementa page conservando el resto de los filtros.

El filtro id_bulk_charge acota el listado a las Transactions que dejó un cobro masivo, usando el identificador de lote que devolvió POST /public/{country_iso}/charge/bulk.

El filtro id_charge_scheduled_date acota el listado a las Transactions que originó una fecha de cobro programada, es decir, las que se mandaron a cobro en esa fecha.

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

get/transactions

Request

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

Query parameters

page_sizeinteger

Cantidad de Transactions por página.

pageinteger

Página que se quiere devolver; la primera es la 1.

integer
OR
string
integer
OR
string
integer
OR
string
integer
OR
string
integer
OR
string
id_bulk_chargestring

Identificador del lote de cobro que devolvió POST /public/{country_iso}/charge/bulk, con que se listan las Transactions que dejó ese lote.

id_charge_scheduled_datestring

Identificador de la fecha de cobro programada (charge scheduled date) que originó las Transactions, con que se listan las que se mandaron a cobro en esa fecha.

external_idstring

Referencia externa que la Organization asignó a la Transaction.

provider_external_idstring

Referencia que el proveedor de pago asignó a la Transaction.

tokenstring

Token con que quedó registrado el medio de pago usado en la Transaction.

status'INITIALIZED' | 'SUCCESS' | 'FAILED' | 'FAILED_INIT' | 'ABORTED' | 'CAPTURE_PENDING'

Estado de una Transaction. INITIALIZED es el intento ya creado y todavía sin resolver; SUCCESS y FAILED son sus dos desenlaces, y ABORTED es el intento cancelado antes de resolverse, ya sea por una cancelación explícita o porque venció su plazo de expiración. CAPTURE_PENDING solo aparece en los cobros con captura diferida: el monto quedó autorizado y espera la captura, que lo lleva a SUCCESS. FAILED_INIT está deprecado: ninguna Transaction nueva lo alcanza y solo sobrevive en registros históricos.

Estado en que está la Transaction.

start_datestring date-time

Fecha desde la que se incluyen Transactions, comparada contra su fecha de transacción. Se acepta YYYY-MM-DD, YYYY-MM-DD HH:MM:SS o YYYY-MM-DDTHH:MM:SS; cualquier otro formato responde 422.

end_datestring date-time

Fecha hasta la que se incluyen Transactions, comparada contra su fecha de transacción. Se acepta YYYY-MM-DD, YYYY-MM-DD HH:MM:SS o YYYY-MM-DDTHH:MM:SS; cualquier otro formato responde 422. Cuando se envía solo la fecha, el día indicado queda incluido completo.

typesTransactionType[]

Tipos de Transaction que se quieren listar. Si se omite, se devuelven las de tipo PAYMENT, REVERSED y CHARGEBACK; enviar cualquier otro tipo responde 422.

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

Página de Transactions que cumplen los filtros.

total_resultsinteger required

Cantidad total de Transactions que cumplen los filtros, sin considerar la paginación.

Example response

{
  "items": [
    {
      "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

  • a6ef070075b1Revision changes
    • breaking

      for the query request parameter types, default value PAYMENT REVERSED CHARGEBACK was added

    • breaking

      for the query request parameter page_size, default value was changed from 50 to 50

    • breaking

      for the query request parameter types, the minItems was increased from 0 to 1

    • breaking

      the // response's property type changed from object to no type for status

    • breaking

      the //// response's property type changed from integer to number for status

    • breaking

      the //// response's property type changed from integer to number for status

    • breaking

      the /// response's property type changed from integer to number for status

    • breaking

      the /// response's property type changed from string to no type for status

    • breaking

      the /// response's property type changed from no type to string for status

    • breaking

      the /// response's property type changed from string to no type for status

    • breaking

      the /// response's property type changed from string to no type for status

    • breaking

      the /// response's property type changed from no type to string for status

    • warning

      for the query request parameter page_size, the max was set to 100.00

    • warning

      for the query request parameter page, the min was set to 1.00

    • warning

      for the query request parameter page_size, the min was set to 1.00

    • warning

      removed the optional property /// from the response with the status

    • warning

      removed the optional property /// from the response with the status

    • warning

      removed the optional property /// from the response with the status

    • warning

      removed the optional property /// from the response with the status

    • warning

      removed the optional property /// from the response with the status

    • warning

      removed the optional property /// from the response with the status

    • warning

      removed the optional property //// from the response with the status

    • warning

      added the new ABORTED enum value to the //// response property for the response status

    • warning

      added the new AUTHORIZED enum value to the //// response property for the response status

    • warning

      added the new BRL enum value to the //// response property for the response status

    • warning

      added the new CHARGEBACK enum value to the //// response property for the response status

    • warning

      added the new CLF enum value to the //// response property for the response status

    • warning

      added the new CLP enum value to the //// response property for the response status

    • warning

      added the new CONSTRAINTS_VIOLATED enum value to the //// response property for the response status

    • warning

      added the new DELETED enum value to the //// response property for the response status

    • warning

      added the new EXPIRED enum value to the //// response property for the response status

    • warning

      added the new FAILED enum value to the //// response property for the response status

    • warning

      added the new INITIALIZED enum value to the //// response property for the response status

    • warning

      added the new INITIALIZED_NON_BLOCKING enum value to the //// response property for the response status

    • warning

      added the new MXN enum value to the //// response property for the response status

    • warning

      added the new PAC_CREATED enum value to the //// response property for the response status

    • warning

      added the new PAC_PENDING enum value to the //// response property for the response status

    • warning

      added the new REFUNDED enum value to the //// response property for the response status

    • warning

      added the new REFUND_FAILED enum value to the //// response property for the response status

    • warning

      added the new REFUND_INITIALIZED enum value to the //// response property for the response status

    • warning

      added the new USD enum value to the //// response property for the response status

    • warning

      added the new amex_batch_mx_recurring_pst enum value to the //// response property for the response status

    • warning

      added the new arcus_transfer enum value to the //// response property for the response status

    • warning

      added the new belvo enum value to the //// response property for the response status

    • warning

      added the new br_banco_bradesco_boleto enum value to the //// response property for the response status

    • warning

      added the new br_banco_bradesco_pix enum value to the //// response property for the response status

    • warning

      added the new br_banco_citibank enum value to the //// response property for the response status

    • warning

      added the new br_banco_de_brasilia enum value to the //// response property for the response status

    • warning

      added the new br_banco_de_brasilia_via_accesstage enum value to the //// response property for the response status

    • warning

      added the new br_banco_do_brasil enum value to the //// response property for the response status

    • warning

      added the new br_banco_do_brasil_via_accesstage enum value to the //// response property for the response status

    • warning

      added the new br_banco_itau enum value to the //// response property for the response status

    • warning

      added the new br_banco_itau_boleto enum value to the //// response property for the response status

    • warning

      added the new br_banco_santander enum value to the //// response property for the response status

    • warning

      added the new br_bradesco_via_accesstage enum value to the //// response property for the response status

    • warning

      added the new br_btg enum value to the //// response property for the response status

    • warning

      added the new br_c6_via_accesstage enum value to the //// response property for the response status

    • warning

      added the new br_caixa enum value to the //// response property for the response status

    • warning

      added the new br_caixa_via_accesstage enum value to the //// response property for the response status

    • warning

      added the new br_itau_via_accesstage enum value to the //// response property for the response status

    • warning

      added the new br_paulista_servicios_automatic_debit enum value to the //// response property for the response status

    • warning

      added the new br_santander_via_accesstage enum value to the //// response property for the response status

    • warning

      added the new br_sicoob enum value to the //// response property for the response status

    • warning

      added the new br_sicoob_via_accesstage enum value to the //// response property for the response status

    • warning

      added the new br_sicredi_boleto enum value to the //// response property for the response status

    • warning

      added the new braintree enum value to the //// response property for the response status

    • warning

      added the new cards_batch_mx_recurring_pst enum value to the //// response property for the response status

    • warning

      added the new cash_pickup enum value to the //// response property for the response status

    • warning

      added the new cielo enum value to the //// response property for the response status

    • warning

      added the new cl_banco_bci enum value to the //// response property for the response status

    • warning

      added the new cl_banco_consorcio_fidi enum value to the //// response property for the response status

    • warning

      added the new cl_banco_de_chile enum value to the //// response property for the response status

    • warning

      added the new cl_banco_santander enum value to the //// response property for the response status

    • warning

      added the new cl_banco_scotiabank enum value to the //// response property for the response status

    • warning

      added the new cl_banco_security enum value to the //// response property for the response status

    • warning

      added the new cobre_transfer enum value to the //// response property for the response status

    • warning

      added the new codi enum value to the //// response property for the response status

    • warning

      added the new codi_qr enum value to the //// response property for the response status

    • warning

      added the new conciliation enum value to the //// response property for the response status

    • warning

      added the new conekta enum value to the //// response property for the response status

    • warning

      added the new dapp enum value to the //// response property for the response status

    • warning

      added the new domiciliation enum value to the //// response property for the response status

    • warning

      added the new ecert_pac enum value to the //// response property for the response status

    • warning

      added the new evo_payments enum value to the //// response property for the response status

    • warning

      added the new external_pac enum value to the //// response property for the response status

    • warning

      added the new external_payment enum value to the //// response property for the response status

    • warning

      added the new fintoc_pac enum value to the //// response property for the response status

    • warning

      added the new fintoc_transfer enum value to the //// response property for the response status

    • warning

      added the new fiserv enum value to the //// response property for the response status

    • warning

      added the new floid_transfer enum value to the //// response property for the response status

    • warning

      added the new getnet enum value to the //// response property for the response status

    • warning

      added the new getnet_pos enum value to the //// response property for the response status

    • warning

      added the new iniciador enum value to the //// response property for the response status

    • warning

      added the new internal_balance enum value to the //// response property for the response status

    • warning

      added the new internal_psp enum value to the //// response property for the response status

    • warning

      added the new khipu_transfer enum value to the //// response property for the response status

    • warning

      added the new klap_oneclick enum value to the //// response property for the response status

    • warning

      added the new kushki enum value to the //// response property for the response status

    • warning

      added the new manual_pac enum value to the //// response property for the response status

    • warning

      added the new mercadopago enum value to the //// response property for the response status

    • warning

      added the new mit enum value to the //// response property for the response status

    • warning

      added the new monex_transfer enum value to the //// response property for the response status

    • warning

      added the new multigateway_onetime enum value to the //// response property for the response status

    • warning

      added the new mx_amex enum value to the //// response property for the response status

    • warning

      added the new mx_banco_banbajio enum value to the //// response property for the response status

    • warning

      added the new mx_banco_bancomer enum value to the //// response property for the response status

    • warning

      added the new mx_banco_banorte enum value to the //// response property for the response status

    • warning

      added the new mx_banco_banorte_h2h enum value to the //// response property for the response status

    • warning

      added the new mx_banco_banregio enum value to the //// response property for the response status

    • warning

      added the new mx_banco_bbva enum value to the //// response property for the response status

    • warning

      added the new mx_banco_bbva_bancomer enum value to the //// response property for the response status

    • warning

      added the new mx_banco_citibanamex enum value to the //// response property for the response status

    • warning

      added the new mx_banco_hsbc enum value to the //// response property for the response status

    • warning

      added the new mx_banco_multiva enum value to the //// response property for the response status

    • warning

      added the new mx_banco_sabadell enum value to the //// response property for the response status

    • warning

      added the new mx_banco_santander enum value to the //// response property for the response status

    • warning

      added the new mx_banco_scotiabank enum value to the //// response property for the response status

    • warning

      added the new mx_banco_scotiabank_h2h_external enum value to the //// response property for the response status

    • warning

      added the new mx_bbva_cie enum value to the //// response property for the response status

    • warning

      added the new mx_belvo enum value to the //// response property for the response status

    • warning

      added the new one_time enum value to the //// response property for the response status

    • warning

      added the new openpay enum value to the //// response property for the response status

    • warning

      added the new oxxo enum value to the //// response property for the response status

    • warning

      added the new pagarme enum value to the //// response property for the response status

    • warning

      added the new patpass enum value to the //// response property for the response status

    • warning

      added the new paycash enum value to the //// response property for the response status

    • warning

      added the new payment_orchestration enum value to the //// response property for the response status

    • warning

      added the new paypal enum value to the //// response property for the response status

    • warning

      added the new pb_transfer_cl_banco_bci enum value to the //// response property for the response status

    • warning

      added the new pb_transfer_cl_banco_bci-native enum value to the //// response property for the response status

    • warning

      added the new pb_transfer_cl_banco_bci-serviex enum value to the //// response property for the response status

    • warning

      added the new pb_transfer_cl_banco_bci_direct enum value to the //// response property for the response status

    • warning

      added the new pb_transfer_cl_banco_bice enum value to the //// response property for the response status

    • warning

      added the new pb_transfer_cl_banco_de_chile enum value to the //// response property for the response status

    • warning

      added the new pb_transfer_cl_banco_de_chile-evertec enum value to the //// response property for the response status

    • warning

      added the new pb_transfer_cl_banco_estado enum value to the //// response property for the response status

    • warning

      added the new pb_transfer_cl_banco_falabella enum value to the //// response property for the response status

    • warning

      added the new pb_transfer_cl_banco_itau enum value to the //// response property for the response status

    • warning

      added the new pb_transfer_cl_banco_itau-evertec enum value to the //// response property for the response status

    • warning

      added the new pb_transfer_cl_banco_santander enum value to the //// response property for the response status

    • warning

      added the new pb_transfer_cl_banco_santander-evertec enum value to the //// response property for the response status

    • warning

      added the new pb_transfer_cl_banco_santander-native enum value to the //// response property for the response status

    • warning

      added the new pb_transfer_cl_banco_santander_direct enum value to the //// response property for the response status

    • warning

      added the new pb_transfer_cl_banco_scotiabank enum value to the //// response property for the response status

    • warning

      added the new pb_transfer_cl_banco_scotiabank-native enum value to the //// response property for the response status

    • warning

      added the new pb_transfer_cl_banco_scotiabank_direct enum value to the //// response property for the response status

    • warning

      added the new po_conekta enum value to the //// response property for the response status

    • warning

      added the new po_evo_payments enum value to the //// response property for the response status

    • warning

      added the new po_fiserv enum value to the //// response property for the response status

    • warning

      added the new po_kushki enum value to the //// response property for the response status

    • warning

      added the new po_mit enum value to the //// response property for the response status

    • warning

      added the new po_open_pay enum value to the //// response property for the response status

    • warning

      added the new po_paypal enum value to the //// response property for the response status

    • warning

      added the new po_rapyd enum value to the //// response property for the response status

    • warning

      added the new po_stripe enum value to the //// response property for the response status

    • warning

      added the new puntored enum value to the //// response property for the response status

    • warning

      added the new qi_tech enum value to the //// response property for the response status

    • warning

      added the new rapyd enum value to the //// response property for the response status

    • warning

      added the new recurring enum value to the //// response property for the response status

    • warning

      added the new rede enum value to the //// response property for the response status

    • warning

      added the new scotiabank_cashier enum value to the //// response property for the response status

    • warning

      added the new sencillito_cashier enum value to the //// response property for the response status

    • warning

      added the new sencillito_web enum value to the //// response property for the response status

    • warning

      added the new servipag enum value to the //// response property for the response status

    • warning

      added the new servipag_button enum value to the //// response property for the response status

    • warning

      added the new servipag_caja_express enum value to the //// response property for the response status

    • warning

      added the new servipag_caja_presencial enum value to the //// response property for the response status

    • warning

      added the new servipag_cashier enum value to the //// response property for the response status

    • warning

      added the new servipag_express enum value to the //// response property for the response status

    • warning

      added the new servipag_portal enum value to the //// response property for the response status

    • warning

      added the new servipag_web enum value to the //// response property for the response status

    • warning

      added the new stp_transfer enum value to the //// response property for the response status

    • warning

      added the new stripe enum value to the //// response property for the response status

    • warning

      added the new tapi enum value to the //// response property for the response status

    • warning

      added the new toku_gateways_conekta enum value to the //// response property for the response status

    • warning

      added the new toku_gateways_mercado_pago enum value to the //// response property for the response status

    • warning

      added the new toku_gateways_net_pay enum value to the //// response property for the response status

    • warning

      added the new toku_gateways_open_pay enum value to the //// response property for the response status

    • warning

      added the new toku_gateways_pay_u enum value to the //// response property for the response status

    • warning

      added the new toku_gateways_paypal enum value to the //// response property for the response status

    • warning

      added the new toku_gateways_stripe enum value to the //// response property for the response status

    • warning

      added the new toku_mx_banco_bbva_bancomer enum value to the //// response property for the response status

    • warning

      added the new toku_mx_belvo enum value to the //// response property for the response status

    • warning

      added the new toku_onetime enum value to the //// response property for the response status

    • warning

      added the new toku_pac enum value to the //// response property for the response status

    • warning

      added the new toku_transfer enum value to the //// response property for the response status

    • warning

      added the new transbank enum value to the //// response property for the response status

    • warning

      added the new transbank_oneclick enum value to the //// response property for the response status

    • warning

      added the new transbank_webpay_plus enum value to the //// response property for the response status

    • warning

      added the new transdata enum value to the //// response property for the response status

    • warning

      added the new unired enum value to the //// response property for the response status

    • warning

      added the new universo_pac enum value to the //// response property for the response status

    • warning

      added the new worldpay enum value to the //// response property for the response status

    • info

      api operation id list-all-transactions removed and replaced with get_public_transactions

    • info

      api tag Transactions added

    • info

      added the new optional header request parameter x-account-key

    • info

      added the new optional header request parameter x-api-version

    • info

      added the new optional query request parameter id_bulk_charge

    • info

      added the new optional query request parameter id_charge_scheduled_date

    • info

      added the new optional query request parameter id_customer_action_metadata

    • info

      added the new optional query request parameter provider_external_id

    • info

      the query request parameter page became optional

    • info

      query request parameter id_customer list-of-types was widened by adding types integer

    • info

      query request parameter id_invoice list-of-types was widened by adding types integer

    • info

      query request parameter id_payment_method list-of-types was widened by adding types integer

    • info

      query request parameter id_payout list-of-types was widened by adding types integer

    • info

      for the query request parameter id_customer, the type was generalized from string to no type

    • info

      for the query request parameter id_invoice, the type was generalized from string to no type

    • info

      for the query request parameter id_payment_method, the type was generalized from string to no type

    • info

      for the query request parameter id_payout, the type was generalized from string to no type

    • info

      for the query request parameter page, the format was generalized from int32 to no format

    • info

      for the query request parameter page_size, the format was generalized from int32 to no format

    • info

      for the query request parameter status, the type was generalized from string to no type

    • info

      for the query request parameter types, the type was generalized from string to array

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      removed the non-success response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property //// to the response with the status

    • info

      added the optional property //// to the response with the status

    • info

      added the optional property //// to the response with the status

    • info

      added the optional property //// to the response with the status

    • info

      added the optional property //// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added to the /// response property allOf list for the response status

    • info

      added to the /// response property allOf list for the response status

    • info

      added to the /// response property allOf list for the response status

    • info

      added to the // response property anyOf list for the response status

    • info

      the response property became required for the status

    • info

      the response property /// became required for the status

    • info

      the response property // became required for the status

    • info

      the response property //// became required for the status

    • info

      the response property //// became required for the status

    • info

      the response property //// became required for the status

    • info

      the response property //// became required for the status

    • info

      the response property //// became required for the status

    • info

      the response property //// became required for the status

    • info

      the response property //// became required for the status

    • info

      the response property //// became required for the status

    • info

      the response property //// became required for the status

    • info

      the response property // became required for the status

    • info

      the response property /// became required for the status

    • info

      the response property /// became required for the status

    • info

      the response property /// became required for the status

    • info

      the response property /// became required for the status

    • info

      the response property /// became required for the status

    • info

      the response property /// became required for the status

    • info

      the response property /// became required for the status

    • info

      the response property // became required for the status

    • info

      the response property became required for the status

    • info

      the response's property default value 0 was removed for the status

    • info

      the response's property default value 0 was removed for the status

    • info

      the response's property default value 0 was removed for the status

    • info

      the response's property default value 0 was removed for the status

    • info

      added the required property // to the response with the status

    • info

      added the required property //// to the response with the status

    • info

      added the required property //// to the response with the status

    • info

      added the required property //// to the response with the status