API referenca

Sve javne API rute, sheme zahteva/odgovora i kodovi grešaka su definisani u OpenAPI 3.1 specifikaciji.

Preuzmi specifikaciju ili pogledaj live API dokumentaciju

Specifikacija opisuje 23 endpoint-a u 5 resursa: PaymentIntents, Customers, PaymentMethods, Refunds, Disputes. Live dokumentacija se otvara u prozoru i prati izabranu temu (svetla / tamna).

Korišćenje sa Postman-om / Insomnia-om

Klikni dugme iznad ili klikni desnim → Copy link da dobiješ URL specifikacije.
Otvori Postman ili Insomnia → File → Import → unesi URL.
Postavi Authorization header: Bearer sk_test_...
Šalji zahteve protiv sandbox-a.

Generisanje SDK-ova iz specifikacije

OpenAPI 3.1 specifikacija je izvor istine za sve buduće SDK-ove (Python, Ruby, Go, Swift). Možete generisati klijent za bilo koji jezik koristeći openapi-generator-cli:

# Replace <host> with this site's hostname (e.g. dashboard.platico.rs)
npx @openapitools/openapi-generator-cli generate \
  -i https://<host>/openapi.json \
  -g python \
  -o ./platico-python-sdk

Format autentifikacije

Svaki zahtev mora poslati API ključ kao Bearer token:

Authorization: Bearer sk_test_...   # sandbox
Authorization: Bearer sk_live_...   # produkcija

Format greške

{
  "error": {
    "type": "card_error",
    "code": "card_declined",
    "decline_code": "insufficient_funds",
    "message": "Vaša kartica ima nedovoljno sredstava.",
    "param": "payment_method"
  }
}

Idempotency-Key

Sve mutirajuće rute (POST/DELETE) prihvataju opcionalni Idempotency-Key header. Slanje istog ključa dva puta uz isti payload vraća isti odgovor — sigurno za retry nakon mrežne greške.