Rova Media Dodo Payment Addon for Paid Member Subscriptions

Description

Rova Media Dodo Payment Addon for Paid Member Subscriptions integrates Dodo Payments hosted checkout with Paid Member Subscriptions and PMS Pro.

Created by Uchechukwu Ajuzieogu for Rova Media Digital Inc.

The plugin lets site owners sell PMS subscription plans through Dodo Payments by mapping each PMS plan to a Dodo Product ID. It supports one-time payments, recurring subscriptions, payment and subscription webhooks, renewals, cancellations, and optional one-time sign-up fee products.

If a PMS subscription plan has a sign-up fee, the plugin can add a separate one-time Dodo product for that fee. Existing members can be backfilled so they are not charged the sign-up fee again during renewal, retry payment, or resubscribe checkout.

Key features:

• Adds Dodo Payments as a PMS payment gateway.
• Uses Dodo Payments hosted checkout.
• Supports recurring PMS subscription plans.
• Supports Dodo payment and subscription webhooks.
• Supports one-time PMS plans.
• Supports separate Dodo products for PMS sign-up fees.
• Stores Dodo subscription IDs on PMS member subscriptions for renewal and cancellation matching.
• Includes live/test API key and webhook secret settings.
• Includes an existing-member backfill tool for sign-up fee history.

Requirements

• WordPress.
• Paid Member Subscriptions / PMS Pro installed and active.
• A Dodo Payments account.
• Dodo Product IDs for each PMS subscription plan you want to sell.
• A separate one-time Dodo Product ID for any PMS sign-up fee.

External services

This plugin connects to Dodo Payments to create hosted checkout sessions, validate configured Dodo product IDs, and process Dodo webhook events for successful payments, failed payments, renewals, cancellations, and subscription status changes.

When a customer starts checkout, the plugin sends the selected Dodo Product ID, customer email address, customer name when available, PMS payment ID, WordPress user ID, subscription plan ID, checkout return URL, and related checkout metadata to Dodo Payments. This is required to create the hosted checkout session and associate the completed Dodo payment with the correct PMS subscription.

When an administrator saves a subscription plan with a Dodo Product ID, the plugin may request product details from Dodo Payments to validate whether the product is configured as one-time or recurring.

When Dodo Payments sends a webhook to the site, the plugin receives and processes the webhook payload sent by Dodo Payments so it can update the related PMS payment and subscription records.

This service is provided by Dodo Payments. Terms: https://dodopayments.com/legal/terms-of-use/ . Privacy policy: https://dodopayments.com/privacy-policy .

Configuration

Webhook URL

Use the webhook URL shown in the Dodo Payments settings block. It has this format:

https://example.com/?pay_gate_listener=rovadpa_dodo_payments

Recommended webhook events

Enable at least these events in Dodo Payments:

• payment.succeeded
• payment.completed
• payment.failed
• subscription.active
• subscription.created
• subscription.renewed
• subscription.cancelled
• subscription.expired
• subscription.failed
• subscription.on_hold

Subscription plan mapping

Edit a PMS subscription plan and fill in:

• Dodo Payments Product ID: the main Dodo product for the plan.
• Dodo Sign-up Fee Product ID: the separate one-time Dodo product for the sign-up fee, if the PMS plan has one.

For recurring PMS plans, the main Dodo product should be configured as a recurring/subscription product in Dodo.

For sign-up fees, the Dodo sign-up fee product should be configured as a one-time product.