Descarga comprobantes de transferencias por la API
Obtén el comprobante en PDF de una transferencia por la API, no solo desde el Dashboard. El comprobante está disponible en Chile y México. El camporeceipt_url solo enlaza al Comprobante Electrónico de Pago mexicano y siempre es null en Chile.- Endpoint:
GET /v2/transfers/{id}/receiptresponde un objetotransfer_receiptcon undownload_urlpara el PDF. La URL expira 1 hora después de que Fintoc la emite. - Estados: el comprobante está disponible cuando la transferencia está en
succeeded,partially_succeededoreturned. Para cualquier otro estado, el endpoint responde409 Conflictconinvalid_transfer_status. - SDKs: llama a
fintoc.v2.transfers.receipt()enfintoc-nodeo aclient.v2.transfers.receipt()enfintoc-python.
Mejoras en el Dashboard
- Menú Pagos: el menú lateral Pagos ahora muestra Analítica de pagos e Historial de pagos. Revisa Analítica de pagos.
- Filtros guardados en Analítica de pagos: la página Analítica de pagos recuerda tus filtros y tu comparación cuando sales de la página o la recargas, por separado para cada organización y modo. Haz clic en Restablecer filtros para volver a los valores iniciales. Revisa Filtra los datos.
- Menú Pagos recurrentes: Invoices y Suscripciones salieron de Pagos y ahora están en su propio menú lateral, Pagos recurrentes. Cada uno tiene su propia página, y sus URL no cambian.
- Descarga varios comprobantes: selecciona transferencias en tu historial de transferencias y haz clic en Comprobantes (N) para descargar sus comprobantes en un solo archivo ZIP.
- Cartolas en Chile: 🇨🇱 las organizaciones con Business Accounts en Chile ahora ven la pestaña Cartolas en Cuentas y en el detalle de cada cuenta. Revisa Obtén estados de cuenta.
Correcciones
- Montos de Shopify en México: 🇲🇽 Fintoc cobraba con un centavo menos algunos pagos en pesos mexicanos (
MXN) creados desde Shopify, por ejemplo1998centavos por una orden de 19.99 MXN. Fintoc ahora cobra el monto exacto de la orden. - Filtros de fecha en Business Accounts: los filtros de fecha de movimientos, transferencias, lotes de transferencias y autorizaciones comparaban las fechas en UTC, así que un día en México empezaba y terminaba seis horas antes. Los filtros y las exportaciones de movimientos y transferencias ahora cubren el día completo en la zona horaria de tu organización.
- Fintoc ID en las exportaciones de movimientos: las exportaciones de movimientos omitían la columna Fintoc ID aunque la seleccionaras. La exportación ahora la incluye.
- Filtro por email del historial de pagos: filtrar el historial de pagos por un email de cliente poco común podía agotar el tiempo de espera. El filtro ahora responde sin agotar el tiempo de espera.
- Analítica de pagos: algunos bancos no mostraban su logo en la página Analítica de pagos. Con el filtro de cuotas activo, Últimos pagos con esta razón y Descargar estos pagos (CSV) no cargaban en el detalle de una razón de fallo. Fintoc corrigió ambos.
Límite de webhook endpoints y reintentos en modo test
Fintoc cambió cuántos webhook endpoints puedes habilitar, qué URL aceptan y cómo Fintoc reintenta las entregas fallidas.- Límite de endpoints: tu organización puede tener hasta 16 webhook endpoints habilitados en cada modo. Crear o habilitar un endpoint por sobre el límite responde
422 Unprocessable Entitycon el códigolimit_exceeded. Los endpoints que ya tienes siguen funcionando. - URL internas: Fintoc rechaza la URL de un endpoint que apunta a una dirección IP privada o a un hostname interno, como
localhost. Crear un endpoint, cambiar su URL o habilitarlo con una URL así responde400 Bad Requestcon el códigoinvalid_url. El Dashboard muestra el mismo error en el formulario del webhook. - Reintentos en modo test: en modo
test, Fintoc hace hasta 3 intentos de entrega en 3 horas. En modolive, Fintoc sigue haciendo hasta 17 intentos en unos 3 días. Fintoc no reintenta las entregas a un endpoint deshabilitado o eliminado. - Selecciona eventos por grupo: cuando creas o editas un endpoint en el Dashboard, selecciona todos los eventos de un grupo (Transferencias, Iniciación de pagos, Débito directo o Movimientos) con una sola casilla.
Descarga carátulas de cuenta por la API
🇲🇽 Descarga la carátula que acredita quién es el titular de una Clave Bancaria Estandarizada (CLABE) por la API, no solo desde el Dashboard.- Endpoints:
GET /v2/accounts/{id}/certificateresponde la carátula de la CLABE principal de la cuenta.GET /v2/account_numbers/{id}/certificateresponde la carátula de cualquier otra CLABE habilitada. - Descarga: la respuesta es un objeto
account_certificatecon undownload_urlpara el PDF. La URL expira 5 minutos después de que Fintoc la emite, enexpires_at. - Solo en modo live: una API key de modo
testresponde400 Bad Requestconnot_supported_mode. Cuando Fintoc no puede emitir la carátula, por ejemplo porque la cuenta no está activa, los endpoints responden422 Unprocessable Entityconaccount_certificate_unavailable.
Regulación de la Comisión para el Mercado Financiero (CMF) en los onboardings de Chile
🇨🇱 Los onboardings de empresas chilenas ahora preguntan si la CMF regula a la empresa.- Requerido en la API: cuando creas un onboarding chileno por API,
plaftrequiere el booleanocmf_regulated. Si lo omites, Fintoc responde400 Bad Requestconmissing_parameter. Actualiza tu integración si crea onboardings chilenos. - Número de inscripción o comprobante: cuando
cmf_regulatedestrue, envíacmf_registration_numbero subecmf_application_proofantes de enviar a revisión.cmf_application_proofaceptaapplication/pdf,image/jpegeimage/png. - Certificado de la Unidad de Análisis Financiero: Fintoc acepta un certificado de registro ante la Unidad de Análisis Financiero emitido dentro de los últimos 60 días.
Acepta solo algunas tarjetas por BIN
Restringe una Checkout Session a tarjetas de algunos bancos conpayment_method_options.card.bins, una lista de números de identificación bancaria (BIN) de 6 u 8 dígitos. Por ejemplo, usa bins para ofrecer un descuento que un banco financia para sus propias tarjetas. El checkout rechaza cualquier otra tarjeta y le pide otra a tu cliente. Una sesión con bins no ofrece Apple Pay, Google Pay, tarjetas guardadas ni tarjetas Hites. bins funciona en POST /v2/checkout_sessions y POST /v1/checkout_sessions, solo para sesiones del flujo payment.Revisa Aceptar solo algunas tarjetas.Aprueba varias operaciones de escritura con Model Context Protocol (MCP) de una vez
Tu agente de inteligencia artificial ahora puede pedirte que apruebes hasta 50 llamadas a la misma operación de escritura en una sola confirmación. El agente usa el servidor MCP de Fintoc. Por ejemplo, aprueba la creación de números de cuenta para varios clientes de una vez.- Un solo formulario: el agente llama a
fintoc_request_write_approvalcon la operación y un conjunto de parámetros por llamada. Revisas todas las entradas en un solo formulario. - Ejecuta cada entrada: Fintoc responde un
approval_id, y el agente ejecuta cada entrada una vez confintoc_tool_write. Una aprobación expira 15 minutos después de que la apruebas. - Clientes compatibles: la aprobación agrupada funciona en los clientes MCP que soportan formularios (elicitation).
Fecha de éxito en la rendición de liquidaciones
🇨🇱 Las rendiciones de liquidaciones de payouts ledger-based ahora incluyensucceeded_at, la fecha y hora en que el recurso de cada fila pasó a estado exitoso. La nueva columna aparece al final del CSV. created_at conserva su valor y posición.Si tu integración espera un número fijo de columnas, actualízala para aceptar succeeded_at. Este cambio no modifica qué transacciones componen cada liquidación. Revisa Reportes y conciliación.Domiciliación en México en modo live
🇲🇽 Las organizaciones que Fintoc habilita ahora pueden inscribir cuentas bancarias mexicanas y cobrarles por domiciliación en modolive.- Inscripción en
live: inscribe un medio de pago por API con la Clave Bancaria Estandarizada (CLABE) de tu cliente en un banco compatible. Las tarjetas de débito y las Checkout Sessions siguen disponibles solo en modotest. Hasta que Fintoc habilite tu organización, las solicitudesliveresponden400 Bad Requestconnot_supported_mode. - Verificación del mandato: un mandato
livequedapendingmientras Fintoc verifica la cuenta, la identidad del titular y el contrato firmado. Cuando una verificación falla o vence el plazo de aprobación,mx_direct_debit.error_reasonen el medio de pago indica el motivo, por ejemploaccount_verification_failedoverification_expired. - Errores del cargo: Fintoc rechaza un cargo al crearlo con
422 Unprocessable Entityy un código comoamount_out_of_range,mandate_limit_exceededodirect_debit_suspended. - Plazos del cargo: Fintoc envía los cargos
liveal banco una vez cada día hábil a las 14:00, hora de Ciudad de México. Fintoc no garantiza cuándo el banco devuelve el resultado. Planifica para el día hábil siguiente y maneja los resultados que lleguen más tarde. - Contracargos: Fintoc crea un contracargo de domiciliación como una
Disputeperdida conpayment_method_typeigual amx_direct_debit. El Dashboard muestra estas disputas en la pestaña Disputas, sin fecha límite de documentación. Un contracargo también bloquea el Registro Federal de Contribuyentes (RFC) del titular y la cuenta para la domiciliaciónlive, así que las nuevas inscripciones con ellos respondenaccount_blocked_for_direct_debit.
Split en Payment Intents y comisión compartida
Split Payments ahora funciona en los Payment Intents que creas por API, y más de un destinatario puede pagar la comisión de procesamiento.- Divide un Payment Intent: envía un arreglo
splitcuando creas un Payment Intent conPOST /v2/payment_intentsoPOST /v1/payment_intents. Las entradas siguen las mismas reglas que en una Checkout Session. En modolive, tu organización debe estar habilitada para split. Si no lo está, Fintoc responde400 Bad Requestcon el códigosplit_not_available. - Comparte la comisión de procesamiento:
charge_processing_feeahora esfalsepor defecto, y al menos una entrada debe enviarlo entrue. Cuando más de una entrada lo envía entrue, Fintoc divide la comisión entre ellas en proporción a su parte del monto del pago. El errorMULTIPLE_CHARGE_PROCESSING_FEEya no existe.
Mejoras en el Dashboard
- Filtros del historial de pagos: filtra los pagos por Razón de fallo. El filtro Método ahora incluye PAC (Pago Automático de Cuentas, en Chile) y Domiciliación (México) para las organizaciones con domiciliación. Link de pago y N° de Tarjeta pasaron a Más filtros.
- Rangos de fecha predefinidos: los filtros de fecha ofrecen opciones como Hoy, Este mes y Mes anterior, y el calendario te deja saltar a un mes y año.
- Exporta varias liquidaciones: selecciona liquidaciones completadas en Liquidaciones y haz clic en Exportar para descargar un archivo de valores separados por comas (CSV) por cada liquidación.
- Validación de transferencias por lotes: cuando haces clic en Continuar, Fintoc valida cada fila y cada cuenta de origen antes del paso de revisión. Los errores de fila muestran el número de fila del archivo y la columna que debes corregir. Revisa Sube tu archivo.
- Campos de transferencias por lotes: 🇨🇱 el nombre del titular puede tener hasta 100 caracteres, o 50 con una configuración heredada de Security. 🇲🇽 Una referencia no puede empezar con
0, salvo que la referencia sea0. - Las devoluciones requieren aprobación: una devolución desde el Dashboard sigue el mismo flujo de aprobación que una transferencia manual. Si no tienes el permiso Autorizar con 100% para la cuenta, la devolución espera aprobaciones en Autorizaciones. Revisa Devolver una transferencia desde el Dashboard.
Correcciones
- Mandatos de domiciliación cancelados: 🇲🇽 cuando un mandato de domiciliación en México terminaba
canceled, su medio de pago quedaba sincanceled_at. Un medio de pago que ya habías cancelado por API también podía recibir un segundopayment_method.canceled. Fintoc ahora completacanceled_aty envía un solopayment_method.canceled.
Analítica de pagos para todas las organizaciones
La nueva página Resumen con la analítica de tus pagos ya está disponible para todas las organizaciones. Haz clic en Pagos en el menú lateral del Dashboard para abrirla. Revisa Analítica de pagos.- Widgets: conversión total, volumen de pagos, ticket promedio, reembolsos, conversión en el tiempo, conversión por banco origen, conversión por método de pago y razones de fallo en el tiempo.
- Filtros y comparación: la página parte con los últimos 30 días hasta ayer. Filtra por fecha, Método, Banco origen y metadata, y usa Comparar para ver el período anterior, el año anterior o un rango que elijas.
- Razones de fallo: abre una razón de fallo para ver los bancos donde se concentra y sus últimos pagos. Haz clic en Descargar estos pagos (CSV) para exportarlos.
- Exportación a Excel: haz clic en Descargar Excel para exportar los datos de la página.
Elige el método de autenticación en modo test
🇨🇱 La cuenta de test813990169 le permite al pagador elegir cómo confirmar un pago por transferencia bancaria, como en modo live. Ingresa 000000 para el dispositivo de seguridad o 0000 para el mensaje de texto (SMS). La aplicación móvil aprueba el pago sin código. Cada código funciona solo con su propio método.Revisa Prueba tu integración.Links de pago de un solo uso e identificadores tributarios personalizados
- Links de pago de un solo uso: envía
max_completed_sessions: 1cuando creas un Link de pago para cerrarlo después de su primer pago exitoso. Elstatusdel link pasa acompleted. Omite el parámetro o envíanullpara que el link sea reutilizable. Revisa Crear un Link de pago. - Identificadores tributarios personalizados:
tax_id.typeen unCustomeraceptacustompara identificadores distintos del Rol Único Tributario (RUT) chileno o el RFC mexicano. Fintoc elimina los espacios al inicio y al final de los valorescustomy no valida su formato. Revisa El objeto Customer.
Dominio test del checkout y Apple Pay en modo test
- Dominio test del checkout: los pagos en modo
testahora se abren entest.pay.fintoc.comen vez depay.fintoc.com. Elredirect_urlde una Checkout Sessiontesty elurlde un Payment Linktestusan el nuevo dominio. Los pagos en modolivesiguen enpay.fintoc.com. Los linkstestantiguos siguen funcionando y redirigen al nuevo dominio. - Apple Pay en modo test: el checkout ahora muestra Apple Pay en modo
testen los dispositivos compatibles, así puedes probar el flujo de pago completo antes de pasar a producción. Revisa Aceptar un pago.
Mejoras en el Dashboard
- Links de pago: haz clic en la fila de un link para abrir su nueva página de detalle. Muestra los totales, los detalles y la metadata del link, además de una tabla de Pagos con todos los pagos hechos a través del link. Revisa Links de pago.
- Encuentra los pagos de un Link de pago: filtra tu historial de pagos por el ID del Link de pago. El detalle de un pago muestra el Link de pago del que viene.
- Historial de pagos: la lista ahora parte con todos los estados. Ya no preselecciona el filtro Exitoso.
- Copia identificadores: las tablas de movimientos, transferencias, equipo y entidades ahora tienen botones para copiar IDs, números de cuenta e identificadores tributarios. Pasa el cursor sobre un valor para copiarlo con un clic.
- Filtros: Transferencias, Links y Clientes mantienen tus filtros cuando vuelves desde una página de detalle.
- Vuelve a iniciar sesión: si tu sesión expira y vuelves a entrar dentro de una hora, el Dashboard te lleva a la página y los filtros que tenías abiertos.
- Transferencias: cuando falla la creación de una transferencia, el Dashboard ahora muestra el motivo.
- Invoices: la exportación de invoices incluye la columna Currency.
Correcciones
- Marcas de tarjeta no aceptadas: Fintoc solo procesa tarjetas Visa y Mastercard. Cuando tu cliente ingresaba una tarjeta de otra marca, el widget de pago mostraba un error de conexión genérico. El widget ahora pide una tarjeta Visa o Mastercard justo debajo del número de tarjeta.
- Error de monto máximo de la organización: 🇲🇽 el error de un pago por sobre el monto máximo de tu organización mostraba el límite con formato de CLP, incluso en pagos en MXN. Fintoc ahora formatea el límite en la moneda del pago.
- Exportación vacía de Links de pago: exportar Links de pago en XLSX con filtros que no coincidían con ningún link descargaba un archivo que Excel no podía abrir. El archivo ahora tiene una hoja con los encabezados de las columnas.
Carátulas de cuenta en México
🇲🇽 Ahora puedes descargar la carátula de una cuenta desde el Dashboard. La carátula es un PDF que acredita que la cuenta está abierta y activa a nombre de su titular.- Qué muestra: la razón social, el Registro Federal de Contribuyentes (RFC) y el domicilio fiscal del titular. También muestra la Clave Bancaria Estandarizada (CLABE), la institución en el Sistema de Pagos Electrónicos Interbancarios (SPEI) y la fecha de emisión.
- Dónde descargarla: haz clic en Carátula en el detalle de una cuenta para su CLABE principal, o en Descargar carátula en el detalle de otra CLABE habilitada.
- Cuándo está disponible: en modo
live, para cuentas activas cuyo titular tiene registrados su razón social, RFC y domicilio fiscal.
Validaciones del mandato en domiciliación en México
🇲🇽 Fintoc ahora valida más datos del mandato desde el inicio y te dice por qué se rechazó un mandato. Estas validaciones aplican en modotest y live.- Contacto del cliente obligatorio: el cliente del mandato debe tener un email y un número de teléfono. Si no, Fintoc responde con un error
422 Unprocessable Entitycon el códigocustomer_contact_requiredy no crea el payment method. - Validación del RFC: Fintoc también valida la fecha y el dígito verificador del RFC. Rechaza un RFC inválido con el código
invalid_rfc, en la API y en el checkout. max_amounten Checkout Sessions: Fintoc valida que el monto máximo esté entre100y5000000centavos de MXN cuando creas la Checkout Session, no cuando tu cliente autoriza el mandato.- Motivo del rechazo: un payment method rechazado o cancelado incluye el motivo en
mx_direct_debit.error_reason, en la API y en los webhooks. El campo esnullcuando el mandato no tiene un motivo guardado.
API de Recipients
Ahora puedes gestionar recipients, las cuentas de destino guardadas de una entidad, con la API en Chile y México.- Gestiona recipients: crea, lista, obtén, actualiza y elimina recipients en
/v2/recipients. - Reglas por país: en Chile, envía el Rol Único Tributario (RUT),
account_typeyholder_type. En México, Fintoc infiereaccount_typea partir deaccount_number. - Filtra la lista: filtra recipients por
entity_id,holder_id,account_numbery otros campos. - Datos de cuenta fijos: no puedes cambiar
account_number,institution_idniholder_iddespués de crear un recipient.
Cancela payment methods con la API
Ahora puedes cancelar un payment method guardado conPOST /v2/payment_methods/{id}/cancel. Fintoc deja de cobrar un payment method cancelado.- Webhook: Fintoc envía el evento
payment_method.canceledcuando cancelas un payment method. - Sin nuevos cobros: Fintoc rechaza los cobros y las Checkout Sessions que usan un payment method cancelado con un error
422 Unprocessable Entityy el códigopayment_method_canceled. - Se cancela una vez: cancelar un payment method que ya está cancelado devuelve un error
409 Conflictcon el códigopayment_method_non_cancelable.
Mejoras en el Dashboard
- Clientes: el detalle de un cliente ahora lista sus suscripciones, con su recurrencia, medio de pago, estado y monto.
Entidades de clientes en Chile
🇨🇱 Ahora puedes crear y completar el onboarding de unaEntity para un cliente en Chile desde el Dashboard o por API. Antes, las entidades de clientes solo estaban disponibles en México.- Onboarding por API: crea la entidad con el Rol Único Tributario (RUT) de la empresa y luego envía el onboarding
account_holdercon los bloques dedatay los documentos de Chile. - Chequeos chilenos al enviar: cuando
incorporation_typeesone_day_company, Fintoc verifica que la empresa esté registrada en Empresa en un Día y devuelvenot_one_day_companysi no lo está. - Cuenta principal: Fintoc crea la cuenta principal de la entidad en CLP cuando aprueba el onboarding.
Correcciones
- Inscripción PAC con RUT de empresa: 🇨🇱 el widget de inscripción PAC mostraba una advertencia con un RUT de empresa, pero dejaba continuar a tu cliente. El widget ahora bloquea el inicio de sesión hasta que tu cliente ingrese el RUT de una persona natural.
Transferencias por lotes en la API
Ahora puedes crear, obtener y listar transferencias por lotes con la API, en México y Chile. Cada lote lo sigues autorizando desde el Dashboard.- Crea un lote: envía hasta 5.000 transferencias en una solicitud a
POST /v2/transfer_batches. El lote parte enpending_authorization. - Sigue el lote: Fintoc envía los nuevos eventos de webhook
transfer_batch.*cada vez que un lote cambia de estado. - Lee sus transferencias: filtra
GET /v2/transfersportransfer_batch_id.
Los reembolsos tienen un nuevo estado returned
🇲🇽 Un reembolso ahora pasa desucceeded a returned cuando el banco del destinatario devuelve la transferencia después de que Fintoc desembolsó los fondos. Fintoc envía el nuevo evento de webhook refund.returned.- No es un fallo:
returnedsignifica que Fintoc desembolsó los fondos y el banco los devolvió después. Un reembolsofailednunca se desembolsó. - Filtra por estado: puedes filtrar el listado de reembolsos por
returned. - Dashboard: el Dashboard muestra un reembolso
returnedcomo un reembolso fallido.
Banco BTG Pactual y Tenpo Bank en Chile
🇨🇱 Fintoc ahora soporta Banco BTG Pactual (cl_banco_btg_pactual) y Tenpo Bank (cl_tenpo_bank).- Cuentas de liquidación: puedes usar una cuenta en cualquiera de los dos bancos como cuenta de liquidación durante el onboarding.
- Dashboard: ambos bancos aparecen en los listados de instituciones chilenas.
- Tenpo Prepago:
cl_tenpoahora se muestra como Tenpo Prepago. Sigue siendo una institución distinta de Tenpo Bank.
Mejoras en el Dashboard
- Historial de pagos: filtra pagos por email del cliente o por razón de fallo. Hay nuevas columnas Razón de fallo y Email, y las exportaciones incluyen la columna Customer Email. Los pagos con tarjeta muestran la marca de la tarjeta en el encabezado del pago.
- Liquidaciones: la tarjeta de resumen muestra tu próxima liquidación y el total acumulado en modo
live. También puedes descargar una liquidación desde el menú de tres puntos de su fila. - Links de pago: elige qué columnas mostrar en la tabla. La nueva columna Pagos exitosos cuenta los pagos que recibió cada link. Revisa Links de pago.
- Invoices: exporta el listado de invoices en CSV o Excel.
- Clientes: el detalle de un cliente tiene un nuevo diseño con sus medios de pago guardados, datos, metadata y actividad reciente. Las tarjetas vencidas muestran la etiqueta Vencido.
Límites del mandato y referencia del cobro en domiciliación en México
🇲🇽 Dos cambios en la domiciliación en México:- Rango de
max_amount:mx_direct_debit.max_amountdebe estar entre100y5000000centavos de MXN ($1.00 a $50,000.00 MXN), inclusive. Fintoc rechaza los valores fuera de este rango con un error de parámetro inválido en modotestylive. Los mandatos existentes no se ven afectados. - Referencia del cobro: el estado de cuenta de tu cliente ahora muestra tu nombre comercial como referencia del cobro, hasta 40 caracteres.
Las suscripciones se pueden pausar
Las suscripciones tienen un nuevo estadopaused. Fintoc pausa tus suscripciones cuando tu organización pierde acceso a suscripciones. Mientras una suscripción está paused, Fintoc deja de generar y cobrar sus invoices.Revisa Obtener una suscripción.Correcciones
- Formulario de reembolso: 🇨🇱 el formulario de reembolso del Dashboard ya no ofrece cuentas de ahorro, que los reembolsos no soportan.
- Feriado bancario en México: 🇲🇽 Fintoc ahora trata el 2 de noviembre de 2026 como feriado bancario. Los cobros por domiciliación, las liquidaciones y el procesamiento de pagos en efectivo programados para ese día pasan al 3 de noviembre.
Transferencias masivas disponibles en Chile
🇨🇱 Las organizaciones chilenas ahora pueden enviar hasta 5.000 transferencias desde un solo archivo en el Dashboard, como ya podían las organizaciones mexicanas.- Solo desde el Dashboard: ve a Transfers → Batch Transfers y descarga la plantilla de Chile (CLP).
- Configuraciones legacy de Security: estas organizaciones solo pueden crear transferencias masivas en modo
live.
Desactiva Links de pago desde el Dashboard
Ahora puedes desactivar un Link de pago activo desde el Dashboard, no solo a través de la API. Abre el menú de tres puntos del link, selecciona Desactivar y confirma.- Requiere permiso: solo los usuarios que pueden gestionar links de pago ven la opción.
- Pagos en curso: los pagos que ya están en curso pueden completarse.
- Nuevo estado
completed: un Link de pago de un solo uso que recibe su pago ahora pasa acompleted.
Los admins pueden dar aprobación de transferencias a otros admins
El rol Admin no incluye la aprobación de transferencias. Un admin que puede cambiar roles ahora puede dar aprobación de transferencias y creación de cuentas a otro admin mediante reglas de cuenta.- Solo agregar: los cambios entre admins pueden agregar permisos, pero no quitarlos ni reducirlos.
- Sin autoedición: no puedes editar tus propios permisos.
El plugin de WooCommerce 1.2.5 agrega pagos en efectivo en México
El plugin Fintoc for WooCommerce ahora está en el directorio de plugins de WordPress y acepta pagos en efectivo.- Efectivo en México: 🇲🇽 tus clientes reciben un voucher para pagar en una tienda. El pedido queda On hold hasta que pagan o expira la Checkout Session.
- Instalación y actualizaciones desde WordPress: instala el plugin desde Plugins → Add New en WordPress. WordPress ofrece nuevas versiones como con cualquier otro plugin.
- Título automático: deja Title vacío y el checkout muestra los medios de pago habilitados para tu organización.
Programa la cancelación de una suscripción desde Checkout Sessions
Envíasubscription_cancel_at al crear una Checkout Session con flujo subscription. Fintoc cancela la suscripción resultante en esa fecha y hora.- Hora exacta:
cancel_aten las suscripciones ahora cancela en el timestamp exacto que envías, no al inicio de ese día. - Sin invoices extra: Fintoc no emite invoices para periodos que comienzan en o después de la cancelación.
Los onboardings de account holders en México requieren el propósito de la cuenta
🇲🇽 Los onboardingsaccount_holder en México ahora requieren transactional_profile.account_purpose. Si envías other, envía también account_purpose_details.Revisa Crear un onboarding.Las disputas pueden cancelarse
Las disputas tienen un nuevo estadocanceled para disputas abiertas por error. Puedes filtrar la lista de disputas por canceled.Revisa el objeto Dispute y Disputas en el Dashboard.Errores de API más claros
Fintoc ahora responde errores más específicos en estos casos:- Entidades de clientes: crear una
Entityde cliente responde con422 Unprocessable Entityy el códigoorganization_without_operational_root_entitysi tu organización no tiene unaEntityraíz en el modo de la API key. Revisa Antes de comenzar. - Reembolsos: reembolsar un medio de pago que no admite reembolsos responde
payment_method_not_refundable. - Invoices y suscripciones: las organizaciones sin acceso a estos productos reciben
403 Forbiddenconproduct_access_required. - Pagos con tarjeta: los Payment Intents y Setup Intents pueden fallar con el error reason
invalid_amount. Revisa Error reasons de Payment Intent.
Devuelve transferencias recibidas en Chile y desde el Dashboard
🇨🇱 Ahora puedes devolver una transferencia recibidasucceeded en Chile, no solo en México. También puedes devolver transferencias desde el Dashboard.- Mismo endpoint: usa el endpoint de devolución existente para transferencias chilenas. Fintoc descuenta el monto del saldo de tu cuenta.
- Espera de 90 segundos para otros bancos: si la transferencia viene de otro banco, espera 90 segundos después de que llegue a
succeeded. Las solicitudes anteriores responden409 Conflictcon el códigoinvalid_transfer_status. - Dashboard: abre el menú de opciones de la transferencia, selecciona Devolver y confirma con el código de tu app de autenticación.
Marca una invoice como incobrable
POST /v2/invoices/{id}/mark_uncollectible castiga una invoice open que ya no esperas cobrar. La invoice mantiene el registro de que tu cliente debía el monto.- Nuevo estado: la invoice pasa a
uncollectible. - Nuevo evento: Fintoc envía
invoice.marked_uncollectible.
Inscribe domiciliación en México desde Checkout Sessions
🇲🇽 Tus clientes ahora pueden autorizar un mandato de domiciliación desde el checkout de Fintoc. Agregamx_direct_debit a payment_method_types en sesiones setup y subscription.- Primero en modo test: la inscripción por checkout está disponible en modo
testcon monedaMXN. - Términos del mandato: en sesiones
setup, definemax_amounteintervalenpayment_method_options.mx_direct_debit. Las sesionessubscriptiontoman los términos deline_items. - Conoce el origen: el
mx_direct_debit.consent_sourcedel payment method esapiocheckout.
Sube varios archivos a un slot de documentos del onboarding
Algunos slots de documentos del onboarding de una Entity ahora aceptan varios archivos. Cada archivo subido tiene su propioid en el arreglo documents.- Agrega un archivo:
POST .../documents/{slot_key}agrega un archivo a un slot de varios archivos. - Elimina un archivo:
DELETE .../documents/{slot_key}/{document_id}elimina un archivo de cualquier slot. - Reemplaza un archivo:
PUTsigue reemplazando el archivo en un slot de un solo archivo.
Los payment intents listan las invoices que pagan
Los objetosPaymentIntent y los webhooks payment_intent.* ahora incluyen el campo invoices. El campo invoices lista los IDs de las invoices que paga el payment intent. El campo está vacío cuando el payment intent no paga ninguna invoice.- Incluye todos los pagos de invoices: los cobros automáticos, sus reintentos y los pagos que tu cliente hace desde el
hosted_invoice_urlde una invoice listan su invoice eninvoices. - Llega a la suscripción a través de la invoice: obtén la invoice para encontrar la suscripción que la emitió.
Descarga el contrato del mandato de domiciliación en México
🇲🇽GET /v2/payment_methods/{id}/mandate_document devuelve un link firmado al contrato del mandato de un payment method mx_direct_debit, en cualquier estado del mandato.- Link de corta duración: el
download_urlexpira 5 minutos después de la solicitud. Pide un nuevodownload_urlcada vez.
Envía vouchers de efectivo por WhatsApp y recuerda a tus clientes pagar
🇲🇽 Fintoc ahora puede enviar el voucher de pago en efectivo por WhatsApp y recordarle a tu cliente que pague.- WhatsApp: envía
customer_phoneen formato E.164, por ejemplo+525511111111. - Elige los canales: usa
notification_preferencespara elegiremail,phoneo ambos, y para activar o desactivar el voucher o los recordatorios. - Recordatorios: Fintoc envía hasta 2 recordatorios por canal mientras el pago está pendiente.
- Checkout Sessions: envía los mismos campos al crear la sesión.
Gestiona tu equipo, webhooks y restricciones de IP desde el servidor MCP
El servidor MCP de Fintoc soporta más operaciones.- Equipo: lista usuarios y roles, e invita usuarios con un rol predefinido. Vuelve a conectar tu cliente y otorga el scope Equipo para usar estas operaciones.
- Webhooks: crea y actualiza webhook endpoints.
- Restricciones de IP: agrega un rango de IP permitido a tu organización.
- Tus facturas de Fintoc: lista las facturas que Fintoc emite a tu organización.
Las conexiones del Widget ya no tienen un límite de tasa separado
Fintoc ya no aplica un límite de tasa separado a las conexiones del Widget. Los límites de solicitudes a la API y de transferencias de Business Accounts siguen vigentes.Revisa Límites de tasa de la API.Acepta efectivo en Checkout Sessions y Payment Links de México
🇲🇽 Tus clientes ahora pueden pagar en efectivo desde el checkout de Fintoc. Generan una referencia y pagan en más de 13.000 tiendas.- Checkout Sessions: agrega
cashapayment_method_typesen una sesiónMXN. Puedes ofrecerlo solo o junto acardybank_transfer. No puedes combinarcashconinstallments. - Payment Links: si tu organización tiene efectivo habilitado, todos tus Payment Links en
MXNofrecen efectivo automáticamente. No necesitas ningún parámetro adicional. - Reintenta en efectivo: si falla un pago con tarjeta o transferencia, tu cliente puede reintentar en efectivo desde el mismo checkout.
Cobra suscripciones en UF
🇨🇱 Ahora puedes definir el precio de los items de una suscripción en Unidad de Fomento (UF). UsaCLF como currency del item y mantén la suscripción en CLP.- Conversión en cada ciclo: Fintoc convierte cada item
CLFaCLPcon el valor de la UF al inicio del período de cobro. Una vez que Fintoc emite la invoice, su monto no cambia. - Cuatro decimales:
unit_amountusa la unidad mínima de la UF, así que35000equivale a 3,5 UF. - Combina con CLP: una suscripción puede combinar items
CLPyCLF. Cualquier otra combinación de monedas retorna un error.
Verifica tarjetas de débito y números móviles en México
🇲🇽 Las verificaciones de cuenta ahora aceptan un número de tarjeta de débito de 16 dígitos o un número de teléfono móvil de 10 dígitos, además de una CLABE. Fintoc confirma el destino con un micro-depósito de 0,01 MXN antes de que envíes el pago completo.- Envía
institution_id: las tarjetas de débito y los números móviles no identifican su banco, así que incluye elinstitution_iddel banco. Sin él, la API retorna400 Bad Request. - Nuevos tipos de cuenta: el
account_typede la verificación esclabe,debit_cardomobile.
Mejoras en el onboarding de receptores de Split Payments
Hacer el onboarding de un receptor de Split Payments es más simple, y su estado es más fácil de leer.- Estado por capability: las Entities ahora retornan
capabilities.settlement_recipient.status. Úsalo para saber si una Entity puede recibir splits. Elstatusprincipal refleja la capability más avanzada de la Entity. - Menos campos para empresas chilenas:
business_activity,business_addressyphoneahora son opcionales para Entities de empresas chilenas. Las empresas mexicanas deben seguir enviándolos. - Cuentas de liquidación por país: las Entities mexicanas solo envían una CLABE de 18 dígitos en
account_number. Fintoc obtiene el banco desde la CLABE.
Fintoc envía automáticamente el voucher de pagos en efectivo
🇲🇽 Fintoc ahora envía el voucher de pago en efectivo a tu cliente automáticamente, para que reciba la referencia y las instrucciones de pago sin que tengas que compartirlas.- Pagos en efectivo creados por API: Fintoc envía el voucher apenas se crea el pago.
- Checkout sessions: Fintoc envía el voucher cuando tu cliente pasa de las instrucciones de pago al voucher.
- Solo por correo: Fintoc envía el voucher al
customer_emaildel pago. - Respeta tu configuración: Fintoc no envía el voucher si desactivaste las notificaciones del voucher en tus preferencias o si tu cuenta suprime las comunicaciones a clientes.
- Mensajes reales en modo test: Fintoc también envía correos reales en modo
test.
Los webhooks de onboarding de una Entity incluyen el onboarding completo
Los eventosentity.onboarding.approved y entity.onboarding.rejected ahora llevan el objeto Onboarding completo. Puedes leer los datos revisados de cada paso, los documentos, los representantes legales y los accionistas directamente desde el webhook, sin obtener el onboarding desde la API.- Campos nuevos: el payload agrega
object,entity_id,type,source,data,legal_representatives,shareholdersydocuments. Omitesubmittable. - Compatible hacia atrás: el payload mantiene
object_name: "onboarding_process"y el resumen deentity, así que tus handlers actuales siguen funcionando.
Actualiza el metadata de una invoice
PATCH /v2/invoices/{id} actualiza el metadata de una invoice en cualquier estado, incluso cuando ya está paid o void. Así puedes guardar tus propios datos en las invoices que Fintoc genera desde una suscripción, sin depender de la ventana de una hora en draft.- Reemplaza el objeto completo: el
metadataque envías sustituye al que tenía la invoice. Si omitesmetadata, la invoice conserva el actual. - Solo metadata: el endpoint no cambia montos, fechas de cobro ni line items.
Envía transferencias sobre $7.000.000 CLP en Chile
Ahora puedes crear una transferencia saliente chilena por más de $7.000.000 CLP. Algunos bancos chilenos limitan las transferencias entrantes a $7.000.000 CLP, así que Fintoc divide las transferencias mayores en partes de hasta $7.000.000 CLP y envía cada parte una tras otra.- Una sola transferencia en la API. Creas y sigues un único
Transfer, con un solo set de webhooks, un comprobante y un movimiento de cuenta. Las partes no aparecen en la API. - Sufijo de conciliación para la contraparte. La contraparte recibe una transferencia por cada parte. Fintoc agrega
X de Nal comentario de cada parte, así queFactura 1042llega comoFactura 1042 1 de 3,Factura 1042 2 de 3yFactura 1042 3 de 3. - Las transferencias entre cuentas de Fintoc no se dividen. Una transferencia a otra cuenta de Fintoc se liquida de inmediato por el monto total, en una sola transferencia.
Added
Eventos de webhook para transferencias salientes chilenas que se liquidan parcialmente o se reversan
Eventos de webhook para transferencias salientes chilenas que se liquidan parcialmente o se reversan
Las transferencias salientes chilenas ahora emiten dos eventos de webhook nuevos, así puedes reaccionar a cada resultado terminal que el Centro de Compensación Automatizado puede informar.transfer.outbound.partially_succeeded: 🇨🇱 Fintoc envía este evento cuando solo una parte de unaTransfersaliente se liquida. Elstatusde la transferencia queda enpartially_succeeded.transfer.outbound.reversed: 🇨🇱 Fintoc envía este evento cuando unaTransfersaliente que ya se había liquidado se reversa. Elstatusde la transferencia queda enreversed.
test, así puedes confirmar el handler de cada resultado antes de pasar a producción. Las transferencias salientes en México no reportan estos estados.Consulta la referencia de tipos de eventos, el modelo de datos de una transferencia y Transferencias salientes.Los pedidos de WooCommerce esperan en On hold mientras Fintoc valida el pago
La versión1.2.4 del plugin de Fintoc para WooCommerce evita que WooCommerce cancele un pedido mientras Fintoc valida el pago de ese pedido. Una transferencia bancaria puede tardar horas o días en confirmarse. WooCommerce cancela los pedidos impagos cuando superan la antigüedad del ajuste Hold stock (minutes), 60 minutos por defecto. Antes de esta versión, tu tienda podía mostrar un pedido como cancelado aunque Fintoc ya hubiera cobrado el dinero.- Los pedidos pasan a On hold. Cuando la API de Fintoc informa que el pago está en validación, el plugin mueve el pedido a On hold. WooCommerce excluye los pedidos en On hold de la limpieza de impagos. El pedido reserva su stock durante la espera y tu cliente no puede iniciar un segundo pago para el mismo pedido.
- El stock vuelve cuando un pago falla. Un pago fallido restituye el stock que el pedido había reservado, así que los productos no quedan retenidos por un pedido que nadie pagó.
- El polling cubre brechas de webhook. Los webhooks siguen siendo la señal principal. El plugin también consulta el pago en la API de Fintoc de forma programada. El primer reintento ocurre después de 15 minutos y los siguientes se espacian hasta una vez al día. El plugin se detiene tras 10 reintentos, unos cuatro días después de que el pedido pasa a On hold. Esto permite resolver el pedido cuando Fintoc tiene el estado final del pago, pero el webhook nunca llega.
- Los pagos duplicados quedan a la vista. Un segundo pago exitoso sobre un pedido ya pagado ahora deja una nota en el pedido y envía un correo al administrador de la tienda, en vez de quedar solo en el debug log. Reembolsa el duplicado desde el dashboard.
1.2.4 desde la página de Fintoc para WooCommerce y consulta Acepta pagos con WooCommerce para ver qué significa cada estado de pedido.Divide un pago entre varios destinatarios
Split Payments permite a plataformas y marketplaces dividir los fondos de un pago de Checkout Session entre varios destinatarios. Fintoc transfiere cada parte a la cuenta bancaria del destinatario, así que ya no necesitas conciliar ni mover el dinero por tu cuenta. Split Payments está disponible en Chile y México.- Cada destinatario es una
Entity. Créala conPOST /v2/entitiesy complétale el onboarding con el tiposettlement_recipient. El onboarding declara la cuenta bancaria donde Fintoc paga la parte de ese destinatario. - Declara las reglas en la Checkout Session. Envía un arreglo
splitcon 1 a 10 entradas. Cada entrada indica unentity_idy su parte, como montoflato comopercentageen puntos base. Las entradas deben sumar exactamente el monto del pago, y exactamente una llevacharge_processing_fee. - Concilia con eventos.
checkout_session.finishedypayment_intent.succeededincluyen un arreglosplit_appliedcon el monto resuelto para cada destinatario. Los eventospayout.*reportan el payout de cada destinatario.
Los mandatos de domiciliación expiran a los 7 días sin confirmación
Un mandato de domiciliación que nunca recibe confirmación del banco ya no queda enpending para siempre. Cuando el banco no confirma dentro de 7 días, Fintoc expira el mandato y su estado pasa a expired.- México:
mx_direct_debit.statuspasa aexpiredy Fintoc envíapayment_method.canceled. Enrola de nuevo al cliente con un nuevo método de pago. Cobrar un mandato expirado devuelve el errorpayment_method_inactive. - Chile: el
statusde la suscripción de domiciliación, incluidopac.statusen un método de pago, suma el valorexpired. - Pruébalo: en modo
test, un mandato mexicano creado con una CLABE terminada en8888nunca recibe confirmación, así que Fintoc expira el mandato a los 7 días.
Un mx_direct_debit más claro en el método de pago
Los detalles demx_direct_debit en el objeto PaymentMethod cambiaron de forma:institutionreemplaza ainstitution_id: un objeto con elid, elcountryy elnamelegible del banco.account_number_last4reemplaza alast_four_digits.max_amountreemplaza amax_amount_centsymax_amount_currency: el tope por cobro, en la unidad más pequeña de la moneda.- Nuevo
account_holder_id: el identificador tributario del titular de la cuenta (RFC o CURP), sin puntos ni guiones.
institution_id, last_four_digits, max_amount_cents o max_amount_currency.Revisa el objeto Payment Method.Detalle de fallas y reversas en transferencias chilenas
Las transferencias chilenas ahora te dicen por qué y cuándo una transferencia no se liquidó:error_reason: código de razón de una transferencia fallida, comoinvalid_recipient_account,recipient_account_closedorecipient_institution_timeout.reject_reason: código de razón de una transferencia rechazada. Uno derecipient_account_closed,recipient_account_credit_restrictedyunknown.failed_at,rejected_atyreversed_at: timestamps ISO 8601 de cada desenlace.- Nuevo evento: Fintoc envía
transfer.inbound.reversedcuando una transferencia entrante chilena se reversa.
null. Revisa la referencia del objeto Transfer y los tipos de eventos.Encuentra Account Numbers sin abonos recientes
GET /v2/account_numbers acepta un nuevo parámetro de consulta no_transfers_since. Envía una fecha ISO 8601, como 2026-07-28. Fintoc lista los Account Numbers cuya última transferencia entrante es anterior a esa fecha, más los que nunca recibieron una. Usa el filtro para encontrar Account Numbers inactivos que puedas deshabilitar o reasignar.- Solo México: el filtro aplica a Account Numbers mexicanos.
- Errores: una fecha inválida devuelve un
400 Bad Requestcon el códigoinvalid_date.
Business Accounts está disponible en Chile
Business Accounts opera en Chile sobre una Cuenta con Provisión de Fondos (CPF). Recibes, envías y concilias transferencias en pesos chilenos por el riel del Centro de Compensación Automatizado, con los mismos objetosEntity, Account y Transfer que ya usas en México. Chile parte con cuentas, Account Numbers, transferencias entrantes y salientes, cartolas, metadata en un Account Number y la posibilidad de deshabilitarlo. Fintoc está avanzando sobre las funciones que México tiene y Chile no; la matriz de disponibilidad nombra cada una.- Abre cuentas y Account Numbers con una sola llamada.
POST /v2/accountsabre una cuenta yPOST /v2/account_numbersemite números adicionales sobre ella. Asigna uno por cliente u orden y adjuntametadatapara conciliar cada abono contra tus registros. Ambas acciones también funcionan desde el Dashboard. Los remitentes eligen Fintoc como institución de destino, con el identificadorcl_fintoc. - Construye en modo
testantes de mover dinero. Todos los endpoints chilenos funcionan con una llavesk_test_.POST /v2/simulate/receive_transfersimula un abono de un remitente chileno concounterparty_account_number,counterparty_account_type,counterparty_holder_id,counterparty_holder_nameycounterparty_institution_id. - Las guías y la referencia de la API ya cubren Chile. Cada página de Business Accounts indica qué soporta cada país, para que sepas qué llamadas aplican dónde.
Enrola un mandato de domiciliación bancaria en México por API
POST /v2/payment_methods enrola un mandato de domiciliación bancaria en México y devuelve el payment method que lo representa. Manda los datos de la cuenta, los términos del mandato y los cuatro documentos de consentimiento bajo mx_direct_debit[consent_documents] como multipart/form-data en una sola request. Así puedes recolectar todo en tu propia UI en vez de redirigir a tu cliente al checkout hosteado por Fintoc.- La request es atómica: si un documento de consentimiento pesa menos de 100 bytes o más de 10 MB, o no es un PDF, JPEG o PNG, Fintoc no crea nada y devuelve
422 Unprocessable Entity. - La aprobación es asíncrona: el mandato queda en
pendinghasta que el titular de la cuenta lo autoriza con su banco. Esperapayment_method.activatedantes de cobrar la cuenta.
Apaga el correo de liquidación desde el dashboard
La pestaña Comunicación en Configuración ahora tiene el toggle Correo de liquidación. Apaga el toggle para que Fintoc deje de enviar el correo con el reporte de conciliación del payout. Antes el correo llegaba en cada payout y solo Fintoc podía apagarlo.- Cubre los correos de payout: Fintoc envía correos de payout para transferencias, tarjetas y el payout aparte de los cobros recurrentes. Fintoc sigue enviando el resumen diario.
- Permiso: editar el toggle requiere el permiso para editar las preferencias de comunicación de la organización. Revisa Roles de Permisos.
- El correo enlaza al toggle: cada correo de liquidación ahora enlaza a la pestaña Comunicación.
Crea un onboarding con type y data
POST /v2/entities/{entity_id}/onboardings ahora recibe dos campos de primer nivel obligatorios. Envía en type el tipo de onboarding que quieres crear. El único valor aceptado es account_holder. Envía los datos de la revisión en data, que contiene company_information, legal_representatives, transactional_profile y shareholders. El objeto Onboarding y los resúmenes del listado ahora también devuelven type.- Cambio incompatible: el cuerpo plano anterior, con esas cuatro claves en el primer nivel y sin
data, ya no funciona. Envuelve las cuatro claves endatay agregatype. - Errores: omitir
typeodatadevuelve un400 Bad Requestcon el códigomissing_parameter. Untypeque no esté entre los valores aceptados devuelve un400 Bad Requestcon el códigoinvalid_enum. - Esquema:
datacambia segúntype, así que la referencia de la API lo describe como un objeto de forma libre.
account_holder, y Onboarding de una entidad por API para el flujo completo.Desasocia el payment method de una suscripción
DELETE /v2/subscriptions/{id}/payment_method quita el payment method de una suscripción que cobra con send_invoice. El payment method sigue disponible en el customer, así lo puedes asociar de nuevo más adelante. Fintoc también limpia el default_payment_method de las invoices draft y open de la suscripción, con lo que se detienen los reintentos automáticos que Fintoc estaba ejecutando sobre cualquier invoice abierta. Las invoices paid y void conservan el payment method como registro de cómo Fintoc las cobró.- Solo
send_invoice: una suscripción concollection_method: charge_automaticallynecesita un payment method para cobrar, así que Fintoc responde409 Conflicten esos casos. - Suscripciones canceladas: Fintoc responde
409 Conflict. - Idempotente sin cambios: desasociar una suscripción que ya no tiene payment method devuelve la suscripción sin cambios y no envía ningún evento.
- Webhook: Fintoc envía
subscription.payment_method_updatedconpayment_methodennull.
Filtra entidades por holder, estado y root
GET /v1/entities acepta tres nuevos parámetros de consulta para acotar el listado sin paginar toda la organización:holder_id: encuentra la entidad por el tax ID de su dueño. Fintoc normaliza el valor (elimina puntos, guiones, ceros iniciales y espacios, y pasa las letras a mayúsculas) antes de buscar.status: envía uno o más dedraft,under_review,pending_signature,canceled,waiting_initialization,operational,rejectedypaused. Fintoc devuelve todas las entidades cuyostatuscoincide con cualquiera de los valores que envíes.is_root: entruedevuelve solo la entidad root de tu organización; enfalse, solo las entidades que no son root.
Estados de reversa en transferencias chilenas
Las transferencias salientes chilenas exponen dos nuevos estados de ciclo de vida:reverse_pending: hay una reversa en curso.reversed: la transferencia se liquidó y luego fue revertida.
status de GET /v1/transfers acepta ambos valores, así puedes listar las reversas que recibió tu organización. Las transferencias mexicanas mantienen el mismo conjunto de estados.Revisa la referencia del objeto Transfer y la referencia para listar transferencias.Lista las cuentas de todas las entidades de tu organización
GET /v1/transfers/accounts ahora devuelve las cuentas de todas las entidades de tu organización cuando omites entity_id. Antes el endpoint devolvía solo las cuentas de la entidad root, así que tenías que recorrer GET /v1/entities para llegar al resto. Envía entity_id para mantener el comportamiento acotado anterior.Revisa la referencia para listar cuentas.Recupera eventos perdidos con una guía paso a paso
Una nueva guía te muestra cómo obtener los eventos que Fintoc ya envió y reprocesarlos en tu handler de webhooks después de una caída. Cubre cómo elegir la ventana de recuperación y cómo paginar constarting_after y ending_before. También muestra cómo reproducir los eventos del más antiguo al más nuevo, para que tu handler los procese en el mismo orden en que Fintoc los entregó, y cómo mantener la idempotencia en los reintentos.Revisa Recuperar eventos perdidos.Consulta los eventos que Fintoc te envió
GET /v2/events lista los eventos de tu organización en el modo de la API key que uses, del más nuevo al más antiguo. GET /v2/events/{id} devuelve un evento a partir del id que llega en cada webhook que recibes. Cada evento contiene en data el mismo payload que Fintoc entregó a tu endpoint, así reprocesas lo que tu integración perdió sin esperar un reenvío.- Filtros: Usa
typepara un tipo de evento yresource_idpara todos los eventos de un recurso. Usasinceyuntilpara un rango de tiempo. El rango acepta una fecha como2026-01-15o un datetime ISO 8601 como2026-01-15T14:30:00Z. - Paginación: los cursores
starting_afteryending_beforereciben un ID de evento, ylimitdevuelve hasta 300 eventos por página, 30 por defecto.
Cobra facturas fuera de suscripciones con send_invoice
Las invoices y suscripciones aceptan un nuevo collection_method: send_invoice. Fintoc no cobra la invoice al finalizarla: la deja open con su hosted_invoice_url para que tu cliente pague con el método que prefieras, o para que la marques cobrada por fuera. charge_automatically sigue siendo el valor por defecto y no cambia su comportamiento.- En invoices puntuales:
default_payment_methoddeja de ser obligatorio cuando usassend_invoice. La invoice queda abierta al finalizarla y avanza apaidcuando la conciliamos. - En suscripciones: cada ciclo genera una invoice que queda
openpara que la cobres. La suscripción arrancaactiveen lugar deincomplete, incluso sinpayment_method.
Marca una invoice como pagada fuera de Fintoc
POST /v2/invoices/{id}/pay acepta el nuevo parámetro external_payment. Envíalo en true cuando cobraste la invoice por otro medio (transferencia manual, efectivo, otro proveedor) y quieras dejarla registrada como pagada. Fintoc pasa la invoice a paid de inmediato, sin generar ningún Payment, y expone external_payment: true en el objeto.- Funciona en cualquier invoice
open: también en las que Fintoc intentó cobrar y fallaron, para cerrarlas manualmente sin reintentar el cobro. - Excluyente con
payment_method: si envías ambos, la API respondemutually_exclusive_params. Elige entre cobrar con un método específico o registrar el pago externo. - Irreversible: Fintoc no verifica el monto que cobraste y la operación no se puede deshacer.
POST /v2/invoices/{id}/pay para ver el detalle.Business profile en invoices y suscripciones
Al crear una invoice o una suscripción puedes declarar elbusiness_profile del negocio en cuyo nombre estás cobrando. Es el mismo campo que ya usas en Checkout Sessions y Payment Intents, disponible ahora en todo el flujo recurrente. Es obligatorio si tu organización identifica un business profile por pago (agregadores).- En invoices puntuales:
business_profilese aplica al cobro que Fintoc emite cuando finalizas la invoice. - En suscripciones:
business_profilese aplica a cada cobro automático que genera la suscripción. - Campos:
category(código MCC de seis dígitos),nameytax_iddel negocio.
Consulta una invoice fiscal por ID
La API Fiscal expone el nuevo endpointGET /v1/invoices/{id}. Recupera una invoice del SII o del SAT por su id, autenticándote con el link_token del Link fiscal correspondiente. Solo devuelve invoices del Link que envías, y en Links de tipo income solo devuelve boletas de honorarios emitidas por el titular.Revisa la referencia del objeto Invoice para ver todos los campos que retorna.Un solo payout para todos tus medios de pago
El payout con el que Fintoc te abona lo recaudado en Chile ahora cubre todos los medios de pago con los que cobras: transferencias, tarjetas, cuotas y botones de pago. Antes Fintoc enviaba los pagos con tarjeta en un payout propio; ahora los pagos con tarjeta llegan en la misma transferencia que los demás medios de pago.- Una transferencia por ciclo: el monto del payout es el neto de todos los medios de pago del ciclo. Tu calendario de payouts, su hora de corte y la cuenta que recibe los fondos no cambian.
- Un solo reporte de conciliación: todas las transacciones vienen en el reporte de conciliación de payouts con
resource_type: payment_intent, yresource_subtypete dice el medio:bank_transfer,credit_card,debit_card,prepaid_card,installment,pac. Fintoc descontinúa el reporte de tarjetas por separado. - Un evento de payout por ciclo: recibes un
payout.createdy unpayout.succeededen lugar de un par por medio de pago. El objetoPayoutno cambia.
charges, ese payout y su reporte se mantienen separados. Revisa la guía de reportes y conciliación para ver todas las columnas del reporte.Simula onboardings de entidades en modo test
Los onboardings deEntity en la API de Business Accounts ahora funcionan en modo test. Al enviar el onboarding con una clave sk_test_..., Fintoc corre una revisión simulada inmediata en lugar de una revisión de cumplimiento real, para que ejercites las rutas de aprobación y rechazo sin esperas.- Valor mágico en
business_activity:illegalfuerzarejected(eventoentity.onboarding.rejected);suspiciousdeja el onboarding ensubmittedsin evento; cualquier otro valor fuerzaapproved(eventoentity.onboarding.approved). Fintoc compara el string exacto, incluyendo mayúsculas y espacios. - Aislamiento por modo: los onboardings test y live son objetos separados. Una clave
testno puede leer ni operar un onboardinglivey viceversa; ambos casos devuelven404 Not Found.
Recupera suscripciones cuando falla el método de pago
Cuando una cuenta se cierra, una tarjeta vence o se revoca un Pago Automático de Cuentas (PAC), los cobros de una suscripción pueden fallar. El método de pago fallido también bloquea los cobros futuros de ese suscriptor. Ahora puedes actualizar el método de pago de una suscripción para repararla sin volver a crearla desde cero.- Le envías un link al usuario: creas una
CheckoutSessionconflow: setupapuntando a la suscripción, y el usuario enrola un método nuevo desde ese link. - Lo actualizas vía API: si el usuario ya autorizó un método de pago, lo asocias con
PATCH /v2/subscriptions/{id}.
hosted_invoice_url de cada una. Sigue el estado del cambio con los eventos subscription.payment_method_updated y subscription.payment_method_update_failed.Revisa la referencia de suscripciones y la referencia de eventos para ver el detalle de la activación del PAC y cómo consultar el estado de un método de pago en proceso.Transferencia bancaria como método de pago reutilizable
El objetoPaymentMethod ahora acepta el tipo bank_transfer, además de card y pac. Cuando un cliente inscribe una cuenta bancaria como método de pago, guardas la cuenta una sola vez y la reutilizas en pagos y suscripciones sin volver a pedir credenciales.- Nuevo objeto
bank_transfer: exponeaccount_holder_id,account_number,account_type(checking_accountosight_account),institution_id,institution_name,mfa_typeystatus(active,pendingocanceled). - Referencia igual que otros tipos: el campo
typeindicabank_transfery los detalles quedan en un campo homónimo, siguiendo el mismo patrón quecardypac.
Más contexto en Charges, Movements, Refresh Intents y Subscriptions
La API ahora expone campos adicionales en varios objetos para que reconcilies y depures con menos llamadas:Charge: ahora incluyesubscription_idpara identificar la suscripción que originó el cobro. El objeto también incluyerecipient_accountcon la cuenta que recibe los fondos (holder_id,institution_id,number,type). Revisa la referencia del objeto Charge.Movement: ahora incluyedocument_number(número que asigna la institución al movimiento) ytransfer_id(identificador que la institución asigna a la transferencia). Revisa la referencia del objeto Movement.RefreshIntent: nuevo campopublic_errorcon el código de error cuandostatusesfailed.retryable_errorindica que puedes reintentar;support_required_errorque debes contactar a soporte. Revisa la referencia del objeto Refresh Intent.Subscription: cadaline_itemahora incluye el objetoproductcompleto. El objeto incluyeid,object,created_at,description,image_url,metadata,modeyname, en lugar de soloname. Revisa la referencia del objeto Subscription.
Acepta pagos en tu tienda WooCommerce con Fintoc
Publicamos el plugin de Fintoc para WooCommerce. Instálalo en tu tienda para aceptar pagos por transferencia bancaria y tarjeta en pesos chilenos (CLP) y pesos mexicanos (MXN) a través del Checkout Session alojado de Fintoc. Descarga el plugin desde la página de Fintoc para WooCommerce, configura tu clave secreta y empieza a cobrar.- Confirmación mediante webhooks: el plugin confirma cada orden en segundo plano y verifica el estado del pago directamente contra la API de Fintoc, que es la fuente de verdad. No necesitas un secreto de webhook.
- Reembolsos desde WooCommerce: emite reembolsos totales o parciales desde la pantalla de la orden. El plugin envía la solicitud a la API de reembolsos de Fintoc y los concilia con los eventos
refund.*.
Cobra facturas con un enlace de pago
Cada factura tiene su propia URL de pago, disponible en el campohosted_invoice_url. Comparte el enlace por WhatsApp, email o el canal que uses. La factura queda al día en cuanto tu cliente paga.- Recupera un cobro fallido: cuando el cobro automático de una suscripción falla, Fintoc emite
invoice.payment_failedy habilitahosted_invoice_urlpara esa factura. Envía el enlace a tu cliente para recuperar el pago. - Concilia pagos automáticamente: el enlace está asociado a la factura. Cuando tu cliente paga, la factura queda marcada como pagada y facilita la conciliación. Tu cliente paga con los métodos de pago configurados para tu organización.
Períodos de prueba y UF en suscripciones
Ampliamos la API de suscripciones con dos capacidades nuevas:- Períodos de prueba (
trial_end): al crear una suscripción puedes definir la fecha en que termina la prueba (mínimo un día en el futuro). Durante la prueba la suscripción queda en estadotrialingy Fintoc no emite factura. Fintoc alinea elbilling_cycle_anchoral término del período y genera la primera factura cuando la prueba termina. - Cobros en UF (
CLF) dentro de suscripciones en CLP: un ítem con precio enCLFes facturable dentro de una suscripción enCLP, útil para planes indexados a UF. Fintoc convierte el monto al facturar y valida la compatibilidad de monedas entre ítems.
incomplete: la suscripción parte en incomplete y avanza a active cuando el primer pago se acredita. Fintoc cobra automáticamente usando el payment_method (collection_method: charge_automatically).Revisa la documentación de suscripciones y la guía de pagos recurrentes para ver los ejemplos completos.Nombre y descripción en ítems de suscripción
Losline_items de suscripciones aceptan dos campos nuevos:name: nombre visible del ítem tal como aparece en la factura.description: detalle adicional del ítem, también visible en la factura.
POST /v2/subscriptions/:id/items/:id. Los cambios se reflejan en la próxima factura sin prorrateo.Revisa la referencia de subscription items para ver el detalle.Metadata de tarjeta en Payment Intents
Los pagos con tarjeta ahora exponen un objetocard dentro de payment_type_options del PaymentIntent, con los datos que necesitas para reconciliar y personalizar la experiencia post-pago:brand,kind(credit,debit,prepaid) ylast_four_digits.bankycountryde emisión.authenticated_with_3ds:truecuando el titular completó 3-D Secure.wallet:apple_pay,google_payonullsi la tarjeta se ingresó manualmente.
Nuevos eventos de webhook para facturas
Agregamos dos eventos al ciclo de vida de una factura:invoice.payment_created: Fintoc lo envía cuando inicia el pago de una factura, antes de conocer el resultado.invoice.voided: Fintoc lo envía cuando se anula una factura.
Filtrar clientes por Tax ID
El endpointGET /v2/customers acepta dos nuevos parámetros de query:tax_id: RUT (con o sin puntos y guión) o RFC (en cualquier capitalización).tax_id_type:cl_rutomx_rfc. Si envíastax_idsintax_id_type, Fintoc lo compara contra ambos formatos.
tax_id_type sin tax_id devuelve todos los clientes con un tax ID en ese formato. Un tax_id_type no soportado retorna 400 con code: invalid_enum.Revisa la referencia de list customers para ver ejemplos.Luna aterrizó en tu dashboard
Ahora puedes gestionar tu operación de pagos en lenguaje natural desde el dashboard. Pregúntale a Luna qué está pasando con tus pagos o pídele que ejecute una tarea.Luna usa el contexto de tu cuenta: organización, país y vista actual del dashboard. También te ayuda a orientarte, encontrar lo que buscas y consultar la documentación de Fintoc sin abrir otra pestaña.Qué puedes hacer hoy
- Preguntar qué está pasando en la pantalla donde estás.
- Crear Claves Bancarias Estandarizadas (CLABE) o clientes desde el chat a partir de una lista de nombres.
- Crear o cancelar reembolsos.
- Analizar tus pagos, medios de pago y tasas de éxito según lo que es relevante para tu negocio.
- Resolver dudas de integración con respuestas basadas en la documentación de Fintoc.
Cómo empezar
Luna ya está disponible en tu dashboard. Entra a tu dashboard para empezar a usarla.Crea nuevas razones sociales vía API o Dashboard
Ahora puedes dar de alta nuevos clientes como razones sociales (el objetoEntity en la API). Luego completas su verificación Know Your Business (KYB) desde la API o desde el Dashboard. Ya no necesitas coordinar el proceso verbalmente con Fintoc.Elige el flujo según cómo trabajas hoy:- Desde el Dashboard: da de alta a tus clientes manualmente, sin escribir código.
- Desde la API: integra la API si ya tienes un proceso de onboarding con tus clientes. Incorpora los campos adicionales que pide Fintoc para mantener una experiencia uniforme para tus clientes.
Reembolsos por transferencia en minutos
Los reembolsos por transferencia ahora se desembolsan apenas se crean, en lugar de esperar al payout diario. Antes podían tardar hasta cerca de un día en llegar a la cuenta de tu cliente; ahora se completan en minutos.Qué cambia para tu integración
Nada. La mejora aplica del lado de Fintoc. Usas los mismos endpoints, recibes los mismos eventos (refund.in_progress, refund.succeeded, refund.failed) y los estados siguen siendo created, in_progress y succeeded. Lo único que cambia es que el reembolso llega a succeeded en minutos.Qué se mantiene igual
- Saldo insuficiente: si tu saldo disponible no cubre el monto, el reembolso queda en
createdy Fintoc lo reintenta automáticamente. - Expiración: si el saldo no alcanza tras 5 días hábiles, el reembolso pasa a
failed. - Cancelación: puedes cancelar un reembolso con
POST /v1/refunds/:id/cancelsolo mientras está encreated. Con este cambio, un reembolso con saldo suficiente avanza ain_progressen segundos, por lo que la ventana para cancelarlo es más corta.
MCP de Fintoc
Lanzamos el MCP de Fintoc. Conéctalo a Claude, Cursor o ChatGPT y opera Fintoc en lenguaje natural, sin cambiar de pestaña ni escribir scripts.¿Por qué usarlo?
- Tu operación financiera desde el chat que ya usas: pregunta por un pago fallido, consulta tu próxima dispersión o confirma si llegó una transferencia específica.
- Docs en contexto: el agente lee la documentación antes de proponer código, para ayudarte en base al producto real.
- Gratis e incluido con todos los productos Fintoc.
¿Cómo usarlo?
Agrega el servidor desde tu cliente MCP y completa el flujo OAuth en el browser:
Métodos alternativos para pagos por transferencia
Ahora puedes ofrecer pagos directos desde BancoEstado, Banco de Chile, Santander y Mach en tu checkout. Tus clientes pagan desde la app o sitio de su banco, con límites más altos que TEF, y tú no tienes que tocar tu integración para activarlos.Cada nuevo método amplía la orquestación de pagos de Fintoc: en cada intento evaluamos disponibilidad, costo y límites entre los proveedores habilitados en tu cuenta, y enrutamos la transacción al camino óptimo.Ventajas:
- Integración directa con cada banco: El cliente confirma el pago desde su app o sitio bancario habitual.
- Límites de transferencia más altos: Aprovecha límites superiores a los de la transferencia electrónica de fondos tradicional.
- Acepta pagos de empresas: Permite a tus clientes pagar con la cuenta bancaria de su empresa.
- Sin cambios en tu integración: No necesitas modificar código ni desplegar nada para empezar a recibir pagos por estos canales. Contacta al equipo de Fintoc para activarlos.

