Developers Hub

Developers Hub

Direct flow integration

1. Introduction

       1.1.        Goal

This API is designed to integrate PCI DSS compliance sellers in order to provide buyers with access to pay for goods and services through third party integrations.


2. Flow description

       2.1.        Interaction format

The interaction of the store's service with the payment aggregator is based on the request/response scheme. The request with the necessary parameters is made by the store using GET/POST methods over the HTTP/HTTPS protocol in json format. Request address: https://{Host}/{type of request/operation}, where {Host} is the URL of the payment gateway of the payment aggregator, {type of request/operation} is the name of the operation for which the request is being made. The results of processing requests from the store are issued synchronously by the payment aggregator in json format, UTF8 encoding.

  1. User enter card data and do checkout on merchant’s page

  2. Merchant backend service fetch JWT token from Payment system SSO service (optional JWT not exists or expired)

  3. Merchant backend service send pay with card request to Payment system Integration service and retrieve transaction info response

  4. Merchant backend service create link for user redirection to Payment system Payment Page

  5. Payment system Payment Page redirect user to payment system challenge window (frictionless, 3ds)

  6. User process challenge for payment system and proceed transaction

  7. Payment system Payment Page redirect user to payment result page

  8. Payment system Integration service send payment result callback

3. Requests-Responses

Before integration process merchant must finish onboarding process and get credentials. Before go live merchant should test integration on sandbox environment.

       3.1.        Get JWT token