Developer Docs

Developer Docs

  • Getting Started
  • SubscriptionJS
  • REST API
  • Webhooks
  • Code Samples
  • UseCases
  • Request a Demo

›Contracts

Introduction

  • Introduction

Contracts

  • Adding contract for new customer
  • Adding contract for existing customer
  • Adding future contract without invoicing
  • Up/-downgrading to a plan variant
  • Terminate a contract with notice
  • Terminate a contract without notice

Components

    Component subscriptions

    • Concept
    • Adding/removing
    • In-/decreasing quantity
    • Override for components

    Metered usage components

    • Concept
    • Bill metered usage
    • Override for metered usage

Discounts

  • Adding discounts
  • Adding discounts via coupon

Miscellaneous

  • Rated items
  • Email Notification Template

Adding future contract without invoicing

By default, billwerk invoices contracts instantly as they are usually prepaid, this is also the case if a contract is created now but should actually start in the future. To work around this behavior you need a plan variant which costs nothing. If you now subscribe your customers to this plan variant there will be no costs for now. After this step you have to create and commit an upgrade order with the future contract start date as ChangeDate. If this date is reached, the system will bill.

Sample request - signup order

POST /Orders

{
    "Cart":{
        "PlanVariantId":"5cb72076443e5521a8bexxxx"
    },
    "CustomerId":"5cd183b8443e551e4446xxxx",
    "StartDate":"2021-03-05T00:00:00.000Z"
}

Sample request - upgrade order

{
    "ContractId":"5ced07d14de0841b78b0fb0f",
    "Cart":{
        "PlanId":"5c8ba204443e55181c34c62f",
        "PlanVariantId":"5c8ba204443e55181c34c633"
    },
    "ChangeDate":"2019-06-01T00:00:00.000Z"
}
Last updated on 5/29/2020 by Thomas Tauber
← Adding contract for existing customerUp/-downgrading to a plan variant →
Docs
Getting StartedAPI Reference
Resource
Help CenterSupportBlogTutorials
Start with billwerk
Test for free
Request a Demo
Already started?
billwerk Sandboxbillwerk Production
billwerk GmbH
© Made with ❤ in Germany for Europe by billwerk GmbH | 2022
Imprint
|
Data Privacy Rules
|
Disclaimer