Múltiples API Keys en tu organización
Múltiples Secret API Keys Ahora puedes crear hasta 10 Secret API Keys por organización. Asigna un nombre y, opcionalmente, una fecha de expiración a cada una.¿Por qué usarla?
- Separa ambientes o servicios. Una key dedicada por integración, sin compartir credenciales.
- Rota sin downtime. Crea la nueva, migra tu integración, revoca la vieja.
- Revoca instantáneamente. Si una key se filtra, la puedes dar de baja sin afectar al resto.
- Programa expiraciones. Útil para accesos temporales o pruebas con terceros.

Fintoc CLI
Lanzamos la CLI de Fintoc, una herramienta para que tú o tu agente IA puedan interactuar con la API directo desde la terminal. Crea recursos, lista pagos y recibe webhooks enlocalhost sin abrir el Dashboard ni levantar túneles.¿Por qué usarla?
- Time-to-first-call más corto: instala, autentícate y haz tu primer llamado en menos de un minuto.
- Itera más rápido durante la integración: prueba payloads, lista recursos y crea webhooks sin armar requests a mano.
- Recibe webhooks en
localhostsin túneles como ngrok.
¿Cómo usarla?
Instálala con Homebrewfintoc <recurso> <acción>:Botón de Apple Pay para pagar con one-click en tu checkout
Ahora puedes implementar un botón de Apple Pay directamente en tu página de checkout, sin redirigir al usuario. Tu cliente toca el botón, confirma con Face ID o Touch ID, y el pago se completa en segundos.Ventajas:
- Sin redirección: El botón de Apple Pay se renderiza directo en tu página. El usuario nunca sale de tu sitio.
- Mayor conversión: Face ID / Touch ID reemplazan formularios de tarjeta. Menos pasos, menos abandonos.
- Misma API: Usa Checkout Sessions como siempre. Solo cambia el frontend para el botón.

