New Features 🚀

Introduced Subscription Plan Change API, enhanced onboarding guidance, notification preferences center, and improved adaptive currency information.

v1.18.3 (26th April 2025)

Dodo Payments Documentation

Welcome to Dodo Payments documentation. This is a guide to help you understand and navigate the Dodo Payments dashboard

Introduction

In this section, we'll guide you through the initial steps to get started with our web application Before you dive into the specifics, make sure you meet the system requirements and have everything in place.

Quickstart

Dodo Payments allows merchants to generate payment links without writing any code. This guide will walk you through the steps to create and share a payment link effortlessly.

No Code Payment Links

This document outlines the Onboarding Verification Process

Verification Process

This document provides detailed information about Dodo Payments' fee structure for processing transactions, issuing payouts, and refunds and chargebacks. All fees outlined here will apply once a merchant's account is live.

Pricing and Fee Structure

Learn the difference between Test Mode and Live Mode and how to switch between them.

Test Mode vs Live Mode

Learn how to test your Dodo Payments integration

Testing Process

The list below includes the countries from which we accept payments for our SaaS and digital products.

Countries Eligible for Payment Acceptance

This documentation is designed to guide merchants through the completion of essential tax forms Form W-9, Form W-8 BEN, and Form W-8 BEN-E. These forms ensure compliance with tax regulations and help merchants claim appropriate tax benefits.

Tax Forms

An overview of payment methods supported by Dodo Payments, including credit/debit cards, digital wallets, BNPL, UPI/Rupay, and European options.

Accepted Payment Methods

When it comes to processing payments globally, digital businesses and SaaS companies are often torn between two models: Merchant of Record (MoR) and Payment Gateway (PG). At Dodo Payments, we believe in simplifying global payments while taking care of compliance, taxes, and local laws — and that's why we operate as a Merchant of Record.

MoR vs PG

A comprehensive guide to selling digital goods and services on iOS apps using Dodo Payments

Selling Digital Goods on iOS

Our Features

The License Key Management feature is designed to help merchants secure their digital products and services by generating, managing, and tracking unique license keys. This feature ensures only authorized users access your products and provides merchants with full control over their license key usage and distribution. Ideal for SaaS businesses and digital product vendors, the tool also includes advanced tracking and revocation capabilities for enhanced security.

License Keys

The Invoice Generation feature in Dodo Payments simplifies the billing process by automatically creating and delivering invoices after every successful payment. Whether for one-time purchases or recurring subscription renewals, invoices are generated to document transactions with clear, professional records.

Invoice Generation

The Storefront Feature allows you to create a simple, branded, and mobile-friendly online store where you can showcase both One-Time Payment products and Subscription products. This feature eliminates the complexity of building an entire website, enabling you to quickly offer your products or services online without additional web development efforts.

Storefront

The Team feature enables you to add teammates to your Dodo Payments dashboard, granting them access based on customizable permissions. You can allow full modification rights or restrict access to view-only mode, ensuring secure and flexible collaboration.

Team Members

Discount codes help merchants attract customers, boost sales, and improve retention by offering promotional discounts. Merchants can create and manage these codes via the dashboard, allowing customers to apply them during checkout for reduced prices.

Discount Codes

Webhooks provide a mechanism for real-time notifications when specific events occur within Dodo Payments, enabling seamless automation and integration with your application.

Webhooks

Manage your Dodo Payments business on the go with our mobile app, available on Google Play and Apple App Store. Monitor transactions, receive real-time notifications, and access your dashboard anywhere.

Mobile App - Dodo Payments

This section provides details on key analytics and reports for business analysis

Analytics and Reporting

Learn about the Account Summary and Payout Wallet features in Dodo Payments. This guide provides a comprehensive overview of transaction types, and amounts, as well as insights into managing your payout wallet for seamless financial operations.

Account Summary & Payout Wallet

Adaptive Currency enables merchants to display prices in customers' local currencies, reducing friction at checkout and improving conversion rates by providing a localized payment experience with automatic currency detection and conversion.

Adaptive Currency

The B2B Payments feature ensures that merchants processing B2B transactions have their customer’s Tax IDs verified during checkout, ensuring accurate tax application based on the customer's country and applicable regulations. This validation helps determine whether input tax collection applies or if the transaction falls under a reverse charge mechanism.

B2B Payments

The Customers Page in Dodo Payments allows merchants to manage their customer relationships by providing a detailed view of all customers who have made a purchase.

Customers

Learn how to implement Purchasing Power Parity pricing with ParityDeals integration to offer location-based discounts for your customers on Dodo Payments

Purchasing Power Parity

The Fraud Detection & Security feature in Dodo Payments helps merchants protect their business from fraudulent activities and secure customer transactions.

Fraud Detection & Security

This section allows you to generate API Keys through the Dashboard

API Key Generation

Integrate Dodo Payments seamlessly with your WooCommerce store to accept global payments through UPI, cards, and more.

WooCommerce Plugin

The **Atlas Demo Product** is a demo site by **Dodo Payments** that showcases how **digital products** (like software licenses, digital downloads, or online memberships) can be sold using our **checkout** solution. Merchants can see both **subscription** and **one-time purchase** flows in action.

Atlas Demo Product

We value feedback from our merchants and aim to continuously improve Dodo Payments to meet your business needs. The **Feature Request and Roadmap** section allows you to directly contribute to our product development by suggesting new features, voting on existing requests, and staying informed about upcoming updates.

Feature Request and Roadmap

We understand that navigating a new platform or resolving issues can sometimes require additional support. To ensure a seamless experience, we offer multiple support channels to address all your concerns.

Help and Support

