Página de redirección

Cuando tus clientes eligen pagar con Fintoc, el proceso funciona de la siguiente manera:

Creación de la Checkout Session: tu backend llama a nuestra API para crear una Checkout Session. Debes incluir un success_url y un cancel_url en tu solicitud.
Recepción del Redirect URL: nuestra API responde con una sesión que contiene un redirect_url. Esta URL se usa para enviar a tu cliente a nuestra página de pago segura.
Flujo de pago del cliente: tu cliente es redirigido a nuestra página de pago, donde completa su pago en el Widget de Fintoc.
Flujo de retorno: después del pago, tu cliente es enviado automáticamente de vuelta a tu sitio a través del success_url o cancel_url proporcionado.

Crear una Checkout Session

Usando tu Secret Key, crea una Checkout Session en tu servidor con el success_url y cancel_url:

curl --request POST \
     --url https://api.fintoc.com/v1/checkout_sessions \
     --header 'Authorization: YOUR_TEST_SECRET_API_KEY' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data-raw 
'{
  "amount": 1000,
  "currency": "CLP",
  "cancel_url": "https://merchant.com/987654321",
  "success_url": "https://merchant.com/success",
  "customer_email": "customer@example.com",
  "metadata": {
      "order": "987654321"
    }
}'

Node

// Primero debes instalar el SDK de Node de Fintoc: https://docs.fintoc.com/docs/accept-a-payment-copy#optional-install-our-backend-sdk

const checkoutSession = await fintoc.checkoutSessions.create({
	amount: 1000,
  currency: 'clp',
  customer_email: 'name@example.com',
  cancel_url: 'https://merchant.com/987654321',
  success_url: 'https://merchant.com/success',
  metadata: {
    order: '987654321'
  }
});

Python

# Primero debes instalar el SDK de Python de Fintoc: https://docs.fintoc.com/docs/accept-a-payment-copy#optional-install-our-backend-sdk

checkout_session = client.checkout_sessions.create(
    amount=1000,
    currency='clp',
    customer_email='name@example.com',
    cancel_url='https://merchant.com/987654321',
    success_url='https://merchant.com/success',
    metadata={
        order: '987654321'
    }
)

Parámetro	Ejemplo	Explicación
`amount`	`2476`	Monto de dinero que debe ser pagado. Se representa como un entero sin decimales en la unidad más pequeña posible de la moneda que estés usando. Un monto de MXN 24.76 se representa como 2476. Para pagos en efectivo, el monto máximo permitido es 500000 (5,000 MXN).
`currency`	`MXN`	Moneda que se está usando para el pago. Actualmente solo soportamos MXN para pagos en efectivo.
`success_url`	`https://merchant.com/success`	URL para redirigir al usuario en caso de pago exitoso.
`cancel_url`	`https://merchant.com/987654321`	URL para redirigir al usuario en caso de que decida cancelar el pago y volver a tu sitio web.
`customer_email`	`customer@example.com`	Correo de cliente opcional vinculado a una Checkout Session. Se usa para notificar al usuario en caso de un reembolso.
`metadata`	`{"order": "987654321"}`	Conjunto opcional de pares clave-valor que puedes adjuntar a un objeto. Esto puede ser útil para almacenar información adicional sobre el objeto en un formato estructurado.

Manejo de la respuesta de la API

Después de crear la checkout session, recibirás una respuesta que incluye un redirect_url junto con otros parámetros importantes. Por ejemplo:

{
  "id": "cs_li5531onlFDi235",
  "created_at": "2025-02-06T18:42:51Z",
  "object": "checkout_session",
  "currency":"CLP",
  "amount": "1000",
  "customer_email":"customer@example.com",
  "expires_at": "2025-02-06T18:52:51Z",
  "mode": "live",
  "status":"created",
  "session_token": "cs_li5531onlFDi235_sec_a4xK32BanKWYn",
  "cancel_url": "https://merchant.com/987654321",
  "success_url": "https://merchant.com/success",
  "metadata": {
      "order": "987654321"
    },
  "business_profile": {},
  "redirect_url": "https://pay.fintoc.com/payment?checkout_sesion=cs_li5531onlFDi235"
}

Manejo de eventos post-pago

Fintoc envía un evento checkout_session.completed cuando el pago está completo. Usa la guía de webhooks para recibir estos eventos y ejecutar acciones, como enviar un correo de confirmación de orden a tu cliente, registrar la venta en una base de datos o iniciar un flujo de envío. Escucha estos eventos en lugar de esperar un callback del cliente. Desde el lado del cliente, el cliente podría cerrar la ventana del navegador o salir de la app antes de que se ejecute el callback, y los clientes maliciosos podrían manipular la respuesta. Recomendamos manejar los siguientes eventos:

Evento	Descripción	Acción
`checkout_session.finished`	Se envía cuando un cliente ha completado un pago. El webhook contiene información sobre el pago, incluyendo su estado final.	Dependiendo del estado final del pago relacionado, confirma la orden al cliente u ofrécele reintentar el pago.
`checkout_session.expired`	Se dispara cuando un cliente abandona el flujo de pago antes de terminar.	Ofrece al cliente otro intento de pagar.

Aprende más sobre webhooksPara aprender más sobre cómo crear tu propio endpoint de webhook, probar tu endpoint de webhook y las mejores prácticas de seguridad, lee nuestra guía de Webhooks.

Inicio

Recursos

Pagos

Transferencias

Movimientos

Página de redirección

Crear una Checkout Session

Manejo de la respuesta de la API

Manejo de eventos post-pago

​Crear una Checkout Session

​Manejo de la respuesta de la API

​Manejo de eventos post-pago

Crear una Checkout Session

Manejo de la respuesta de la API

Manejo de eventos post-pago