Estados de cuenta mensuales
Tus cuentas Fintoc ahora generan estados de cuenta mensuales en PDF, listos para descargar desde el Dashboard o consultar por API.Cada documento resume los movimientos, balances, abonos y cargos del periodo, con la información que exige la regulación. Ya no necesitas armar esta información manualmente con planillas o copiando y pegando valores.Los estados de cuenta son retroactivos: si ya llevas meses operando, encontrarás los documentos de periodos anteriores disponibles automáticamente.
Ventajas
- Descarga los estados de cuenta: Selecciona uno o varios estados de cuenta y descárgalos con un click.
- Envíalos por correo a varias personas: Si tienes que enviar el estado de cuenta por email a una o más personas lo puedes hacer muy fácilmente.
- Desde el Dashboard y API: Obtén los estados de cuenta que quieras con su link de descarga.
- Exporta movimientos: Además de los PDFs, ahora puedes exportar el detalle de movimientos de cualquier cuenta en CSV, XLSX.
Ejemplo de PDF

Busca y elimina CLABEs inactivas
Ahora puedes buscar fácilmente las CLABEs que no reciben transferencias hace un tiempo y luego eliminarlas para liberar cuota para crear nuevas.Importante: Una vez eliminada, la CLABE entra en un periodo de espera antes de poder ser reasignada a otra organización.¿Por qué usarlo?
- Libera cuota: Cada CLABE eliminada reduce tu conteo de account numbers, permitiéndote crear nuevas.
- Identifica CLABEs inactivas: El nuevo filtro
no_transfers_sinceenGET /v2/account_numberste permite encontrar CLABEs sin actividad desde una fecha específica. - Reutilización limpia: Las CLABEs eliminadas entran en un pool y pueden reasignarse a cualquier usuario de Fintoc en el futuro. Al reasignarse, su información y lógica asociada se reinician por completo.
¿Qué cambió?
Principalmente cambios en la API:Nuevos campos en el objeto Account Number:deleted_at: timestamp de eliminación (nullsi no ha sido eliminado).last_transfer_at: timestamp del último pago recibido (nullsi nunca recibió uno).
no_transfers_sinceenGET /v2/account_numbers: filtra CLABEs que no han recibido transferencias desde una fecha.
DELETE /v2/account_numbers/{id}: elimina un account number de forma permanente.
Guarda destinatarios y reutilízalos en tus transferencias
Ahora puedes crear y guardar destinatarios desde el Dashboard para reutilizar sus datos al momento de hacer transferencias. Ya no necesitas ingresar el número de cuenta, banco o nombre del beneficiario cada vez que quieras enviar dinero a un mismo destinatario.¿Por qué usarlo?
- Menos errores en tus transferencias: Al guardar los datos de un destinatario una sola vez, eliminas el riesgo de escribir mal los datos en transferencias recurrentes.
- Transferencias más rápidas: Selecciona un destinatario guardado y transfiere en segundos, sin volver a llenar los datos de la cuenta destino.
- Gestión centralizada: Consulta, busca y edita todos tus destinatarios desde la nueva pestaña Destinatarios en la sección de Transferencias.
Para crear un destinatario
- En Transferencias > Destinatarios > Nuevo destinatario ingresa los datos del beneficiario: nombre, número de cuenta, banco, y opcionalmente un correo y alias para identificarlo fácilmente.


