Developers
All the necessary information and tools to quickly and efficiently integrate Paytrail’s payment solutions.
Welcome to Paytrail developer resources!
Navigate through our comprehensive guides, from API documentation to detailed examples, to successfully implement and optimize our payment service in your projects.
Embark on your journey with Paytrail and enhance your payment processing experience. Explore the sections below to access comprehensive resources designed for a smooth integration.
1. Why Paytrail?
2. Quick start guide
3. Comprehensive API documentation
4. SDKs and libraries
5. Plugins and extensions
6. Testing
7. Support and troubleshooting
8. Additional resources
9. Legal and compliance
1. Why Paytrail?
Paytrail offers an efficient and comprehensive payment service solution, trusted by around 20,000 online businesses.
With one agreement, gain access to a broad range of payment methods, ensuring high conversion rates and customer satisfaction through flexible and secure payment options.
All the popular payment methods
Get all the popular payment methods in Finland to increase conversion rates: online banks, cards, mobile, Buy now, Pay later and PayPal. Learn more about the payment methods we offer.
Versatility
From e-commerce and mobile apps to in-app purchases and beyond, our service supports all types of online payment scenarios, whether it’s B2C or B2B.
Tokenization and subscriptions
Our service supports card tokenization which allows customers to store their credit card information securely and reliably for later use on the checkout page or for recurring payments.
User friendly
Our service emphasizes the simplicity and ease of making payments online, ensuring that both payment method selection and payment are quick and straightforward.
First class customer service
Accessible, friendly, and fast customer service. Our customer service team assists consumers, developers, and online businesses through multiple channels.
Easy monitoring and detailed reporting
Track and analyze transactions, create refunds and payment links, and download detailed reports for accounting purposes.
Reliability and security
Our robust platform boasts an impressive 99.98% uptime, ensuring continuous transaction success without disruptions. We ensure compliance with local and EU regulations and perform updates in a timely manner.
Licensed by the Finnish Financial Supervisory Authority, we provide one of the most secure payment services with stringent security measures in place to protect all transactions.
2. Quick start guide
Get up and running with Paytrail's payment solutions quickly and efficiently using this guide.
Step 1: Account sign up and setup
- Sign up for our service.
- Enter your company information in the Merchant panel and sign the agreement electronically. We will contact you if needed and guide you through the setup process.
- Get the Merchant ID and Secret key from the Paytrail's Merchant panel. These are essential for your integration.
- Choose your integration method: Decide if you will use our APIs directly, or implement via SDKs or plugins depending on your platform (more on these topics below).
- Download and install or build from scratch: Download a ready-made plugin for your platform or start with a SDK or code example, but remember to review our API documentation for full endpoint details.
Step 3: Test and make your first API call
- Configure your environment: Set up your development environment with your live credentials or use our test credentials.
- Test the connection: Make a test API call to ensure everything is set up correctly. Example calls can be found in our API documentation.
Step 4: Verify and go live
- Test: Utilize our test credentials to safely test your payment flows without making real transactions.
- Go live: Once you are confident in your integration, switch from the test credentials to live credentials with a simple configuration change.

3. Comprehensive API documentation
Our full API documentation serves as a thorough resource for integrating Paytrail's payment solutions, offering endpoint descriptions, parameter details, and examples.
The API documentation includes detailed sections on setup, authentication, handling payments, managing refunds, and dealing with errors. It provides all the necessary tools for developers to effectively use our APIs.
OpenAPI Specification
Access our machine-readable OpenAPI spec for a comprehensive overview of API structures and capabilities.
4. SDKs and libraries
Comprehensive Development Kits
Paytrail provides several Software Development Kits (SDKs) that offer pre-built libraries and sample code to help streamline your integration process. These SDKs are designed for various programming environments.
Available SDKs
- Paytrail PHP-SDK: Incorporate Paytrail payment functionalities into your PHP-based applications. The repository includes comprehensive setup instructions and usage examples.
- Paytrail JavaScript-SDK: Ideal for developers working on web front-ends or Node.js projects.
- Paytrail .NET-SDK: Use this SDK to integrate Paytrail's payment solutions into your .NET applications.
- Paytrail iOS-SDK: Develop iOS apps with built-in payment functionality using this SDK tailored for mobile developers.
- Paytrail Android-SDK: Equip your Android applications with our versatile payment solutions.
Each SDK comes with detailed installation instructions. Select your desired SDK from the list above to find specific guidance on how to incorporate it into your project.
Why use an SDK?
SDKs can significantly reduce the amount of code you need to write and provide a more stable and streamlined integration experience. They are updated regularly to cope with new features and security updates.
Explore example codes
Working on a language that has no SDK available? Enhance your development with practical implementation examples. See detailed examples and code snippets across many different languages and frameworks.
5. Plugins and extensions
Paytrail is compatible with a vast array of e-commerce platforms, ensuring seamless integration to many systems. Check our complete list of supported platforms.
We are working closely with the platform providers to ensure best possible integration and user experience. We have top-level partnerships with the leading webshop platform providers, like Adobe Commerce, WooCommerce and PrestaShop.
Featured open source plugins
- WooCommerce: Integrate Paytrail smoothly with your WooCommerce setup using the Paytrail for WooCommerce plugin. We are Platinum-level partners with WooCommerce.
- Adobe Commerce: Enhance your Adobe Commerce store with the Paytrail for Adobe Commerce plugin, including support for advanced features like PWA and GraphQL through our PWA Studio and GraphQL extensions. As a token of quality, our module was recently accepted to Adobe’s App Assurance program.
Our plugins provide a robust, secure payment service directly into your e-commerce platform, designed to meet the latest standards.

6. Testing
Testing is a critical step to ensure your payment integration works seamlessly. Paytrail provides essential tools and resources to help you verify and perfect your setup before going live.
Test credentials
Use our comprehensive set of test credentials to simulate various payment methods. This is crucial for verifying that your integration can handle all expected transaction scenarios effectively.
7. Support and troubleshooting
Encounter a snag? Our comprehensive FAQs and troubleshooting guides in our Help Center will help you navigate common issues during the integration process.
Direct assistance
If you can't find the support needed from our Help Center, reach out to our technical support team.
GitHub collaboration
Our API documentation is hosted on GitHub. You can contribute to the documentation, request improvements, or report bugs directly through GitHub, making it a collaborative and continuously improving resource.
All the SDKs and plugins we have published are also available on our GitHub account, so please report a bug or submit an enhancement idea there.
We also welcome your participation in the development of the open source plugins or SDKs by creating a pull request for your own improvement or fix.
News and updates
Keep up with the latest features and updates by subscribing to our newsletter and following us on social media.

8. Additional resources
Beyond immediate integration and troubleshooting, Paytrail offers a wealth of additional resources designed to enrich your development knowledge and help you maximize the use of our payment solutions.
Webinars
Dive into our detailed webinars and tutorials which cover various aspects of using Paytrail effectively. These sessions are perfect for developers looking to deepen their understanding of our payment system. Webinars are held in Finnish.
Customer references and stories
Learn how Paytrail is used in various industries. Customer stories provide valuable insights on integrating payment solutions in various contexts.
9. Legal and compliance
Understanding and adhering to legal and regulatory standards is crucial when integrating payment solutions. This section provides essential information to help you comply with relevant laws and guidelines.
Terms and conditions
Familiarize yourself with Paytrail's terms and conditions to ensure your integration aligns with our operational policies.
Privacy notice
Review our Privacy notice to understand how we handle and protect personal data according to privacy laws.
Data security
Learn about how Paytrail secures payment transaction data and user personal information in accordance with international security standards.