Direct Deposit - MX Documentation

Enable users to set up or switch their direct deposits, increasing direct deposits to your institution. Percentage allocation is available as a toggled feature if your payment provider supports it. This can be turned on for your users through the direct deposit provider. You can access the direct deposit integration in one of three ways: Financial Insights, Mobile, or the Actionable Integration Widget.

Financial Insights

Through Financial Insights, users may see one of two insights prompting them to take action:

Set Up Direct Deposit: Shown to users without an active direct deposit.
Switch Direct Deposit: Encourages users to switch an existing direct deposit to their account.

INFOThe account_number and routing_number are required for this use case. Provide them using the MDX Real Time API using the Create or Update Account Number endpoint or the MDX On Demand v5 API.

Mobile

If you’re using our mobile app, users have access to several entry points encouraging direct deposit setup or switching. Here is an example user flow:

The following diagram outlines the entire UX flow, including the steps taken at the third-party site, and showcases different configuration options:

The Actionable Integration Widget is a standalone widget designed to unlock functionality without requiring you to have another product. You can call directly to our SDK integrations and display them wherever you need to. Recommended Dimensions: set to 100% of the available container. Supported Languages: English, Spanish, and French. To integrate, request a Widget URL (Platform API or SSO API) and:

Set the widget_type to actionable_integration_widget
Include "deep_link_params": { "launch_integration": "direct-deposit" }.

Platform API Example

curl -i -X POST https://int-api.mx.com/users/{USR-guid}/widget_urls \
    -H 'Accept: application/vnd.mx.api.v1+json' \
    -u 'client_id:api_key' \
    -H 'Content-type: application/json' \
    -d '{
        "widget_url": {
            "widget_type": "actionable_integration_widget",
            "deep_link_params": {
                "launch_integration": "direct-deposit"
                }
            }
        }'

​Financial Insights

​Mobile

​Actionable Integration Widget

​Platform API Example

Financial Insights

Mobile

Actionable Integration Widget

Platform API Example