Quickstart

Kreirajte projekat, otkrijte secret i otvorite pay link — obično za manje od deset minuta.

1. Prijava

Otvorite login na dashboardu. Koristite Perper nalog. Ako ga nemate, kreirajte ga u Perper aplikaciji. Neki nalozi traže 4-cifreni PIN nakon lozinke. /login · Perper app.

2. Kreirajte projekat

Idite na Kreiraj projekat i unesite: Create:

Naziv projekta — oznaka za vas i pay ekran
Redirect URL — URL povratka u browseru nakon plaćanja
API endpoint — javni HTTPS callback na vašem serveru (bez localhost / privatnih IP)

3. Otkrijte secret

Na stranici projekta izaberite Otkrij secret. Ponovo se autentifikujete; odmah kopirajte secret u vault. Autentifikacija.

4. Otvorite pay link

Pošaljite platioca na hostovanu pay stranicu. Zamijenite placeholdere project id-jem i referencom narudžbe:

url

https://sdk.perper.net/pay?amount=10&project=PROJECT_ID&data=order-123&customId=order-123

Plaćanja

5. Obrada rezultata

Implementirajte apiUrl na backendu da verifikujete potpisani hash i isporučite narudžbu. Secret držite samo na serveru — nikad u klijentskom bundle-u. Pun recept je na stranici Webhook-ovi. Webhook-ovi.

javascript

// Example: build a pay URL in your backend
const payUrl = new URL("https://sdk.perper.net/pay");
payUrl.searchParams.set("amount", "10");
payUrl.searchParams.set("project", process.env.PERPER_PROJECT_ID);
payUrl.searchParams.set("data", orderId);
// Redirect the customer to payUrl.toString()