Saltar al contenido principal
GET
Get a checkout session
v2 · Base URL https://api.fintoc.com/v2

Autorizaciones

Authorization
string
header
requerido

Parámetros de ruta

id
string
requerido

Unique identifier for the checkout session to retrieve.

Respuesta

The checkout session.

id
string
requerido

Unique identifier of the checkout session.

Ejemplo:

"cs_li5531onlFDi235"

object
any
requerido

Type of the object. Always checkout_session.

amount
integer | null
requerido

Amount the session charges your customer, in the smallest unit of currency. For CLP the smallest unit is one peso (CLP has no decimals), so 350000 means $350,000 CLP. For MXN the smallest unit is one centavo, so 350000 means $3,500.00 MXN. null for setup and subscription flow sessions, which do not carry a single amount.

Ejemplo:

350000

business_profile
object | null
requerido

Business on whose behalf you collect the payment, for payment aggregators. null when the session was created without a business profile.

cancel_url
string | null
requerido

URL Fintoc redirects your customer to when the payment is not completed. null when the session was created without redirect URLs.

Ejemplo:

"https://merchant.com/cancel"

created_at
string<date-time>
requerido

ISO 8601 timestamp of when the checkout session was created.

Ejemplo:

"2026-01-13T18:48:25Z"

currency
enum<string>
requerido

Three-letter ISO 4217 currency code, in uppercase. One of CLP or MXN.

Opciones disponibles:
CLP,
MXN
Ejemplo:

"CLP"

customer_email
string | null
requerido

Email of your customer, used to send the payment receipt. null when not provided.

Ejemplo:

"customer@example.com"

expires_at
string<date-time>
requerido

ISO 8601 timestamp of when the checkout session expires. After this time your customer can no longer pay the session.

Ejemplo:

"2026-01-14T18:48:25Z"

flow
enum<string>
requerido

Flow the session runs. One of payment (collects a one-time payment), subscription (starts a recurring subscription), or setup (saves a payment method for future payments).

Opciones disponibles:
payment,
subscription,
setup
Ejemplo:

"payment"

line_items
object[] | null
requerido

Items the session charges for. null when the session was created without line items.

metadata
object
requerido

Set of key-value pairs you attached to the session.

mode
enum<string>
requerido

Mode of the object. live objects use real institution data, test objects use fake data for integration testing.

Opciones disponibles:
test,
live
Ejemplo:

"live"

payment_method
string | null
requerido

id of the saved payment method that pays the session. null when the session is not paid with a previously saved payment method.

Ejemplo:

"pm_xL9mPq2RkV3WnDQG"

payment_method_options
object
requerido

Configuration of the session's payment methods, keyed by payment method type. Each key matches one of payment_method_types and holds the options you set when creating the session, such as the recipient_account for bank_transfer or the kinds for card. See POST /v2/checkout_sessions for the full shape.

payment_method_types
enum<string>[]
requerido

Payment method types your customer can use to pay the session. One or more of card, bank_transfer, installments, and pac (automatic recurring bank debit).

Opciones disponibles:
bank_transfer,
installments,
card,
pac
payment_resource
object | null
requerido

Payment generated by the session. null until your customer starts a payment attempt.

redirect_url
string | null
requerido

URL of the Fintoc-hosted checkout page where your customer completes the payment. Redirect your customer to this URL after creating the session. null for sessions paid through the Fintoc widget instead of a redirect.

Ejemplo:

"https://pay.fintoc.com/cs_li5531onlFDi235"

session_token
string | null
requerido

Token used to initialize the Fintoc widget to pay the session. null for subscription and setup flow sessions and for payments completed outside the widget, like non-embedded card payments.

Ejemplo:

"eyJhbGciOiJIUzI1NiJ9.eyJpZCI6ImNzX2xpNTUzMSJ9.iV2qAVrqYLuqxF4"

setup_intent
string | null
requerido

Unique identifier for the setup intent created by setup and subscription flow sessions. null for other flows and until Fintoc attempts a setup. Retrieve the setup intent's status and error with the setup intent endpoint.

Ejemplo:

"seti_xL9mPq2RkV3WnDQG"

status
enum<string>
requerido

Lifecycle status of the session. created until your customer starts paying, in_progress while Fintoc processes the payment, and finished or expired once the session succeeds or expires.

Opciones disponibles:
created,
in_progress,
expired,
finished
Ejemplo:

"created"

subscription
string | null
requerido

id of the subscription started by a subscription flow session. null until the subscription is created and for other flows.

Ejemplo:

"sub_xL9mPq2RkV3WnDQG"

success_url
string | null
requerido

URL Fintoc redirects your customer to after a successful payment. null when the session was created without redirect URLs.

Ejemplo:

"https://merchant.com/success"

customer
object

Customer the session belongs to. This key is omitted (not null) when the session has no customer.

save_payment_method
enum<string> | null

Whether the session offers your customer the option to save their payment method for future payments. One of enabled or disabled. Only returned for payment flow sessions; null when not configured.

Opciones disponibles:
disabled,
enabled,
null
Ejemplo:

"enabled"