- El destinatario aparecerá en tu tabla de destinatarios, donde podrás buscarlo por nombre, institución o número de cuenta.

- En el detalle de cada destinatario puedes revisar su información, editarla o hacer clic en Transferir para enviarle dinero directamente.
Define límites para rechazar transferencias automáticamente
Ahora puedes definir límites mínimos y máximos al crear una CLABE, ya sea desde el Dashboard o vía API. Si una transferencia entrante no cumple con el rango establecido, el sistema la rechazará automáticamente.¿Por qué usarlo?
- Reducción de costos operativos: Elimina la carga de gestionar devoluciones manuales por montos incorrectos. El sistema filtra las operaciones por ti, ahorrando tiempo y recursos.
- Automatización de reglas de negocio: Asegura que cada cuenta reciba solo lo que esperas, aplicando tus reglas de validación de forma inmediata y sin errores.

Descarga comprobantes de transferencias
Para usuarios de Business Accounts, ahora en el detalle de tus transferencias en el dashboard puedes descargar el comprobante Fintoc.

Apple Pay en Chile
Ahora puedes ofrecer Apple Pay dentro del checkout de Fintoc, para que tus clientes paguen en segundos con Face ID/Touch ID, sin tener que ingresar los datos de su tarjeta. El pago por la billetera reduce fricción y errores, especialmente en móvil, y puede mejorar la conversión hasta en un 22%.Apple Pay viene habilitado por defecto en todos los checkouts con el método de pago por tarjetas, siempre que el dispositivo del usuario sea compatible con la billetera.📘 Revisa la documentación para crear un pago en sandbox y empezar a probar pagos con Apple Pay.
Herramientas de visualización del dashboard
Tenemos nuevas funcionalidades en el dashboard para que lo uses como te acomode más. Usa la navegación superior para:- Esconder y mostrar el menú lateral

