v1.75.0 (January 23, 2026)

​

New Features

​

1. Product Collections

• Collection-based checkout: Display all products from a collection in one checkout view, letting customers compare and choose their preferred plan
• Organized product management: Group related products (e.g., Starter, Pro, Enterprise) under a single collection
• Customer Portal integration: Enable customers to upgrade or downgrade between products within the same collection
• Merchant control: Enable, disable, and reorder products within each collection

const session = await client.checkoutSessions.create({
  product_collection_id: 'pdc_abc123',
  product_cart: [], // Required: pass an empty array for collection checkout
  return_url: 'https://yoursite.com/return'
});

// Redirect customer to the checkout
window.location.href = session.checkout_url;

​

2. RevolutPay & Billie Payment Methods for GBP Currency

• RevolutPay – Fast and seamless payments for Revolut users globally
• Billie – B2B Buy Now Pay Later solution enabling businesses to offer flexible payment terms to their customers

​

3. Checkout Session Preview

const preview = await client.checkoutSessions.preview({
  product_cart: [
    { product_id: 'pdt_123', quantity: 1 }
  ],
  billing_address: {
    country: 'US',
    state: 'CA',
    zipcode: '94102'
  },
  discount_code: 'SAVE20'
});

console.log('Subtotal:', preview.current_breakup.subtotal);
console.log('Tax:', preview.current_breakup.tax);
console.log('Discount:', preview.current_breakup.discount);
console.log('Total:', preview.total_price);

• Custom pricing displays: Show accurate totals including tax before checkout
• Discount validation: Verify discount codes and show savings to customers
• Multi-currency support: Preview pricing in different currencies
• Cart summaries: Build custom cart UIs with real-time pricing

​

4. Metadata Support in Change Plan Requests

// Adding metadata when changing a subscription plan
await client.subscriptions.changePlan('sub_123', {
  product_id: 'pdt_premium',
  proration_billing_mode: 'prorated_immediately',
  quantity: 1,
  metadata: {
    upgrade_reason: 'feature_request',
    previous_plan: 'basic',
    sales_rep: 'john@company.com'
  }
});

• Track upgrade/downgrade reasons: Store why customers changed plans
• Link to CRM records: Associate plan changes with sales activities
• Internal categorization: Tag plan changes for reporting and analytics
• Audit trails: Maintain records of who initiated plan changes

​

5. invoice_url Field in Payment Response and Payment Link Response

{
  "payment_id": "pay_2IjeQm4hqU6RA4Z4kwDee",
  "status": "succeeded",
  "invoice_url": "https://dodopayments.com/invoices/inv_2IsUnWGtRKFLxk7xAQeyt",
  "total_amount": 9900,
  "currency": "USD",
  // ... other fields
}

• Customer communication: Send invoice links directly to customers
• Accounting integration: Link payments to invoices in your accounting software
• Self-service portals: Allow customers to access their invoices easily
• Record keeping: Maintain direct references to invoice documents

​

6. Validate Discount by Code Name Endpoint

// Validate a discount code before checkout
const discount = await client.discounts.retrieveByCode('SAVE20');

console.log('Discount type:', discount.type);
console.log('Discount value:', discount.amount);
console.log('Valid until:', discount.expires_at);

• Pre-checkout validation: Verify discount codes before creating checkout sessions
• Real-time feedback: Show customers if their code is valid
• Error handling: Catch invalid or expired codes early
• Custom discount UIs: Build discount code input fields with instant validation

​

7. Enhanced Filtering Capabilities for Customers, Discounts, and License Keys

// Find customers by name created in the last 30 days
const customers = await client.customers.list({
  name: 'John',
  created_at_gte: '2026-01-01T00:00:00Z'
});

// Find active percentage discounts for a specific product
const discounts = await client.discounts.list({
  active: true,
  discount_type: 'percentage',
  product_id: 'pdt_123'
});

// Find active license keys for a specific product
const licenseKeys = await client.licenseKeys.list({
  status: 'active',
  product_id: 'pdt_123'
});

​

8. UI/UX Improvements in Dashboard

• Improved navigation and layout consistency
• Enhanced data table interactions
• Better loading states and feedback
• Refined visual design elements
• Improved mobile responsiveness