Para comenzar a usar la API de Checkout Session de Fintoc, solo necesitas crear una cuenta en nuestro Dashboard y seguir estos cinco pasos:

Obtén tus API Keys de test
Crea una Checkout Session
Redirige a tu usuario a la página de checkout alojada por Fintoc
Maneja eventos post-pago
Realiza tu primer pago

Paso 1: configuración inicial

Obtén tus API Keys de test

Cada interacción con la API de Fintoc debe ser autenticada con las API Keys de tu cuenta de Fintoc. Si una interacción con la API no incluye tu API Key o incluye una API Key incorrecta, Fintoc devolverá un error. Cada cuenta de Fintoc tiene dos pares de claves: uno corresponde al modo test, mientras que el otro corresponde al ambiente real de la API. Cada recurso se almacena en modo test o en modo live, y los recursos de un ambiente no pueden ser manipulados por recursos del otro ambiente. Tus API Keys estarán disponibles en el Dashboard. Primero necesitas crear una cuenta en el Dashboard de Fintoc. Una vez creada tu cuenta de Fintoc, podrás obtener tus API Keys. En este caso, debes usar la Public Key y la Secret Key del modo test. Para identificarlas fácilmente, agregamos los prefijos pk_test_ y sk_test_, respectivamente.

Opcional: instala el SDK de backend de Fintoc

Python
Node

Si usas Python, puedes instalar nuestro SDK de Python para interactuar con nuestra API de manera más sencilla. El SDK maneja automáticamente la paginación, te permite verificar fácilmente los webhooks de Fintoc y ofrece muchas otras funciones útiles.

pip install fintoc

Si usas Node, puedes instalar nuestro SDK de Node para interactuar con nuestra API de manera más sencilla. El SDK maneja automáticamente la paginación, te permite verificar fácilmente los webhooks de Fintoc y ofrece muchas otras funciones útiles.

npm install fintoc

Paso 2: crea una Checkout Session

Usando tu Secret Key de test, crea una Checkout Session desde tu backend con el monto y la moneda del pago. Crea siempre la Checkout Session desde tu backend, o un usuario malicioso podría alterar cualquiera de esos campos. Si planeas usar el producto de Refunds, debes incluir un customer_email en la solicitud de la Checkout Session. Aquí tienes un ejemplo de cómo crear una Checkout Session para Chile:

curl --request POST "https://api.fintoc.com/v2/checkout_sessions" \
  --header "Authorization: YOUR_TEST_SECRET_API_KEY" \
  --header "Content-Type: application/json" \
  --data-raw '{
    "amount": 2476,
    "currency": "CLP",
    "customer_email": "name@example.com",
    "success_url": "https://merchant.com/success",
    "cancel_url": "https://merchant.com/987654321"
  }'

Node

const { Fintoc } = require('fintoc');

const fintoc = new Fintoc('YOUR_TEST_SECRET_API_KEY');

const checkoutSession = await fintoc.checkoutSessions.create({
  amount: 1000,
  currency: 'mxn',
  customer_email: 'name@example.com'
});

from fintoc import Fintoc

client = Fintoc('YOUR_TEST_SECRET_API_KEY')

checkout_session = client.checkout_sessions.create(
  amount=1000,
  currency='clp',
  customer_email='name@example.com'
)

require 'net/http'
require 'uri'
require 'json'

checkout_session = {
  amount: 1000,
  currency: 'clp',
  customer_email: 'name@example.com'
}

uri = URI("https://api.fintoc.com/v2/checkout_sessions")

header = {
  Accept: 'application/json', Authorization: 'YOUR_TEST_SECRET_API_KEY'
}

http = Net::HTTP.new(uri.host, uri.port)
request = Net::HTTP::Post.new(uri.request_uri, header)
request.body = checkout_session.to_json

response = http.request(request)

Si quieres crear una Checkout Session para México, cambia la moneda a MXN.

Las monedas se representan 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 10.29 se representa en Fintoc como 1029. Puedes leer más sobre monedas aquí.

La respuesta debería verse así:

{
  "id": "cs_li5531onlFDi235",
  "object": "checkout_session",
  "mode": "test",
  "status": "created",
  "amount": 350000,
  "currency": "CLP",
  "created_at": "2024-06-04T15:32:46.721Z",
  "updated_at": "2024-06-04T15:32:46.721Z",
  "success_url": "https://merchant.com/success",
  "cancel_url": "https://merchant.com/987654321",
  "redirect_url": "https://checkout.fintoc.com/checkout_session_01HXY3Z7X5YQ54V8G2E1KJQAVF",
  "metadata": {},
  "customer": {}
}

Paso 3: redirige a tu usuario a la página de checkout alojada por Fintoc

Tu checkout_session recién creada debería contener el atributo redirect_url. Debes redirigir a tu usuario a esta URL para completar el flujo de pago.

Flujo de pago cuando el usuario selecciona "Paga con tu banco"

Paso 4: maneja eventos post-pago

Fintoc envía un evento checkout_session.finished cuando el pago relacionado a una sesión se completa. 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.
`payment_intent.succeeded`	Se envía cuando el pago relacionado a una checkout session tiene éxito. Es útil para confirmar pagos que previamente estaban en estado pendiente.	Confirma la orden del cliente.
`payment_intent.failed`	Se envía cuando el pago relacionado a una checkout session falla. Se usa para determinar el estado final de pagos que previamente estaban en estado pendiente.	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.

Paso 5: realiza tu primer pago

Una vez que accedas a la página de checkout alojada por Fintoc, sigue el flujo de pago usando los valores especiales de test de Fintoc. Para un pago exitoso, puedes usar uno de estos valores:

En Chile, selecciona cualquier banco e inicia sesión usando el RUT 41614850-3 y la contraseña jonsnow. Una vez que estés conectado al banco, selecciona la cuenta con el número 422159212. Después de seleccionar esa cuenta, espera 5 segundos y el pago debería ser exitoso.
Para México, selecciona cualquier banco y escribe el número 5555555555. Espera 5 segundos y el pago debería ser exitoso.

Deberías haber recibido un evento checkout_session.finished que contiene un pago exitoso en tu endpoint de webhook. ¡Felicidades! Acabas de hacer tu primer pago con Fintoc. Para probar diferentes flujos de pago, consulta los valores especiales de test de Fintoc.

Inicio

Recursos

Pagos

Transferencias

Movimientos

Quickstart

Paso 1: configuración inicial

Obtén tus API Keys de test

Opcional: instala el SDK de backend de Fintoc

Paso 2: crea una Checkout Session

Paso 3: redirige a tu usuario a la página de checkout alojada por Fintoc

Paso 4: maneja eventos post-pago

Paso 5: realiza tu primer pago

​Paso 1: configuración inicial

​Obtén tus API Keys de test

​Opcional: instala el SDK de backend de Fintoc

​Paso 2: crea una Checkout Session

​Paso 3: redirige a tu usuario a la página de checkout alojada por Fintoc

​Paso 4: maneja eventos post-pago

​Paso 5: realiza tu primer pago

Paso 1: configuración inicial

Obtén tus API Keys de test

Opcional: instala el SDK de backend de Fintoc

Paso 2: crea una Checkout Session

Paso 3: redirige a tu usuario a la página de checkout alojada por Fintoc

Paso 4: maneja eventos post-pago

Paso 5: realiza tu primer pago