---
search:
  tags:
    - billing
    - POST
seo:
  description: >-
    Starts the subscription: EUR 20 a month at list prices, which exclude VAT,
    with… 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
exclude VAT, with EUR 25 of usage included each month; with 17%
Luxembourg VAT (`lu_vat`) a month charges EUR 23.40. 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.

A consumer, or a business whose VAT ID VIES has not confirmed,
orders only with `withdrawal_consent` (409
`withdrawal_consent_required` otherwise): "I expressly request
that pols.so start the subscription now, before the 14-day
withdrawal period ends. I understand that if I withdraw, I pay a
proportionate amount for the service provided until then, which
is the share of the month's price matching the share of the
month's usage I used, and that I lose my right of withdrawal once
the contract has been fully performed." It is recorded and the
order confirmed by email as for a top-up (`createTopUp`).

`POST /v1/billing/subscription`