Skip to main content

On demand subscription via API 2.0

Updated over 7 months ago

On-demand subscription: This option is ideal for businesses with variable monthly costs (e.g., depending on usage). Since you can manually create each payment, it's easy to collect a varying amount.


Steps to create the on-demand subscription:

  1. Create a customer
    POST /customers
    Documentation: Create Customer

  2. Create a direct-debit mandate, where you specify the IBAN and the customer created in step 1
    POST /mandates
    Documentation: Create Mandate

  3. There are two options after this:

    • Option 1: Create a payment with a mandate

    • Option 2: Create a subscription (a subscription object will be created, and it will be visible on the subscriptions dashboard).

    3.1 Create a payment with a mandate
    POST /payments
    Documentation: Create Payment
    Example request body:

    jsonCode kopiëren{ "amount": 100, "currency": "EUR", "description": "Payment description", "mandate": "MANDATE_ID" }


    3.2 Create a subscription using the created mandate and specify scheduling as "manual"
    POST /subscriptions
    Documentation: Create Subscription
    Example request body:

    jsonCode kopiëren{ "mandate": "MANDATE_ID", "description": "Subscription description", "currency": "EUR", "scheduling": "manual", "first_period": { "amount": 100 } }

  4. To create subsequent periods for the subscription
    POST /subscriptions/{id}/subscription_periods
    Documentation: Create Subscription Period

Did this answer your question?