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:
| Parameter | Description |
|---|---|
cart_id | The ID of the user's cart |
auth_token | The CST minted via POST /checkout/cst |
Both parameters are required — the checkout page will not load without them.
⚠️Pass
auth_tokenas 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.
