Create Guest Checkout Session

POST

portal

guest-checkout-session

curl -X POST https://api.alguna.io/portal/guest-checkout-session \
  -H "Content-Type: application/json" \
  -d '{
    "orgSlug": "acme-corp",
    "planId": "plan_pro_monthly",
    "successUrl": "https://yourapp.com/checkout/success",
    "cancelUrl": "https://yourapp.com/pricing",
    "email": "customer@example.com"
  }'

const session = await alguna.checkout.createGuestSession({
  orgSlug: 'acme-corp',
  planId: 'plan_pro_monthly',
  successUrl: 'https://yourapp.com/checkout/success',
  cancelUrl: 'https://yourapp.com/pricing',
  email: 'customer@example.com'
});

// Redirect customer to session.redirectUrl
window.location.href = session.redirectUrl;

{
  "checkoutSessionId": "cs_abc123xyz",
  "sessionToken": "tok_checkout_abc123...",
  "redirectUrl": "https://checkout.alguna.io/cs/cs_abc123xyz..."
}

Create a checkout session for a new customer (guest checkout). No authentication required. Returns a URL to redirect the customer to complete their purchase.

string

required

Your organization’s slug identifier.

string

required

The plan ID the customer is subscribing to.

string

URL to redirect the customer after successful checkout.

string

URL to redirect the customer if they cancel checkout.

string

Pre-fill the customer’s email address.

object

Optional metadata to attach to the subscription.

curl -X POST https://api.alguna.io/portal/guest-checkout-session \
  -H "Content-Type: application/json" \
  -d '{
    "orgSlug": "acme-corp",
    "planId": "plan_pro_monthly",
    "successUrl": "https://yourapp.com/checkout/success",
    "cancelUrl": "https://yourapp.com/pricing",
    "email": "customer@example.com"
  }'

const session = await alguna.checkout.createGuestSession({
  orgSlug: 'acme-corp',
  planId: 'plan_pro_monthly',
  successUrl: 'https://yourapp.com/checkout/success',
  cancelUrl: 'https://yourapp.com/pricing',
  email: 'customer@example.com'
});

// Redirect customer to session.redirectUrl
window.location.href = session.redirectUrl;

{
  "checkoutSessionId": "cs_abc123xyz",
  "sessionToken": "tok_checkout_abc123...",
  "redirectUrl": "https://checkout.alguna.io/cs/cs_abc123xyz..."
}

string

Unique identifier for the checkout session.

string

Session token for the checkout.

string

URL to redirect the customer to complete checkout.

This endpoint does not require authentication and is designed for public-facing checkout flows. The checkout page is hosted by Alguna and handles payment collection, account creation, and subscription activation.

⌘I

curl -X POST https://api.alguna.io/portal/guest-checkout-session \
  -H "Content-Type: application/json" \
  -d '{
    "orgSlug": "acme-corp",
    "planId": "plan_pro_monthly",
    "successUrl": "https://yourapp.com/checkout/success",
    "cancelUrl": "https://yourapp.com/pricing",
    "email": "customer@example.com"
  }'

const session = await alguna.checkout.createGuestSession({
  orgSlug: 'acme-corp',
  planId: 'plan_pro_monthly',
  successUrl: 'https://yourapp.com/checkout/success',
  cancelUrl: 'https://yourapp.com/pricing',
  email: 'customer@example.com'
});

// Redirect customer to session.redirectUrl
window.location.href = session.redirectUrl;

{
  "checkoutSessionId": "cs_abc123xyz",
  "sessionToken": "tok_checkout_abc123...",
  "redirectUrl": "https://checkout.alguna.io/cs/cs_abc123xyz..."
}

API Reference

Examples

API Reference

Create Guest Checkout Session