Create a subscription

curl --request POST \
  --url https://api.fintoc.com/v2/subscriptions \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "customer": "cus_2c4mDe9NJyGmMzvCqLkXqAtjnRu",
  "payment_method": "pm_2c4mDhAbCdEfGhIjKlMnOpQrStu",
  "items": [
    {
      "price_data": {
        "currency": "CLP",
        "recurring": {
          "interval": "month",
          "interval_count": 1
        },
        "unit_amount": 10000,
        "product_data": {
          "name": "Premium plan"
        }
      },
      "quantity": 1
    }
  ],
  "metadata": {
    "internal_id": "12345"
  }
}
'

import requests

url = "https://api.fintoc.com/v2/subscriptions"

payload = {
    "customer": "cus_2c4mDe9NJyGmMzvCqLkXqAtjnRu",
    "payment_method": "pm_2c4mDhAbCdEfGhIjKlMnOpQrStu",
    "items": [
        {
            "price_data": {
                "currency": "CLP",
                "recurring": {
                    "interval": "month",
                    "interval_count": 1
                },
                "unit_amount": 10000,
                "product_data": { "name": "Premium plan" }
            },
            "quantity": 1
        }
    ],
    "metadata": { "internal_id": "12345" }
}
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({
    customer: 'cus_2c4mDe9NJyGmMzvCqLkXqAtjnRu',
    payment_method: 'pm_2c4mDhAbCdEfGhIjKlMnOpQrStu',
    items: [
      {
        price_data: {
          currency: 'CLP',
          recurring: {interval: 'month', interval_count: 1},
          unit_amount: 10000,
          product_data: {name: 'Premium plan'}
        },
        quantity: 1
      }
    ],
    metadata: {internal_id: '12345'}
  })
};

fetch('https://api.fintoc.com/v2/subscriptions', 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/subscriptions",
  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([
    'customer' => 'cus_2c4mDe9NJyGmMzvCqLkXqAtjnRu',
    'payment_method' => 'pm_2c4mDhAbCdEfGhIjKlMnOpQrStu',
    'items' => [
        [
                'price_data' => [
                                'currency' => 'CLP',
                                'recurring' => [
                                                                'interval' => 'month',
                                                                'interval_count' => 1
                                ],
                                'unit_amount' => 10000,
                                'product_data' => [
                                                                'name' => 'Premium plan'
                                ]
                ],
                'quantity' => 1
        ]
    ],
    'metadata' => [
        'internal_id' => '12345'
    ]
  ]),
  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/subscriptions"

	payload := strings.NewReader("{\n  \"customer\": \"cus_2c4mDe9NJyGmMzvCqLkXqAtjnRu\",\n  \"payment_method\": \"pm_2c4mDhAbCdEfGhIjKlMnOpQrStu\",\n  \"items\": [\n    {\n      \"price_data\": {\n        \"currency\": \"CLP\",\n        \"recurring\": {\n          \"interval\": \"month\",\n          \"interval_count\": 1\n        },\n        \"unit_amount\": 10000,\n        \"product_data\": {\n          \"name\": \"Premium plan\"\n        }\n      },\n      \"quantity\": 1\n    }\n  ],\n  \"metadata\": {\n    \"internal_id\": \"12345\"\n  }\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/subscriptions")
  .header("Authorization", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"customer\": \"cus_2c4mDe9NJyGmMzvCqLkXqAtjnRu\",\n  \"payment_method\": \"pm_2c4mDhAbCdEfGhIjKlMnOpQrStu\",\n  \"items\": [\n    {\n      \"price_data\": {\n        \"currency\": \"CLP\",\n        \"recurring\": {\n          \"interval\": \"month\",\n          \"interval_count\": 1\n        },\n        \"unit_amount\": 10000,\n        \"product_data\": {\n          \"name\": \"Premium plan\"\n        }\n      },\n      \"quantity\": 1\n    }\n  ],\n  \"metadata\": {\n    \"internal_id\": \"12345\"\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.fintoc.com/v2/subscriptions")

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  \"customer\": \"cus_2c4mDe9NJyGmMzvCqLkXqAtjnRu\",\n  \"payment_method\": \"pm_2c4mDhAbCdEfGhIjKlMnOpQrStu\",\n  \"items\": [\n    {\n      \"price_data\": {\n        \"currency\": \"CLP\",\n        \"recurring\": {\n          \"interval\": \"month\",\n          \"interval_count\": 1\n        },\n        \"unit_amount\": 10000,\n        \"product_data\": {\n          \"name\": \"Premium plan\"\n        }\n      },\n      \"quantity\": 1\n    }\n  ],\n  \"metadata\": {\n    \"internal_id\": \"12345\"\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "id": "sub_2c4mDcMaVxDx7nT3o5GbPMQbS2v",
  "object": "subscription",
  "billing_cycle_anchor": "2026-06-01T15:00:00Z",
  "collection_method": "charge_automatically",
  "created_at": "2026-06-01T15:00:00Z",
  "customer": "cus_2c4mDe9NJyGmMzvCqLkXqAtjnRu",
  "items": [
    {
      "id": "si_2c4mDfkPLLrLTCJ3wPCEHGYpkVf",
      "object": "subscription_item",
      "price": {
        "currency": "CLP",
        "product": {
          "id": "prod_2c4mDgwQqkNwMHnXSc4DBjkbcWz",
          "object": "product",
          "created_at": "2026-06-01T15:00:00Z",
          "description": null,
          "image_url": null,
          "metadata": {},
          "mode": "live",
          "name": "Premium plan"
        },
        "recurring": {
          "interval": "month",
          "interval_count": 1
        },
        "unit_amount": 10000
      },
      "quantity": 1
    }
  ],
  "metadata": {
    "internal_id": "12345"
  },
  "mode": "live",
  "payment_method": "pm_2c4mDhAbCdEfGhIjKlMnOpQrStu",
  "status": "incomplete",
  "trial_end": null
}

