Saltar al contenido principal
GET
Get a transfer
v2 · Base URL https://api.fintoc.com/v2

Autorizaciones

Authorization
string
header
requerido

Parámetros de ruta

id
string
requerido

Unique identifier of the transfer to retrieve.

Respuesta

The requested transfer.

A movement of money between one of your accounts and a counterparty. A transfer is outbound when you send money to a counterparty, or inbound when money arrives in one of your account numbers. Fintoc settles transfers over local payment rails in Chile and Mexico.

id
string
requerido

Unique identifier of the transfer.

Ejemplo:

"tr_2daFu0zqqDtZGJaSi2TGI2Mm1nN"

object
any
requerido

Type of the object. Always transfer.

account_number
object
requerido
amount
integer
requerido

Amount of the transfer, in the smallest currency unit. For MXN this is centavos; CLP has no minor unit.

Ejemplo:

50000

comment
string | null
requerido

Comment shown to the counterparty, or null.

Ejemplo:

"Payout March"

counterparty
object
requerido

Details of the counterparty of the transfer.

currency
enum<string>
requerido

Currency of the transfer. One of CLP, MXN.

Opciones disponibles:
CLP,
MXN
Ejemplo:

"MXN"

direction
enum<string>
requerido

Whether the transfer is inbound or outbound.

Opciones disponibles:
inbound,
outbound
Ejemplo:

"outbound"

entity
object
requerido

Entity that owns the account involved in the transfer. For an inbound transfer this is the entity that received the money; for an outbound transfer, the entity that sent it.

metadata
object
requerido

Set of key-value pairs attached to the transfer.

Ejemplo:
mode
enum<string>
requerido

Whether the transfer is live or test data.

Opciones disponibles:
live,
test
Ejemplo:

"test"

post_date
string<date-time> | null
requerido

Time the transfer was posted, as an ISO 8601 datetime in UTC, or null.

Ejemplo:

null

receipt_url
string | null
requerido

URL of the transfer receipt, or null.

Ejemplo:

null

reference_id
string | null
requerido

Numeric reference shown in the counterparty statement in Mexico, or null.

Ejemplo:

null

return_reason
string | null
requerido

Reason code when the transfer was returned, or null.

Ejemplo:

null

status
enum<string>
requerido

Lifecycle status of the transfer. One of pending (being processed), succeeded (settled), rejected (rejected before settling), failed (could not be processed), returned (settled, then returned to the sender), return_pending (a return is in progress), or reject_failed (the rejection could not be completed).

Opciones disponibles:
succeeded,
rejected,
failed,
pending,
returned,
return_pending,
reject_failed
Ejemplo:

"succeeded"

tracking_key
string | null
requerido

Interbank tracking key (clave de rastreo) of the transfer, or null.

Ejemplo:

null

transaction_date
string<date-time> | null
requerido

Time the transfer occurred, as an ISO 8601 datetime in UTC, or null.

Ejemplo:

"2026-03-01T12:00:00.000Z"