Skip to main content

Self-Serve Provider Settings Guide

Enable and Manage Integration Features Directly in the Developer Portal​

Overview​

The Developer Portal now supports self-serve configuration for select integration features. Rather than submitting a support request, you can enable or disable the following settings directly within your portal account:

  • Should Send Merchant Tips for POS Orders
  • Plasticware Option
  • Plasticware Menu Option for POS
  • Store Enabled for Getting Fees
  • Should Set Masked Consumer Phone Number

These settings are available at the Provider or Store level and take effect without requiring engineering approval.

Before You Begin​

Confirm you have the following before making changes:

  • An active Developer Portal account with appropriate permissions
  • Your Sandbox Provider Type or Production Provider Type identifier (e.g., my_provider_prod)
  • The Store ID (if updating at those levels)

Access Provider Settings​

  1. Log in to the Developer Portal.
  2. In the left navigation, select Settings.
  3. Under Settings, select Marketplace Integration.
  4. Click the Provider Settings tab.

You will see a list of configurable settings along with their current values and inheritance status.

How to Update a Setting​

Settings can be updated at two levels: Provider, or Store. Use the dropdowns at the top of the Provider Settings page to scope your change.

Provider-Level Update​

  1. In the Providers dropdown, select the provider_type you want to update.

    Recommended: Enable settings on your Sandbox provider first to validate behavior before enabling in production.

  2. Scroll to the setting you want to change.

  3. Click Edit.

  4. In the configuration panel, select Enabled or Disabled.

  5. Click Confirm.

Store-Level Update​

  1. Ensure the Providers dropdown has your desired provider_type selected.
  2. In the Store dropdown, select the target store_id. Search by store id or location id.
  3. Scroll to the setting you want to change.
  4. Click Edit, select the desired value, and click Confirm.

Settings Reference​

The following settings are available for self-serve configuration in the Provider Settings tab.

Should Send Merchant Tips for POS Orders​

Enables DoorDash to include customer tip amounts in the POS order payload sent to your system.

When to enable: Your POS system supports ingesting Merchant tip data and you want to display or process tip amounts at the point of sale.

Plasticware Option​

Global setting that controls whether plasticware preference is included in the order payload.

When to enable: Your integration supports receiving and acting on customer plasticware preferences (e.g., "no utensils").

Plasticware Menu Option for POS​

Enables plasticware as a menu-level option surfaced to customers at the POS level, rather than just in the order payload.

When to enable: You want to surface the plasticware option as a menu modifier so customers can opt in or out at the item level.

Store Enabled for Getting Fees​

Enables a store to participate in the bag fee integration, allowing DoorDash to retrieve applicable fees for a given store. Please note this is not relevant for ANZ operations.

When to enable: Your merchant locations are subject to bag fees (e.g., regional plastic bag regulations) and your POS or integration handles fee computation.

Should Set Masked Consumer Phone Number​

Allows merchants to call customers directly through a masked phone number included in the order payload, protecting consumer privacy.

When to enable: Your POS or order management system surfaces customer contact information to staff and you want to enable masked calling for order coordination.

Settings Inheritance​

Settings follow a hierarchy: Provider → Store.

  • A value explicitly set at the Store level overrides the inherited Provider value.
  • The "Inherited" label in the UI indicates the value is flowing down from a higher level and has not been explicitly set at the current scope.

To override an inherited value, select the target Store from the dropdowns, click Edit on the relevant setting, and set the desired value.

FAQ​

Q: Do changes take effect immediately?
A: Yes. Updates made in the Provider Settings tab are applied in real time — no deployment or engineering approval is required.

Q: Can I revert a change after confirming it?
A: Yes. Return to the same setting, click Edit, and select the previous value.

Q: Can I test on Sandbox before enabling production?
A: Yes, and it is strongly recommended. Select your Sandbox provider_type from the Providers dropdown and validate the behavior before repeating the change on your production provider.

Q: I don't see my or Store ID in the dropdown. What should I do?
A: Make sure the Providers dropdown is set to the desired provider_type.

Q: What if I need to update a setting not listed here?
A: Some configurations are not yet available for self-serve and still require support. Submit a request through the Developer Portal Support page.

Next Steps​

  • Validate your changes using sandbox testing before enabling on production.
  • For settings not listed submit a support request.
  • Questions? Reach out to support or use the Dev Chat AI assistant in the top-right corner of the Developer Portal.