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.

{
  "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).

API de Fintoc

Recursos principales

API de Payment Initiation

API de Transferencias

API de Movimientos

Direct Debit y Suscripciones

API Fiscal

API de Billing

Objeto Transfer