Skip to content

Blik

SS Integration option

Payment

Payment Flow

  1. The customer initiates the payment on the merchant's website.
  2. The merchant sends a payment request to PaynetworkGate.
  3. PaynetworkGate responds with a link to the payment page.
  4. The merchant redirects the customer to the payment page.
  5. The customer completes the payment.
  6. PaynetworkGate sends a webhook notification with the payment status to the merchant.

Info

This integration option supports only PLN currency.

Request

Send a payment request with the following additional data:

object
return_url
required

string
A URL to return the customer to when a transaction is completed.
ip
string
The customer's IP address.
object
A section of the payment method.
type
required
string
blik
object
A section of information about the customer.
first_name
required
string
The customer's first name.
last_name
required
string
The customer's last name.
email
required
string
The customer's email.
object
A section of additional transaction parameters.
object
A section of the customer's browser parameters.
accept_header
string
Value of Accept request HTTP header sent by the customer's browser.
screen_color_depth
integer
Screen color depth in bits per pixel. Equals the screen.colorDepth parameter in JavaScript. Applicable values are:

1 - 1 bit
4 - 4 bits
8 - 8 bits
15 - 15 bits
16 - 16 bits
24 - 24 bits
32 - 32 bits
48 - 48 bits.
language
string
Language of the navigator. Equals the navigator.language parameter in JavaScript.
screen_height
integer
Screen height in pixels. Equals the screen.height parameter in JavaScript.
screen_width
integer
Screen width in pixels. Equals the screen.width parameter in JavaScript.
time_zone
integer
Time zone difference, in minutes, from the current locale (host system settings) to UTC. Equals the new Date().getTimezoneOffset() parameter in JavaScript.
user_agent
string
User agent string for the browser. Equals the navigator.userAgent parameter in JavaScript.
java_enabled
boolean
Indicates if the browser is Java-enabled or not. Equals the navigator.javaEnabled() parameter in JavaScript.
window_width
integer
Browser window width in pixels. Equals the document.body.clientWidth parameter in JavaScript.
window_height
integer
Browser window height in pixels. Equals the document.body.clientHeight parameter in JavaScript.
Request example
{
  "request": {
    "amount": 5000,
    "currency": "PLN",
    "ip": "127.0.0.1",
    "description": "description",
    "return_url": "https://return.com",
    "method": {
      "type": "blik"
    },
    "customer": {
      "first_name": "John",
      "last_name": "Doe",
      "email": "john@example.com"
    },
    "additional_data": {
      "browser": {
        "accept_header": "text/html,application/xhtml+xml,application/xml",
        "screen_color_depth": 24,
        "language": "en",
        "screen_height": 800,
        "screen_width": 600,
        "time_zone": -300,
        "user_agent": "AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0",
        "java_enabled": true,
        "window_width": 1024,
        "window_height": 640
      }
    }
  }
}
Response

Redirect your customer to the URL received as the value of the form.action parameter.

Response example
{
    "transaction": {
        "uid": "d7b88f80-f714-4f64-9aeb-dc880b3b7b4a",
        "type": "payment",
        "status": "pending",
        "amount": 2300,
        "currency": "PLN",
        "description": "test",
        "created_at": "2025-01-11T11:31:09Z",
        "updated_at": "2025-01-11T11:31:10Z",
        "method_type": "blik",
        "receipt_url": "https://backoffice.paynetworks.io/customer/transactions/d7b88f80-f714-4f64-9aeb-dc880b3b7b4a/e598bbe9b8a2deaf99fbcefca028f6c6c2b7eedf593d3ee37151e9acd61844da?language=ru",
        "payment": {
            "status": "pending",
            "gateway_id": 4824,
            "ref_id": "4214474",
            "message": "Invoice is created successfully, waiting for a payment",
            "bank_code": 31
        },
        "blik": {
            "type": "blik"
        },
        "customer": {
            "email": "john@example.com",
            "first_name": "John",
            "last_name": "Doe",
            "ip": null
        },
        "manually_corrected_at": null,
        "version": 0,
        "message": "Invoice is created successfully, waiting for a payment",
        "tracking_id": "your_uniq_number21212",
        "test": true,
        "language": "en",
        "billing_address": {
            "email": "john@example.com",
            "last_name": "Doe",
            "first_name": "John"
        },
        "additional_data": {
          "browser": {
              "accept_header": "text/html,application/xhtml+xml,application/xml",
              "screen_color_depth": 24,
              "language": "en",
              "screen_height": 800,
              "screen_width": 600,
              "time_zone": -300,
              "user_agent": "AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0",
              "java_enabled": true,
              "window_width": 1024,
              "window_height": 640
            },
            "payment_method": {
                "type": "alternative"
            }
        },
        "gateway": {
            "iframe": false
        },
        "form": {
            "action": "https://test-ss/hosted?transaction-id=5e747509-4b2e-8a0a-03ea-5697eb",
            "method": "GET",
            "fields": []
        }
    }
}

