Guide for starting hosted Checkout Sessions, payment links, and overlay or inline checkout for one-time and recurring products; use subscription-integration for post-checkout lifecycle management.
SkillScore100Maintained
Automatic
◆Coding pack
Last verified 9/1/2026
What it changes
Passed 24 of 24 test cases with the skill, and 8 of 24 without it.
Without skill33%
With skill100%
Checks it passed that the model alone missed
Includes URL path prefix /buy/
Passes billing_currency: 'EUR'
Calls client.checkoutSessions.preview
and 25 more in the full report
16 fixed8 passed either way0 still failing0 broke
Pass-rate lift
+67 pp
Tokens
+253%
Agent turns
0%
Response time
-26%
Model gemini-3.6-flashMeasured 9/1/2026v124 of 24 cases passed with skill
Tokens, turns and time describe resource use, not a dollar price.
See it in action
One of 16 test cases the skill fixed. Same model, same prompt, with and without the skill.
1 of 16
Prompt
When creating a finalized Dodo Payments session with 'confirm: true' for an immediate client-side integration, how long does the generated session checkout URL remain valid before expiring?
What was checked, without and with the skill
Checked
Without skill
With skill
Identifies that the session expires after 15 minutes when confirm=true
Missed
Passed
case-14 · gemini-3.6-flash · 9/1/2026 · answers are capped and redacted
What's inside
The instructions your model reads when the skill loads.
SKILL.md845 linessingle file
Dodo Payments Checkout Integration
Use client.checkoutSessions.create(...) to build hosted checkout pages or overlay checkout modals. This is the recommended path for all new payment integrations.
When to use this skill
Build a one-time payment checkout flow
Create a subscription checkout with optional trial
Embed checkout in an overlay or inline modal
Collect customer billing info and custom fields at checkout
Apply discount codes or handle currency selection
Redirect customers after payment completes
Checkout Methods
Dodo Payments offers three ways to collect payment:
Method
Best For
Setup
Checkout Sessions (recommended)
Most integrations; full control
Server-side SDK call
Static Payment Links
No-code sharing; reusable URLs
Dashboard or direct URL
Overlay/Inline Checkout
Checkout stays on your site
Client-side SDK
Legacy: Dynamic Payment Links created via POST /payments or POST /subscriptions are deprecated. Use Checkout Sessions instead.
Core Concepts
Amounts in smallest currency unit: All prices are in cents (or equivalent). A $10 USD charge is 1000.
Checkout Session: A single-use session that generates a hosted checkout URL. Expires after 24 hours (or 15 minutes if confirm=true).
Return URL: Where the customer lands after payment. Query parameters include status=success and session_id.
Entitlement on webhook: The browser redirect is not the source of truth. Always verify payment via webhook before granting access. See webhook-integration skill for verification.