#dwolla-legal-disclaimer {
  margin-top: 2rem;
  font-size: 12px;
  color: #6b7280; /* Tailwind gray-500 */
  max-width: 700px;
  font-family: Roboto, Arial, sans-serif;
  padding: 20px 0 0 0;
  text-align: left;
}

#dwolla-legal-disclaimer strong {
  display: block;
  margin-bottom: 0.5rem;
  font-weight: 600;
  color: #111827; /* Tailwind gray-900 */
  font-size: 12px;
}

#dwolla-legal-disclaimer span {
  color: #6b7280; /* Tailwind gray-500 */
  font-size: 12px;
  line-height: 21px;
}

#dwolla-legal-disclaimer a {
  color: #ca4c24;
  text-decoration: none;
  transition: text-decoration 0.2s;
}
#dwolla-legal-disclaimer a:hover {
  text-decoration: underline;
}

/* Dark mode support */
[data-theme="dark"] #dwolla-legal-disclaimer,
.dark #dwolla-legal-disclaimer {
  color: #d1d5db; /* Tailwind gray-300 */
}
[data-theme="dark"] #dwolla-legal-disclaimer strong,
.dark #dwolla-legal-disclaimer strong {
  color: #fff;
}
[data-theme="dark"] #dwolla-legal-disclaimer span,
.dark #dwolla-legal-disclaimer span {
  color: #d1d5db; /* Tailwind gray-300 */
}

.osano-cm-widget {
  display: none;
}

/* Hide Ask AI button from Mintlify */
#assistant-entry,
.assistant-entry,
#assistant-entry-mobile,
.assistant-entry-mobile {
  display: none !important;
}

/* Body background override for dark mode */
[data-theme="dark"] body,
.dark body {
  background-color: #101019 !important;
}

/* Improved paragraph text contrast for dark mode */
[data-theme="dark"] p,
.dark p {
  color: #d1d5db !important; /* Light gray for good contrast */
}

/* Improved general text contrast for dark mode */
[data-theme="dark"] .prose,
.dark .prose {
  color: #d1d5db !important;
}

[data-theme="dark"] .prose p,
.dark .prose p {
  color: #d1d5db !important;
}

/* Target Mintlify's specific white text classes in gradient section */
[data-theme="dark"] #gradient-cta-section .mint-text-white,
[data-theme="dark"] #gradient-cta-section .mint-text-white p,
[data-theme="dark"] #gradient-cta-section .mint-text-lg,
[data-theme="dark"] #gradient-cta-section .mint-text-lg p,
.dark #gradient-cta-section .mint-text-white,
.dark #gradient-cta-section .mint-text-white p,
.dark #gradient-cta-section .mint-text-lg,
.dark #gradient-cta-section .mint-text-lg p {
  color: white !important;
}

/* Preserve the B45277 button text color */
[data-theme="dark"] #gradient-cta-section [class*="mint-text-[#B45277]"],
[data-theme="dark"] #gradient-cta-section [class*="mint-text-[#B45277]"] p,
.dark #gradient-cta-section [class*="mint-text-[#B45277]"],
.dark #gradient-cta-section [class*="mint-text-[#B45277]"] p {
  color: #B45277 !important;
}

/* Catch-all for any other text elements in gradient section (default to white) */
[data-theme="dark"] #gradient-cta-section h1,
[data-theme="dark"] #gradient-cta-section h2, 
[data-theme="dark"] #gradient-cta-section h3,
[data-theme="dark"] #gradient-cta-section h4,
[data-theme="dark"] #gradient-cta-section h5,
[data-theme="dark"] #gradient-cta-section h6,
[data-theme="dark"] #gradient-cta-section span,
.dark #gradient-cta-section h1,
.dark #gradient-cta-section h2,
.dark #gradient-cta-section h3,
.dark #gradient-cta-section h4,
.dark #gradient-cta-section h5,
.dark #gradient-cta-section h6,
.dark #gradient-cta-section span {
  color: white !important;
}

/* Improved sidebar navigation text contrast for dark mode - Mintlify specific */
[data-theme="dark"] .dark\:text-gray-400,
.dark .dark\:text-gray-400,
[data-theme="dark"] .text-gray-700,
.dark .text-gray-700 {
  color: #d1d5db !important;
}

/* Sidebar group headers */
[data-theme="dark"] .sidebar-group-header,
.dark .sidebar-group-header,
[data-theme="dark"] #sidebar-title,
.dark #sidebar-title {
  color: #d1d5db !important;
}

