Get started with Straal

Three steps to start

It only takes three steps:

  1. Fill in the registration form.

  2. Sign the agreements.

  3. 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

Within 24 hours, you will receive an e-mail with two contracts attached:

  • technical agreement comprising the Terms of Use of Straal Payment Gateway,
  • 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'll receive an API Key with permissions for the types of payments you specified earlier. 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.

Test environment

We'll set up a test environment for your API Key. 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 send you an API Key with production permissions.

Enabling payments

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.

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 received 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.

You can reach us by e-mail. Dev Team: [email protected], Support Team: [email protected].