Pay an invoice

curl --request POST \
  --url https://api.fintoc.com/v2/invoices/{id}/pay \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "external_payment": true
}
'

import requests

url = "https://api.fintoc.com/v2/invoices/{id}/pay"

payload = { "external_payment": True }
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({external_payment: true})
};

fetch('https://api.fintoc.com/v2/invoices/{id}/pay', 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/{id}/pay",
  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([
    'external_payment' => true
  ]),
  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/{id}/pay"

	payload := strings.NewReader("{\n  \"external_payment\": true\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/{id}/pay")
  .header("Authorization", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"external_payment\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.fintoc.com/v2/invoices/{id}/pay")

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  \"external_payment\": true\n}"

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

{
  "id": "inv_2bVdWxLpzXq8RkNcM3JtUv9AhTe",
  "hosted_invoice_url": "https://acme.billing.fintoc.com/invoices/inv_2bVdWxLpzXq8RkNcM3JtUv9AhTe",
  "object": "<unknown>",
  "attempt_count": 1,
  "collection_method": "send_invoice",
  "created_at": "2026-05-01T12:00:00Z",
  "currency": "CLP",
  "customer": "cus_2bVdWyTnGq4PfLs7DkXjRm0CwIo",
  "default_payment_method": "pm_2c4mDhAbCdEfGhIjKlMnOpQrStu",
  "external_payment": false,
  "lines": [
    {
      "id": "il_2bVdX0PqJs6RhNu9FmZlTo2EyKq",
      "object": "<unknown>",
      "amount": 30000,
      "currency": "CLP",
      "description": "A premium plan",
      "name": "Premium Plan",
      "period_end": "2026-06-01T00:00:00Z",
      "period_start": "2026-05-01T00:00:00Z",
      "quantity": 1
    }
  ],
  "metadata": {},
  "mode": "live",
  "next_payment_attempt_at": "2026-05-02T12:00:00Z",
  "payments": [
    {
      "amount": 30000,
      "currency": "CLP",
      "payment_intent": "pi_2bVdX2RsLu8TjPwBHoBnVq4G0Ms",
      "status": "succeeded"
    }
  ],
  "status": "draft",
  "subscription": "sub_2bVdWzKfHr5QgMt8ElYkSn1DxJp",
  "total": 30000
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "mutually_exclusive_params",
    "param": "external_payment",
    "message": "external_payment and payment_method are mutually exclusive",
    "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",
    "param": "id",
    "message": "No such invoicing/invoice: inv_fake_id",
    "doc_url": "https://docs.fintoc.com/reference/errors"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "invoice_not_payable",
    "message": "Invoice is not open (status=paid)",
    "doc_url": "https://docs.fintoc.com/reference/errors"
  }
}

Facturas

Pay an invoice

Settles an open invoice, in the live or test mode of the API key used. By default Fintoc charges the invoice: pass payment_method to charge a specific method, or omit it to use the invoice’s default_payment_method. The method must belong to the invoice’s customer and be active. Use this to collect an invoice on demand, or to retry collection after a failed attempt with a different method. The charge is asynchronous: the invoice stays open with a pending payment until the charge resolves. Pass external_payment instead to mark the invoice paid because you collected it outside Fintoc. Fintoc moves the invoice to paid right away and creates no payment. Fintoc does not verify the amount you collected, and settling an invoice is not reversible.

POST

invoices

{id}

pay

Pay an invoice

curl --request POST \
  --url https://api.fintoc.com/v2/invoices/{id}/pay \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "external_payment": true
}
'

import requests

url = "https://api.fintoc.com/v2/invoices/{id}/pay"

payload = { "external_payment": True }
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({external_payment: true})
};

fetch('https://api.fintoc.com/v2/invoices/{id}/pay', 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/{id}/pay",
  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([
    'external_payment' => true
  ]),
  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/{id}/pay"

	payload := strings.NewReader("{\n  \"external_payment\": true\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/{id}/pay")
  .header("Authorization", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"external_payment\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.fintoc.com/v2/invoices/{id}/pay")

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  \"external_payment\": true\n}"

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

{
  "id": "inv_2bVdWxLpzXq8RkNcM3JtUv9AhTe",
  "hosted_invoice_url": "https://acme.billing.fintoc.com/invoices/inv_2bVdWxLpzXq8RkNcM3JtUv9AhTe",
  "object": "<unknown>",
  "attempt_count": 1,
  "collection_method": "send_invoice",
  "created_at": "2026-05-01T12:00:00Z",
  "currency": "CLP",
  "customer": "cus_2bVdWyTnGq4PfLs7DkXjRm0CwIo",
  "default_payment_method": "pm_2c4mDhAbCdEfGhIjKlMnOpQrStu",
  "external_payment": false,
  "lines": [
    {
      "id": "il_2bVdX0PqJs6RhNu9FmZlTo2EyKq",
      "object": "<unknown>",
      "amount": 30000,
      "currency": "CLP",
      "description": "A premium plan",
      "name": "Premium Plan",
      "period_end": "2026-06-01T00:00:00Z",
      "period_start": "2026-05-01T00:00:00Z",
      "quantity": 1
    }
  ],
  "metadata": {},
  "mode": "live",
  "next_payment_attempt_at": "2026-05-02T12:00:00Z",
  "payments": [
    {
      "amount": 30000,
      "currency": "CLP",
      "payment_intent": "pi_2bVdX2RsLu8TjPwBHoBnVq4G0Ms",
      "status": "succeeded"
    }
  ],
  "status": "draft",
  "subscription": "sub_2bVdWzKfHr5QgMt8ElYkSn1DxJp",
  "total": 30000
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "mutually_exclusive_params",
    "param": "external_payment",
    "message": "external_payment and payment_method are mutually exclusive",
    "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",
    "param": "id",
    "message": "No such invoicing/invoice: inv_fake_id",
    "doc_url": "https://docs.fintoc.com/reference/errors"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "invoice_not_payable",
    "message": "Invoice is not open (status=paid)",
    "doc_url": "https://docs.fintoc.com/reference/errors"
  }
}

Autorizaciones

Authorization

string

header

requerido

Parámetros de ruta

string

requerido

The id of the invoice to pay.

Cuerpo

application/json

external_payment

boolean

Set to true to mark the invoice paid because you collected it outside Fintoc, which creates no payment and charges nothing. Defaults to false. Works on any open invoice, including one Fintoc collects whose charge failed. When true, cannot be combined with payment_method.

Ejemplo:

true

payment_method

string

Payment method to charge. Must belong to the invoice's customer and be active. Defaults to the invoice's default_payment_method.

Ejemplo:

"pm_2c4mDhAbCdEfGhIjKlMnOpQrStu"

Respuesta

Returns the invoice. When Fintoc charges it, the invoice stays open with a new pending payment in payments. When you collected it outside Fintoc, the invoice is paid with external_payment: true.

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 invoices that are not open. In test mode, the URL points to the test mode portal.

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

collection_method

enum<string>

requerido

The way Fintoc collects the invoice. charge_automatically means Fintoc charges default_payment_method once the invoice is finalized. send_invoice means Fintoc leaves the invoice open for you to collect, through hosted_invoice_url or outside Fintoc. Subscription invoices inherit the collection method when issued and keep that collection method even if the subscription changes later.

Opciones disponibles:

charge_automatically,

send_invoice

Ejemplo:

"send_invoice"

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"

external_payment

boolean

requerido

Whether the invoice was settled with a payment collected outside Fintoc. false for invoices Fintoc collected, and for invoices that are not yet paid.

Ejemplo:

false

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

⌘I