Skip to main content
Con los Links de pago puedes aceptar pagos sin construir un sitio web o aplicación. Crea un Link de pago usando nuestra API y compártelo con tus clientes por correo electrónico o WhatsApp.

Requisitos

Las organizaciones registradas a través de Shopify no pueden crear Links de pago. Fintoc también bloquea la creación de Links de pago para algunas otras organizaciones. Si tu organización está bloqueada:
  • El botón Crear link de pago del Dashboard se mantiene deshabilitado, aunque tu usuario tenga permiso para gestionar links de pago. El tooltip muestra No tienes permiso para crear links de pago.
  • La API rechaza las solicitudes para crear pagos y Links de pago con 403 Forbidden y el mensaje This organization is not allowed to create payments through the API.
Para solicitar Links de pago para tu organización, escribe a soporte@fintoc.com o sales@fintoc.com. Fintoc revisa cada solicitud. Usando tu secret key, crea un link de pago desde tu backend con el amount y currency:

Monedas representadas como enterosLa API de Fintoc representa las monedas en sus unidades más pequeñas posibles sin decimales (como un entero). Eso significa que un monto de MXN 247.50 se representa en Fintoc como 24750. Puedes leer más sobre monedas aquí.
Los parámetros customer_email, checkout, metadata y business_profile son opcionales. Algunos de los parámetros opcionales que puedes usar para crear tu link de pago son: El objeto recipient account está definido por 4 atributos: Para una lista completa de parámetros, revisa la API de Links de pago (objeto PaymentLink). Cada link de pago contiene una url que puedes compartir con tus clientes por correo electrónico, WhatsApp o a través de otros canales.

Ofrece pagos en efectivo en México

Si tu organización tiene habilitados los pagos en efectivo, tus Links de pago en MXN ofrecen efectivo automáticamente. No necesitas enviar ningún parámetro adicional al crear el link. Tu cliente ve la opción Paga en efectivo junto a los otros métodos de pago, con los logos de las tiendas que aceptan el monto del link. Al elegirla, tu cliente genera un voucher con la referencia para pagar en la tienda. Fintoc oculta la opción de efectivo cuando:
  • Ninguna tienda acepta el monto del Link de pago.
  • La sesión de checkout de tu organización dura menos que el tiempo que tu cliente necesita para pagar en efectivo.

Rastrear pagos

Cuando los clientes usan un link de pago para completar un pago, Fintoc envía un webhook payment_intent.succeeded que puedes usar para cumplimiento y conciliación. Este webhook contendrá las claves metadata que usaste para crear el link de pago. Para más información, consulta nuestra guía sobre cómo completar el pago en tu backend. En el caso de links de pago, te recomendamos escuchar solo los eventos payment_intent.succeeded. También puedes ver los pagos exitosos de un Link de pago en el Dashboard:
  • Desde la tabla de Links de pago: Haz clic en el conteo de la columna Pagos recibidos. Si el link tiene un pago exitoso, el Dashboard abre el detalle de ese pago. Si el link tiene más de un pago exitoso, el Dashboard abre tu historial de pagos filtrado por ese link y por el estado Exitoso. Los links sin pagos exitosos muestran --.
  • Desde el historial de pagos: Usa el filtro Link de pago e ingresa el ID exacto del Link de pago. El filtro aparece cuando tu organización tiene al menos un Link de pago en el modo actual.
  • Desde el detalle de un pago: Si el pago viene de un Link de pago, la fila Link de pago muestra el ID del link. Haz clic en ella para abrir la tabla de Links de pago filtrada por ese ID.
Para ver todos los datos de un Link de pago en un solo lugar, haz clic en su fila en la tabla de Links de pago. La página de detalle muestra el monto del link, la cantidad de pagos recibidos, el total recibido, los detalles y la metadata del link. También incluye una tabla de Pagos con todos los pagos hechos a través del link. El monto de Total recibido no descuenta devoluciones ni contracargos. Puedes cancelar un link de pago activo desde el Dashboard o a través de la API. Solo puedes cancelar links activos. No puedes cancelar links expirados, links ya cancelados ni links de uso único con estado Completado.

Desde el Dashboard

  1. Ve a la tabla de Links de pago en el Dashboard.
  2. Haz clic en el menú de tres puntos de la fila del link de pago que quieres cancelar. También puedes abrir la página de detalle del link de pago y hacer clic en el menú de tres puntos de la parte superior.
  3. Selecciona Desactivar.
  4. En el modal de confirmación, haz clic en Desactivar.
El menú de tres puntos también tiene Copiar URL y Abrir link. El Dashboard solo muestra Desactivar a usuarios con permiso para gestionar links de pago, y solo lo habilita para links activos.
No puedes deshacer la desactivación de un link de pago. Los pagos que ya estén en proceso al momento de desactivar el link aún pueden completarse.

A través de la API

Cancela un link de pago usando el endpoint de cancelación:
Después de cancelar un link de pago, los clientes ya no pueden finalizar compras usando el enlace y son redirigidos a una página de expiración.