HashPay Documentation
Everything you need to know about using HashPay for on-chain payroll.
What is HashPay?
HashPay is an on-chain payroll platform that lets you pay your team automatically using cryptocurrency on HashKey Chain. Set up a payroll once, fund it, and execute payments to all your team members with a single click.
Every payment is settled through the HashKey Settlement Protocol (HSP) and recorded on the blockchain with a permanent, verifiable receipt. No intermediaries, no delays, no hidden fees.
Who is it for?
- DAOs — Automate contributor payments with full transparency and on-chain audit trails
- Crypto-native teams — Pay your team in stablecoins with recurring schedules
- Freelancers & contractors — Get paid on time with verifiable settlement receipts
Quick Start
Get your first payroll running in under 2 minutes:
Get Testnet Tokens
You need two types of tokens: HSK for gas fees and USDT for payments.
Get HSK from the HashKey Chain Faucet. Then go to hashpay.tech/faucet and mint free USDT.
Connect Your Wallet
Click "Connect Wallet" on the homepage. HashPay supports MetaMask, WalletConnect, and other popular wallets. If prompted, add HashKey Chain Testnet to your wallet (it's automatic with most wallets).
Create a Payroll
Go to Employer Dashboard → Create Payroll. Use the "Quick Test" template to try it fast — it sets up a 5-minute cycle with one recipient. Enter a wallet address and amount, then confirm the transaction.
Fund the Escrow
After creating, you'll be asked to deposit USDT into the escrow. Two steps: Approve (allows the contract to use your USDT) then Fund (deposits the amount). The runway indicator shows how many payment cycles your deposit covers.
Execute a Payment Cycle
Once the cycle period elapses (5 minutes for test), the "Execute Cycle" button activates on your payroll card. Click it — all recipients receive their payments simultaneously. You'll see a link to view the transaction on the block explorer.
For Employers
Creating a Payroll
The payroll creation wizard has 3 steps:
- 1Details — Name your payroll, pick a payment token (USDT or add a custom token), and choose how often to pay: weekly, biweekly, monthly, or a 5-minute test cycle.
- 2Recipients — Add your team's wallet addresses and how much each person gets paid per cycle. The total cost per cycle is shown at the bottom.
- 3Fund — Deposit USDT into the on-chain escrow. You can see exactly how many cycles your deposit will cover (the "runway").
Templates
Don't want to fill everything manually? Use a template:
Templates pre-fill the name, frequency, and recipient slots. You just need to add the wallet addresses.
Managing Payrolls
Your dashboard shows all payrolls as cards. Each card displays:
- Number of recipients and cost per cycle
- Current escrow balance with USD equivalent
- Runway — how many more cycles your funds cover
- Cycles completed and total paid out
Actions on Each Payroll
Triggers payment to all recipients. Only available when the cycle period has elapsed and there are sufficient funds.
After executing a cycle, create permanent on-chain proof-of-payment for each recipient via EAS. Attestations are non-revocable and verifiable by anyone.
Process payment through HashKey Settlement Protocol's hosted checkout. Shows a demo flow when API keys aren't configured.
Downloads a PDF compliance report with your company header, all payment details, and HSP receipt IDs. Requires setting up your business profile first.
After executing a cycle, click to see the transaction on the HashKey Chain block explorer.
Business Profile
Go to the profile page (click the icon on your dashboard) to enter your company details — name, registration number, address, country, and email. This information appears in the header of your PDF compliance reports. Your profile is saved in your browser.
For Employees
Connect a wallet that is registered as a recipient in an active payroll. Your employee dashboard shows:
What You'll See
Real on-chain payment data fetched from the blockchain. Shows date, amount (with USD value), cycle number, HSP receipt ID, and settlement status.
All USDT amounts show their approximate USD value alongside the token amount.
Download your complete payment history as a CSV file for accounting, tax filing, or personal records.
How Settlement Works
Every payment in HashPay goes through the HashKey Settlement Protocol (HSP). This ensures every payment is verifiable and creates an immutable audit trail.
The Payment Flow
Employer Clicks 'Execute Cycle'
The smart contract checks that enough time has passed since the last payment and that the escrow has sufficient funds.
HSP Payment Requests Created
A batch of payment requests is created through the settlement protocol — one for each recipient. Each request gets a unique HSP receipt ID.
Tokens Transferred
USDT is transferred from the escrow directly to each recipient's wallet. Each transfer is confirmed and marked as settled in the HSP system.
Receipts Stored On-Chain
A permanent receipt is stored for every payment containing: who paid, who received, how much, when, and the HSP receipt ID. These receipts can never be altered or deleted.
HSP Hosted Checkout
HashPay also supports payment through HSP's hosted checkout page. When you click "Pay via HSP" on a payroll card, you're taken to HSP's payment page where you approve a USDC transfer directly. This adds an extra layer of settlement verification from HashKey's own infrastructure.
Payment Verification
HashPay creates permanent, cryptographic proof for every payment using the Ethereum Attestation Service (EAS). This means anyone — your accountant, a tax auditor, or a business partner — can independently verify that a payment happened.
What is an Attestation?
An attestation is a signed, on-chain record that proves a specific event occurred. HashPay attestations prove: this employer paid this recipient this amount at this time, and here is the HSP settlement receipt to prove it. Attestations are permanent — they can never be revoked or deleted.
How to Verify a Payment
Get the Attestation UID
After a payroll cycle is attested, each payment gets a unique attestation UID (a long hex string starting with 0x). This UID is your proof of payment.
Visit the Verify Page
Go to hashpay.tech/verify — no wallet connection needed.
Paste and Verify
Paste the attestation UID and click Verify. The page reads directly from the blockchain and shows: payroll ID, cycle number, employer address, recipient address, exact amount, token used, HSP receipt ID, and timestamp.
Why This Matters
Traditional payroll relies on trust — you trust your employer's records, you trust the bank's statement. With HashPay, proof of payment lives on the blockchain. It can't be altered, backdated, or disputed. This is especially valuable for:
- Tax compliance and audit readiness
- Contractor payment disputes
- DAO contributor transparency
- Cross-border payment verification
Analytics & AI
Analytics Dashboard
The analytics page gives employers a bird's-eye view of their payroll operations:
- Summary cards — total paid, active payrolls, average cycle cost, employee count, runway remaining, next payout date
- Payment volume chart — monthly payment trends showing growth over time
- Escrow runway — how your treasury balance changes over time, including refill events
- Cost breakdown — per-employee compensation comparison
AI Payroll Intelligence
The AI panel on the analytics page automatically analyzes your payroll data and provides:
A 0-100 score indicating your overall payroll health based on runway, consistency, and anomalies.
Estimates when your escrow will run out and recommends when to top up.
Flags unusual patterns — cost spikes, missed cycles, or unexpected changes in recipient count.
Actionable suggestions like optimal execution timing for gas savings or escrow efficiency.
The AI panel currently runs in demo mode with realistic sample analysis. When configured with an AI API key, it provides live analysis based on your actual payroll data.
Tokens & Faucet
Supported Tokens
HashPay supports multiple payment tokens:
You can also add any custom ERC-20 token by pasting its contract address in the token selector during payroll creation.
Token Faucet
For testing, visit hashpay.tech/faucet to mint free Mock USDT. Choose from 1,000 / 10,000 / 100,000 USDT amounts. Your balance updates automatically after minting.
You'll also need HSK for gas fees — get it from the HashKey Chain Faucet.
Contract Addresses
If you need to add these tokens to your wallet manually:
Security
HashPay is designed with security as a priority:
Funds are held in a smart contract, not by HashPay. Only the payroll owner can execute cycles or withdraw excess funds.
Every transaction is recorded on HashKey Chain. Anyone can verify payments, balances, and settlement receipts on the block explorer.
HSP receipts and EAS attestations cannot be altered, backdated, or deleted after creation.
Only the wallet that created a payroll can execute cycles, add/remove recipients, fund, cancel, or withdraw. No admin backdoors.
The HSP settlement layer restricts confirm/settle/cancel operations to authorized contracts only. Unauthorized callers are rejected.
All fund-moving operations (execute, fund, cancel, withdraw) are protected by OpenZeppelin's ReentrancyGuard.
All smart contracts and frontend code are open source and available on GitHub for independent review.