- Ver la configuración de tu perfil y cerrar sesión

- Moverte entre modo prueba y modo en vivo

Pagos por Tarjetas en Chile
Ahora puedes aceptar pagos con tarjetas (crédito, débito o prepago) en Chile usando Fintoc, junto con transferencias bancarias. Así puedes ofrecer ambos métodos de pago para mejorar la conversión, con una sola integración, conciliación y reportería.Fintoc cuenta con certificación PCI DSS Nivel 1 y soporta autenticación 3DS cuando corresponde, para reducir el fraude y prevenir contracargos.📘 Consulta la la documentación para más detalles de la integración y empieza a probar el flujo de pago por tarjetas.Si te interesa conocer las condiciones comerciales y tarifas, haz clic acá para conversar con un experto en medios de pago.
Checkout Fintoc con las opciones de pago por transferencia y tarjetas
Nueva navegación en el Dashboard
Hicimos algunos cambios en la forma de navegar el dashboard, para que encuentres más rápido lo que estás buscando.- Reorganizamos la información y ahora tenemos 4 secciones principales:
- Iniciación de pagos. Aquí encontrarás información y configuraciones sobre Pagos puntuales y recurrentes, hechos por tus usuarios a través del Checkout de Fintoc.
- Tesorería. Aquí encontrarás Transfers y Accounts: herramientas e infraestructura para automatizar y tener control total del dinero de tu negocio.
- Conciliación (Solo Chile 🇨🇱). Aquí encontrarás conexiones a cuentas de instituciones externas.
- Para desarrolladores. Aquí podrás gestionar tus webhooks y obtener tus API Keys.
- Ahora en modo “En vivo”, sólo verás productos que ya tienes habilitados. En modo “Prueba” seguirás pudiendo probar todos los productos de Fintoc en nuestro Sandbox.

