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

Crear un Payment Link

Usando tu Secret Key, crea un payment link 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": "MXN",
  "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": "771433855",
    "number": "1836027172",
    "type": "checking_account",
    "institution_id": "cl_banco_de_chile"
  },
  "business_profile": {
    "name": "Merchant Name",
    "category": "009613",
    "tax_id": "774981120"
  }
}'

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 payment link son:

Parámetros opcionales	Tipo	Descripción
`expire_after_seconds`	`integer`	El número de segundos después de los cuales el payment link expirará. Por defecto, un payment link 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 payment link. 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`	193426816	RUT del titular de la cuenta
`number`	1836027172	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. Puedes ver el código para cada banco aquí

Para una lista completa de parámetros, revisa la API de Payment Link.

Comparte tu Payment Link

Cada payment link contiene una url que puedes compartir con tus clientes por correo electrónico, WhatsApp o a través de otros canales.

json

{
  "id": "plink_K2zwNNSxPyx8w3GZ",
  "object": "payment_link",
  "amount": 120900,
  "currency": "MXN",
  "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": "771433855",
    "number": "1836027172",
    "type": "checking_account",
    "institution_id": "cl_banco_de_chile"
  },
	"business_profile": {
  	"name":"Merchant Name",
    "category": "009613",
    "tax_id": "774981120"
  }
}

Rastrear pagos

Cuando los clientes usan un payment link 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 payment link. Para más información, consulta nuestra guía sobre cómo completar el pago en tu backend. En el caso de payment links, te recomendamos escuchar solo los eventos payment_intent.succeeded. También puedes ver los pagos exitosos usando nuestro Dashboard.

Cancelar un Payment Link

Puedes cancelar un payment link usando el endpoint de cancelación:

curl

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

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

Inicio

Recursos

Pagos

Transferencias

Domiciliación bancaria

Movimientos

Payment Links

Crear un Payment Link

Comparte tu Payment Link

Rastrear pagos

Cancelar un Payment Link

​Crear un Payment Link

​Comparte tu Payment Link

​Rastrear pagos

​Cancelar un Payment Link

Crear un Payment Link

Comparte tu Payment Link

Rastrear pagos

Cancelar un Payment Link