Create an invoice

curl --request POST \
  --url https://api.fintoc.com/v2/invoices \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "customer": "cus_2c4mDe9NJyGmMzvCqLkXqAtjnRu",
  "default_payment_method": "pm_2c4mDhAbCdEfGhIjKlMnOpQrStu",
  "lines": [
    {
      "amount": 60000,
      "currency": "CLP",
      "name": "Design",
      "quantity": 1,
      "description": "Design work"
    }
  ],
  "collection_method": "charge_automatically",
  "metadata": {
    "order_id": "12345"
  }
}
'

import requests

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

payload = {
    "customer": "cus_2c4mDe9NJyGmMzvCqLkXqAtjnRu",
    "default_payment_method": "pm_2c4mDhAbCdEfGhIjKlMnOpQrStu",
    "lines": [
        {
            "amount": 60000,
            "currency": "CLP",
            "name": "Design",
            "quantity": 1,
            "description": "Design work"
        }
    ],
    "collection_method": "charge_automatically",
    "metadata": { "order_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',
    default_payment_method: 'pm_2c4mDhAbCdEfGhIjKlMnOpQrStu',
    lines: [
      {
        amount: 60000,
        currency: 'CLP',
        name: 'Design',
        quantity: 1,
        description: 'Design work'
      }
    ],
    collection_method: 'charge_automatically',
    metadata: {order_id: '12345'}
  })
};

fetch('https://api.fintoc.com/v2/invoices', 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/invoices",
  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',
    'default_payment_method' => 'pm_2c4mDhAbCdEfGhIjKlMnOpQrStu',
    'lines' => [
        [
                'amount' => 60000,
                'currency' => 'CLP',
                'name' => 'Design',
                'quantity' => 1,
                'description' => 'Design work'
        ]
    ],
    'collection_method' => 'charge_automatically',
    'metadata' => [
        'order_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/invoices"

	payload := strings.NewReader("{\n  \"customer\": \"cus_2c4mDe9NJyGmMzvCqLkXqAtjnRu\",\n  \"default_payment_method\": \"pm_2c4mDhAbCdEfGhIjKlMnOpQrStu\",\n  \"lines\": [\n    {\n      \"amount\": 60000,\n      \"currency\": \"CLP\",\n      \"name\": \"Design\",\n      \"quantity\": 1,\n      \"description\": \"Design work\"\n    }\n  ],\n  \"collection_method\": \"charge_automatically\",\n  \"metadata\": {\n    \"order_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/invoices")
  .header("Authorization", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"customer\": \"cus_2c4mDe9NJyGmMzvCqLkXqAtjnRu\",\n  \"default_payment_method\": \"pm_2c4mDhAbCdEfGhIjKlMnOpQrStu\",\n  \"lines\": [\n    {\n      \"amount\": 60000,\n      \"currency\": \"CLP\",\n      \"name\": \"Design\",\n      \"quantity\": 1,\n      \"description\": \"Design work\"\n    }\n  ],\n  \"collection_method\": \"charge_automatically\",\n  \"metadata\": {\n    \"order_id\": \"12345\"\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

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

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  \"default_payment_method\": \"pm_2c4mDhAbCdEfGhIjKlMnOpQrStu\",\n  \"lines\": [\n    {\n      \"amount\": 60000,\n      \"currency\": \"CLP\",\n      \"name\": \"Design\",\n      \"quantity\": 1,\n      \"description\": \"Design work\"\n    }\n  ],\n  \"collection_method\": \"charge_automatically\",\n  \"metadata\": {\n    \"order_id\": \"12345\"\n  }\n}"

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

{
  "id": "inv_2bVdWxLpzXq8RkNcM3JtUv9AhTe",
  "object": "invoice",
  "attempt_count": 0,
  "created_at": "2026-05-01T12:00:00Z",
  "currency": "CLP",
  "customer": "cus_2c4mDe9NJyGmMzvCqLkXqAtjnRu",
  "default_payment_method": "pm_2c4mDhAbCdEfGhIjKlMnOpQrStu",
  "hosted_invoice_url": null,
  "lines": [
    {
      "id": "il_2bVdX0PqJs6RhNu9FmZlTo2EyKq",
      "object": "line_item",
      "name": "Design",
      "description": "Design work",
      "amount": 60000,
      "currency": "CLP",
      "period_end": null,
      "period_start": null,
      "quantity": 2
    },
    {
      "id": "il_2bVdX1QrKt7SiOvAGnAmUp3FzLr",
      "object": "line_item",
      "name": "Hosting",
      "description": "Hosting",
      "amount": 40000,
      "currency": "CLP",
      "period_end": null,
      "period_start": null,
      "quantity": 1
    }
  ],
  "metadata": {
    "order_id": "12345"
  },
  "mode": "live",
  "next_payment_attempt_at": null,
  "payments": [],
  "status": "draft",
  "subscription": null,
  "total": 100000
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "invalid_collection_method",
    "message": "collection_method must be one of: charge_automatically",
    "doc_url": "https://docs.fintoc.com/reference/errors"
  }
}

{
  "error": {
    "type": "authentication_error",
    "code": "invalid_api_key",
    "message": "Invalid API Key: invalid-*oken"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "missing_resource",
    "message": "No such payment_method: pm_2c4mDhAbCdEfGhIjKlMnOpQrStu",
    "doc_url": "https://docs.fintoc.com/reference/errors"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "currency_mismatch",
    "message": "The currency is not allowed for the organization's country",
    "doc_url": "https://docs.fintoc.com/reference/errors"
  }
}

POST

invoices

Create an invoice

curl --request POST \
  --url https://api.fintoc.com/v2/invoices \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "customer": "cus_2c4mDe9NJyGmMzvCqLkXqAtjnRu",
  "default_payment_method": "pm_2c4mDhAbCdEfGhIjKlMnOpQrStu",
  "lines": [
    {
      "amount": 60000,
      "currency": "CLP",
      "name": "Design",
      "quantity": 1,
      "description": "Design work"
    }
  ],
  "collection_method": "charge_automatically",
  "metadata": {
    "order_id": "12345"
  }
}
'

import requests

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

payload = {
    "customer": "cus_2c4mDe9NJyGmMzvCqLkXqAtjnRu",
    "default_payment_method": "pm_2c4mDhAbCdEfGhIjKlMnOpQrStu",
    "lines": [
        {
            "amount": 60000,
            "currency": "CLP",
            "name": "Design",
            "quantity": 1,
            "description": "Design work"
        }
    ],
    "collection_method": "charge_automatically",
    "metadata": { "order_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',
    default_payment_method: 'pm_2c4mDhAbCdEfGhIjKlMnOpQrStu',
    lines: [
      {
        amount: 60000,
        currency: 'CLP',
        name: 'Design',
        quantity: 1,
        description: 'Design work'
      }
    ],
    collection_method: 'charge_automatically',
    metadata: {order_id: '12345'}
  })
};

