Receipts

Upon placing an order via the ordering endpoint or the finalize endpoint, an order receipt is emailed to the email passed to the user_email. This email can be disabled by passing disable_email=true. An email that you provide to MealMe will also be BCC'd on the email. Below we'll discuss how to customize these emails.

Custom Item Price Markups

To have marked prices reflect in the receipt, when making creating an order via the ordering endpoint, the item's marked price should be passed via the product_marked_price parameter, the item customization's marked price should be passed via the marked_price parameter, and prices_marked=true should be passed.

curl --request POST \
     --url https://api.mealme.ai/order/order/v2 \
     --header 'Id-Token: <API KEY>' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
     "place_order": true,
     "items": [
          {
               "product_id": "gAAAAABjG7vcneDPtykGbsBcLjJUqW8qqJFctTqQDovWuSkEd9VlTM0dNVVKPLcDAMHXhna_dsa-RJOrXBO82jvvMCDXHYCz3Qwv9qEznaqGB2OXKA-k9cWAQFv1S7epy-C5yCDj7MLlDLl1psRTBRtUcv2PUnaYMMnMvonWGbzQbkGr0_0yjtFNS38EosYy-0-l3_0wLfSzQjSPVQ2Go9FUL4Dw_lvLYMkPHnGnewXnh0HtztKYrMn4lZQppC505ReRYfWxMQkMnqq10EbYMYRGDlEkYCNQX8TFtrNeq3ikYpmctjinfqdhs1-AjapHL6wpkyoRoY6rnKE7dBQjIkn_nIQ1aXmznzKpR5P0Xr9xvp5w2IkCWK8_MhHEenGct1y7n3yGteXzQM4o5Md1yynTwRal7Bq4QoVt-EzyLoW-ZtX8-snYWnDpNLduZLW7j3XCo8EIEBlKUSWkvNl0gbQgyosKgZB573GNQ-rEu3RYvJ_S_Ri62ywBYf_zTexUJtERtIpd6lawr6sty3Wpyq1zhve2zuhsRJ8wj_uorThApJreOXRiOpzyFXTZWxjXz3EklKoqPjUCVllMjVkVQUYkUghVvfr9dO7GWhkqGsRkRHjGxX7coYlI3GaVEQdaIcVrAo2zJBOJt42j5xwgOz0Gw2oupiwQwYtWpUVnYX0JHssDlbmbDON8ddU7YJdGxhC3TOFAGXLIzCPbRifamoEu2np7wbNQ8pDB5tX07lwVQIbrVs0thXYpdGxKk1eKx_c1aKQcf-srjZKHVUvO_4zSRC2FqIpdaYPU0pDDlIovXu6NgoB7CL0=",
               "selected_options": [
                    {
                         "option_id": "gAAAAABjMpgZm5L8nYHt5nJxpKa6aF-rKMV6xRmNSsYbs64zy92KBMt-Dqxxz1lQb_R0VqNVvOlrLYzaHUVtO8mn4G5zOOSgD3cVlhpzRPssnSQF-P-aW552UGwtDfPDD-3gVRit6_57bgJthqEjKp1b-iWca7AMrGviiOtJmpj00EriKVQjdpQucDiDYxqVEkMibMJFp79p0HxoXGxBmP5l027LYU-Vhe7QNtZL1P4fOSLdEpy2ni2i8ieliaO-M4bUrGrDQ7u3EIrvR4rYRm_SBPgErD0ObWwVp17tfHCXXOUi9yYlif5AzHCxXYfcEYGpPUsgjlWfcQffKX0vcO7Js5W_FzqoLxmIEigm_790hSJuj5hsUKw9SvQJxW7YWucrujq1xJIC_2HhE2pthonbZhH0TQysB8W9Yh4Ox7f_uLIHAM4AY7fiSVWTeZThnD8KCRLfC3_lUi8-c3fc3F075gpGkygYN2EazQpJnoHkrB7T1lZePudFacU7W3wKIejvl5IZOs2QGUmqEyIsAAvIMiRpech4hQR8FCNBp51aYRD8u4RKKeBzf244dOw92ncOqwJ7V6GJha5BZgv48zVQZtBGO_vuJx8-uEtPGgWp3Ahha1MLfUQydmm5DtbU9AbjzFDMcOXL",
                         "quantity": 1,
                         "marked_price": 100
                    }
               ],
               "notes": "No whipped cream.",
               "product_marked_price": 100
          }
     ],
     "pickup": false,
     "driver_tip_cents": 100,
     "user_latitude": 37.7786357,
     "user_longitude": -122.3918135,
     "user_street_num": "188",
     "user_street_name": "King Street",
     "user_city": "San Francisco",
     "user_state": "CA",
     "user_country": "US",
     "user_zipcode": "94107",
     "user_dropoff_notes": "Leave in lobby",
     "user_name": "Steve Jobs",
     "user_email": "[email protected]",
     "user_phone": 14044442058,
     "user_id": "7B36A9CF",
     "include_final_quote": true,
     "disable_sms": false,
     "email_receipt_specifications": {
          "prices_marked": true,
          "added_fee": {
               "added_fee_flat": 100,
               "added_fee_percent": 0
          },
          "unify_service_fee": false,
          "disable_email": false
     }
}
'

In the request above we pass marked price of $1.00 for the item and a marked price of $1.00 for the customization option. Below you'll see the resulting email.

Additional Fee

An additional fee can be added by passing the added_fee_flat and added_fee_percent parameters to the ordering endpoint. In the image above, we can see that added_fee_flat=100 was passed, resulting in the last line item in the email. To combine this additional fee with the service fee, you can pass unify_service_fee=true. This results in the following email:

White-labelling Email

To white-label the email receipt, please provide MealMe with a logo and a display name. To white-label the sender email, CNAME records will need to be added to your DNS. Please request further instructions from MealMe.

Physical Receipt

Here's an example of what the physical receipt may look like when the order is delivered or picked up.