curl --request GET \
--url https://api.fintoc.com/v2/checkout_sessions \
--header 'Authorization: <api-key>'import requests
url = "https://api.fintoc.com/v2/checkout_sessions"
headers = {"Authorization": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<api-key>'}};
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 => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.fintoc.com/v2/checkout_sessions"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.fintoc.com/v2/checkout_sessions")
.header("Authorization", "<api-key>")
.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::Get.new(url)
request["Authorization"] = '<api-key>'
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"
}
]{
"error": {
"type": "invalid_params",
"code": "invalid_params",
"message": "Cannot use starting_after and ending_before params at the same time"
}
}{
"error": {
"type": "authentication_error",
"code": "invalid_api_key",
"message": "Invalid API Key: invalid-*oken"
}
}{
"error": {
"type": "missing_cursor",
"message": "Cursor cs_li5531onlFDi235 not found",
"code": "missing_cursor"
}
}List checkout sessions
Lists the checkout sessions of your organization for the live or test mode of the API key used. The API returns sessions sorted by creation date, with the most recently created sessions first. Use limit, starting_after, and ending_before to paginate through the list. The Link response header contains the URL of the next page.
curl --request GET \
--url https://api.fintoc.com/v2/checkout_sessions \
--header 'Authorization: <api-key>'import requests
url = "https://api.fintoc.com/v2/checkout_sessions"
headers = {"Authorization": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<api-key>'}};
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 => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.fintoc.com/v2/checkout_sessions"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.fintoc.com/v2/checkout_sessions")
.header("Authorization", "<api-key>")
.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::Get.new(url)
request["Authorization"] = '<api-key>'
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"
}
]{
"error": {
"type": "invalid_params",
"code": "invalid_params",
"message": "Cannot use starting_after and ending_before params at the same time"
}
}{
"error": {
"type": "authentication_error",
"code": "invalid_api_key",
"message": "Invalid API Key: invalid-*oken"
}
}{
"error": {
"type": "missing_cursor",
"message": "Cursor cs_li5531onlFDi235 not found",
"code": "missing_cursor"
}
}Query Parameters
Response
List of checkout sessions for the current mode, sorted by creation date with the most recently created sessions first.
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?