Creates a subscription: the billing schedule a payment link follows. You set how often it bills (frequency and frequency_interval) and when it stops (end_date and/or payment_quantity; if you send both, billing stops at whichever limit is reached first).

To start on a set day, send weekly_start_day for weekly plans or monthly_start_date for monthly and annual plans. The response's start_date is then the next matching date. The response's frequency uses the singular unit (week, month, year), not the value you sent.

test is a sandbox-only frequency for trying out recurring charges. Production rejects it. See Sandbox testing.

🚧

Attach it to a payment link

A subscription does nothing on its own. Pass the returned identifier as subscription_id on Create payment link or Update payment link. Until it is attached, the other subscription endpoints return 404 for it.