Cash on Delivery Orders

🚧

Cash on Delivery orders is available in eligible markets only. As of today this includes: the United Arab Emirates, Kuwait and Italy.

Customers can pay for their orders in selected markets using cash upon delivery. These orders follow a slightly different process than regular orders (i.e. paid via card).

Specifics of Cash on Delivery Orders

The Deliveroo rider arrives at the partner location and pays the amount specified in the order.total_price.fractional field. The cash_due field also indicates this amount.

"order": {
  "total_price": {
    "fractional": 1000,
    "currency_code": "EUR"
  },
  "cash_due": {
    "fractional": 1000,
    "currency_code": "EUR"
  }
}

The customer will pay for their order upon delivery to the Deliveroo rider. No cash is given directly from the customer to the restaurant (except for pick-up and table service orders).

Example Webhook Payloads

{
  "event": "order.new",
  "body": {
    "order": {
      "id": "gb:32498deb-d730-4dfb-b034-38f2d24f5bfd",
      "order_number": "28401753",
      "location_id": "348502bd-708f-4977-a02c-600c5419e2b7",
      "display_id": "1753",
      "status": "placed",
      "status_log": [
        {
          "at": "2022-03-07T16:12:12Z",
          "status": "pending"
        },
        {
          "at": "2022-03-07T16:12:13Z",
          "status": "placed"
        }
      ],
      "fulfillment_type": "deliveroo",
      "order_notes": "No pickles please.",
      "cutlery_notes": "NO CUTLERY",
      "asap": true,
      "prepare_for": "2022-03-07T16:36:15Z",
      "total_price": {
        "fractional": 1770,
        "currency_code": "GBP"
      },
      "partner_order_total": {
        "fractional": 1770,
        "currency_code": "GBP"
      },
      "offer_discount": {
        "fractional": 630,
        "currency_code": "GBP"
      },
      "cash_due": {
        "fractional": 1770,
        "currency_code": "GBP"
      },
      "bag_fee": {
        "fractional": 10,
        "currency_code": "GBP"
      },
      "items": [
        {
          "pos_item_id": "4534.0",
          "quantity": 2,
          "name": "The Chicken Burger",
          "operational_name": "The Chicken Burger (Wraps and Burgers)",
          "unit_price": {
            "fractional": 630,
            "currency_code": "GBP"
          },
          "menu_unit_price": {
            "fractional": 630,
            "currency_code": "GBP"
          },
          "total_price": {
            "fractional": 885,
            "currency_code": "GBP"
          },
          "discount_amount": {
            "fractional": 630,
            "currency_code": "GBP"
          },
          "modifiers": [
            {
              "pos_item_id": "99.0",
              "quantity": 1,
              "name": "Fries",
              "operational_name": "Fries - Salted",
              "unit_price": {
                "fractional": 255,
                "currency_code": "GBP"
              },
              "total_price": {
                "fractional": 255,
                "currency_code": "GBP"
              },
              "discount_amount": {
                "fractional": 0,
                "currency_code": "GBP"
              }
            }
          ]
        }
      ],
      "start_preparing_at": "2022-03-07T16:16:15Z",
      "promotions": [
        {
          "id": "fb9fa099-15c3-4995-a2a6-c81c7f666a52",
          "type": "percentage_off_on_items",
          "value": 50,
          "pos_item_ids": [
            {
              "id": "4534.0"
            }
          ]
        }
      ],
      "is_tabletless": false
    }
  }
}
{
  "event": "new_order",
  "location_id": "05VIN",
  "restaurant_acknowledged_at": "2018-12-04T11:39:41Z",
  "order": {
    "id": "gb:df8849ae-5261-446d-9481-beb53a5cac35",
    "display_id": "2206",
    "order_number": "128102206",
    "total_price": {
      "fractional": 1375,
      "currency_code": "EUR"
    },
    "partner_order_total": {
      "fractional": 1375,
      "currency_code": "EUR"
    },
    "items": [
      {
        "pos_item_id": "1666",
        "unit_price": {
          "fractional": 595,
          "currency_code": "EUR"
        },
        "menu_unit_price": {
          "fractional": 595,
          "currency_code": "EUR"
        },
        "quantity": 1,
        "modifiers": [
          {
            "pos_item_id": "11010049",
            "unit_price": {
              "fractional": 95,
              "currency_code": "EUR"
            },
            "quantity": 1,
            "modifiers": [],
            "discount_amount": {
              "fractional": 0,
              "currency_code": "EUR"
            }
          },
          {
            "pos_item_id": "109841",
            "unit_price": {
              "fractional": 0,
              "currency_code": "EUR"
            },
            "quantity": 1,
            "modifiers": [],
            "discount_amount": {
              "fractional": 0,
              "currency_code": "EUR"
            }
          }
        ],
        "discount_amount": {
          "fractional": 119,
          "currency_code": "EUR"
        }
      },
      {
        "pos_item_id": "11118914",
        "unit_price": {
          "fractional": 320,
          "currency_code": "EUR"
        },
        "menu_unit_price": {
          "fractional": 320,
          "currency_code": "EUR"
        },
        "quantity": 1,
        "modifiers": [],
        "discount_amount": {
          "fractional": 0,
          "currency_code": "EUR"
        }
      },
      {
        "pos_item_id": "11123102",
        "unit_price": {
          "fractional": 365,
          "currency_code": "EUR"
        },
        "menu_unit_price": {
          "fractional": 365,
          "currency_code": "EUR"
        },
        "quantity": 1,
        "modifiers": [],
        "discount_amount": {
          "fractional": 0,
          "currency_code": "EUR"
        }
      }
    ],
    "asap": true,
    "notes": "PAS DE COUVERTS",
    "fulfillment_type": "deliveroo",
    "cash_due": {
      "fractional": 1375,
      "currency_code": "EUR"
    },
    "bag_fee": {
      "fractional": 0,
      "currency_code": "EUR"
    },
    "offer_discount": {
      "amount": {
        "fractional": 0,
        "currency_code": "EUR"
      }
    },
    "pickup_at": "2018-12-04T11:51:22Z",
    "promotions": [
      {
        "id": "305ddb7a-e25e-4a6f-944e-68471a754c9e",
        "type": "percentage_off_on_item",
        "value": 20,
        "pos_item_ids": [
          {
            "id": "1666"
          }
        ]
      }
    ]
  }
}

What’s Next