Quickstart
Create a project, reveal your secret, and open a pay link — typically under ten minutes.
1. Sign in
Open the dashboard login. Use your Perper account. If you do not have one, create it in the Perper app. Some accounts require a 4-digit PIN after password login. /login · Perper app.
2. Create a project
Go to Create project and set: Create:
- Project name — label for you and the pay screen
- Redirect URL — browser return URL after payment
- API endpoint — your public HTTPS server callback (no localhost / private IPs)
3. Reveal the secret
On the project page, choose Reveal secret. You will re-authenticate; copy the secret immediately into your vault. Authentication.
4. Open a pay link
Send the payer to the hosted pay page. Replace placeholders with your project id and order reference:
url
https://sdk.perper.net/pay?amount=10&project=PROJECT_ID&data=order-123&customId=order-1235. Handle the result
Implement apiUrl on your backend to verify the signed hash and fulfill the order. Keep the project secret server-side only — never embed it in client bundles. See Webhooks for the full recipe. Webhooks.
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()