First integration

This guide will help you to make your first payment with ready-to-use payment forms.

Demo app

You are welcome to get started with our demo application. You can start making test transactions without any efforts including setting up a server, we provide a test integration server for you. Please note, that it is configured for demo purposes only.

The demo app is provided along with SDK since version 2.5.0.

NOTE: Before running the application, make sure SDK files are copied to the demo app folder. Find more details in the readme.txt file.


Requirements

Install the SDK

Set Up Your Server

  • Endpoint 1: Creating a checkout ID,
  • Endpoint 2: Getting result of payment.

See detailed instruction in our guide "Set Up Your Server".


Request Checkout ID

Your app should request a checkout ID from your server. This example uses our sample integration server; please adapt it to use your own backend API.

Present Checkout UI

Get the Payment Status

Finally your app should request the payment status from your server (again, adapt this example to your own setup) for any result except cancelled.

Validate Payment Response Against Order Details

Before confirming the order to the customer, merchants should validate that the payment response matches the original order details. This validation might include:

  • Order ID
  • Amount
  • Product ID or SKU
  • Currency

This validation ensures that the payment authorization corresponds to the correct product and prevents mismatches due to potential manipulation or technical issues.

⚠️ Important: If the validation fails, the merchant should not confirm the order and should instead initiate an investigation or notify the customer.

Testing

The sandbox environment only accepts test payment parameters.

You can find test values for credit cards and bank accounts in our Testing Guide.

Go to Production

1. Talk to your account manager to get the live credentials.

2. Adjust the server type to LIVE in your initialization of .

3. Change your backend to use the correct API endpoints and credentials.