Skip to content
Helpcentrum-gids · Facturering & betalingen
3 min leestijdGecontroleerd 2026-11-16

Facturen & betalingshistorie

Bekijk maandelijkse en jaarlijkse facturen, download officiële btw-pdf's en check aankomende verlengingen.

In deze gids

Overzicht

Geautoriseerde facturatiebeheerders kunnen de volledige historische facturatielijst (GET /api/v1/billing/history), factuurregels (invoice line item type) en betaalstatussen bekijken onder Instellingen -> Facturatie -> Facturen (/settings/billing/invoices). Ondersteund door Billing API (/api/v1/billing/invoices* en GET /api/v1/billing/tax-profile/datev-export) genereert Passinstance btw-conforme PDF-belastingfacturen voor elke abonnementsverlenging, pro-rata tussentijdse aanpassing en modulaire add-on, en maakt directe betaling of annulering van openstaande facturen mogelijk.

Levenscyclus van factuurgeneratie & afrekening

SYSTEEMARCHITECTUUR
INTERACTIEVE ARCHITECTUUR
FACTUURLEVENCYCLUS, PDF-STREAMING & HERPOGING
FASE 01 FACTURATIECYCLUS / PRO-RATA-GEBEURTENIS
Abonnementsverlenging, planupgrade (change) of add-on-abonnement
Legt rechtspersoon, adres & vatNumber/taxId vast (PUT/billing/settings)
FASE 02 FACTUURTOESTANDSMACHINE (Billing API)
+[ PAID ] (Automatische incasso geslaagd) [ PENDING / OPEN ]-+[ OVERDUE ]POST/invoices/:id/pay (Wacht op betaling) | (Gebruikt stand.meth.)
+[ VOID / CANCELLED ] (Geannuleerde factuur)
FASE 03 FACTUUR OPVRAGEN & PDF-STREAMING
GET/api/v1/billing/invoices (Gepagineerde ?page=&limit= geschiedenis)
GET/api/v1/billing/invoices/:id (Regels, tegoeden, btw-uitsplitsing)
GET/api/v1/billing/invoices/:id/download (application/pdf binaire stream)

Belangrijk: Zakelijke factuurgegevens (companyName, address, taxId en vatNumber via PUT /api/v1/billing/settings en PUT /api/v1/billing/tax-profile) worden op elke factuur vastgelegd zodra deze wordt afgerond. Houd uw belastinggegevens actueel in Bedrijfsinstellingen vóór uw verlengingsdatum.

Factuurstatus (invoice status), levenscyclus & regelsoorten

Facturen houden zowel een administratieve levenscyclus bij (invoice lifecycle state: DRAFT | OPEN | CLOSED | VOID) als een betalingsstatus (invoice status), terwijl afzonderlijke regels invoice line item type gebruiken (BASE_SUBSCRIPTION | ADD_ON | ACTIVE_PASSES_INCLUDED | ACTIVE_PASSES_OVERAGE | USAGE_EMAIL | USAGE_SMS | CREDIT_NOTE | ADJUSTMENT | TAX):

invoice statusBoekhoudkundige betekenisAanbevolen actie
PAIDBetaling is geslaagd en afgerekend via de standaard betaalmethode van de werkruimte.Download het officiële PDF-belastingbewijs via /download voor uw administratie.
PENDING / PARTIALLY_PAIDDe factuur is definitief (OPEN) en wacht op incasso of gedeeltelijke voldoening.Controleer uw standaard betaalinstrument in Betaalmethoden en voer POST /api/v1/billing/invoices/:id/pay uit.
OVERDUEAutomatische betaling is mislukt na het eerste incassovenster (bijv. verlopen kaart of vereiste 3DS-verificatie).Werk uw kaart/mandaat bij in /settings/billing/payment-method en probeer opnieuw via POST /api/v1/billing/invoices/:id/pay.
CANCELLED / VOIDFactuur werd geannuleerd (POST /api/v1/billing/invoices/:id/cancel) of ongeldig verklaard vóór incasso.Geen betaling verschuldigd; bewaar het document desgewenst voor volledige auditopbouw.