Suscripciones

Create a subscription

Creates a subscription that bills a customer on a recurring cadence, in the live or test mode of the API key used. Each item defines its price through price_data, referencing an existing product (product) or defining one inline (product_data). All items must share a compatible currency (CLF items bill alongside CLP) and the same recurring interval and interval_count. A subscription can have up to 10 items. Fintoc charges each subscription automatically using payment_method, so the collection_method is always charge_automatically. The payment_method must be active and have a type of pac or card; subscriptions do not support bank_transfer. Without trial_end, Fintoc sets the billing_cycle_anchor to the creation time and finalizes an initial invoice immediately. The subscription starts incomplete and becomes active once that first payment succeeds. For a zero-amount subscription, Fintoc marks the initial invoice paid and the subscription starts active. With trial_end, the subscription’s status is trialing. Fintoc sets the billing_cycle_anchor to the trial end and generates the first invoice when the trial ends.

POST

subscriptions

curl --request POST \
  --url https://api.fintoc.com/v2/subscriptions \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "customer": "cus_2c4mDe9NJyGmMzvCqLkXqAtjnRu",
  "payment_method": "pm_2c4mDhAbCdEfGhIjKlMnOpQrStu",
  "items": [
    {
      "price_data": {
        "currency": "CLP",
        "recurring": {
          "interval": "month",
          "interval_count": 1
        },
        "unit_amount": 10000,
        "product_data": {
          "name": "Premium plan"
        }
      },
      "quantity": 1
    }
  ],
  "metadata": {
    "internal_id": "12345"
  }
}
'

import requests

url = "https://api.fintoc.com/v2/subscriptions"

payload = {
    "customer": "cus_2c4mDe9NJyGmMzvCqLkXqAtjnRu",
    "payment_method": "pm_2c4mDhAbCdEfGhIjKlMnOpQrStu",
    "items": [
        {
            "price_data": {
                "currency": "CLP",
                "recurring": {
                    "interval": "month",
                    "interval_count": 1
                },
                "unit_amount": 10000,
                "product_data": { "name": "Premium plan" }
            },
            "quantity": 1
        }
    ],
    "metadata": { "internal_id": "12345" }
}
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({
    customer: 'cus_2c4mDe9NJyGmMzvCqLkXqAtjnRu',
    payment_method: 'pm_2c4mDhAbCdEfGhIjKlMnOpQrStu',
    items: [
      {
        price_data: {
          currency: 'CLP',
          recurring: {interval: 'month', interval_count: 1},
          unit_amount: 10000,
          product_data: {name: 'Premium plan'}
        },
        quantity: 1
      }
    ],
    metadata: {internal_id: '12345'}
  })
};

