Projects
A project is one integration: URLs plus a secret.
Fields
- name — Display name in the dashboard and on Perper Pay.
- resultUrl — Browser redirect after the payer finishes (success or failure handling is your responsibility on that URL).
- apiUrl — Public HTTPS server endpoint that receives payment result callbacks from Perper (localhost and private networks are rejected).
- id — Project identifier used in pay links as project=…
Create
Use Create project in the dashboard. Conceptually the portal sends: Create:
json
{
"name": "My storefront",
"resultUrl": "https://yoursite.com/checkout/return",
"apiUrl": "https://yoursite.com/api/perper/callback"
}Maximum 5 projects per account. Hitting the limit returns too_many — see Errors. Errors.
Secret lifecycle
- Create the project.
- Open the project and choose Reveal secret (or Rotate live secret).
- Re-authenticate when prompted (same step-up key cookie as Reveal).
- Copy the secret once into your vault. After rotate, the previous secret stops working immediately.
The UI never persists the secret after you leave the page. Reveal recovers the current Contabo secret; Rotate issues a new one (POST /sdk/project/rotateSecret). Edit name / resultUrl / apiUrl from project detail (POST /sdk/project/update) — public https only.
Dashboard
- Projects list
- Project detail — editable configuration, live secret reveal/rotate, sk_test_, sample pay URL, QR, checkStatus
Backend routes used: POST /sdk/project/add, /update, /list, /get, /seeSecret, /rotateSecret, /qr, /sdk/transaction/checkStatus (portal tools after login). Also API-only: /sdk/ai/prompt. sk_test_ rotate stays BFF-only.