HomeGuíasAPI ReferenceChangelog
Log In
API Reference
  1. Recursos principales
  2. Transactions
  3. Consultas

Listar Transactions

get
https://api.trytoku.com/transactions

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.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
integer
1 to 100
Defaults to 50

Cantidad de Transactions por página.

integer
≥ 1
Defaults to 1

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

Identificador público del Customer cuyas Transactions se quieren listar.

Identificador público del Invoice que cubren las Transactions.

Identificador público del medio de pago con que se cobraron las Transactions.

Identificador público del Payout en que se liquidaron las Transactions.

Identificador público de la acción del Customer que originó las Transactions.

string

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

string

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.

string

Referencia externa que la Organization asignó a la Transaction.

string

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

string

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

string
enum

Estado en que está la Transaction.

Allowed:
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.

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.

types
array of objects
length ≥ 1
Defaults to PAYMENT,REVERSED,CHARGEBACK

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.

types
Headers
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.

string

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

Responses

Updated about 2 months ago

Did this page help you?
Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated about 2 months ago

Did this page help you?