Guides (For Platforms)
Markdown
Hosted Checkout Flow

Once you've minted a CST, you can route your customer to the Diddo-hosted checkout page to complete their purchase. The hosted checkout handles the full payment experience — no additional frontend work required.

There are two ways to load it: a URL redirect for web, or a WebView for native iOS and Android apps.

📘

Don't have a CST yet? See Customer Session Token (CST) first.


🚀 Checkout URL

https://checkout.shopdiddo.com

Both methods below load this URL with the following required parameters:

ParameterDescription
cart_idThe ID of the user's cart
auth_tokenThe CST minted via POST /checkout/cst

Both parameters are required — the checkout page will not load without them.

⚠️

Pass auth_token as a URL fragment (after #), not a query parameter. Fragments are never sent to the server, which keeps the token out of access logs.

A correctly formed URL looks like this:

json

🧭 Integration Examples

1. Web Redirect

Redirect the user's browser directly to the checkout URL:

javascript

From there, the customer selects a payment method and completes their purchase.


2. iOS — WKWebView (Swift)

Load the checkout experience natively inside your iOS app:

swift

3. Android — WebView (Kotlin)

kotlin
⚠️

You must enable JavaScript in your Android WebView (javaScriptEnabled = true). The checkout experience will not function without it.


📦

Prefer to embed checkout directly in your web UI without a redirect? See the Checkout SDK.


👉 Next: Checkout SDK →