Links de pago

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.

Crear un Link de pago

Usando tu secret key, crea un link de pago desde tu backend con el amount y currency:

curl --request POST "https://api.fintoc.com/v1/payment_links" \
--header 'Authorization: sk_test_0000000000000000' \
--header 'Content-Type: application/json' \
--data-raw '{
  "amount": 120900,
  "currency": "CLP",
  "expires_after_seconds": 86400,
  "customer_email": "customer@example.com",
  "checkout": {
    "description": "Use this field to add a custom description of the product the customer is buying"
  },
  "metadata": {
    "your_order_id": "10000"
  },
  "recipient_account": {
    "holder_id": "111111111",
    "number": "0000000000",
    "type": "checking_account",
    "institution_id": "cl_banco_de_chile"
  },
  "business_profile": {
    "name": "Merchant Name",
    "category": "009613",
    "tax_id": "222222222"
  }
}'

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:

Parámetros opcionales	Tipo	Descripción
`expires_after_seconds`	`integer`	El número de segundos después de los cuales el link de pago expirará. Por defecto, un link de pago no expirará.
`customer_email`	`string`	Si se establece un correo de cliente, Fintoc enviará al cliente un correo en caso de un reembolso.
`checkout`	`dictionary`	Personaliza el checkout para tus clientes. Por ahora, solo puedes agregar una descripción personalizada junto al botón de compra.
`metadata`	`hash`	Conjunto de pares clave-valor que puedes adjuntar al link de pago. Esto puede ser útil para almacenar información adicional que puedes usar para conciliar el pago con tus sistemas internos.
`recipient_account`	`object`	El objeto recipient account debe incluirse si tu organización usa Pagos Directos.
`business_profile`	`object`	Objeto para identificar comercios inscritos para precios basados en categoría.

El objeto recipient account está definido por 4 atributos:

Parámetro	Ejemplo	Explicación
`holder_id`	111111111	RUT del titular de la cuenta
`number`	0000000000	Número de cuenta
`type`	checking_account	Tipo de cuenta. Los tipos admitidos son `checking_account` y `sight_account`.
`institution_id`	`cl_banco_de_chile`	ID de institución de Fintoc del banco que recibe la transferencia bancaria. Consulta el código de cada banco.

Para una lista completa de parámetros, revisa la API de Links de pago (objeto PaymentLink).

Comparte tu Link de pago

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.

{
  "id": "plink_K2zwNNSxPyx8w3GZ",
  "object": "payment_link",
  "amount": 120900,
  "currency": "CLP",
  "status": "active",
  "created_at": "2024-08-02T20:28:13Z",
  "expires_at": "2024-08-02T21:28:13Z",
  "mode": "test",
  "url": "https://pay.fintoc.com/plink_K2zwNNSxPyx8w3GZ",
  "customer_email": "customer@example.com",
  "checkout": {
    "description": "Use this field to add a custom description of the product the customer is buying"
  },
  "metadata": {
    "your_order_id": "10000"
  },
  "recipient_account": {
    "holder_id": "111111111",
    "number": "0000000000",
    "type": "checking_account",
    "institution_id": "cl_banco_de_chile"
  }
}

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 exitosos. Si el link tiene un pago exitoso, el Dashboard abre el detalle de ese pago. Si tiene varios, 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.

Cancelar un Link de pago

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

Ve a la tabla de Links de pago en el Dashboard.
Haz clic en el menú de tres puntos de la fila del link de pago que quieres cancelar.
Selecciona Desactivar.
En el modal de confirmación, haz clic en Desactivar.

El Dashboard solo habilita Desactivar para links activos y solo muestra la opción a usuarios con permiso para gestionar links de pago.

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:

curl --request PATCH \
     --url https://api.fintoc.com/v1/payment_links/plink_K2zwNNSxPyx8w3GZ/cancel \
     --header 'Authorization: sk_test_0000000000000000' \
     --header 'accept: application/json'

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.

Inicio

Recursos

Pagos

Business Accounts

Movimientos

Skeleton group medium 9

Crear un Link de pago

Comparte tu Link de pago

Ofrece pagos en efectivo en México

Rastrear pagos

Cancelar un Link de pago

Desde el Dashboard

A través de la API

Inicio

Recursos

Pagos

Business Accounts

Movimientos

Skeleton group medium 9

​Crear un Link de pago

​Comparte tu Link de pago

​Ofrece pagos en efectivo en México

​Rastrear pagos

​Cancelar un Link de pago

​Desde el Dashboard

​A través de la API

Crear un Link de pago

Comparte tu Link de pago

Ofrece pagos en efectivo en México

Rastrear pagos

Cancelar un Link de pago

Desde el Dashboard

A través de la API