Saltar al contenido principal
GET
List checkout sessions
v2 · Base URL https://api.fintoc.com/v2

Autorizaciones

Authorization
string
header
requerido

Parámetros de consulta

limit
integer

Maximum number of checkout sessions to return per page, between 1 and 300. Defaults to 30.

Ejemplo:

30

starting_after
string

Cursor for pagination: the id of the last checkout session on the current page. Returns the sessions created before that session. Cannot be combined with ending_before.

Ejemplo:

"cs_li5531onlFDi235"

ending_before
string

Cursor for pagination: the id of the first checkout session on the current page. Returns the sessions created after that session. Cannot be combined with starting_after.

Ejemplo:

"cs_li5531onlFDi235"

Respuesta

List of checkout sessions for the current mode, sorted by creation date with the most recently created sessions first.

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"