Context

This is a proposal from Google based on our experience consuming schema.org markup and working with similar data from online merchants. If it were accepted, it would make it easier for us and others to understand URLs used by online merchants to send consumers to checkout pages for products sold online.

Proposal

Schema.org currently provides a /urlTemplate property with values of type /Text, used to specify a templated URL following RFC6570. In the world of eCommerce, such templated URLs are important in the case of checkout URLs, where a consumer clicks on a product for a one-click purchase, sending the user directly to a checkout page, passing in parameters such as for example a logged-in consumer id, product identifier, quantity, discount code, and more.

We therefore propose to add a new /checkoutUrl property for use on the /Offer type to allow merchants to specify a checkout page URL to allow online checkout of the offered product. The property would be a templated URL to allow passing-in of aforementioned parameters to the checkout page. We can decide to allow values of type /Text for /checkoutUrl or we could introduce new types, for example, /UrlTemplate as a subtype of /Text or URL.