Skip to main content
Después de probar tu integración en modo test, hay algunas tareas que debes completar antes de salir a producción con el producto de Payment Initiation. El ambiente de test de Fintoc es funcionalmente muy similar al modo live, pero es importante realizar pruebas para configurar correctamente tu ambiente live.

​
Quién puede usar Fintoc

Para usar Fintoc, tu negocio debe cumplir todos estos requisitos:
  • Un identificador tributario de empresa. En Chile, es el RUT de empresa. En México, es el RFC de la empresa (12 caracteres).
  • Una cuenta bancaria a nombre de tu empresa. Fintoc solo envía tus liquidaciones a una cuenta asociada al RUT o RFC de tu empresa.
  • Un correo con el dominio de tu empresa. Regístrate con un correo corporativo, no con uno personal como Gmail o Hotmail.
Fintoc no acepta personas naturales, incluidas las personas naturales con giro. El Dashboard rechaza un RUT personal con el error “El RUT debe pertenecer a una empresa”. En Chile, tu empresa también necesita al menos 6 meses de actividad, contados desde la fecha de tu certificado de inicio de actividades. Si tu empresa es más reciente, el Dashboard muestra un error al subir el certificado y no puedes completar el onboarding.
Asegúrate de que tu integración admita cambios compatibles con versiones anterioresHacemos constantemente cambios compatibles con versiones anteriores a nuestra API para agregar nuevas funcionalidades. Asegúrate de que tu integración pueda soportar tales cambios una vez que salgas a producción. Para más información, lee nuestra guía sobre Cambios en la API.
  • Configura las API Keys de Live en tu backend
En tu dashboard, abre la pestaña API Keys. Confirma que estás en modo live verificando el indicador de toggle en la esquina inferior izquierda.
Genera tu Live Secret Key y configúrala en tu backend para hacer solicitudes a la API en modo Live.
Solo puedes acceder a tu Secret API Key una vezSolo podrás copiar y ver tu API Key cuando la actives o rotes. Asegúrate de almacenarlas de forma segura en tu backend.

  • Confirma que tus productos están habilitados en modo Live
Los productos que usas en modo test no se habilitan automáticamente para tu organización en live. Confirma con tu Account Executive, o escribiendo a sales@fintoc.com, que cada producto y método de pago que usas está habilitado en modo Live. Por ejemplo, las suscripciones con pac requieren el producto Subscriptions, y las suscripciones con card requieren pagos con tarjeta con inscripción para cobros futuros. Si un producto no está habilitado, las solicitudes a la API en live devuelven un error 403 con code: product_access_required. Consulta Sal a producción en la guía de suscripciones.
  • Configura nuevos webhooks para mantener tu aplicación sincronizada con Fintoc
Los webhooks creados en modo test no notificarán a tu aplicación sobre eventos que ocurren en modo Live. Necesitarás configurar nuevos webhooks en tu ambiente de producción para manejar cualquier evento relacionado con una Checkout Session. Si necesitas ayuda configurando nuevos webhooks, revisa nuestra Guía de Webhooks. Hay varios eventos que puedes configurar desde el dashboard o la API para recibir notificaciones sobre el proceso de pago, pero hay cuatro eventos asociados al procesamiento de una Checkout Session que son críticos para la operación y se envían vía webhook: checkout_session.finished, checkout_session.expired, payment_intent.succeeded y payment_intent.failed. Revisa nuestra Guía de Webhooks para entender cómo funcionan los webhooks de Fintoc y cómo puedes configurar tus endpoints de Webhook.
Elige el botón de pago correcto para tu checkout: nuestra investigación ha demostrado que el botón de pago afecta la conversión. Lanza el widget sin redirigir al cliente: integrar el widget de pago de esta forma promueve la confianza, haciendo más probable que el usuario ingrese sus credenciales bancarias y finalice el pago. Asegúrate de que no haya elementos visuales adicionales durante el flujo de pago: mantener el flujo de pago limpio y simple mejora la experiencia general del pago. Redirige correctamente al usuario final después de realizar un pago: ya sea que el pago sea exitoso o no, es importante reducir la incertidumbre y confirmar el estado final del pago del cliente.
  • Maneja correctamente los casos extremos relacionados con webhooks
Algunos pagos pueden tener campos nulos si el usuario sale a mitad del proceso. Asegúrate de manejar estos casos como se muestra en nuestra guía de pagos.
  • Especifica la cuenta donde quieres recibir las liquidaciones
Si estás usando Fintoc Collects, necesitarás especificar la cuenta bancaria en la que quieres recibir las liquidaciones. Para hacerlo, envía un correo a tu Account Executive especificando: 🇨🇱
  • Nombre del banco
  • Tipo de cuenta
  • Número de cuenta
  • RUT
  • Correo de notificaciones
🇲🇽
  • Nombre de la empresa
  • Nombre del banco
  • CLABE
  • RFC
  • Correo de notificaciones
  • Dirección de la empresa

  • Realiza pruebas de certificación
Antes de pasar a producción, debes asegurarte de que tu integración se haya realizado correctamente. Las pruebas que realizaremos involucran pagos reales, por lo tanto debes:
  • Pedirle a tu Sales Executive que active el modo Live en tu cuenta. Debes poder lanzar el widget en este modo. Si lo deseas, puedes realizar las pruebas en un sitio de desarrollo, pero siempre usando las credenciales del modo Live y realizando pagos reales.
  • Tener tus endpoints de webhook configurados en modo Live.
Pruebas de Payment Initiation
  1. Completa un pago exitoso usando Fintoc.
    Resultados esperados:
    1. Puedes iniciar correctamente una Checkout Session y mostrar el widget. Si tu flujo de pago requiere que el usuario ingrese su RUT (en CL) o número de teléfono (en MX) antes del pago, el widget se despliega con el campo username precompletado.
    2. Después de finalizar el flujo de pago, rediriges correctamente al usuario final a una página de confirmación en tu sitio.
    3. Tu sistema registra el pago como exitoso y se disparan el resto de tus procesos (por ejemplo, enviar un correo de confirmación).
  2. Crea una nueva Checkout Session y cierra el widget antes de autorizar el pago.
    Resultados esperados:
    1. Tu frontend redirige al usuario final a una página donde puede reintentar el pago o elegir otro método de pago.
    2. Tu sistema registra el pago como fallido usando webhooks.
  3. Simula una Checkout Session donde el usuario final autoriza la transacción en su app bancaria y cierra la pestaña inmediatamente después.
    Resultados esperados:
    1. Tu sistema registra el pago como exitoso después de recibir el webhook de confirmación.
    2. Se disparan el resto de tus procesos (por ejemplo, enviar un correo de confirmación).
  4. Simula un pago que resulta en un estado pendiente.
    Resultados esperados:
    1. Tu sistema registra el pago como pendiente después de recibir el webhook checkout_session.finished con un estado final pendiente.
    2. Se muestra un mensaje al usuario final indicando que el pago aún no ha sido confirmado.
    3. Puedes decidir cómo manejar el resto del flujo de pago según los requisitos de tu negocio y nuestra guía de pagos pendientes.
  • Sal a producción
Después de completar las pruebas de certificación, estás listo para poner tu integración en Live.