/* Navigation items within sidebar groups */
[data-theme="dark"] #sidebar-group a,
.dark #sidebar-group a,
[data-theme="dark"] #sidebar-group div,
.dark #sidebar-group div {
  color: #d1d5db !important;
}

/* Navigation anchors */
[data-theme="dark"] .nav-anchor,
.dark .nav-anchor {
  color: #d1d5db !important;
} 

// Initialize Kapa widget and hide Mintlify search
(function initKapaWidget() {
  const script = document.createElement('script');
  script.async = true;
  script.src = 'https://widget.kapa.ai/kapa-widget.bundle.js';
  script.setAttribute('data-website-id', '2e65478c-ab3c-4bf2-b997-db8a398de4a5');
  script.setAttribute('data-project-name', 'Dwolla');
  script.setAttribute('data-search-mode-enabled', 'true');
  script.setAttribute('data-button-hide', 'true');
  script.setAttribute('data-modal-override-open-id', 'search-bar-entry');
  script.setAttribute('data-modal-override-open-id-ask-ai', 'search-bar-entry-mobile');
  script.setAttribute('data-modal-open-on-command-k', 'true');
  script.setAttribute('data-project-color', '#2d2d48');
  script.setAttribute('data-button-border-radius', '10px');
  script.setAttribute('data-button-image-width', '34');
  script.setAttribute('data-button-image-height', '39');
  script.setAttribute('data-button-text-font-family', 'Poppins, sans-serif');
  script.setAttribute('data-button-text-font-weight', '400');
  script.setAttribute('data-modal-image-width', '34');
  script.setAttribute('data-modal-image-height', '39');
  script.setAttribute('data-modal-title-font-family', 'Poppins, sans-serif');
  script.setAttribute('data-modal-title-font-weight', '500');
  script.setAttribute('data--font-family', 'Roboto, sans-serif');
  script.setAttribute('data-project-logo', 'https://cdn.dwolla.com/images/cms/logos/dwolla/dwolla-logo-color.png');
  script.setAttribute('data-user-analytics-fingerprint-enabled', 'true');
  script.setAttribute(
    'data-modal-disclaimer',
    `Meet Dwolla Koala, Dwolla's friendly AI assistant! While Koala studies hard to answer your questions based on the latest information, remember, machines are still learning, and Dwolla does not guarantee the responses Koala provides are accurate, up-to-date or complete. It's always a good idea to double-check answers with our docs for ultimate accuracy. To help Koala grow smarter, conversations may be logged for training purposes. Keep things professional – don't share sensitive information or PII with Koala please! If this disclaimer doesn't sit right, we recommend you don't use Koala. All conversations with Koala are subject to [Dwolla's Privacy Policy](https://www.dwolla.com/legal/privacy).`
  );

  document.head.appendChild(script);

  // Add CSS to hide Mintlify search modal
  const style = document.createElement('style');
  style.textContent = `
    /* Hide the portal root completely */
    #headlessui-portal-root {
      display: none !important;
      visibility: hidden !important;
      opacity: 0 !important;
      pointer-events: none !important;
      position: absolute !important;
      left: -9999px !important;
    }
    
    /* Hide any headlessui dialogs with search state */
    [id*="headlessui-dialog"][data-headlessui-state="open"] { 
      display: none !important;
      visibility: hidden !important;
      opacity: 0 !important;
      pointer-events: none !important;
    }
    
    /* Hide backdrop */
    .fixed.inset-0.bg-background-dark\\/20,
    .fixed.inset-0[class*="bg-background"] {
      display: none !important;
    }
    
    /* Only reset body overflow if it's been locked by a modal */
    body[style*="overflow: hidden"],
    body[style*="overflow:hidden"] {
      overflow: auto !important;
    }
  `;
  document.head.appendChild(style);
})();


Retrieve a list of beneficial owners that belong to a Customer

List beneficial owners

Request body model for a Beneficial Owner

BeneficialOwner

HalLink

InternationalAddress

clientCredentials

BeneficialOwners

Dwolla Developer Portal

The Dwolla Developer Portal provides comprehensive guides, API documentation, and resources to help you build, test, and launch powerful solutions with Dwolla’s modern account-to-account payments platform.

Dwolla Developers

Everything you need to understand, build, and launch your payment integration

Overview

Guides and Concepts

Leverage Dwolla's existing financial institution relationship to connect your business to the U.S. banking infrastructure.

What is Dwolla?

Understanding and selecting the appropriate Customer type is the first step to a successful payment integration.

Customer Types

