Laskut

Lasku on kauppiaan laatima laskutusasiakirja — numeroitu, eritelty ja asiakkaalle osoitettu — joka maksetaan sen omalla maksuaikomuksella ja isännöidyllä kassalla.

POST/v1/invoiceslive · tilin aktivoinnin jälkeen

{
  "store_id": "store_01J…",
  "currency": "EUR",
  "items": [
    { "description": "Annual plan", "quantity": 1, "unit_amount": "480.00" },
    { "description": "Onboarding session", "quantity": 2, "unit_amount": "60.00" }
  ],
  "customer": { "name": "Ada Example", "email": "ada@example.com", "reference": "cust-42" },
  "memo": "Thank you for your order.",
  "expires_in_seconds": 604800
}

• Rivisummat ja kokonaissumman laskee rajapinta kaavalla quantity × unit_amount; et koskaan lähetä kokonaissummaa, joka voisi olla ristiriidassa rivien kanssa.
• Laskunumerot ovat juoksevia organisaatio- ja ympäristökohtaisesti.
• Vastaus sisältää kentät payment_intent_id, payment_status ja checkout_url, jonka lähetät asiakkaalle.

Tila

Laskun status johdetaan sen maksuaikomuksesta:

Laskun tila	Maksuaikomus
open	odottaa maksua tai käsittely on kesken
paid	confirmed / overpaid tai ratkaistu hyväksytyksi
partially_paid	underpaid
review	late_payment, manual_review tai reorged
expired	expired ilman maksua
void	sinun mitätöimäsi

POST /v1/invoices/{id}/void mitätöi laskun ja peruu sen maksuaikomuksen, mutta vain ennen kuin yhtään siirtoa on havaittu.