Skip to main content

Split tax breakdown

WHAT​

DoorDash has enhanced its Open API contract to allow Merchants to access item and jurisdiction level tax details within the order payload. This information will include order-level summary details and a tax breakdown at the item/option level. It will be available to any Merchant using the Open API platform.

WHY​

Currently, for Merchants in Marketplace Facilitator (MPF) states, DoorDash collects and remits all taxes to the relevant jurisdictions, even when the Merchant is responsible for remitting some local taxes. Merchants will be automatically enrolled in our Split Tax Program to receive a detailed tax breakdown where they are liable for remittance.

Merchants also want their point-of-sale (POS) system to be the single source of truth for accounting reconciliation and for correct jurisdiction-level remittance. Previously, orders were sent to the POS without item or jurisdiction-level tax details, making it difficult for US Merchants to remit the correct tax per jurisdiction.

WHEN​

In Q3 2025, Merchants on the Open API integration can request to join the pilot program for this enhancement.

In Q4 2025, this feature will be enabled by default. Merchants who are not ready to receive this information must opt-out of the program by working with their technical account manager.

HOW​

DoorDash will include additional and enhanced fields in the order payload. This information will provide merchants with the necessary details for reconciliation and correct remittance at the jurisdiction level, down to the individual item and option on each order.

New and Modified Fields​

These new fields will be present for all orders:

Field NameDescriptionLevel
subtotal_tax_passed_by_doordash_to_merchantOrder-level summary of subtotal tax passed to the Merchant for government remittance. Tax amount for each item/option that the Merchant remits.Order, Item
subtotal_for_taxAdjusted subtotal amount used to calculate tax.Item
subtotal_tax_remitted_by_doordash_to_tax_authoritiesTax amount for each item/option that DoorDash remits.Item

These fields will be present for orders where DoorDash has tax system details available from our Vertex tax engine:

Field NameDescriptionLevel
destination_tax_area_idVertex tax area ID for the customer’s delivery address.Order
physical_origin_tax_area_idVertex tax area ID for the store's physical location.Order
tax_breakdown_detailsTax breakdown by imposition/jurisdiction. Includes amounts due by taxpayer. For self-delivery, includes fee tax details.Order, Item

tax_breakdown_details contains the following:

  • jurisdiction_level
  • jurisdiction_name
  • imposition_type
  • imposition
  • taxpayer
  • taxable_basis
  • nontaxable_basis
  • tax_amount
  • tax_rate

Modified Fields:

Field NameDescription
is_tax_remitted_by_doordashThis field will be updated to mean "DoorDash remitted some amount of subtotal tax" instead of "ALL subtotal tax".

FAQ​

1. Why are the tax area IDs missing from my response? In rare cases (less than 0.5% of transactions), if the system fails to retrieve details from our third-party tax provider, the tax area ID fields cannot be populated.

2. Is there any situation where we would be missing the tax breakdown details? No, a tax breakdown should always exist at the item and order level. In rare instances (less than 0.5% of orders), all tax may be populated at the state jurisdiction level if the primary tax system cannot provide more granular details.

Example Order​

Below are highlighted portions of an order message showing the new tax breakdown details.