Comprehensive answers to common questions about documentation, covering setup guides, user manuals, and how-to articles to help you navigate and make the most of our product.

FAQs

Merchant can access and manage their personal account information such as Contact Name, Profile Image and phone number for a more personalised experience through the my account section.

My Accounts

Guidelines for responsible disclosure of security vulnerabilities at Dodo Payments.

Security Reporting Policy

This guide will help you migrate your payment infrastructure to Dodo Payments, ensuring a smooth transition while maintaining security and compliance.

Migrating to Dodo Payments

Welcome to the Dodo Payments API. Our APIs makes it easy to integrate secure, scalable, and versatile payment solutions into your applications.

This tutorial demonstrates integrating Dodo Payments into a Next.js app using the Node.js SDK for One-Time and Subscription Products. It utilizes the Dodo Next.js Minimal Boilerplate and covers essential steps to get started efficiently.

Code Integration Tutorial

Official SDKs of Node, Python, PHP, Go, Ruby, Java & Kotlin for integrating Dodo Payments

SDKs - Node, Python, PHP, Go, Ruby, Java & Kotlin

This guide will help you integrate the Dodo Payments API into your website.

Payments Integration Guide

This guide will help you integrate the Dodo Payments Subscription Product into your website.

Subscription Integration Guide

This guide will help you integrate the Dodo Payments API into your mobile applications.

Mobile Integration Guide

On Demand Subscriptions allow you to charge customers flexibly, rather than strictly on a recurring schedule.

On Demand Subscriptions

This document provides details on how to create, update, manage, and retrieve one-time or subscription-based products using the Dodo Payments API.

Managing Products Via API

Learn how to use metadata to store additional information about your Dodo Payments objects

Metadata Guide

The Allowed Payment Methods feature enables you to control which payment options are available to your customers during checkout. This configuration works for both one-time payments and subscriptions.

Configuring Allowed Payment Methods

The DodoPayments MCP (Model Context Protocol) Server provides a standardized interface for AI models to interact with the DodoPayments API.

MCP Server

Detailed explanations and solutions to technical queries, including troubleshooting, integrations, and system requirements, ensuring seamless implementation and performance.

Technical - FAQs

Get a list of all payments associated with your account.

List Payments

Create a one-time payment for a customer.

Create One Time Payment

Get detailed information about a specific payment.

Get Payment Detail

Get Invoice

Get a list of all subscriptions associated with your account.

List subscriptions

Create Subscription

Get detailed information about a specific subscription.

Get Subscription Detail

Modify an existing subscription's plan, enabling both upgrades and downgrades to different pricing tiers.

Change Plan

Update Subscription

Create a charge for a subscription. This is useful for on-demand billing.

Create Charge (On-Demand)

Retrieve a list of all discounts associated with your account.

List Discounts

Create Discount

Validate a discount code to check if it is valid and can be applied to the current cart.

Validate Discount

Update Discount

Delete Discount

This endpoint allows you to activate a license for the user.

Activate License

This endpoint allows you to deactivate a license for the user.

Deactivate License

This endpoint allows you to validate a license for the user.

Validate License

Retrieve a list of license keys associated with your account.

Get License Keys

Retrieve the details of a specific license key by its ID.

Get License Key

This endpoint allows you to update a license key by its ID.

Update License Key

Retrieve a list of instances for a specific license key.

Get License Key Instances

Retrieve details of a specific license key instance by its ID.

Get License Key Instance

This endpoint allows you to update a specific license key instance by its ID.

Update License Key Instance

Create a new customer in your Dodo Payments account.

Create Customer

Get a list of all customers associated with your account.

List Customers

Get detailed information about a specific customer.

Get Customer Detail

Patch Customer

Create a session of the Customer Portal for a specific customer.

Create Customer Portal Session

Get a list of all webhook events associated with your account.

List Webhook Events

Get detailed information about a specific webhook event.

Get Webhook Event Detail

Send a POST request to your webhook URL to receive notifications about events that occur in your account.

Outgoing Webhooks

Get a list of all products associated with your account.

List Products

Create Product

Get detailed information about a specific product.

Get Product Detail

Update Product

Update Product Images

Archive a product associated with your account.

Archive Products

Unarchive a product associated with your account.

Unarchive Products

Create a new addon product that can be attached to your main subscription products

Create Addon

Retrieve a comprehensive list of all available addons

List Addons

Retrieve detailed information about a specific addon using its unique identifier

Get Addon

Modify the details of an existing addon using its unique identifier

Update Addon

Update Addon Images

Get a list of all refunds associated with your account.

List Refunds

Create Refund

Get detailed information about a specific refund.

Get Refund Detail

Get a list of all disputes associated with your account.

List Disputes

Get detailed information about a specific dispute.

Get Dispute Detail

Get a list of all payouts associated with your account.

List Payouts

Retrieve a list of countries that are supported by the Dodo Payments for your customers.

Supported Countries

Charge a customer for an on-demand subscription.

Charge Subscription

This section provides an overview of the login process and how to access your account.

Login

This section provides an overview of the Identity Verification process.

Identity Verification

This section provides an overview of the Business Verification process.

Business Verification

This section provides an overview of the process to add a one-time product to your Dodo Payments account.

Add One Time Payment Product

This section provides an overview of the process to add a subscription product to your Dodo Payments account.

Add Subscription Product

This section provides an overview of the process to refund a payment for your Dodo Payments account.

Changelog

May 2025

April 2025

March 2025

February 2025

January 2025

December 2024

November 2024

v1.18.3 (26th April 2025)

New Features 🚀

Changelog

May 2025

April 2025

March 2025

February 2025

January 2025

December 2024

November 2024

​New Features 🚀

New Features 🚀