Projekti
Projekat je jedna integracija: URL-ovi plus secret.
Polja
- name — Naziv u dashboardu i na Perper Pay.
- resultUrl — Browser redirect nakon završetka plaćanja (uspjeh/greška obrađujete vi na tom URL-u).
- apiUrl — Javni HTTPS endpoint koji prima payment callback od Perpera (localhost i privatne mreže se odbijaju).
- id — Identifikator projekta u pay linku kao project=…
Kreiranje
Koristite Kreiraj projekat u dashboardu. Portal šalje: Create:
json
{
"name": "My storefront",
"resultUrl": "https://yoursite.com/checkout/return",
"apiUrl": "https://yoursite.com/api/perper/callback"
}Maksimalno 5 projekata po nalogu. Prekoračenje vraća too_many — vidi Greške. Greške.
Lifecycle secret-a
- Kreirajte projekat.
- Otvorite projekat i izaberite Otkrij secret (ili Rotiraj live secret).
- Ponovo se autentifikujte kad se zatraži (isti step-up key cookie kao Otkrij).
- Jednom kopirajte secret u vault. Nakon rotacije prethodni secret odmah prestaje da radi.
UI ne čuva secret nakon što napustite stranicu. Otkrij vraća trenutni Contabo secret; Rotiraj izdaje novi (POST /sdk/project/rotateSecret). Naziv / resultUrl / apiUrl uređujte sa detalja projekta (POST /sdk/project/update) — samo javni https.
Dashboard
- Lista projekata
- Detalj projekta — editable konfiguracija, live secret otkrivanje/rotacija, sk_test_, sample pay URL, QR, checkStatus
Backend rute: POST /sdk/project/add, /update, /list, /get, /seeSecret, /rotateSecret, /qr, /sdk/transaction/checkStatus (portal alati nakon prijave). Samo API: /sdk/ai/prompt. sk_test_ rotate ostaje samo BFF.