API-referentie factuurbeheer (Billing API)

EndpointHTTP-methodeBeschrijving
/api/v1/billing/invoicesGETGeeft gepagineerde facturen van de werkruimte weer (?page=1&limit=20).
/api/v1/billing/invoices/:idGETHaalt gedetailleerde factuurgegevens op inclusief factuurregels (invoice line item type), btw-tarieven, btw-notities en betaalpogingen.
/api/v1/billing/invoices/:id/downloadGETStreamt de officiële gespecificeerde btw-factuur als application/pdf-bijlage.
/api/v1/billing/invoices/:id/payPOSTBetaalt of probeert opnieuw een openstaande/achterstallige factuur te innen met de actieve betaalmethode van de werkruimte.
/api/v1/billing/invoices/:id/cancelPOSTAnnuleert een onbetaalde open factuur.
/api/v1/billing/historyGETRetourneert chronologische facturatie- en betaalgebeurtenissen van de werkruimte.

1. Gedetailleerde factuurregels & btw bekijken (GET /api/v1/billing/invoices/:id)

HTTP
GET /api/v1/billing/invoices/inv_01933220-5a11-7e00-9c44-887766554433 HTTP/1.1
Host: api.passinstance.com
Authorization: Bearer <access_token>

Antwoordpayload (200 OK)

JSON
{
  "id": "inv_01933220-5a11-7e00-9c44-887766554433",
  "invoiceNumber": "PI-2026-004891",
  "status": "PAID",
  "lifecycle": "CLOSED",
  "currency": "EUR",
  "issuedAt": "2026-11-16T09:00:00.000Z",
  "paidAt": "2026-11-16T09:00:04.000Z",
  "customerDetails": {
    "companyName": "Phenix Hospitality GmbH",
    "vatNumber": "DE301928374",
    "address": "Friedrichstrasse 114A, 10117 Berlin, DE"
  },
  "lineItems": [
    {
      "kind": "BASE_SUBSCRIPTION",
      "description": "Growth Plan (2,000 Active Passes) — Monthly",
      "quantity": 1,
      "unitAmountCents": 12000,
      "amountCents": 12000
    },
    {
      "kind": "ADD_ON",
      "description": "Custom Vanity Domain & Branded Email Add-On",
      "quantity": 1,
      "unitAmountCents": 2900,
      "amountCents": 2900
    }
  ],
  "subtotalCents": 14900,
  "taxRatePercent": 19.0,
  "taxCents": 2831,
  "totalCents": 17731
}

2. PDF-belastingfacturen streamen (GET /api/v1/billing/invoices/:id/download)

HTTP
GET /api/v1/billing/invoices/inv_01933220-5a11-7e00-9c44-887766554433/download HTTP/1.1
Host: api.passinstance.com
Authorization: Bearer <access_token>
HTTP
HTTP/1.1 200 OK
Content-Type: application/pdf
Content-Disposition: attachment; filename="invoice-PI-2026-004891.pdf"

3. Betaling opnieuw starten op een openstaande factuur (POST /api/v1/billing/invoices/:id/pay)

Werk uw standaard betaalinstrument bij onder Instellingen -> Facturatie -> Betaalmethode (/settings/billing/payment-method) en start daarna de incasso (geen JSON-body vereist):

HTTP
POST /api/v1/billing/invoices/inv_01933299-1b22-7c00-8d11-223344556677/pay HTTP/1.1
Host: api.passinstance.com
Authorization: Bearer <access_token>
JSON
{
  "invoiceId": "inv_01933299-1b22-7c00-8d11-223344556677",
  "status": "PAID",
  "paidAt": "2026-11-16T10:36:45.000Z",
  "amountPaidCents": 17731
}

Gerelateerde documentatie

Klaar om uw eerste kaartprogramma te lanceren?

Maak uw workspace aan, configureer uw sjabloon en test een echte kaart in Apple Wallet en Google Wallet voordat u opschaalt.