POS API
For full OpenAPI reference and live testing, see https://api.blikk.tech/pos/docs.
Service Purpose
This API powers Blikk's Point-of-sale systems integrations with various POS system providers. Provides endpoints for creating payments with items, cancelling payments, and creating refunds.
Contact
For implementation help or questions, contact hello@blikk.tech
Endpoints
Production environment
URL: https://api.blikk.tech/pos
Staging environment
URL: https://stage.blikk.tech/pos
API-Key: Please contact Blikk for the API key
Pos-Id: any value will work for our staging environment
You can pick whatever Pos-Id you want when creating a new payment on our staging environment. The payment that you create will then be available either via the QR-code you receive in response to the creation POST request or via the following URL https://stage.app.blikk.tech/payment?type=pos&id=<Pos-Id>.
On our production environment the Pos-Id is equally important as your API key. It is used to identify the terminal that is making the request and must be a valid value.
Status Lifecycle
| Status | Recommended Translation |
|---|---|
| DRAFT | Skannaðu Blikk QR kóðann til að ganga frá greiðslu |
| PENDING | Beðið eftir heimild… |
| SCA_REQUIRED | Beðið eftir heimild… |
| SCA_COMPLETE | Beðið eftir heimild… |
| SUCCESS | Greiðsla tókst |
| ERROR | Villa við greiðslu |
| REJECTED | Villa við greiðslu |
| CANCELLED | Hætt var við greiðslu |
Payment Item Model
| Field | Description |
|---|---|
id | string Unique id for this item |
name | string The name of the product being sold |
quantity | int How many products of this item is being sold |
unitPrice | string The unit price of item |
vat | string The percentage of the VAT on this product (e.g. 24) |
sku | string The product's SKU. |
upc | string The product's UPC. |
description | string All additional details on product |
Security Notes
Keep credentials server-side only. Do not embed API keys in frontend code, mobile binaries, logs, screenshots, or support tickets.