Appearance
1. Create an account
Before calling the API you need a Salaxy account. For development, create a test company in the test environment — it takes a few minutes and uses test data only.
Choose a company
Pick a real Finnish company or association (oy, ky, avoin yhtiö, ry) from the trade register at ytj.fi — preferably one you are connected with. It is test data, so you do not need signing rights. Note its business ID (Y-tunnus).
Create it in the test environment
- Go to test.palkkaus.fi and create a company — or an accounting firm (PRO / tilitoimisto) if you build for accounting firms.
- Sign up with email and password (not Google, Microsoft or similar).
- After the first verification, the test environment sends no emails. Verification is not required either, so a made-up address such as
yourname@example.comworks.
Complete the onboarding wizard
- Personal identity code. On the digital signature page, enter a made-up code
ddmmyy-nnn*: a real date, any three digits, and*in place of the checksum. - Signing. To skip the signature, choose any authentication method except "Testing ID" — that one leads to an external test service that needs its own account.
- Ready. Your test company is set up and you can use its web application.
The test account works in both test and demo — they share the same data.
Check
- You can sign in to test.palkkaus.fi as your test company.
- The onboarding wizard is complete and the company's web application opens.
- You have noted the company's business ID.
Screenshots
The interactive version of this step — sign in and run it against your test account — is on the current developer site: create account. The runnable samples stay there; the steps and endpoints are here.

