Get the extra phone numbers add-on
Asks Polar for a page where the customer pays for the extra phone numbers add-on, which bills extra numbers every month apart from the plan, on an annual plan too. Poll GET /billing/extra-numbers/checkout/ until status is ready, send them checkout_url, then poll until add_on_active is true. Only a business that can buy a priced extra number and doesn’t have the add-on gets one; an active add-on, a business that can’t buy extra numbers, someone else’s open checkout and a deployment that doesn’t sell extra numbers are a 409. With a platform key the checkout is made out to the business’s owner.
Authorizations
An API key from Settings > API keys (lsk_...), which acts on its own business, or a platform key from the PLATFORM_API_KEYS setting (lsp_...), which onboards and manages businesses. Scopes: business:read, business:write, calls:read, contacts:read, contacts:write, appointments:read, appointments:write, messages:read, knowledge:read, knowledge:write, webhooks:manage, billing:manage, phone_numbers:manage, team:manage, businesses:create, users:create, phone_numbers:purchase, partner:read, partner.businesses:write, partner.demos:write, partner.packages:write, partner.branding:write, partner.templates:write, partner.team:write, partner.billing:read, partner.billing:write. Only platform keys can hold businesses:create and users:create, and only a key a partner made in its console can hold the partner scopes, which the Partner endpoints use. Only a partner's owners grant partner.billing:read and partner.billing:write.
Headers
The business a platform key acts on. Required with a platform key. A per-business key may leave it out; if it sends one, it must be the key's own business.
A unique value, up to 255 characters, that makes retries of this request safe for 24 hours.
255Body
The agent whose phone page Polar sends the payer back to. Left out, they land on the billing page.
Response
Accepted
A Polar checkout for the extra phone numbers add-on.