Invoices

Match invoice

Records a bank deposit as an open invoice’s payment, marking it paid with the deposit’s date as paid_date. The deposit takes the invoice’s revenue category and the invoice date as its accounting date; unmatching later doesn’t restore its previous category. The deposit must be a bank deposit for exactly the invoice’s amount and currency, not a transfer, not split, and not matched to another invoice. Matching the same pair again returns the invoice unchanged. Requires Invoices: Manage and Transactions: Manage.

POST

invoices

{id}

match

Match invoice

curl --request POST \
  --url https://app.finta.com/api/v1/invoices/{id}/match \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "transaction_id": "txn_a1b2c3d4e5f6g7"
}
'

import requests

url = "https://app.finta.com/api/v1/invoices/{id}/match"

payload = { "transaction_id": "txn_a1b2c3d4e5f6g7" }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({transaction_id: 'txn_a1b2c3d4e5f6g7'})
};

fetch('https://app.finta.com/api/v1/invoices/{id}/match', 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://app.finta.com/api/v1/invoices/{id}/match",
  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([
    'transaction_id' => 'txn_a1b2c3d4e5f6g7'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "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://app.finta.com/api/v1/invoices/{id}/match"

	payload := strings.NewReader("{\n  \"transaction_id\": \"txn_a1b2c3d4e5f6g7\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	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://app.finta.com/api/v1/invoices/{id}/match")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"transaction_id\": \"txn_a1b2c3d4e5f6g7\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.finta.com/api/v1/invoices/{id}/match")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"transaction_id\": \"txn_a1b2c3d4e5f6g7\"\n}"

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

{
  "id": "inv_k3m9p2q8r4s7t1",
  "object": "invoice",
  "status": "open",
  "customer_name": "Acme Corp",
  "invoice_date": "2026-09-01",
  "amount_cents": 1100000,
  "currency": "USD",
  "line_items": [
    {
      "description": "Annual license",
      "amount_cents": 1200000,
      "category_id": "cat_r1a2b3c4d5e6f7",
      "category_name": "Subscription Revenue",
      "spread_months": 12
    }
  ],
  "adjustments": [
    {
      "kind": "discount",
      "amount_cents": 100000,
      "description": "<string>"
    }
  ],
  "paid_transaction_id": "txn_a1b2c3d4e5f6g7",
  "paid_date": "2023-12-25",
  "source": "manual",
  "stripe_url": "<string>",
  "created": 1788220800
}

Authorizations

Authorization

string

header

required

API key prefixed with finta_

Path Parameters

string

required

The invoice's inv_ ID.

Example:

"inv_k3m9p2q8r4s7t1"

Body

application/json

transaction_id

string

required

The bank deposit, from GET /transactions.

Pattern: ^txn_

Example:

"txn_a1b2c3d4e5f6g7"

Response

The paid invoice

An invoice the company sent, with the revenue it booked and the deposit that paid it.

string

required

Example:

"inv_k3m9p2q8r4s7t1"

object

enum<string>

required

Available options:

invoice

status

enum<string>

required

open until a deposit is matched as its payment, then paid. voided invoices booked nothing.

Available options:

open,

paid,

voided

customer_name

string

required

Example:

"Acme Corp"

invoice_date

string<date>

required

Example:

"2026-09-01"

amount_cents

integer

required

The total due in cents, after discounts, credits and tax.

Example:

1100000

currency

string

required

Example:

"USD"

line_items

object[]

required

Every line item, in order. At most 10 on invoices created in Finta or through the API; invoices recorded from Stripe can have more.

Show child attributes

adjustments

object[]

required

Discounts, customer balance credits and tax, at most one of each kind.

Show child attributes

paid_transaction_id

string | null

required

The bank deposit matched as this invoice's payment. Null unless paid. It stays set even if that transaction is later deleted in Finta, so it may not be retrievable with GET /transactions/{id}.

Example:

"txn_a1b2c3d4e5f6g7"

paid_date

string<date> | null

required

The date of the matched deposit. Null unless paid.

source

enum<string>

required

stripe when Finta recorded the invoice from the company's Stripe account; manual when it was entered in Finta or through the API.

Available options:

manual,

stripe

stripe_url

string | null

required

The invoice in the Stripe dashboard, for Stripe invoices.

created

integer

required

When the invoice was recorded in Finta, as a Unix timestamp.

Example:

1788220800

Match invoice

curl --request POST \
  --url https://app.finta.com/api/v1/invoices/{id}/match \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "transaction_id": "txn_a1b2c3d4e5f6g7"
}
'

import requests

url = "https://app.finta.com/api/v1/invoices/{id}/match"

payload = { "transaction_id": "txn_a1b2c3d4e5f6g7" }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({transaction_id: 'txn_a1b2c3d4e5f6g7'})
};

fetch('https://app.finta.com/api/v1/invoices/{id}/match', 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://app.finta.com/api/v1/invoices/{id}/match",
  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([
    'transaction_id' => 'txn_a1b2c3d4e5f6g7'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "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://app.finta.com/api/v1/invoices/{id}/match"

	payload := strings.NewReader("{\n  \"transaction_id\": \"txn_a1b2c3d4e5f6g7\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	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://app.finta.com/api/v1/invoices/{id}/match")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"transaction_id\": \"txn_a1b2c3d4e5f6g7\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.finta.com/api/v1/invoices/{id}/match")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"transaction_id\": \"txn_a1b2c3d4e5f6g7\"\n}"

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

{
  "id": "inv_k3m9p2q8r4s7t1",
  "object": "invoice",
  "status": "open",
  "customer_name": "Acme Corp",
  "invoice_date": "2026-09-01",
  "amount_cents": 1100000,
  "currency": "USD",
  "line_items": [
    {
      "description": "Annual license",
      "amount_cents": 1200000,
      "category_id": "cat_r1a2b3c4d5e6f7",
      "category_name": "Subscription Revenue",
      "spread_months": 12
    }
  ],
  "adjustments": [
    {
      "kind": "discount",
      "amount_cents": 100000,
      "description": "<string>"
    }
  ],
  "paid_transaction_id": "txn_a1b2c3d4e5f6g7",
  "paid_date": "2023-12-25",
  "source": "manual",
  "stripe_url": "<string>",
  "created": 1788220800
}

API Reference

Taxes

Company

Team

Categories

Rules

Departments

Integrations

Aggregations

Transactions

Forms

Journal Entries

Invoices

Parties

Reports

Feedback

Match invoice

Authorizations

Path Parameters

Body

Response