The payload sent to your webhook endpoint when a license key is created or updated.

License Key Webhook Payload

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

A comprehensive guide to testing various payment methods with Dodo Payments.

Testing Payment Methods

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

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

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

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

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

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.

FAQ's

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 for integrating Dodo Payments

SDKs - Node, Python, PHP, Go & Ruby

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

API Integration Guide

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

Subscription 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

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

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

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.

Payment links

Learn how to integrate Dodo Payments into your checkout process

Checkout Process

This section provides an overview of the process to view and manage payments for your Dodo Payments account.

Payments

Refunds

This section provides an overview of the process to view and manage disputes for your Dodo Payments account.

Disputes

This section provides an overview of the process to view and download reports for your Dodo Payments account.

Reports

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

Add Bank Account Information

Payout Compliance

This section provides an overview of the process to generate API keys for your Dodo Payments account.

API Keys generation

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

Webhook Creation

This section provides an overview of the process to view and manage your business profile for your Dodo Payments account.

Business Profile

This section provides an overview of the process to view and manage your user profile for your Dodo Payments account.

User Profile

Welcome to the Dodo Payments Changelog! Stay updated on all the latest features and improvements we've rolled out to enhance your payment processing experience. At Dodo Payments, we strive to provide a seamless, transparent, and robust platform for global merchants.

Introduced address autofill for checkout page, notifications center, payment link query builder, saved payment methods, and billing currency control.

v1.11.0 (28 March 2025)

Introduced Checkout 2.0, configurable payment methods, dynamic tax calculation, and on-demand subscriptions.

v1.10.1 (21 March 2025)

Introduced a dedicated subscriptions page, enhanced customer details, detailed payout information, an official Ruby SDK, enhanced API filters, and various minor improvements.

v1.7.0 (14 March 2025)

Introduced a custom date filter for analytics, a new tax category, and various improvements.

API Documentation & SDKs

Payments

Subscriptions

Discounts

Licenses

Customers

Webhooks

Products

Refunds

Disputes

Payouts

Miscellaneous

License Key Webhook Payload