Payment plans

Payment plans split the invoice into instalments. The service can either calculate instalments or you can provide them.

Calculated payment plan

Use these fields on invoice dataset:

• payplaninterval. Months between instalments.
• payplanamount. Instalment amount in EUR.
• payplancount. Number of instalments.

Send payplaninterval and one of payplanamount or payplancount.

Example: 100 EUR per month

{
  "datastream": {
    "dataset": [
      {
        "jobtype": "0",
        "customertype": "1",
        "company": "Example Company",
        "address": "Example street 1",
        "postcode": "00100",
        "city": "Helsinki",
        "billdate": "2026-02-06",
        "paydate": "2026-02-20",
        "payplaninterval": "1",
        "payplanamount": "100.00",
        "payrow": [
          { "desc": "Installment sale", "count": "1", "amount": "499.99", "taxpr": "24" }
        ]
      }
    ]
  }
}

Self-calculated payment plan

Use payplan.instalment to set your own amounts and dates.

{
  "datastream": {
    "dataset": [
      {
        "jobtype": "0",
        "customertype": "1",
        "company": "Example Company",
        "address": "Example street 1",
        "postcode": "00100",
        "city": "Helsinki",
        "billdate": "2026-02-06",
        "paydate": "2026-02-20",
        "payplan": {
          "instalment": [
            { "date": "2026-02-20", "amount": "250.00" },
            { "date": "2026-08-20", "amount": "249.99" }
          ]
        },
        "payrow": [
          { "desc": "Installment sale", "count": "1", "amount": "499.99", "taxpr": "24" }
        ]
      }
    ]
  }
}

Payment plans cannot be used for consumer e-invoices or consumer invoices. If you need instalments for consumers, send separate invoices per due item.