TI Integration option

Info

This integration option supports only PLN currency.

Payment

Payment flow

  1. The customer initiates the payment on the merchant's website.
  2. The merchant sends the payment request to PaynetworkGate.
  3. PaynetworkGate sends a response containing the URL for completing the payment.
  4. The merchant redirects the customer to the provided URL.
  5. The customer completes the payment.
  6. PaynetworkGate sends a webhook notification with the payment status to the merchant. The merchant may also request the payment status from PaynetworkGate with the status query.

Warning

If the customer edits the payment amount on the provider's payment page before completing the payment, the amount parameter value in the webhook notification and in the response to the transaction status query will be different from the value sent in the initial payment request and will equal the actual paid amount according to the information in the provider's system.

Request

Send a payment request with the following additional parameters:

object
return_url
required

string
A URL to return the customer to when a transaction is completed.
object
A section of the payment method.
type
required
string
blik
object
A section of information about the customer.
first_name
required
string
The customer's first name.
last_name
required
string
The customer's last name.
email
required
string
The customer's email address.
birth_date
required
string
The customer's date of birth in the ISO 8601 format (YYYY-MM-DD).
country
required
string (2)
The customer's billing country in the ISO 3166-1 Alpha-2 format. Possible values: AD (Andorra), AT (Austria), BE (Belgium), BG (Bulgaria), HR (Croatia), CY (Cyprus), CZ (Czechia), DK (Denmark), EE (Estonia), FI (Finland), FR (France), DE (Germany), GR (Greece), HU (Hungary), IS(Iceland), IE (Ireland), IT (Italy), LV (Latvia), LI (Liechtenstein), LT (Lithuania), LU (Luxembourg), MT (Malta), MC (Monaco), NL (Netherlands), NO (Norway), PL (Poland), PT (Portugal), RO (Romania), SM (San Marino), SK (Slovakia), SI (Slovenia), ES (Spain), SE (Sweden), CH (Switzerland), GB (United Kingdom). The new countries are continually added to the list of possible values.
phone
string
The customer's phone number without the special characters.
address
string
The customer's address.
zip
string (6)
The post code of the customer's billing address.
gender
string
The customer's gender.
Possible values:
male;
female.
Request example
{
    "request": {
        "test": true,
        "amount": 1500,
        "currency": "PLN",
        "description": "description",
        "return_url": "https://return.com",
        "method": {
            "type": "blik"            
        },
        "customer": {
            "first_name": "John",
            "last_name": "Willson",
            "email": "test@example.com",
            "birth_date": "01-01-1980",
            "country": "PL"           
        }
    }
}
Response

Redirect your customer to the URL received as the value of the form.action parameter.

Response example
{
  "transaction": {
    "uid": "560d9a3b-e2d2-42c1-9992-fc78e21adec2",
    "type": "payment",
    "status": "pending",
    "amount": 1500,
    "currency": "PLN",
    "description": "description",
    "created_at": "2025-01-22T08:27:11Z",
    "updated_at": "2025-01-22T08:27:15Z",
    "method_type": "blik",
    "receipt_url": "https://backoffice.paynetworks.io/customer/transactions/560d9a3b-e2d2-42c1-9992-fc78e21adec2/53016ad33c5c3264d3da2611f8c64e0d002168f3309def82a73e8dd31093e889",
    "payment": {
      "status": "pending",
      "gateway_id": 4870,
      "ref_id": "OR-250122082714139",
      "message": "Transaction was initialized."
    },
    "blik": {
      "type": "blik"
    },
    "customer": {
      "first_name": "John",
      "last_name": "Willson",
      "email": "test@example.com",
      "country": "PL",
      "birth_date": "1980-01-01",
      "ip": null
    },
    "manually_corrected_at": null,
    "version": 0,
    "message": "Transaction was initialized.",
    "test": true,
    "billing_address": {
      "first_name": "John",
      "last_name": "Willson",
      "email": "test@example.com",
      "country": "PL",
      "birth_date": "1980-01-01"
    },
    "additional_data": {
      "payment_method": {
        "type": "alternative"
      }
    },   
    "gateway": {
      "iframe": true
    },
    "form": {
      "action": "widget-ti/g?paytoken=9bce49ac-1ca0-45f3-a81e-44580cf6251a",
      "method": "GET",
      "fields": []
    }
  }
}