// Integration / Developer Hub

Razvijte jednom. Dosegnite svakog trgovca.

Most od clouda do uređaja s predvidljivim REST endpointima, webhookovima i sandboxom. Isporučite svoju integraciju a da ne dirnete nijedan terminal.

create-merchant.sh
# Registracija trgovca u Vaš portfelj
curl -X POST https://api.veslo.io/v1/merchants \
  -H "Authorization: Bearer $VESLO_KEY" \
  -d '{
    "legal_id": "SK2020123456",
    "brand":    "your-iso",
    "package":  "gastro",
    "device":   "pax-a920pro"
  }'

# → 201 Created
{
  "merchant_id": "mch_9f2a…",
  "status": "onboarding",
  "fiscalization": "ekasa_pending"
}
// Brzi početak

U produkciji u tri API poziva.

Autentificirajte se, kreirajte trgovca i počnite primati događaje. Isti API u sandboxu i u produkciji.

KORAK 01

Nabavite ključ

Kreirajte API ključ s ograničenim opsegom u Integration Hubu — sandbox ili live.

export VESLO_KEY="sk_live_…"
KORAK 02

Kreirajte trgovca

Pošaljite POST s trgovcem i njegovim pravnim identifikatorom; Veslo rješava KYC i provisioning.

POST /v1/merchants
KORAK 03

Slušajte webhookove

Pretplatite se na događaje životnog ciklusa — onboarding, namira, stanje uređaja.

POST /v1/webhooks
// Sve što trebate

Jedan hub za cijelu integraciju.

API

REST API

Verzionirani, predvidljivi endpointi za trgovce, uređaje, transakcije i isplate.

Webhookovi

Događaji u stvarnom vremenu s potpisanim payloadima i automatskim ponovnim slanjem.

OAuth & SSO

Tokeni s ograničenim opsegom, kontrola pristupa na razini partnera i single sign-on.

Sandbox

Potpuno testno okruženje s mock uređajima i simulacijom fiskalizacije.

Logovi & revizija

Svaki zahtjev i transakcija, pretraživi i izvozivi.

{ }

SDK-ovi

Tipizirane klijentske biblioteke da pišete manje boilerplate koda.

// API referenca

Čist API temeljen na resursima.

Modelirajte cijeli životni ciklus trgovca uz šačicu predvidljivih resursa. Potpuna referenca i sheme na api.veslo.io.

Otvorite API referencu
POST/v1/merchants
GET/v1/merchants/{id}
GET/v1/devices
POST/v1/devices/{id}/config
GET/v1/transactions
GET/v1/payouts
POST/v1/webhooks
// Webhookovi

Reagirajte na sve, u stvarnom vremenu.

Potpisani događaji s ponovnim slanjem za svaku bitnu promjenu u životnom ciklusu trgovca — bez pollinga.

  • merchant.onboarded
  • transaction.settled
  • device.health.changed
  • payout.created
merchant.onboarded
{
  "type": "merchant.onboarded",
  "created": "2026-07-27T09:14:22Z",
  "data": {
    "merchant_id": "mch_9f2a…",
    "brand": "your-iso",
    "device": "pax-a920pro",
    "fiscalization": "ekasa_active"
  }
}
// SDK-ovi

Koristite svoj jezik.

Tipizirane klijentske biblioteke i dokumentirana OpenAPI specifikacija iz koje možete generirati kod.

Node.jsPythonPHPGoJavacURLOpenAPI spec
// Logovi & revizija

Potpuna vidljivost, svaki zahtjev.

Pregledajte API pozive, isporuke webhookova i transakcijske događaje. Izvezite potpuni revizijski trag za usklađenost.

Pogledajte zapisnik promjena
api.veslo.io/audit-logs
API zapisnik promjena
// Počnite graditi

Preuzmite svoje sandbox ključeve.

Pokrenite sandbox u nekoliko minuta i napravite prvi poziv — za istraživanje nije potreban ugovor.