Test and refine your integration in the Dwolla Sandbox—a free, full-featured environment that simulates real API interactions, allowing you to build, experiment, and validate your application before going live.

Testing

Testing in the Sandbox

Requests to the Dwolla API require an OAuth access token for authentication. Learn about Dwolla's supported authorization flow and how to create an access token.

Authentication

Learn the key steps involved with sending funds to your end user's bank account.

Send Money

Learn the key steps involved with receiving funds from your end user's bank account.

Receive Money from Users

Facilitate ACH transfers between two distinct parties, e.g. for marketplace applications that connect buyers with sellers for bank to bank payments.

Transfer Money Between Users

Move funds between two different bank accounts belonging to a single Verified Customer, e.g. for savings applications that move funds between a Customer's checking and savings accounts.

Transfer Money Me-to-Me

Verifying a business' identity enables increased functionality on the platform. Create a business Customer that can receive funds and send up to $10,000 per transfer (default).

Business Verified Customer

Learn how to create a Verified personal Customer that can send and receive funds.

Personal Verified Customer

Send to, receive from, or hold funds within the Dwolla network for client master accounts and Verified Customer accounts.

Balance Funding Source

Learn about the different methods of adding and verifying a bank funding source to a Customer account.

Bank Funding Source

Use a Virtual Account Number to create unique account and routing numbers for receiving external transactions into a Dwolla Balance.

Virtual Account Numbers

Learn how to verify a user's bank account ownership by initiating micro-deposits - small deposits that are sent to the account and must be verified by the user to confirm account ownership.

Verify Bank with Micro-deposits

Learn about the complete lifecycle of a transfer in Dwolla and find out what webhooks you can expect to receive during each step.

Transfer Lifecycle

Learn more about transfer clearing times, including `standard` ,`expedited` and `instant` clearing.

Transfer Processing Times

Familiarize yourself with the unhappy path of transfers and build resilient practices to mitigate ACH returns. Learn about returns, why they happen and recommended actions your application can take based on the return code.

Transfer Failures

An overview of Same Day ACH and leveraging next-available processing times for faster transfers.

Same-Day ACH

Learn about Real Time Payments, and how to identify and send transfers to RTP-enabled funding-sources.

Real-time Payments

Charge users a flat rate amount to be removed from a payment as a fee. The fee is sent to the creator of the application.

Facilitator Fee

Real-time event notifications. Determine why a webhook subscription is vital to the experience of your application.

Webhook Events

Understand what Dwolla events are tied to notifications that are sent to your end users. Preview the customizable email templates here.

Operational Notifications

Implement simple, real-time, event notifications regarding account and transaction status, and more.

Working with Webhooks

Comprehensive, structured, and up-to-date documentation for all Dwolla API endpoints, parameters, request/response schemas, and usage examples. 

The entry point that clients can use to discover and explore the entire API.

root

Choose from a collection of client libraries and tools to get up and running quickly in a variety of languages.

SDKS & Tools

Use Dwolla’s SDK for Node to build applications that interact with the Dwolla API to perform account-to-account payment functions.

Node

Use Dwolla’s SDK for PHP to build applications that interact with the Dwolla API to perform account-to-account payment functions.

`Dwolla.Client` is available on [Nuget](https://www.nuget.org/packages/Dwolla.Client/) with [source code](https://github.com/Dwolla/dwolla-v2-csharp) available on our GitHub page.

Use Dwolla’s SDK for Python to build applications that interact with the Dwolla API to perform account-to-account payment functions.

Python

Use Dwolla’s SDK for Ruby to build applications that interact with the Dwolla API to perform account-to-account payment functions.

Ruby

Use Dwolla’s SDK for Kotlin to build applications that interact with the Dwolla API to perform account-to-account payment functions.

Kotlin

Dwolla's Drop-in components are low-code solutions to alleviate the technical overhead of a payments integration to rapidly implement key functionality into an application.

Drop-in Components

Dwolla's Drop-in Components are low-code solutions to abstract away the complexity of integrating with a payment API and act as a shortcut to completing a payment integration.

Building with Drop-in Components

Creates a client token with certain actions for Dwolla Drop-in components. The client token API request requires an `action` as well as a `link` which points to the Customer that identifies the end user performing the action within the drop-in component. The `action` is a string that contains a granular permission for the Customer performing the action within a drop-in component.


Create a client token

Keep up to date on new product features and enhancements, API docs, tools changes, and development updates.

Introduction

Resources

List beneficial owners

Authorizations

Headers

Path Parameters

Response