Agent skill · dodopayments
dodo-best-practices
Guide for initial Dodo Payments setup, including SDK installation, test and live environments, API keys, and the canonical checkout-to-webhook architecture.
What it needs
About 6k tokens when loaded.
What this skill does
Dodo Payments Integration Guide This skill covers the foundational concepts and setup for Dodo Payments. Use it when starting a new integration, setting up the SDK, or understanding the core payment flow. When to use this skill You're building a new payment integration and need to understand Dodo's architecture You need to install and initialize the SDK in your language You want to understand the canonical payment flow and webhook verification You're choosing between framework adapters or payment methods You need to know what Dodo handles versus what you must build --- What is Dodo Payments Dodo Payments is a Merchant of Record (MoR). That means Dodo is the legal seller on every transaction, handles sales tax registration and calculation across all jurisdictions, remits taxes to authorities, and manages card-network disputes and chargebacks. As a developer, you don't build a sales-tax engine or dispute-handling system. You create checkout sessions, listen to webhooks, and grant access when payment succeeds. --- Environment Setup Base URLs Only two real base URLs exist: Live: https://live.dodopayments.com Test: https://test.dodopayments.com Never use api.dodopayments.com — it has no DNS record and cannot be reached. API Keys Keys have two formats: Test: dodotest... Live: dodolive... Environment Variables Default Environment The environment parameter defaults to livemode if omitted. Always pass testmode explicitly during development. --- SDK Installation & Initialization TypeScript/Node.js Constructor options: Option Type Default Notes --- --- --- --- bearerToken string env DODOPAYMENTSAPIKEY Required for API calls environment 'testmode' \ 'livemode' 'livemode' Explicit in dev webhookKey string env DODOPAYMENTSWEBHOOKKEY For webhooks.unwrap() baseURL string — Override; mutually exclusive with environment Python Go PHP Ruby Java Kotlin --- Framework Adapters Dodo publishes framework-specific packages under @dodopayments/. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills dodopayments/dodo-best-practices--07db9a