Record a payment
Partial transfers are allowed; the status only moves to paid once the balance is settled in full.
post
Path Parameters
settlementIdstringrequired
Example:stl_7c53
Body
application/json
Body
application/json
amount_usdnumber(float)required
Example:826.85
value_datestring(date)required
Example:2026-09-10
referencestring
Example:XFER-2026-0418
Response
application/json
Response
application/json
Recorded
Settlement
idstring
Example:stl_7c53
agent_idstring
Example:agt_8f2c1a
statusstring
Allowed values:draftopenpartially_paidpaidcanceled
Example:open
usage_typestring
Allowed values:standardburstreserved
Example:standard
billing_basis_usdnumber(float)
Example:6380
line_itemsarray[object]
Show Child Parameters
invoice_idstring
Example:inv_a920
due_datestring(date)
Example:2026-09-14
paid_usdnumber(float)
Example:0
created_atstring(date-time)
Example:2026-08-15T07:30:00Z
post/settlements/{settlementId}/payments
Authentication
Path Parameters
Body
{
"amount_usd": 826.85,
"value_date": "2026-09-10"
}
application/json
Invoices
Download an invoice as PDF
get
Path Parameters
invoiceIdstringrequired
Example:inv_a920
Response
application/pdf
Response
application/pdf
PDF document
string
get/invoices/{invoiceId}/pdf
Authentication
Path Parameters
application/pdf
Chargeback
Calculate a chargeback upfront
Runs a chargeback calculation without creating a settlement - useful
for budget conversations and for the figure shown in the catalog
entry.
post
Body
application/json
Body
application/json
billing_basis_usdnumber(float)required
Example:6380
chargeback_rate_percentnumber(float)required
Example:12
overhead_percentnumber(float)
Default:8
Response
application/json
Response
application/json
Calculation
line_itemsarray[object]
Show Child Parameters
total_usdnumber(float)
Example:826.85
post/chargeback/calculator
Authentication
Body
{
"billing_basis_usd": 6380,
"chargeback_rate_percent": 12
}
application/json