Checkout Session represents a payment session in the Fintoc API.
{
"id": "cs_li5531onlFDi235",
"object": "checkout_session",
"amount": 350000,
"business_profile": {},
"cancel_url": "https://merchant.com/987654321",
"created_at": "2026-01-13T18:48:25Z",
"currency": "CLP",
"customer": {
"name": "Felipe Castro",
"email": "felipe@example.com",
"metadata": {},
"tax_id": {
"type": "cl_rut",
"value": "12088191"
}
},
"customer_email": null,
"expires_at": "2026-01-14T18:48:25Z",
"metadata": {},
"mode": "test",
"payment_method_options": {},
"payment_methods": ["payment_intent"],
"payment_resource": {
"payment_intent": {
"id": "pi_38DNJo3rbvGUzKFvCGZ6dxR1Kxx",
"object": "payment_intent",
"amount": 350000,
"business_profile": {},
"created_at": "2026-01-13T18:48:31Z",
"currency": "CLP",
"customer_email": null,
"error_reason": null,
"expires_at": "2026-01-14T18:48:25Z",
"metadata": {},
"mode": "test",
"payment_type": "bank_transfer",
"payment_type_options": {},
"recipient_account": null,
"reference_id": null,
"sender_account": {
"type": "checking_account",
"number": "813990168",
"holder_id": "415792638",
"institution_id": "cl_banco_falabella"
},
"status": "succeeded",
"transaction_date": null,
"widget_token": null
}
},
"redirect_url": "https://checkout.fintoc.com/checkout_session_01HXY3Z7X5YQ54V8G2E1KJQAVF",
"session_token": null,
"status": "finished",
"success_url": "https://merchant.com/success"
}
| Attribute | Type | Description |
|---|---|---|
id | string | Unique identifier for the Checkout Session. |
object | string | Identifier for the type of object. Its value for Checkout Session will always correspond to checkout_session. |
amount | integer | Amount to pay, represented as an integer. This value must always be greater than 0. |
business_profile | hash | Optional object to identify enrolled merchants for category-based pricing. |
cancel_url | string | URL to redirect the user to if they cancel the payment. |
created_at | string | Checkout Session’s creation date, using ISO 8601. |
currency | string | Currency ISO code. Currently supports CLP and MXN only. |
customer | hash | Customer data linked to the Checkout Session, including tax identification and refund contact information. |
customer_email | string | Customer email linked to the Checkout Session for refund notifications. Required if using the refunds product; will be null if not provided. |
expires_at | string | UTC timestamp in ISO 8601 format indicating session expiration. Must be at least 10 minutes after creation; defaults to 24 hours. |
metadata | hash | Set of key-value pairs for storing additional structured information. Will be null if not provided. |
mode | string | Indicates whether the session is in live or test mode. |
payment_method_options | hash | Optional set of settings for each available payment method. |
payment_methods | array | Optional definition of the available payment method(s): payment_intent (bank transfers) and card. |
payment_resource | object | Payment resource associated with the session after completion. Will be null if the session is unfinished or expired. |
redirect_url | string | URL to redirect the user to so they can complete the payment using the Fintoc widget. |
session_token | string | Temporary token to configure the widget. Will be null if success_url and cancel_url are provided. |
status | string | Session status. Can be created, in_progress, finished, or expired. |
success_url | string | URL to redirect the user to after a successful payment. |
Customer object
Used to send customer data, including tax identification and refund contact information.| Attribute | Type | Description |
|---|---|---|
tax_id | object | Required object identifying the customer at the fiscal/regulatory level, with type (e.g. cl_rut) and value fields. |
name | string | Optional full name of the customer. |
email | string | Optional customer email for refund notifications. |
metadata | object | Optional custom data for additional customer information (internal IDs, CRM references, tags). |
Business Profile object
| Attribute | Type | Description |
|---|---|---|
category | string | Merchant category identifier (6-character SII activity code in Chile). |
name | string | Enrolled merchant’s name. Displayed as “Recipient” on the payment success screen. |
tax_id | string | Enrolled merchant’s tax identifier (RUT in Chile). |