fetch('https://api.fintoc.com/v2/subscriptions', 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/subscriptions",
  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([
    'customer' => 'cus_2c4mDe9NJyGmMzvCqLkXqAtjnRu',
    'payment_method' => 'pm_2c4mDhAbCdEfGhIjKlMnOpQrStu',
    'items' => [
        [
                'price_data' => [
                                'currency' => 'CLP',
                                'recurring' => [
                                                                'interval' => 'month',
                                                                'interval_count' => 1
                                ],
                                'unit_amount' => 10000,
                                'product_data' => [
                                                                'name' => 'Premium plan'
                                ]
                ],
                'quantity' => 1
        ]
    ],
    'metadata' => [
        'internal_id' => '12345'
    ]
  ]),
  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/subscriptions"

	payload := strings.NewReader("{\n  \"customer\": \"cus_2c4mDe9NJyGmMzvCqLkXqAtjnRu\",\n  \"payment_method\": \"pm_2c4mDhAbCdEfGhIjKlMnOpQrStu\",\n  \"items\": [\n    {\n      \"price_data\": {\n        \"currency\": \"CLP\",\n        \"recurring\": {\n          \"interval\": \"month\",\n          \"interval_count\": 1\n        },\n        \"unit_amount\": 10000,\n        \"product_data\": {\n          \"name\": \"Premium plan\"\n        }\n      },\n      \"quantity\": 1\n    }\n  ],\n  \"metadata\": {\n    \"internal_id\": \"12345\"\n  }\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/subscriptions")
  .header("Authorization", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"customer\": \"cus_2c4mDe9NJyGmMzvCqLkXqAtjnRu\",\n  \"payment_method\": \"pm_2c4mDhAbCdEfGhIjKlMnOpQrStu\",\n  \"items\": [\n    {\n      \"price_data\": {\n        \"currency\": \"CLP\",\n        \"recurring\": {\n          \"interval\": \"month\",\n          \"interval_count\": 1\n        },\n        \"unit_amount\": 10000,\n        \"product_data\": {\n          \"name\": \"Premium plan\"\n        }\n      },\n      \"quantity\": 1\n    }\n  ],\n  \"metadata\": {\n    \"internal_id\": \"12345\"\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.fintoc.com/v2/subscriptions")

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  \"customer\": \"cus_2c4mDe9NJyGmMzvCqLkXqAtjnRu\",\n  \"payment_method\": \"pm_2c4mDhAbCdEfGhIjKlMnOpQrStu\",\n  \"items\": [\n    {\n      \"price_data\": {\n        \"currency\": \"CLP\",\n        \"recurring\": {\n          \"interval\": \"month\",\n          \"interval_count\": 1\n        },\n        \"unit_amount\": 10000,\n        \"product_data\": {\n          \"name\": \"Premium plan\"\n        }\n      },\n      \"quantity\": 1\n    }\n  ],\n  \"metadata\": {\n    \"internal_id\": \"12345\"\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "id": "sub_2c4mDcMaVxDx7nT3o5GbPMQbS2v",
  "object": "subscription",
  "billing_cycle_anchor": "2026-06-01T15:00:00Z",
  "collection_method": "charge_automatically",
  "created_at": "2026-06-01T15:00:00Z",
  "customer": "cus_2c4mDe9NJyGmMzvCqLkXqAtjnRu",
  "items": [
    {
      "id": "si_2c4mDfkPLLrLTCJ3wPCEHGYpkVf",
      "object": "subscription_item",
      "price": {
        "currency": "CLP",
        "product": {
          "id": "prod_2c4mDgwQqkNwMHnXSc4DBjkbcWz",
          "object": "product",
          "created_at": "2026-06-01T15:00:00Z",
          "description": null,
          "image_url": null,
          "metadata": {},
          "mode": "live",
          "name": "Premium plan"
        },
        "recurring": {
          "interval": "month",
          "interval_count": 1
        },
        "unit_amount": 10000
      },
      "quantity": 1
    }
  ],
  "metadata": {
    "internal_id": "12345"
  },
  "mode": "live",
  "payment_method": "pm_2c4mDhAbCdEfGhIjKlMnOpQrStu",
  "status": "incomplete",
  "trial_end": null
}