Ask AI en nuestra documentación
Agregamos Ask AI a la documentación de Fintoc. Ahora, si tienes una duda técnica o necesitas encontrar un endpoint rápido, puedes preguntarle directamente al asistente integrado.Para probarlo, busca el botón Ask AI en la esquina superior derecha mientras navegas por los docs.
Ahora puedes hacer payouts y recibir payins usando SPEI con Fintoc
Lanzamos el producto Business Accounts en México, una forma de hacer payins y payouts, conectado directo al SPEI. Usando Business Accounts podrás:- Crear cuentas CLABE al instante
- Verificación de CLABEs externas
- Hacer payouts inmediatos
- Recibir notificaciones en tiempo real de payins
- Asociar metadata para agilizar tu conciliación
- Hacer dispersiones masivas

Nuevo Widget de Débito Directo
Actualizamos por completo el widget de Débito Directo para hacerlo más rápido, más estable y visualmente alineado con los nuevos estilos de Fintoc.Mejoras principales- Nueva interfaz más limpia, moderna y fácil de usar.
- Flujo más rápido, con tiempos de carga más cortos.
- Menos errores en login y en los distintos métodos de autenticación (Mi Pass, SMS, coordenadas).
- Mejor feedback visual durante el proceso y mensajes más claros para el usuario.
- Pantalla de éxito renovada, con comprobante descargable y opción para compartir.

