{ "status": "ok" }

POS Webhook

Base path: /api/v1/pos/webhooks

Overview

Webhook receiver for POS providers such as Poster. The endpoint verifies signatures and deduplicates events before dispatching downstream sync jobs.

Duplicate events are accepted and acknowledged with 200 to keep upstream retries safe.

POST `/api/v1/pos/webhooks/poster`

Process a webhook from Poster.

cURL
JavaScript
Python

curl --request POST \
  --url https://api.foodsave.kz/api/v1/pos/webhooks/poster \
  -H 'Content-Type: application/json' \
  -H 'X-Poster-Signature: sha256=abcd1234' \
  -d '{"event":"order_created","externalId":"ext-1","data":{}}'

const response = await fetch('https://api.foodsave.kz/api/v1/pos/webhooks/poster', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-Poster-Signature': 'sha256=abcd1234'
  },
  body: JSON.stringify({ event: 'order_created', externalId: 'ext-1', data: {} })
})

console.log(response.status)

import requests

response = requests.post(
    'https://api.foodsave.kz/api/v1/pos/webhooks/poster',
    headers={'X-Poster-Signature': 'sha256=abcd1234'},
    json={'event': 'order_created', 'externalId': 'ext-1', 'data': {}}
)

print(response.status_code)

{ "status": "ok" }

Errors

Code	Meaning	How to fix
400	BAD_PAYLOAD	Verify JSON structure
401	INVALID_SIGNATURE	Validate HMAC secret used by POS

POS Credentials Device API

⌘I

Getting Started

API Reference

Guides

Reference

POS Webhook

POS Webhook

Overview

POST `/api/v1/pos/webhooks/poster`

Errors

Getting Started

API Reference

Guides

Reference

Documentation Index

​POS Webhook

​Overview

​POST /api/v1/pos/webhooks/poster

​Errors

POS Webhook

Overview

POST `/api/v1/pos/webhooks/poster`

Errors