A field guide to the Perpolis platform
The Perpolis dashboard is where your business raises payment orders and invoices and manages its addresses and counterparties. This guide covers the dashboard, screen by screen.
The user guide
Everything a business does day to day: from raising an invoice to keeping the address whitelist current.
Overview
The dashboard is where your business moves value: raise payment orders and invoices, and keep your address whitelist and counterparty book current. The main areas sit in the left sidebar after sign-in, and the create flows — new order, new address — open from buttons on those screens. If your workspace uses approval controls, some actions pause in Approvals for sign-off before they take effect; the sections below call this out where it applies. When the Perpolis team schedules maintenance, a banner at the top of the dashboard announces the window and a notice goes out by email; the platform may be unavailable while it runs.
- Sign in with your registered email and two-factor code
- Complete verification before raising your first order
- Use the left sidebar to move between areas at any time
Onboarding
Getting set up happens once. Create your account, confirm your email, sign in and set up two-factor authentication, then complete verification by uploading your documents. Full access opens once review is complete and approved. Passwords must be at least 12 characters. After repeated failed sign-ins you see Too many sign-in attempts and sign-in pauses for a few minutes — wait, then try again, or use Forgot your password? if you no longer know it. Depending on your business, verification can involve more than one form — each is presented in turn on the verification screen, and features unlock as the relevant review completes.
- Check spam if the confirmation email does not arrive
- Set up two-factor authentication on first sign-in
- Upload verification documents early: review takes time

Home (Dashboard)
The landing screen after sign-in: your activity at a glance. A chart of order activity over the last 7 days sits at the top, with headline figures underneath — orders volume, average order size, and successful and pending order counts — followed by monthly totals and asset-usage and status breakdowns.
- Scan the 7-day activity chart for anything unexpected
- Read the volume and order-count figures
- Jump to any area from the left sidebar

Orders
Every payment order and invoice your business has raised, newest first. Statuses run Pending, Processing, then Paid. Underfunded and Overfunded flag payments outside the tolerance band. Past Due marks an invoice past its due date (it returns to Pending if the due date is extended); Cancelled and Failed cover orders that did not complete, and Expired appears only on non-invoice payment orders that lapsed. Settlement completes within 2 business days. Open any order's full detail with the eye icon; the actions menu adapts to the order — Download and Copy payment link on invoices, Download Invoice Summary once a crypto-to-fiat invoice is paid, Open link while it is payable, Resend top-up email when underfunded, and Cancel Order while it is still pending.
- Search by ID, label or counterparty; filter by status or date range
- Open an order with the eye icon; manage it from its actions menu
- Export the current view as CSV