Webhook de Cambios en los Movimientos
Ahora puedes recibir notificaciones automáticas cuando un movimiento existente cambie alguno de sus atributos. Este nuevo webhook complementa al eventoaccount.refresh_intent.movements_removed, permitiéndote detectar no solo movimientos eliminados, sino también movimientos modificados durante un refresh.Tipo de eventoaccount.refresh_intent.movements_modifiedCuándo se activaSe activa cuando el banco actualiza información de movimientos ya existentes, por ejemplo:- Cambio en la descripción del movimiento.
- Cambio en el estado (
pending→confirmed). - Cambio en los datos de transferencia para movimientos de tipo
transfer. - Cualquier modificación de los atributos del movimiento entregados por el banco.
account.refresh_intent.movements_modified como se muestra en la imagen a continuación:
Errores de los Intentos de Suscripción
Ahora es más fácil entender por qué una suscripción falló. Agregamos visibilidad del error en tres lugares distintos:- API: El objeto
subscription_intentahora incluye el campopublic_errorcuando el status esfailed. - Webhooks: En el webhook
subscription_intent.failedtambién encontrarás el campopublic_error. OnExitcallback: Ahora el callback recibe directamente elerrorReason, que corresponde al mismo valor depublic_error.
public_errorlogin_invalid_credentialslogin_credentials_lockedauthorization_failedauthorization_timeoutrequest_timeoutsubscription_intent_expiredinternal_error
- Webhook
subscription_intent.failed:
OnExitcallback:
- API:
Nueva Vista de Cuentas Bancarias
Tenemos una nueva funcionalidad en el Dashboard de Links. Ahora, al seleccionar un Link en el Dashboard podrás ver:- Todas las cuentas bancarias asociadas a ese link.
- El estado de cada cuenta (activa, conectando, inválida, etc.).
- La última actualización y la próxima actualización a nivel de cuenta.

