Register sales from your till

For shops whose point-of-sale, website or automation tool can send a web request. One request per e-bike sold — the same details as the counter form. Your customer gets the same claim email.

1. Get a key

Signed（as your shop, open） Shop growth → Connect your till and create a key. It starts ebm_shop_. Send it with every request:

Authorization: Bearer ebm_shop_…

2. Register a sale

POST https://www.ebikemate.com.au/api/v1/shop/sales
Content-Type: application/json

{
  "serial": "WTU123456C",
  "make": "Trek",
  "model": "Allant+ 7",
  "customerEmail": "sam@example.com",
  "customerName": "Sam",
  "saleRef": "INV-1042",
  "saleDate": "2026-10-10",
  "modelYear": 2025,
  "colour": "Black",
  "batterySerial": "BAT998877",
  "labelCode": "EL-ABCD-2345",
  "serviceAfterDays": 42
}

Required: serial, make, model, customerEmail. Everything else is optional. serviceAfterDays is the first service you offer (7–400 days); the customer chooses whether to be reminded.

Up to 50 at once: send {"sales": [ … ]}. Each comes back with its own result.

3. What comes back

201 { "emid": "AU-XXXX-XXXX", "emailed": true, "label": "EL-ABCD-2345" }

409 ——the serial is already registered，or it’s reported stolen. For a stolen bike, don’t complete the sale if it’s safe not to, and call the Police Assistance Line on 131 444. Our team is told automatically.
422 ——something to fix (the message says what，and fields says where).
401 / 403 ——the key is wrong or turned off，or the shop account is no longer able to register bikes.
429 — more than 120 requests a minute.

4. Check your recent registrations

GET https://www.ebikemate.com.au/api/v1/shop/sales?limit=50

Returns each bike’s EMID, make, model, date, and whether the customer has claimed it. No customer details beyond what you sent.

Shopify

No code needed: connect Shopify with an order webhook and add the frame serial as a line-item property called 序列号.

Questions? 联系我们. EbikeMate is an independent Australian registry; it is not a government register.