---
search:
  tags:
    - billing
    - POST
seo:
  description: >-
    Starts the subscription: EUR 20 a month at list prices, which include 17%…
    Reference for the POST /v1/billing/subscription endpoint in the pols.so API.
sidebar:
  label: Start the monthly subscription, its first payment on Mollie's checkout
  badge: POST
title: Start the monthly subscription, its first payment on Mollie's checkout
type: openapi-operation
---
Starts the subscription: EUR 20 a month at list prices, which
include 17% Luxembourg VAT, with EUR 25 of usage included each
month. It returns the subscription, `pending`, with `checkout_url`,
where the first month is paid on mollie.com. That payment also
lets Mollie charge the same card or account each month from then
on (a mandate). Once Mollie confirms it, the subscription is
`active` until `period_end`, the org gets the month's credit
(`credit_eur`, a `subscription` credit lot on `/v1/balance` that
lasts that month and the next), and the payment gets its invoice.
Mollie then charges the subscription on the same day each month,
each paid month granting its credit and invoice once. What each
month charges (`charged_eur`) follows `tax_treatment`, from the
org's billing details as they are when it is charged, as for a
top-up. Usage beyond the subscription's credit is taken from
prepaid credit (`createTopUp`). Owners' and admins' keys only (403
`forbidden` otherwise).

409 `subscription_exists`: the org has a subscription that has not
ended. 409 `billing_details_required` and `subscription_not_available`
as for top-ups (`createTopUp`). More than 10 subscription payments
started in an hour is 429 `rate_limited`. 502
`payment_provider_error`: Mollie could not be reached or refused
the payment; nothing is charged. 503 `unavailable`: the deployment
takes no payments. While `test` is true, payments go through
Mollie's test mode and no money moves, and their invoices are
drafts.

`POST /v1/billing/subscription`