fetch('https://api.fintoc.com/v2/invoices', 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/invoices",
  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',
    'default_payment_method' => 'pm_2c4mDhAbCdEfGhIjKlMnOpQrStu',
    'lines' => [
        [
                'amount' => 60000,
                'currency' => 'CLP',
                'name' => 'Design',
                'quantity' => 1,
                'description' => 'Design work'
        ]
    ],
    'collection_method' => 'charge_automatically',
    'metadata' => [
        'order_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/invoices"

	payload := strings.NewReader("{\n  \"customer\": \"cus_2c4mDe9NJyGmMzvCqLkXqAtjnRu\",\n  \"default_payment_method\": \"pm_2c4mDhAbCdEfGhIjKlMnOpQrStu\",\n  \"lines\": [\n    {\n      \"amount\": 60000,\n      \"currency\": \"CLP\",\n      \"name\": \"Design\",\n      \"quantity\": 1,\n      \"description\": \"Design work\"\n    }\n  ],\n  \"collection_method\": \"charge_automatically\",\n  \"metadata\": {\n    \"order_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/invoices")
  .header("Authorization", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"customer\": \"cus_2c4mDe9NJyGmMzvCqLkXqAtjnRu\",\n  \"default_payment_method\": \"pm_2c4mDhAbCdEfGhIjKlMnOpQrStu\",\n  \"lines\": [\n    {\n      \"amount\": 60000,\n      \"currency\": \"CLP\",\n      \"name\": \"Design\",\n      \"quantity\": 1,\n      \"description\": \"Design work\"\n    }\n  ],\n  \"collection_method\": \"charge_automatically\",\n  \"metadata\": {\n    \"order_id\": \"12345\"\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

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

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  \"default_payment_method\": \"pm_2c4mDhAbCdEfGhIjKlMnOpQrStu\",\n  \"lines\": [\n    {\n      \"amount\": 60000,\n      \"currency\": \"CLP\",\n      \"name\": \"Design\",\n      \"quantity\": 1,\n      \"description\": \"Design work\"\n    }\n  ],\n  \"collection_method\": \"charge_automatically\",\n  \"metadata\": {\n    \"order_id\": \"12345\"\n  }\n}"

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

{
  "id": "inv_2bVdWxLpzXq8RkNcM3JtUv9AhTe",
  "object": "invoice",
  "attempt_count": 0,
  "created_at": "2026-05-01T12:00:00Z",
  "currency": "CLP",
  "customer": "cus_2c4mDe9NJyGmMzvCqLkXqAtjnRu",
  "default_payment_method": "pm_2c4mDhAbCdEfGhIjKlMnOpQrStu",
  "hosted_invoice_url": null,
  "lines": [
    {
      "id": "il_2bVdX0PqJs6RhNu9FmZlTo2EyKq",
      "object": "line_item",
      "name": "Design",
      "description": "Design work",
      "amount": 60000,
      "currency": "CLP",
      "period_end": null,
      "period_start": null,
      "quantity": 2
    },
    {
      "id": "il_2bVdX1QrKt7SiOvAGnAmUp3FzLr",
      "object": "line_item",
      "name": "Hosting",
      "description": "Hosting",
      "amount": 40000,
      "currency": "CLP",
      "period_end": null,
      "period_start": null,
      "quantity": 1
    }
  ],
  "metadata": {
    "order_id": "12345"
  },
  "mode": "live",
  "next_payment_attempt_at": null,
  "payments": [],
  "status": "draft",
  "subscription": null,
  "total": 100000
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "invalid_collection_method",
    "message": "collection_method must be one of: charge_automatically",
    "doc_url": "https://docs.fintoc.com/reference/errors"
  }
}

{
  "error": {
    "type": "authentication_error",
    "code": "invalid_api_key",
    "message": "Invalid API Key: invalid-*oken"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "missing_resource",
    "message": "No such payment_method: pm_2c4mDhAbCdEfGhIjKlMnOpQrStu",
    "doc_url": "https://docs.fintoc.com/reference/errors"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "currency_mismatch",
    "message": "The currency is not allowed for the organization's country",
    "doc_url": "https://docs.fintoc.com/reference/errors"
  }
}

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

Autorizaciones

Authorization

string

header

requerido

Cuerpo

application/json

customer

string

requerido

ID of the customer the invoice bills.

Ejemplo:

"cus_2c4mDe9NJyGmMzvCqLkXqAtjnRu"

default_payment_method

string

requerido

Payment method Fintoc charges when the invoice is finalized. Must belong to the specified customer.

Ejemplo:

"pm_2c4mDhAbCdEfGhIjKlMnOpQrStu"

lines

object[]

requerido

Line items the invoice bills for. All lines must share the same currency, which becomes the invoice currency.

Minimum array length: 1

Show child attributes

collection_method

enum<string>

How Fintoc collects the invoice. Only charge_automatically is supported. Defaults to charge_automatically.

Opciones disponibles:

charge_automatically

Ejemplo:

"charge_automatically"

metadata

object

Set of key-value pairs you can attach to the invoice.

Ejemplo:

{ "order_id": "12345" }

Respuesta

The created invoice, in draft status.

string

requerido

Unique identifier of the invoice.

Ejemplo:

"inv_2bVdWxLpzXq8RkNcM3JtUv9AhTe"

hosted_invoice_url

string | null

requerido

URL of the hosted invoice page, where your customer can view and pay the invoice. null for test mode invoices and for invoices that are not open.

Ejemplo:

"https://acme.billing.fintoc.com/invoices/inv_2bVdWxLpzXq8RkNcM3JtUv9AhTe"

object

any

requerido

Type of the object. Always invoice.

attempt_count

integer

requerido

Number of automatic charge attempts Fintoc has made on the invoice. 0 until the invoice is finalized and charged for the first time.

Ejemplo:

1

created_at

string<date-time>

requerido

ISO 8601 timestamp of when the invoice was created.

Ejemplo:

"2026-05-01T12:00:00Z"

currency

enum<string>

requerido

Currency of the invoice, as an ISO 4217 code. Every line item uses this currency.

Opciones disponibles:

CLP,

MXN

Ejemplo:

"CLP"

customer

string

requerido

id of the customer the invoice bills.

Ejemplo:

"cus_2bVdWyTnGq4PfLs7DkXjRm0CwIo"

default_payment_method

string | null

requerido

id of the payment method Fintoc charges when the invoice is finalized. null for invoices without one, such as subscription invoices.

Ejemplo:

"pm_2c4mDhAbCdEfGhIjKlMnOpQrStu"

lines

object[]

requerido

Line items that make up the invoice total.

Show child attributes

metadata

object | null

requerido

Set of key-value pairs attached to the invoice. null when the invoice has no metadata.

mode

enum<string>

requerido

Mode of the invoice. live invoices use real data; test invoices use fake data for integration testing. An API key only sees invoices that share its mode.

Opciones disponibles:

live,

test

Ejemplo:

"live"

next_payment_attempt_at

string<date-time> | null

requerido

ISO 8601 timestamp of the next scheduled automatic charge attempt. null when no further attempt is scheduled.

Ejemplo:

"2026-05-02T12:00:00Z"

payments

object[]

requerido

Payment attempts to collect the invoice.

Show child attributes

status

enum<string>

requerido

Status of the invoice. Invoices start as draft, become open when finalized, and end as paid or void.

Opciones disponibles:

draft,

open,

paid,

void

Ejemplo:

"draft"

subscription

string | null

requerido

id of the subscription that generated the invoice. null for invoices not tied to a subscription.

Ejemplo:

"sub_2bVdWzKfHr5QgMt8ElYkSn1DxJp"

total

integer

requerido

Total amount of the invoice, in the smallest unit of currency (for example, 30000 for $30000 CLP, since CLP has no minor unit, or 3000 for $30.00 MXN). Equals the sum of the line item amounts.

Ejemplo:

30000

Get an invoice Add invoice lines

API de Fintoc

Recursos principales

API de Pagos

API de Transferencias

API de Movimientos

Direct Debit (Legacy)

API Fiscal

Create an invoice

Autorizaciones

Cuerpo

Respuesta