> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fintoc.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Objeto Transfer

Un objeto `Transfer` representa dinero recibido en o enviado desde tus Account Numbers. Incluye el monto, la moneda, la dirección, la contraparte y el estado de la transferencia.

```json theme={null}
{
  "id": "tr_jKaHD105H",
  "object": "transfer",
  "account_number": {
    "id": "acno_Kasf91034gj1AD",
    "object": "account_number",
    "account_id": "acc_Jas92lf9adg94ka",
    "created_at": "2024-03-01T20:09:42.949787176Z",
    "description": "Mis payins",
    "metadata": {
      "id_cliente": "12343212"
    },
    "mode": "test",
    "number": "738969123456789120"
  },
  "amount": 2864,
  "comment": "Pago de gas",
  "counterparty": {
    "account_number": "012969123456789120",
    "account_type": "clabe",
    "holder_id": "OODC911119JL3",
    "holder_name": "Carmen Marcela",
    "institution": {
      "id": "mx_banco_bbva",
      "country": "mx",
      "name": "BBVA Mexico"
    }
  },
  "currency": "MXN",
  "direction": "inbound",
  "metadata": {},
  "mode": "test",
  "post_date": "2020-04-17T00:00:00.000Z",
  "receipt_url": "https://www.banxico.org.mx/cep/",
  "reference_id": "130824",
  "return_reason": null,
  "status": "succeeded",
  "tracking_key": "s2123423423324334",
  "transaction_date": "2020-04-17T05:12:41.462Z"
}
```

| Atributo                           | Tipo      | Descripción                                                                                                                                                                                                                      |
| :--------------------------------- | :-------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `id`                               | `string`  | Identificador único de la transfer.                                                                                                                                                                                              |
| `object`                           | `string`  | El tipo del objeto, que siempre es `transfer`.                                                                                                                                                                                   |
| `account_number`                   | `object`  | El objeto Account Number asociado a esta transfer.                                                                                                                                                                               |
| `account_number.id`                | `string`  | Identificador único del account number.                                                                                                                                                                                          |
| `account_number.object`            | `string`  | El tipo del objeto, que siempre es `account_number`.                                                                                                                                                                             |
| `account_number.account_id`        | `string`  | Account a la que apunta el Account Number.                                                                                                                                                                                       |
| `account_number.created_at`        | `string`  | Marca de tiempo de cuándo se creó el account number (en formato ISO 8601).                                                                                                                                                       |
| `account_number.description`       | `string`  | Una descripción que puedes usar para identificar fácilmente este Account Number (40 caracteres máx.).                                                                                                                            |
| `account_number.metadata`          | `object`  | Pares clave-valor opcionales asociados a este account number.                                                                                                                                                                    |
| `account_number.mode`              | `string`  | Modo de la API (`test` o `live`).                                                                                                                                                                                                |
| `account_number.number`            | `string`  | El número de cuenta (para México: CLABE) del emisor.                                                                                                                                                                             |
| `amount`                           | `integer` | El monto de la transfer en la unidad más pequeña de la moneda (por ejemplo, centavos para MXN). En Chile, las transfers no pueden superar los \$7.000.000 CLP.                                                                   |
| `comment`                          | `string`  | Un comentario o referencia proporcionado por el emisor para la transfer, visible para el destinatario. En Chile, la misma combinación monto-counterparty-comentario no puede usarse más de una vez por día (40 caracteres máx.). |
| `counterparty`                     | `object`  | Información sobre la Counterparty (emisor si es inbound, receptor si es outbound) de la transfer.                                                                                                                                |
| `counterparty.account_number`      | `string`  | El número de cuenta (en México: CLABE) del tercero de la transacción (counterparty).                                                                                                                                             |
| `counterparty.account_type`        | `string`  | El tipo de la cuenta de la counterparty. En México es uno de: `clabe`, `debit_card` o `phone_number`. Opciones para Chile: `checking`, `sight`.                                                                                  |
| `counterparty.holder_id`           | `string`  | El ID único del tercero de la transacción (counterparty).                                                                                                                                                                        |
| `counterparty.holder_name`         | `string`  | El nombre del tercero de la transacción (counterparty).                                                                                                                                                                          |
| `counterparty.institution`         | `object`  | El objeto institution con los detalles de la institución financiera del emisor.                                                                                                                                                  |
| `counterparty.institution.id`      | `string`  | Identificador único de la institución.                                                                                                                                                                                           |
| `counterparty.institution.country` | `string`  | El país donde se ubica la institución financiera (en formato ISO 3166-1 alpha-2, por ejemplo, `mx` para México).                                                                                                                 |
| `counterparty.institution.name`    | `string`  | El nombre de la institución financiera.                                                                                                                                                                                          |
| `currency`                         | `string`  | Moneda de la transfer (en formato ISO 4217, por ejemplo, MXN).                                                                                                                                                                   |
| `direction`                        | `string`  | Puede ser `inbound` (si estás recibiendo una transfer en tu Account Number) o `outbound` (si estás enviando una transfer desde tu Account).                                                                                      |
| `metadata`                         | `object`  | Pares clave-valor opcionales asociados a esta transferencia.                                                                                                                                                                     |
| `mode`                             | `string`  | Modo de la API (`test` o `live`).                                                                                                                                                                                                |
| `post_date`                        | `string`  | La fecha en que se registró la transfer (formato YYYY-MM-DD).                                                                                                                                                                    |
| `receipt_url`                      | `string`  | Una URL al comprobante de la transfer, si está disponible.                                                                                                                                                                       |
| `reference_id`                     | `string`  | Un ID de referencia único para la transfer, usado para fines de conciliación.                                                                                                                                                    |
| `return_reason`                    | `string`  | Detalles sobre por qué se devolvió la Transfer. Es `null` salvo que esté en estado `returned`.                                                                                                                                   |
| `status`                           | `string`  | El estado de la transfer. Puede ser `pending`, `succeeded`, `failed`, `returned`, `rejected` o `return_pending`.                                                                                                                 |
| `tracking_key`                     | `string`  | La clave de rastreo única de la transacción proporcionada por el sistema bancario.                                                                                                                                               |
| `transaction_date`                 | `string`  | La fecha real en que se inició la transfer (formato YYYY-MM-DD).                                                                                                                                                                 |
