Get started with Straal
Three steps to start
It only takes three steps:
Fill in the registration form.
Sign the agreements.
Integrate your system with Straal.
Before you begin
You need to meet a few conditions before integrating with Straal. You will need:
- a registered business
- a website
- a bank account
- IT support
Fill in the registration form
Your first step is to fill in our registration form and tell us a little about your business. We'd like to get to know your company to better adapt to your needs and preferences.
You'll need the following documents to complete the process:
- photocopy of the official identity card or passport from the authorized signatory(-ies) (shareholders with more than 25% of the shares)
- if home addresses of signatories are not stated on the identity cards – photocopies of utility bills, dated within the last 3 months as a proof of address (note: mobile phone bills are not accepted)
- Certificate of Incorporation – certified true copy of the original (not older than 6 months)
- Memorandum & Article of Association – certified true copy of the original (not older than 6 months)
- a photocopy of the power of attorney to sign the agreement (if the agreement will be concluded on behalf of your company by an attorney-in-fact)
- a photocopy of the first page of the agreement with the bank holding the company’s account that you'll be using for accepting payments
- a link to the webpage with Terms & Conditions or a corresponding PDF/DOCX file if the website is not available yet
- credentials (login and password) to the test account on your shopping platform if the access to your e-store is available only for registered users
Sign the agreements
You will receive an e-mail with two contracts attached:
- payment services agreement concluded with one of Straal’s partners authorizing the transactions. We will select the solution that perfectly suits the scale, individual needs and characteristics of your e-business.
Both contracts should be signed in 2 copies each. If the (co-)owner of your company has more than 25% of the shares, additionally attach the Statement of the Ultimate Beneficial Owner, necessary to establish the ownership structure. You will receive its draft from us along with the contracts.
Send the required documents by post to the following address: Straal Sp. z o.o., Plac Europejski 1, 00-844 Warsaw, Poland, whereas their digital copies (scans) to [email protected].
Signed contracts will be sent back to your company’s postal address by Straal (technical agreement) and Straal’s partner (payment service agreement).
Please note that Straal payments activation is only possible in the e-store or e-service where it is already possible to place orders.
Integrate your system
Before you start accepting payments with Straal, make sure your website is in accordance with the law in force of providing services via the internet. Among others, remember to do the following:
- Inform your customers about all the costs (in gross values) associated with the services (packages) provided, such as subscription costs or additional fees.
- Make sure your e-store’s Terms & Conditions contain company policies about: returns, personal data privacy (with the information that Straal will have the access to transaction and customer data for the purpose of processing digital transactions), warranty, withdrawals and so forth.
- Place a legal note with the registered name of the company, its address, telephone number, email address, tax identification number, REGON number, the name of the registration authority (applies to the business activity) in the Contact tab or the footer of the website.
- Display the logos of Straal and other payment systems on your website (download logos).
How to enable payments on your website
You can create an API Key with permissions for the types of payments you require. An API Key identifies you in our system and serves as your password.
When you make a payment or create an object in Straal, you should send an API Key in the header of an HTTP request as Basic Auth password, with the user left empty. See the usage in the API Reference.
You'll also receive a Merchant ID (MID), which means that there will be an environment for processing your transactions set up in our system. Some Payment Gateways use an MID to identify the Merchant, but in Straal it's enough to use an API Key for this purpose.
We'll set up a test environment for your business. After it's done, you can begin testing various types of transactions. You can find test credit card numbers and IBANs in APIref: Testing resources.
You can play with the sandbox, using cURL and your favourite programming language. This is the time to test your integration with Straal. After you're done, we will create a production account for you.
To enable payments on your website, you need to make a connection between your website and Straal. You can choose one of three ways:
Straal Checkout Page. Your back end needs to (1) send a request to Straal to generate a checkout page for a given customer, and (2) redirect them to it. More details soon.
Back-end-to-back-end integration. It's possible if you're PCI Compliant, which means you can process payment data through your back end, and if you are able to generate CryptKeys. This integration method is the most powerful, but it's not often possible because of the high requirements of PCI-DSS compliance. Read more in Managing payments via Straal API
Custom payment form on your website. You can design and code your own checkout using Straal.js for rapid integration, and by following PCI-DSS and online payments best practices. Read more about security or visit the PCI Security Standards Council website.
If you have a mobile app, or you're developing one, and you'd like to give your users the option to make safe payments, you can use the Mobile SDKs for Android and iOS. Read more about the various options in Receiving payments.
To start accepting payments with Straal, visit the Boarding page.
API keys and notifications
There are a two things you need to have prepared before you start accepting payments with Straal. As these things require some technical knowledge we recommend sharing this information with your developers.
- Make sure you have access to Kompas: our analytics and account management dashboard. If not, please contact our support or your account manager.
- Make sure a test account was set up for you.
- Given points 1 and 2 are true you can login to Kompas and:
- Generate an API Key.
- Configure a notification endpoint.
Generating an API key
An API key authorizes you in our API and allows you to interface with it. Keep it secure and do not expose it to any unauthorized personel or your customers, as it can lead to malicious behaviors. To generate an API key follow these steps:
- Go to Kompas and navigate to API keys.
- Click on the “Generate API key” button.
- Name your API key with a prefix that will help you easily identify it in the future. For example:
- Use the checkboxes to signal which API permissions this key should have. For the general purpose key we recommend keeping all boxes checked.
- Click on the "Generate key" button.
- We will display you the API key that you have just generated. Save it now in a safe place. For security reasons, there is no way to retrieve the key after closing the modal. You can only generate a new one.
Configuring a notification endpoint
Notifications allow you to receive status updates from Straal about events happening inside our payment gateway. A notification endpoint is a URL provided by your system to which Straal will send the notifications. To configure an endpoint follow these steps:
- Go to Kompas and navigate to Notification endpoints.
- Click on “Create”.
- A modal window will pop up. Enter the URL to which we will send the notifications. Make sure the URL is secured via an SSL certificate (starts with https://).
- Optionally, if you want to protect the endpoint from unauthorized use, you can secure it with HTTP basic authorization. Enter the username and password that Straal will use when sending the notifications to your server. We highly recommend protecting the endpoint.
- Click on “Create”.
Go Live Checklist
You may think you're ready to go live with your Straal implementation. But before you do it, go over the checklist below to make sure everything is ready.
- Is your website integrated with Straal?
- Have you completed testing your Straal integration?
- Have you configured credentials and endpoints for production after testing?
- Have you enabled online payments on your website?
Remember you can consult our comprehensive API Reference at any moment.
For help with payments vocabulary, head to our glossary.