Skip to main content

Integration checklist

This step-by-step guide will help you set up your interaction with Financial Line services, test all settings and start accepting payments from your customers.

Stage 1. Getting to know the merchant portal​

  1. Create an account​

    To connect to Financial Line and work with payments, you need to register in the merchant portal
    ➡️ Registration instructions.

  2. Add other members of your team​

    You can give your team access to the account right away. Access levels can be controlled using a set of roles that are already provided in the merchant portal ➡️ Adding users.

  3. Familiarize yourself with the test project and use its API keys​

    After registration, you will immediately have access to the test project and its authentication data - API keys. They are needed to set up and test payment before starting work on a live project
    ➡️ Test project.

Stage 2. Setting up the integration and making test payments​

Before accepting payment on your live project, make sure that the settings and processes are correct.

  1. Get onboarded​

    Contact our supports to complete data verification and determine the terms of cooperation
    ➡️ Financial Line.

  2. Configure the integration​

    Choose the required integration method and make the appropriate settings using the data of the test project ➡️ Integration options.

  3. Make test payments​

    Use test payment data and check different card payment scenarios ➡️ Test payment.

  4. Handle errors and failed payments​

    ПMake sure that API requests are formed correctly and that you receive correct responses about failed payments and errors that may occur when creating or making a payment.

  5. Make refund and void​

    Check how the refund and/or void functionality works (if you use two-step payment). You can test these features using the test payments you made earlier.

  6. Set up payment card verification (optional)​

    This function allows you to make sure that the card specified by the payer is valid and its details are correct
    ➡️ Card verification.

  7. Set up alternative payment methods (optional)​

    If you plan to work not only with card payments, but also with other payment methods, see additional information about their settings ➡️ Payment methods.

Stage 3. Setting up webhooks​

Webhooks are utilized by Financial Line to transmit the information about various payment events such as the status of payments, successful completion of 3DS, charge or pre-authorization of payment, refund, payment capture or void when using two-step payment. Therefore, in order to receive this data, you need to integrate with the webhook service.

  1. Define the structure of webhooks​

    Familiarize yourself with the mandatory and optional parameters of webhooks and determine the ones that you need
    ➡️ Webhooks.

  2. Create your endpoint for the webhooks​

    Provide the public URL of your endpoint so that it can receive the payload from the webhooks.

  3. Receive and process notifications​

    Receive and process notifications with information about payments and individual transactions, as well as their status.

Stage 4. Work with reporting information​

  1. Control your account balance​

    Find out where and how to get information about your account balance.

  2. Get more information on payments​

    Receipts, information on certain transactions, orders, etc. ➡️ Receiving information about payments.

  3. Configure receiving of transaction registers (optional)​

    Receive transaction registers automatically via the за API or via the scheduler for sending out transaction registers in the merchant portal. You determine the amount of data, the date and time of sending, and the format of the registers yourself.

Stage 5. Go live​

After testing the payment process with the test data, it's time to connect the live project and make a few additional settings for further work.

  1. Create a live project​

    Go to the merchant portal and create a live project. On your side, replace the authentication data (API keys) of the test project with the credentials for the live project.

  2. Improve account security​

    • Set up two-factor authentication (recommended).
    • Define a list of allowed IP addresses to interact with the API (optional).

  3. Set up a payment page (optional)​

    To accept payments, you can use:

  4. Set up the software-based cash register (optional)​

    If you work in the Ukrainian market and you need to fiscalize online payments, use our ready-made solution ➡️ Software-based CR.

  5. Conduct comprehensive testing​

    The final step of the integration is to verify that all stages and scenarios of your payment cycle are working correctly.