gocommerce

Netlify Commerce

A small go based API for static e-commerce sites.

It handles orders and payments. Integrates with Stripe for payments and will support international pricing and VAT verification.

Netlify Commerce is released under the MIT License. Please make sure you understand its implications and guarantees.

Setting up

See the example configuration for an example of how to configure Netlify Ccommerce.

The most important setting is the site_url. Netlify Ccommerce is always tied to a website, and will use the site URL to verify product prices, offers, and settings for countries, product types and VAT rules.

Netlify Commerce will also look for email templates within a designated site folder and use the site URL to construct links to order history.

Create a config.json file based on config.example.json - You must set the site_url and the stripe_key as a minimum.

What your static site must support

Each product you want to sell from your static site must have unique URL where Netlify Commerce can find the meta data needed for calculating pricing and taxes in order to verify that the order is legitimate before using Stripe to charge the client.

The metadata can be anywhere on the page, and goes in a script tag in this format:

The minimum required is the SKU, title and at least one "price". Default currency is USD if nothing else specified.

Mail templates (Not implemented yet)

Netlify Commerce will look for mail templates inside https://yoursite.com/netlify-commerce/emails/ when sending mails to users or administrators.

Right now the mail templates are:

• Order Confirmation netlify-commerce/emails/confirmation.html

VAT, Countries and Regions

Netlify Commerce will regularly check for a file called https://yoursite.com/netlify-commerce/settings.json

This file should have settings with rules for VAT or currency regions.

This file is not required for Netlify Commerce to work, but will enable support for various advanced features. Currently it enables VAT calculations on a per country/product type basic.

The reason we make you include the file in the static site, is that you'll need to do the same VAT calculations client side during checkout to be able to show this to the user. The commerce-js client library can help you with this.

Here's an example settings file:

{
  "taxes": [{
    "percentage": 20,
    "product_types": ["ebook"],
    "countries": ["Austria", "Bulgaria", "Estonia", "France", "Gibraltar", "Slovakia", "United Kingdom"]
  }, {
    "percentage": 7,
    "product_types": ["book"],
    "countries": ["Austria", "Belgium", "Bulgaria", "Croatia", "Cyprus", "Denmark", "Estonia"]
  }]
}

Based on these rules, if an order includes a product with "type" set to "ebook" in the product metadata on the site and the users billing Address is set to "Austria", Netlify Commerce will verify that a 20 percentage tax has been included in that product.

JavaScript Client Library

The easiest way to use Netlify Commerce is with commerce-js.