{
"id": "ff7b377b-0530-4676-ac2c-e6830b4619eb",
"store_order_cart_id": "3000008638863680",
"tax": 323,
"subtotal": 4608,
"estimated_pickup_time": "2025-07-25T21:44:26+00:00",
"is_pickup": false,
"order_special_instructions": "",
"delivery_address": {},
"consumer": {
"id": 513127262,
"first_name": "Thomas",
"last_name": "F",
"email": "[email protected]",
"phone": "8552228111"
},
"store": {
"id": "24385957",
"merchant_supplied_id": "123",
"provider_type": "paolo_test",
"timezone": "US/Eastern",
"store_business": {},
"auto_release_enabled": false
},
"categories": [
{
"merchant_supplied_id": "54543318-e7da-4eaf-a62f-84b5ed62171e",
"name": "Deals",
"items": [
{
"name": "NEW! 6 pc Crispy Tender Meal for 2",
"quantity": 1,
"price": 1729,
"merchant_supplied_id": "1009d2cd-eaba-4229-8a1a-bef0da549cc8",
"special_instructions": "",
"line_item_id": "253aa441-9f32-44a7-b16e-90ec3eb9597c",
"subtotal_for_tax": 1729,
"subtotal_tax_remitted_by_doordash_to_tax_authorities": 121,
"subtotal_tax_passed_by_doordash_to_merchant": 0,
"tax_breakdown_details": [
{
"jurisdiction_level": "STATE",
"jurisdiction_name": "FLORIDA",
"imposition_type": "General Sales and Use Tax",
"imposition": "Sales and Use Tax",
"taxpayer": "DOORDASH",
"taxable_basis": 1729,
"nontaxable_basis": 0,
"tax_amount": 104,
"tax_rate": "0.06"
},
{
"jurisdiction_level": "COUNTY",
"jurisdiction_name": "MIAMI-DADE",
"imposition_type": "General Sales and Use Tax",
"imposition": "Local Sales and Use Tax (Discretionary Sales Surtax)",
"taxpayer": "DOORDASH",
"taxable_basis": 1729,
"nontaxable_basis": 0,
"tax_amount": 17,
"tax_rate": "0.01"
}
]
},
{
"name": "Full Court Flavor Feast",
"quantity": 1,
"price": 2879,
"merchant_supplied_id": "73c57fde-9d17-46b5-9b20-54df5b49c9f8",
"special_instructions": "",
"line_item_id": "4b217003-df5b-4852-82be-880369ddc5b7",
"subtotal_for_tax": 2879,
"subtotal_tax_remitted_by_doordash_to_tax_authorities": 202,
"subtotal_tax_passed_by_doordash_to_merchant": 0,
"tax_breakdown_details": [
{
"jurisdiction_level": "STATE",
"jurisdiction_name": "FLORIDA",
"imposition_type": "General Sales and Use Tax",
"imposition": "Sales and Use Tax",
"taxpayer": "DOORDASH",
"taxable_basis": 2879,
"nontaxable_basis": 0,
"tax_amount": 173,
"tax_rate": "0.06"
},
{
"jurisdiction_level": "COUNTY",
"jurisdiction_name": "MIAMI-DADE",
"imposition_type": "General Sales and Use Tax",
"imposition": "Local Sales and Use Tax (Discretionary Sales Surtax)",
"taxpayer": "DOORDASH",
"taxable_basis": 2879,
"nontaxable_basis": 0,
"tax_amount": 29,
"tax_rate": "0.01"
}
]
}
]
}
],
"delivery_short_code": "da966bbf",
"tax_transaction_id": "",
"is_demand_gen": false,
"commission_type": "regular",
"is_tax_remitted_by_doordash": false,
"tax_amount_remitted_by_doordash": 0,
"fulfillment_type": "dx_delivery",
"merchant_tip_amount": 0,
"experience": "DOORDASH",
"destination_tax_area_id": "100250300",
"physical_origin_tax_area_id": "100250300",
"subtotal_tax_passed_by_doordash_to_merchant": 0,
"tax_breakdown_details": [
{
"jurisdiction_level": "STATE",
"jurisdiction_name": "FLORIDA",
"imposition_type": "General Sales and Use Tax",
"imposition": "Sales and Use Tax",
"taxpayer": "DOORDASH",
"taxable_basis": 4608,
"nontaxable_basis": 0,
"tax_amount": 277
},
{
"jurisdiction_level": "COUNTY",
"jurisdiction_name": "MIAMI-DADE",
"imposition_type": "General Sales and Use Tax",
"imposition": "Local Sales and Use Tax (Discretionary Sales Surtax)",
"taxpayer": "DOORDASH",
"taxable_basis": 4608,
"nontaxable_basis": 0,
"tax_amount": 46
}
],
"applied_loyalty_reward_details": {
"rewards": [],
"rewards_total": 0
}
}