DashboardHome
GuidesAPI ReferenceChangelog
DashboardHomeLog In
API Reference

Create an invoice

post
https://api.fintoc.com/v2/invoices

Creates a one-off invoice for a customer, in the live or test mode of the API key used. The invoice is not tied to a subscription and starts in draft status. Fintoc does not charge the invoice until you finalize it. The total is the sum of the lines, which must all share the same currency. Fintoc charges the invoice automatically against default_payment_method, so collection_method is always charge_automatically.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
required

ID of the customer the invoice bills.

string
required

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

lines
array of objects
required
length ≥ 1

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

lines*
integer
required

Total amount of the line, in the currency's smallest unit. CLP has no minor unit, so 60000 is 60,000 CLP.

string
enum
required

Three-letter ISO 4217 currency code, in uppercase. One of CLP or MXN.

Allowed:
string
required

Short name of the line.

string

Longer description of the line.

integer
required

Number of units the line bills for. Must be greater than 0.

string
enum

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

Allowed:
metadata
object

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

Responses

Updated about 2 hours ago

Did this page help you?
Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated about 2 hours ago

Did this page help you?