Status de los Movimientos
Ahora puedes ver el status de los movimientos directamente en el endpoint List Movements. Antes solo se mostraban los movimientos confirmados, pero ahora tienes mayor visibilidad del ciclo de vida de cada movimiento y más control sobre la información que recibes.- Se agregó el campo
statusal recurso Movement en el endpoint List Movements. Consulta a continuación todos los posibles estados. - Nuevo query param
confirmed_onlyque permite filtrar los movimientos:true: Solo movimientos confirmados (default).false: Todos los movimientos (incluyeconfirmed,processingyreversed).
- El comportamiento por defecto de la API no cambia: si no envías el query param, solo verás los movimientos
confirmed, tal como antes.
Intégrate más fácil con nuestro MCP Server
Acabamos de hacer que integrar Fintoc sea tan fácil como preguntarle a un amigo.Lanzamos nuestro MCP Server. Ahora tu herramienta de AI favorita puede conversar directamente con nuestra documentación, responder dudas y ayudarte a integrar Fintoc en pocas horas.Funciona con Cursor, Claude Code y cualquier herramienta de AI que soporte MCP. Se configura en menos de 30 segundos.Lo puedes instalar desde acá.
Historial de Webhooks
Ahora puedes ver todos los webhook events que has recibido, cuántas veces se intentó el envío, el código y payload de la respuesta que Fintoc está recibiendo de tu servidor. Puedes encontrarlo en la nueva subsección Eventos en la sección de Webhooks en el Dashboard.Con esta información en tiempo real se vuelve simple y rápido entender y corregir errores de integración.
Notificación por correo al usuario
Millones de personas realizan pagos y suscripciones con Fintoc cada mes. Sabemos que muchas de ellas necesitan una confirmación y un registro claro de que la transacción fue realizada exitosamente, más allá del aviso visual en el widget.Ahora, Fintoc notifica al usuario por correo electrónico cuando hay una actualización sobre sus transacciones de pagos, reembolsos o suscripciones, incluyendo un enlace para contactar a nuestro Soporte por WhatsApp si necesita ayuda.El correo para recibir el comprobante puede ser proporcionado por el comercio mediante el parámetrocustomer_email al momento de crear la Checkout Session, o ingresado por el propio usuario en la pantalla de pago exitoso dentro del widget.
Flujo para solicitar comprobante de pago exitoso en el widget + ejemplo del correo enviado
Pagos por Efectivo en Mexico
Ahora puedes aceptar pagos en efectivo en México usando Fintoc. Con la integración a nuestra Payment Intent API, puedes generar referencias de pago para que tus usuarios paguen en efectivo en más de 13.000 sucursales, como 7-Eleven, Walmart y farmacias.Al crear el pago desde la API, Fintoc responde con un número de referencia, un código de barras y un voucher con instrucciones para enviar al usuario. En el momento en que el pago se efectúa en la sucursal, Fintoc te notifica en tiempo real para que puedas avanzar en el flujo de entrega del producto o servicio.📘 Consulta la documentación de Cash Payments para más detalles de la integración.
Voucher con instrucciones para enviar al usuario
Entra a múltiples organizaciones con el mismo email
Sabemos que muchos de nuestros clientes optan por usar múltiples organizaciones para acomodar distintas razones sociales, recibir facturación separada, diferenciar el origen de los pagos y otras razones.Desde hoy es posible entrar a múltiples organizaciones usando un mismo email al iniciar sesión, facilitando el trabajo de quienes necesitan operar distintas organizaciones.Para empezar a usar esta funcionalidad, invita a los usuarios que necesites a todas las organizaciones donde necesiten estar. Una vez tengan acceso, podrán cambiarse usando el selector de organizaciones en la esquina superior izquierda del dashboard.
Pagos via Redirect Page

- Crear un Checkout Session desde tu backend, incluyendo los parámetros
success_urlycancel_url. - Recibirás en la respuesta un
redirect_url, que debes usar para redirigir a tu cliente a la página de pago de Fintoc. - Una vez realizado (o cancelado) el pago, el cliente será redirigido automáticamente a la URL correspondiente.
Error público ahora disponible en webhooks de Movements
Los eventosaccount.refresh_intent incluyen un nuevo atributo public_error que representa el tipo de error de la actualización. Para cada evento relacionado hay distintos valores.account.refresh_intent.succeeded: el valor siempre seránullaccount.refresh_intent.rejected: el valor siempre seránullaccount.refresh_intent.failed: hay dos valoressupport_required_error: indica que la actualización falló por un error que requiere asistencia de nuestro equipo de soporte.retryable_error: indica que la actualización falló por una intermitencia, por lo que se puede reintentar de inmediato.
account.refresh_intent.failed:Valor de
public_errorEl valor de public_error puede variar según el tipo de error. En este ejemplo es retryable_error, pero también puede ser support_required_error o null.Payment Links ahora disponible para Direct Payments y Fintoc Reconciles
Hasta ahora nuestro producto de Links de Pago sólo estaba disponible en Chile para clientes que usan el modelo Fintoc Collects. Desde hoy, empresas que usan Direct Payments o Fintoc Reconciles también podrán crear links de pago a través de nuestra API.
Pagos por Transferencia Directa en Chile

Rediseño de las vistas de error para incentivar a reintentar

Seguridad en la API

Agregar una capa de seguridad extra a tus solicitudes a la API usando JSON Web Signature (JWS).
Comunicando errores de conexión

Permisos - Ahora más granulares

Ve y descarga tus facturas
Habilitamos la descarga de facturas y archivos de usabilidad desde el dashboard en la sección de ajustes. Con esto puedes ver tu histórico de facturas y a qué operaciones corresponde cada factura. Úsalo acá.Pagos con Face ID o huella


Desde diciembre, los usuarios pueden usar Face ID o huella en vez de escribir el RUT y contraseña cada vez que pagan con Fintoc. Usando passkeys (cifrado asimétrico) los usuarios pueden hacer login con su huella o Face ID, logrando un pago hasta 6 segundos más rápido.Para más información puedes leer este blogpost.
Analytics - Tus métricas de un vistazo

Además de recibir webhooks con toda la información relacionada a un pago (que requiere tiempo y recursos para procesar), ahora puedes tener de un vistazo las métricas más importantes de tus pagos en el mismo dashboard.Gana más visibilidad de tus operaciones en la sección Resumen. Importante: esta función solo está disponible para clientes de Iniciación de Pagos.