Hosted checkout

Hosted checkout is a payment page that Solvimon builds and hosts for one subscription you are selling. You link to it from your site, and when a customer pays, Solvimon creates their account and starts the subscription.

What it does

You are selling a plan. Rather than building a signup and payment flow, you create a checkout link in Solvimon and put it behind a button on your pricing page or in an email.

When a customer opens that link, the page:

• Asks for their name, email, country, and billing address.
• Prices the subscription live as they type, including the correct tax for their country.
• Offers the payment methods available for that country and amount.
• Takes the payment.

When the payment succeeds, Solvimon creates the customer record, activates the subscription, and marks the first invoice as paid. You do not have to create the customer beforehand or finish anything afterwards.

Depending on how the plan is configured, the customer may also choose their billing period, pick optional add-ons, set the number of seats, or enter a promotion code. The price preview updates with each choice.

When to use it

Use hosted checkout for self-serve signup, where anyone who visits your site should be able to subscribe without you touching the account. Because the page is public and not tied to one person, you can publish the link anywhere.

If you want the same flow to happen inside your own product rather than on a Solvimon page, use the SDK’s Checkout screen instead. That is a separate integration: your application renders the UI and handles who the visitor is.

Create a checkout link

A checkout link is a portal URL of type INIT_PRICING_PLAN_SUBSCRIPTION. It points at the pricing plan subscription that describes what you are selling.

$
curl -X POST https://test.api.solvimon.com/v1/portal-urls \
>
  -H "X-API-KEY: <apiKey>" \
>
  -H "Content-Type: application/json" \
>
  -d '{
>
    "type": "INIT_PRICING_PLAN_SUBSCRIPTION",
>
    "init_pricing_plan_subscription": {
>
      "pricing_plan_subscription_id": "ppsu_example",
>
      "success_url": "https://yourapp.com/welcome"
>
    }
>
  }'

1
{
2
  "object_type": "PORTAL_URL",
3
  "id": "purl_example",
4
  "type": "INIT_PRICING_PLAN_SUBSCRIPTION",
5
  "status": "PUBLISHED",
6
  "url": "https://portal.solvimon.com/...",
7
  "init_pricing_plan_subscription": {
8
    "pricing_plan_subscription_id": "ppsu_example",
9
    "success_url": "https://yourapp.com/welcome"
10
  }
11
}

You do not pass a customer_id. The customer identifies themselves on the page, which is why one link works for everyone.

Take the url from the response and link to it. The link stays valid until you revoke it, so you can create it once and reuse it.

See Create a portal URL for the full schema.

After the payment

success_url is where Solvimon sends the customer once payment succeeds.

Treat that redirect as a convenience for the customer, not as your record of the sale. It happens in the customer’s browser, so someone who closes the tab after paying never triggers it.

Revoking a link

To stop a checkout link from working, revoke it:

$
curl -X POST https://test.api.solvimon.com/v1/portal-urls/purl_example/revoke \
>
  -H "X-API-KEY: <apiKey>"

The link then reports status: "REVOKED" and no longer opens. Revoke and recreate when you change what you are selling, so nobody checks out on old terms.

Things to know

• One link, one subscription. The link is tied to the pricing plan subscription you created it for. Selling a second plan means a second link.
• Abandoned checkouts cost nothing. A visitor who leaves without paying creates no customer and no invoice.
• US and Canada need a full address. Tax there depends on the address, so the page requires it before payment.
• Test and live are separate. A link created with a test API key only accepts test payments and creates test data.