Skip to main content
POST
Expire a checkout session
v2 · Base URL https://api.fintoc.com/v2

Authorizations

Authorization
string
header
required

Path Parameters

id
string
required

Unique identifier for the checkout session to expire.

Response

The expired checkout session, with its status set to expired.

id
string
required

Unique identifier of the checkout session.

Example:

"cs_li5531onlFDi235"

object
any
required

Type of the object. Always checkout_session.

amount
integer | null
required

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.

Example:

350000

business_profile
object | null
required

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
required

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

Example:

"https://merchant.com/cancel"

created_at
string<date-time>
required

ISO 8601 timestamp of when the checkout session was created.

Example:

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

currency
enum<string>
required

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

Available options:
CLP,
MXN
Example:

"CLP"

customer_email
string | null
required

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

Example:

"customer@example.com"

expires_at
string<date-time>
required

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

Example:

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

flow
enum<string>
required

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).

Available options:
payment,
subscription,
setup
Example:

"payment"

line_items
object[] | null
required

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

metadata
object
required

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

mode
enum<string>
required

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

Available options:
test,
live
Example:

"live"

payment_method
string | null
required

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

Example:

"pm_xL9mPq2RkV3WnDQG"

payment_method_options
object
required

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>[]
required

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).

Available options:
bank_transfer,
installments,
card,
pac
payment_resource
object | null
required

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

redirect_url
string | null
required

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.

Example:

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

session_token
string | null
required

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.

Example:

"eyJhbGciOiJIUzI1NiJ9.eyJpZCI6ImNzX2xpNTUzMSJ9.iV2qAVrqYLuqxF4"

setup_intent
string | null
required

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.

Example:

"seti_xL9mPq2RkV3WnDQG"

status
enum<string>
required

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.

Available options:
created,
in_progress,
expired,
finished
Example:

"created"

subscription
string | null
required

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

Example:

"sub_xL9mPq2RkV3WnDQG"

success_url
string | null
required

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

Example:

"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.

Available options:
disabled,
enabled,
null
Example:

"enabled"