Checkout Session

Stripe Connect Checkout via Altan Pay

⚠️ Always use Altan’s Payment API (no substitutions or extra headers).

1. Endpoint & Headers

Do not include any API key in the headers for this endpoint.

If you don’t yet have stripe_connect_id, prompt Altan Pay to provide it before proceeding.

2. Request Body

{
  "payload": {
    "success_url": "https://your.app.com/success/", // Use root URL if success/ is not implemented
    "cancel_url":  "https://your.app.com/cancel/", // Use root URL if cancel/ is not implemented
    "line_items": [
      {
        "price":    "price_ABC123",
        "quantity": 1
      }
    ],
    "mode": "payment"
  }
}

success_url / cancel_url
Set to your application’s endpoints to handle post-checkout flow.

line_items
List each cart item with its Stripe price ID and desired quantity.

mode

"payment" = one-time purchase

"subscription" = recurring billing

3. Handling the Response

Parse the JSON response:

{ "url": "https://checkout.stripe.com/pay/..." }

Redirect your user’s browser to the returned url.

Implement a webhook listener on your server to confirm payment events.

4. Critical Implementation Rules

URL Substitution
Replace {account_id} and {stripe_connect_id} with the real values before calling.

Mode Selection
Choose "payment" for one-time charges or "subscription" for recurring.

Accurate Line Items
Ensure each item’s price ID and quantity reflect the actual cart.

URL Configuration
Use your own application URLs for success and cancellation.

Error Handling
Gracefully handle HTTP failures and malformed responses (e.g., retry, log, alert).

Checkout Session

Stripe Connect Checkout via Altan Pay#

1. Endpoint & Headers#

2. Request Body#

3. Handling the Response#

4. Critical Implementation Rules#

Stripe Connect Checkout via Altan Pay

1. Endpoint & Headers

2. Request Body

3. Handling the Response

4. Critical Implementation Rules