API Reference

Get a checkout link

A Stripe Checkout link that starts the customer's subscription, with a free trial when their account has one. The customer finishes it on Stripe's page, where any card is entered.

Response. ```json { "url": "https://checkout.stripe.com/c/pay/cs_live_…" }


Give the link to the customer. They open it and finish on Stripe's page themselves. Stripe's webhook, not this call, starts the subscription; poll [setup status](/docs/setup-status) until the stage is `start`. Stripe Checkout links last 24 hours.

Before you hand it over, read `payment` from setup status and tell the customer what they are agreeing to: the price, the free period if any, and whether the page asks for a card. Each call makes a new Checkout session, and a new one stops the earlier link working, so ask for a new link only when the customer has lost theirs. The CLI's `revnu setup checkout` reuses the link it handed out.

| Code | Meaning |
|---|---|
| 200 | `{ "url": "…" }` |
| 409 | `rejected` with a `message`: the review isn't confirmed yet, or the account has a YC deal and adds its card in the dashboard. |
post/api/v1/setup/checkout

Request

  • Base URL: https://revnu.com
  • URL: https://revnu.com/api/v1/setup/checkout
  • Auth: HTTP bearer

Response

{ "url": "…" }

urlstring required

Changes

No recorded changes to this operation across all 1 revision of this API.