Objeto Account verification

Una verificación de cuenta (account verification) confirma que una cuenta bancaria de contraparte existe y pertenece al titular esperado. Fintoc emite una transferencia de verificación desde una de tus cuentas hacia la cuenta de contraparte y luego reporta el resultado a través del status de la verificación. Usa una account verification para validar una cuenta de contraparte, como un número de cuenta bancaria estandarizado mexicano (CLABE), antes de hacer un pago hacia ella.

Account verification object

{
  "id": "accv_2daFu0zqqDtZGJaSi2TGI2Mm1nN",
  "object": "account_verification",
  "counterparty": {
    "account_number": "000000000000000000",
    "account_type": "clabe",
    "holder_id": "000000000",
    "holder_name": "Test Customer 1",
    "institution": {
      "id": "40012",
      "country": "mx",
      "name": "BBVA Mexico"
    }
  },
  "mode": "test",
  "reason": null,
  "receipt_url": "https://www.banxico.org.mx/cep/",
  "status": "succeeded",
  "transaction_date": "2026-03-11T20:42:49Z",
  "transfer_id": "tr_2daFu0zqqDtZGJaSi2TGI2Mm1nN"
}

Atributo	Tipo	Descripción
`id`	string	Identificador único de la account verification.
`object`	string	Tipo del objeto. Siempre `account_verification`.
`counterparty`	object	Detalles de la cuenta de contraparte verificada. Consulta los atributos de counterparty más abajo.
`mode`	string	Uno de `live` o `test`. Las verificaciones realizadas con una API key live son `live`; las realizadas con una API key de test son `test`.
`reason`	string	Motivo por el que la verificación falló. `null` salvo que `status` sea `failed`. Consulta las razones de fallo de account verification.
`receipt_url`	string	URL del comprobante de la verificación. `null` hasta que la transferencia de verificación se liquide.
`status`	string	Estado de la verificación. Uno de `pending` (en progreso), `succeeded` (titularidad confirmada) o `failed` (no se pudo completar).
`transaction_date`	string	Fecha y hora en UTC (ISO 8601) en que se realizó la verificación. `null` hasta que la transferencia de verificación se liquide.
`transfer_id`	string	Identificador de la transferencia emitida para verificar la cuenta. `null` hasta que se cree la transferencia de verificación.

Counterparty

Atributo	Tipo	Descripción
`account_number`	string	Número de cuenta de la contraparte verificada. El número de cuenta bancaria estandarizado mexicano (CLABE) de 18 dígitos.
`account_type`	string	Tipo de cuenta de la contraparte, en minúsculas. Siempre `clabe` para verificaciones de cuentas mexicanas.
`holder_id`	string	Identificador fiscal del titular de la cuenta. El RFC mexicano. `null` cuando no está disponible.
`holder_name`	string	Nombre del titular de la cuenta. `null` cuando no está disponible.
`institution`	object	Institución financiera de la contraparte. Consulta los atributos de institution más abajo.

Institution

Atributo	Tipo	Descripción
`id`	string	Identificador de la institución. Consulta los códigos de instituciones de México (Banxico).
`country`	string	Código de país ISO 3166-1 alpha-2 de la institución, en minúsculas. Siempre `mx`.
`name`	string	Nombre de la institución.

Razones de fallo de account verification

Razón	Descripción
`transfer_fail`	Fintoc no pudo enviar la transferencia de verificación.
`cep_unavailable`	Banxico no publicó el Comprobante Electrónico de Pago (CEP) antes de que la verificación expirara, alrededor de 30 minutos, por lo que Fintoc no pudo confirmar la cuenta. Vuelve a intentar la verificación más tarde.
`unknown`	No se pudo determinar la razón.
Cualquier código de retorno SPEI	La institución de contraparte devolvió la transferencia de verificación por SPEI, el sistema interbancario de pagos de México. El código corresponde al `return_reason` de la transferencia. Consulta los códigos SPEI para conocer cada código y la acción recomendada.

​Counterparty

​Institution

​Razones de fallo de account verification

Counterparty

Institution

Razones de fallo de account verification