Preskoči na sadržaj

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

  1. Kreirajte projekat.
  2. Otvorite projekat i izaberite Otkrij secret (ili Rotiraj live secret).
  3. Ponovo se autentifikujte kad se zatraži (isti step-up key cookie kao Otkrij).
  4. 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.