Skip to content

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-123

Payments

5. 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()