v2 · Base URL https://api.fintoc.com/v2

Autorizaciones

Authorization

string

header

requerido

Cuerpo

application/json

customer

string

requerido

ID of the customer to bill.

Ejemplo:

"cus_2c4mDe9NJyGmMzvCqLkXqAtjnRu"

payment_method

string

requerido

Payment method to charge automatically on every billing cycle. Must belong to the specified customer.

Ejemplo:

"pm_2c4mDhAbCdEfGhIjKlMnOpQrStu"

items

object[]

requerido

Items the subscription bills for on every billing cycle. All items must share a compatible currency (CLF bills alongside CLP) and the same recurring cadence. Up to 10 items.

Maximum array length: 10

Show child attributes

metadata

object

Set of key-value pairs to attach to the subscription. Nested objects and arrays are not allowed as values.

Ejemplo:

{ "internal_id": "12345" }

trial_end

string<date-time>

ISO 8601 timestamp in UTC at which the trial ends, at least one day in the future. During the trial the subscription's status is trialing and Fintoc issues no invoice; Fintoc generates the first invoice when the trial ends. Omit for no trial.

Ejemplo:

"2030-07-08T00:00:00Z"

Respuesta

Subscription created. Fintoc generates and finalizes the initial invoice for the first billing period immediately.

string

requerido

Unique identifier of the subscription.

Ejemplo:

"sub_2c4mDcMaVxDx7nT3o5GbPMQbS2v"

object

any

requerido

Type of the object. Always subscription.

billing_cycle_anchor

string<date-time>

requerido

ISO 8601 timestamp that anchors the billing cycle. Fintoc sets this anchor to the subscription's creation time, or to trial_end when a trial applies. Fintoc measures every billing period from this anchor.

Ejemplo:

"2026-06-01T15:00:00Z"

collection_method

enum<string>

requerido

Method Fintoc uses to collect the invoices the subscription generates. One of charge_automatically (Fintoc charges the saved payment method) or send_invoice (Fintoc sends the invoice for the customer to pay). Subscriptions created through the API always use send_invoice.

Opciones disponibles:

charge_automatically,

send_invoice

Ejemplo:

"send_invoice"

created_at

string<date-time>

requerido

ISO 8601 timestamp of when the subscription was created.

Ejemplo:

"2026-06-01T15:00:00Z"

customer

string

requerido

ID of the customer the subscription bills.

Ejemplo:

"cus_2c4mDe9NJyGmMzvCqLkXqAtjnRu"

items

object[]

requerido

Items the subscription bills for on every billing cycle.

Show child attributes

metadata

object

requerido

Set of key-value pairs attached to the subscription.

Ejemplo:

{ "order_id": "12345" }

mode

enum<string>

requerido

Mode of the object. One of live or test. test subscriptions use fake data for integration testing and do not collect real money.

Opciones disponibles:

live,

test

Ejemplo:

"live"

payment_method

string | null

requerido

ID of the payment method charged when collection_method is charge_automatically. Always null for subscriptions created through the API.

Ejemplo:

null

status

enum<string>

requerido

Current status of the subscription. One of active, incomplete (the first invoice payment has not yet succeeded), trialing (the trial period has not ended), or canceled (the subscription stopped generating invoices).

Opciones disponibles:

active,

canceled,

incomplete,

trialing

Ejemplo:

"active"

trial_end

string<date-time> | null

requerido

ISO 8601 timestamp at which the trial period ends, or null if the subscription has no trial.

Ejemplo:

null

Get a subscription Update a subscription

API de Fintoc

Recursos principales

API de Pagos

API de Transferencias

API de Movimientos

Direct Debit (Legacy)

API Fiscal

Create a subscription

Autorizaciones

Cuerpo

Respuesta