Paylink provides two isolated environments: a sandbox for development and testing, and a live environment for processing real payments. Both environments expose the same API surface, so you can build and verify your integration in sandbox and promote to live with minimal changes.
Environment URLs
Each environment has its own base URL for API calls and a separate checkout URL for hosted payment pages.
Sandbox vs. Live
The sandbox mirrors live behaviour exactly but uses simulated payment instruments — no real money moves and no real bank accounts or cards are charged. Use it to:
- Develop and test your integration end-to-end
- Trigger different payment outcomes (success, failure, pending)
- Test webhook delivery and signature verification
- Validate your reference-management and idempotency logic
To switch from sandbox to live, replace the sandbox base URL with the live base URL in your HTTP client configuration and swap in your live API credentials. No other code changes are required.
Never hard-code a checkout host in your application. The checkout URL for a specific payment is returned in the response body when you call /payments/initialize, and it is always environment-specific. Always redirect customers to the URL returned by the API.
Interactive OpenAPI documentation is available at /docs on each environment — https://sandbox.lyseis-pay.com/docs and https://live.lyseis-pay.com/docs. Use the sandbox docs to explore and test endpoints without writing any code.
Moving to Live
Once your integration is working correctly in sandbox, complete the following steps before accepting real payments.
