curl --request POST \
--url https://api.fintoc.com/v2/checkout_sessions \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"flow": "payment",
"amount": 350000,
"currency": "CLP",
"payment_method_types": [
"bank_transfer"
],
"customer_email": "customer@example.com",
"success_url": "https://merchant.com/success",
"cancel_url": "https://merchant.com/cancel"
}
'import requests
url = "https://api.fintoc.com/v2/checkout_sessions"
payload = {
"flow": "payment",
"amount": 350000,
"currency": "CLP",
"payment_method_types": ["bank_transfer"],
"customer_email": "customer@example.com",
"success_url": "https://merchant.com/success",
"cancel_url": "https://merchant.com/cancel"
}
headers = {
"Authorization": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
flow: 'payment',
amount: 350000,
currency: 'CLP',
payment_method_types: ['bank_transfer'],
customer_email: 'customer@example.com',
success_url: 'https://merchant.com/success',
cancel_url: 'https://merchant.com/cancel'
})
};
fetch('https://api.fintoc.com/v2/checkout_sessions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.fintoc.com/v2/checkout_sessions",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'flow' => 'payment',
'amount' => 350000,
'currency' => 'CLP',
'payment_method_types' => [
'bank_transfer'
],
'customer_email' => 'customer@example.com',
'success_url' => 'https://merchant.com/success',
'cancel_url' => 'https://merchant.com/cancel'
]),
CURLOPT_HTTPHEADER => [
"Authorization: <api-key>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.fintoc.com/v2/checkout_sessions"
payload := strings.NewReader("{\n \"flow\": \"payment\",\n \"amount\": 350000,\n \"currency\": \"CLP\",\n \"payment_method_types\": [\n \"bank_transfer\"\n ],\n \"customer_email\": \"customer@example.com\",\n \"success_url\": \"https://merchant.com/success\",\n \"cancel_url\": \"https://merchant.com/cancel\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.fintoc.com/v2/checkout_sessions")
.header("Authorization", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"flow\": \"payment\",\n \"amount\": 350000,\n \"currency\": \"CLP\",\n \"payment_method_types\": [\n \"bank_transfer\"\n ],\n \"customer_email\": \"customer@example.com\",\n \"success_url\": \"https://merchant.com/success\",\n \"cancel_url\": \"https://merchant.com/cancel\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fintoc.com/v2/checkout_sessions")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"flow\": \"payment\",\n \"amount\": 350000,\n \"currency\": \"CLP\",\n \"payment_method_types\": [\n \"bank_transfer\"\n ],\n \"customer_email\": \"customer@example.com\",\n \"success_url\": \"https://merchant.com/success\",\n \"cancel_url\": \"https://merchant.com/cancel\"\n}"
response = http.request(request)
puts response.read_body{
"id": "cs_li5531onlFDi235",
"object": "checkout_session",
"amount": 350000,
"business_profile": null,
"cancel_url": "https://merchant.com/cancel",
"created_at": "2026-01-13T18:48:25Z",
"currency": "CLP",
"customer_email": "customer@example.com",
"expires_at": "2026-01-14T18:48:25Z",
"flow": "payment",
"line_items": null,
"metadata": {},
"mode": "live",
"payment_method": null,
"payment_method_options": {
"bank_transfer": {}
},
"payment_method_types": [
"bank_transfer"
],
"payment_resource": null,
"redirect_url": "https://pay.fintoc.com/cs_li5531onlFDi235",
"save_payment_method": null,
"session_token": "eyJhbGciOiJIUzI1NiJ9.eyJpZCI6ImNzX2xpNTUzMSJ9.iV2qAVrqYLuqxF4",
"setup_intent": null,
"split": null,
"split_applied": null,
"status": "created",
"subscription": null,
"success_url": "https://merchant.com/success"
}Create a checkout session
Creates a checkout session in the live or test mode of the API key used. The flow determines what the session does: payment collects a one-time payment, subscription starts a recurring subscription, and setup saves a payment method for future payments. Required fields depend on the flow. After creating the session, redirect your customer to the session’s redirect_url or initialize the Fintoc widget with the session’s session_token.
curl --request POST \
--url https://api.fintoc.com/v2/checkout_sessions \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"flow": "payment",
"amount": 350000,
"currency": "CLP",
"payment_method_types": [
"bank_transfer"
],
"customer_email": "customer@example.com",
"success_url": "https://merchant.com/success",
"cancel_url": "https://merchant.com/cancel"
}
'import requests
url = "https://api.fintoc.com/v2/checkout_sessions"
payload = {
"flow": "payment",
"amount": 350000,
"currency": "CLP",
"payment_method_types": ["bank_transfer"],
"customer_email": "customer@example.com",
"success_url": "https://merchant.com/success",
"cancel_url": "https://merchant.com/cancel"
}
headers = {
"Authorization": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
flow: 'payment',
amount: 350000,
currency: 'CLP',
payment_method_types: ['bank_transfer'],
customer_email: 'customer@example.com',
success_url: 'https://merchant.com/success',
cancel_url: 'https://merchant.com/cancel'
})
};
fetch('https://api.fintoc.com/v2/checkout_sessions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.fintoc.com/v2/checkout_sessions",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'flow' => 'payment',
'amount' => 350000,
'currency' => 'CLP',
'payment_method_types' => [
'bank_transfer'
],
'customer_email' => 'customer@example.com',
'success_url' => 'https://merchant.com/success',
'cancel_url' => 'https://merchant.com/cancel'
]),
CURLOPT_HTTPHEADER => [
"Authorization: <api-key>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.fintoc.com/v2/checkout_sessions"
payload := strings.NewReader("{\n \"flow\": \"payment\",\n \"amount\": 350000,\n \"currency\": \"CLP\",\n \"payment_method_types\": [\n \"bank_transfer\"\n ],\n \"customer_email\": \"customer@example.com\",\n \"success_url\": \"https://merchant.com/success\",\n \"cancel_url\": \"https://merchant.com/cancel\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.fintoc.com/v2/checkout_sessions")
.header("Authorization", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"flow\": \"payment\",\n \"amount\": 350000,\n \"currency\": \"CLP\",\n \"payment_method_types\": [\n \"bank_transfer\"\n ],\n \"customer_email\": \"customer@example.com\",\n \"success_url\": \"https://merchant.com/success\",\n \"cancel_url\": \"https://merchant.com/cancel\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fintoc.com/v2/checkout_sessions")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"flow\": \"payment\",\n \"amount\": 350000,\n \"currency\": \"CLP\",\n \"payment_method_types\": [\n \"bank_transfer\"\n ],\n \"customer_email\": \"customer@example.com\",\n \"success_url\": \"https://merchant.com/success\",\n \"cancel_url\": \"https://merchant.com/cancel\"\n}"
response = http.request(request)
puts response.read_body{
"id": "cs_li5531onlFDi235",
"object": "checkout_session",
"amount": 350000,
"business_profile": null,
"cancel_url": "https://merchant.com/cancel",
"created_at": "2026-01-13T18:48:25Z",
"currency": "CLP",
"customer_email": "customer@example.com",
"expires_at": "2026-01-14T18:48:25Z",
"flow": "payment",
"line_items": null,
"metadata": {},
"mode": "live",
"payment_method": null,
"payment_method_options": {
"bank_transfer": {}
},
"payment_method_types": [
"bank_transfer"
],
"payment_resource": null,
"redirect_url": "https://pay.fintoc.com/cs_li5531onlFDi235",
"save_payment_method": null,
"session_token": "eyJhbGciOiJIUzI1NiJ9.eyJpZCI6ImNzX2xpNTUzMSJ9.iV2qAVrqYLuqxF4",
"setup_intent": null,
"split": null,
"split_applied": null,
"status": "created",
"subscription": null,
"success_url": "https://merchant.com/success"
}Body
id of a saved payment method, requiring customer and matching payment_method_types (["bank_transfer"] or ["card"]). Your customer confirms the payment in the checkout. Saved cards use one installment and require access to customer-initiated card payments in the API key's mode.
"pm_xL9mPq2RkV3WnDQG"
ISO 8601 datetime in UTC when the trial for the subscription started by the session ends. The datetime must be at least one day in the future and at least one day after the session's expires_at. During the trial, the subscription's status is trialing, and Fintoc issues no invoice. Fintoc generates the first invoice when the trial ends. Only for subscription flow sessions. Omit for no trial; the subscription starts charging when your customer completes the session.
"2030-01-24T18:48:25Z"
ISO 8601 datetime in UTC of the first charge of the subscription started by the session. The datetime must be in the future and sets the start of every billing period. Cannot be combined with trial_end. Only for subscription flow sessions. Omit to charge your customer when they complete the session.
"2030-02-01T00:00:00Z"
ISO 8601 datetime in UTC of the scheduled cancellation of the subscription started by the session. The datetime must be after the session's expires_at and after trial_end or billing_cycle_anchor. Fintoc cancels the subscription at this datetime and issues no invoice for a billing period that starts at or after it. Only for subscription flow sessions. Omit to keep the subscription active until you cancel it.
"2031-02-01T00:00:00Z"
Payment method types your customer can use to pay the session. Valid values depend on the flow. The payment flow accepts card, bank_transfer, installments, and cash. cash is available only in MXN sessions. The subscription flow accepts card and pac (automatic recurring bank debit). The setup flow accepts card, bank_transfer, and pac. In MXN sessions, subscription and setup flows accept card and, in test mode only, mx_direct_debit (Mexican direct debit). Defaults to the available types for the flow. In MXN test mode sessions, setup and subscription default to card and mx_direct_debit.
bank_transfer, installments, card, cash, pac, mx_direct_debit Whether to offer your customer the option to save their payment method for future payments. One of enabled or disabled. Only valid for payment flow sessions. When enabled, you must also provide customer or customer_data.
disabled, enabled "enabled"
Rules for dividing payment amounts between entities. Available for payment and subscription flow sessions from organizations with splits enabled. In subscription flow sessions, Fintoc copies the rules to the subscription the session creates. The rules apply to every invoice. Provide 1 to 10 entries. All entries must use the same type, and each entity_id can appear only once. When Fintoc deducts processing fees from your payouts, at least one entry must pay the processing fee. When Fintoc invoices you for processing fees, no entry can pay the fee. For flat splits, amounts must add up to the session's amount in payment flow sessions, and to the total of the line_items in subscription flow sessions. flat splits are not allowed if a line item is priced in CLF. For percentage splits, amounts must add up to 10000 basis points (100%).
Show child attributes
Show child attributes
UI mode for payment and setup flow sessions. Set to embedded to initialize the Fintoc widget with the session's session_token instead of redirecting your customer. When embedded, you can omit both success_url and cancel_url. Set to fields to mount Fintoc's card fields on your page with the session_token. Available only in test mode for organizations in Chile. When fields, payment_method_types must be ["card"], and you can't send success_url, cancel_url, or payment_method. In setup flow sessions, ui_mode is optional, and fields is its only supported value.
embedded, fields "embedded"
Response
The created checkout session.
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.
350000
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. When cash is one of payment_method_types, cash.notification_preferences holds the channels, send_voucher, and send_reminders that apply to your customer, with the defaults applied to the values you omitted. See POST /v2/checkout_sessions for the full shape.
Payment method types your customer can use to pay the session. One or more of card, bank_transfer, installments, cash, pac (automatic recurring bank debit), and mx_direct_debit (Mexican direct debit).
bank_transfer, installments, card, cash, pac, mx_direct_debit 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.
"https://pay.fintoc.com/cs_li5531onlFDi235"
Token used to initialize the Fintoc widget or Fintoc's card fields for the session. null for subscription flow sessions, for setup flow sessions whose ui_mode isn't fields, and for payments completed outside the widget, like card payments without ui_mode.
"eyJhbGciOiJIUzI1NiJ9.eyJpZCI6ImNzX2xpNTUzMSJ9.iV2qAVrqYLuqxF4"
ISO 8601 datetime, in UTC, when the trial for the subscription started by the session ends and charges begin. The API returns this field only for subscription flow sessions; the value is null when the session was created without a trial.
"2026-01-24T18:48:25Z"
Was this page helpful?