Create order
Raise an invoice in one form. Your client pays in crypto; depending on your account, Perpolis settles your business in fiat, or in crypto to your whitelisted settlement addresses. The Payout currency selector sets which fiat currency you are settled in — it defaults to your account's own currency. Set the fiat amount and the networks and assets your client can pay with — advanced accounts also choose the invoice type, and crypto-to-crypto invoices settle in crypto to whitelisted settlement addresses instead — then the due date, label and client details. The order link is generated automatically, and you can customize it. Enter the client email, or pick a counterparty that has an email on file and leave the field to use it. Under Invoice PDF, Attach PDF uploads your own invoice, and Create Invoice PDF (where your permissions allow it) generates one from your details and the counterparty's. If your workspace requires order approval, clicking Create submits the order for sign-off instead — it appears under Approvals, and the order is created and the invoice email sent only once an approver approves it. Without approval controls, the invoice is emailed the moment you click Create.
- Choose the fiat currency to be settled in; set the amount, networks, assets and due date; pick settlement addresses for crypto-to-crypto
- Enter the client email (or use the counterparty's); attach your invoice PDF or create one
- Click Create — the invoice is emailed to your client on creation, or once approved if your workspace requires order approval

Invoice payment: the client view
What your client sees when they open the order link: a payment page with the invoice amount converted into their chosen asset, the deposit address, and a QR code. Invoice details and the attached PDF sit on the same page. The client sends the exact amount shown, or connects a wallet and proceeds to payment. The page accepts payment while the order is Pending or Underfunded; once a deposit is detected it shows the payment's progress, and a paid invoice simply confirms that no further payment is needed.
- Client selects the asset to pay with
- Client sends the exact amount to the address, or scans the QR code
- Payment is matched to your order automatically once confirmed

Counterparties
The book of entities you transact with. Attach a counterparty when raising an invoice to link it to that entity and carry its details onto the generated invoice PDF, and open a counterparty's record to see every order raised against it.
- Review a counterparty before raising an invoice against it
- Open a record for its full order history; Edit there to update it
- Keep contact details and service descriptions current
- Deactivate a counterparty you no longer invoice from the Status toggle (two-factor confirmation): it drops out of the order form, and Hide inactive tidies the list

Add counterparty
Add a new entity to your book: choose the counterparty type (individual or company), enter its name, one or more contact emails, and a description of the services they render. The address is part of the record: address line 1, city and country are required, while address line 2, state and postal code are optional. Confirm with your two-factor code to save.
- Pick the counterparty type and enter the name exactly as you invoice it
- Add at least one contact email and describe the services rendered
- Enter the address: line 1, city and country are required
- Confirm with your two-factor code

Addresses › Crypto (whitelist)
The whitelist of receiving addresses used for crypto-to-crypto settlement, under the Crypto tab of Addresses. Submitted addresses are screened after you confirm ownership and pass two-factor confirmation; a green shield marks addresses that passed screening, and only those can be selected as settlement addresses. Depending on your workspace permissions, adding addresses may be limited to specific team members, and workspaces can require approval before a new address is released — a submission awaiting approval is tracked under Approvals, not here.
- Check an address shows the validated shield before relying on it for settlement
- Keep labels meaningful: treasury01, not wallet3
- Remove addresses that are no longer in use

Add address
Submit a new address from the Crypto tab of Addresses: choose the network type, enter the address and re-type it to confirm, add a short label, tick the box confirming you own the address, then confirm with your two-factor code. Screening runs automatically. If your workspace requires whitelist approval, the button reads Submit for approval and the submission waits in Approvals — an approver releases it with their own two-factor code, and only then does it join the whitelist. Otherwise the address becomes available for use as soon as screening passes.
- Paste the exact address into both fields — the form asks you to confirm it
- Pick the network type and a short label, confirm ownership, then complete two-factor confirmation
- Screening runs automatically; in approval workspaces the address activates once an approver releases it

Approvals
The sign-off queue for workspaces with approval controls. Orders and whitelist additions can each be set to require sign-off in your workspace settings, and those requests land here. Approvals appears in the sidebar once you can approve a kind of request or have submitted one. Approvers see an Awaiting approval tab for the kinds they hold the matching permission for, and My submissions tracks your own requests with their status, and the reason if rejected. You cannot approve your own request unless the workspace allows self-approval. Approving executes the action on the spot — whitelist additions ask the approver for their two-factor code first. If a request is stuck because nobody in the workspace can approve it, the Perpolis team can release it: it then shows as Cancelled under My submissions with the reason they gave, and you can submit it again once an approver is in place.
- Review the full detail before approving — approval executes the action immediately
- Reject with a reason; the requester sees it under My submissions and can submit a fresh request
- Track your own pending requests under My submissions, and cancel one while it is still pending

Workspace: members and permissions
Your workspace is your company's shared account: every member signs in with their own credentials and works on the same orders and addresses. The sidebar shows which workspace you are in — people who belong to more than one pick one at sign-in and can switch there any time. Workspace opens the Members page, which lists the members with their permission groups; it is visible to members with administration permissions. Invite Member adds a colleague by email. A pending invitation shows Resend invitation and Remove on its row; every other member's actions menu (⋯) has Edit groups to change what they can see and do, Reset password and Reset 2FA when they are locked out, and Remove. A reset a member has requested from their own Security settings appears on their row to Execute or Cancel. Manage groups is where administrators define the permission groups themselves. Removing a member, or changing their groups, is refused if it would leave requests nobody could approve — keep at least one other approver for each kind of request your workspace requires sign-off on. Members granted order create or approve permissions are the workspace's authorized representatives: a banner walks them through a short verification form, and those permissions unlock once the Perpolis team approves their authorized-representative status.
- Invite a colleague with Invite Member — they receive an email and join with their own login
- Set what a member can do via Edit groups; define the groups under Manage groups
- Use Reset password / Reset 2FA to recover a locked-out member, or Remove to revoke access
- Execute or Cancel a member's own reset request from their row

Support
Help when you need it. The support assistant replies instantly, any hour, and can check your orders, verification status and account details while you chat. Ask for a person at any point and the conversation is handed to the Perpolis support team; sensitive topics go straight to the team automatically. You can delete a message you sent — with a short window to undo — and a copy is retained for compliance. You can also email [email protected].
- Ask the assistant first: it can check your orders and verification status instantly
- Ask to speak to a person at any time; the team replies during support hours
- Email [email protected] for anything urgent

Settings
Account and security controls: User Information, the details shown on your invoices (read-only — contact Perpolis to change them), allowed networks with the assets each carries (editable on some account tiers), notifications, and password and two-factor reset requests. Depending on your account you may also see Api settings (API key and webhooks) and Liquidity Providers preferences. Notifications lists every email you can receive, grouped by area, with a switch for each: optional ones such as payment received and invoice paid can be turned off, while important alerts such as a new whitelisted address are always sent and show as locked. Additional recipients sends copies of the emails you have enabled to up to 5 other addresses, each of which must confirm by email before it receives anything. Forgot your password? on the sign-in page resets your password yourself: the emailed link asks for your authenticator code before a new password (at least 12 characters) is accepted. Security also has Request password reset and Request 2FA reset — use the second if you have lost your authenticator device — and a pending request can be withdrawn with Cancel request. A workspace administrator completes those requests from the Members page, where they appear on your row to Execute or Cancel. The Maker-Checker Approvals controls decide which actions need sign-off (orders, whitelist additions, and whether self-approval is allowed) — editable with the workspace-settings permission. A combination that would leave nobody able to approve a required kind of request is refused when you save: keep at least one member who holds the matching approve permission and is not the only person submitting, or allow self-approval. For your security you are signed out automatically after a period of inactivity — a Still there? prompt appears shortly before, and Stay signed in keeps the session going. New accounts default to the Ethereum network with USDT and USDC enabled.
- Two-factor authentication is always on; request a reset from Security if you lose your device
- Switch optional emails on or off under Notifications; locked ones are always sent
- Review your allowed networks: accounts default to Ethereum with USDT and USDC
- Set which actions require approval under Maker-Checker Approvals

Screens shown are illustrative and generated from example data — no real account information appears in this guide. Sections showing a placeholder are awaiting an updated screen.