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:

Parameter Type Description
request object
return_url * required
 string URL to return the customer to when the transaction is completed.
ip string The customer's IP address.
method object A section of the payment method information.
type * required
 string blik
customer object A section of information about the customer.
first_name string The customer's first name.
last_name string The customer's last name.
additional_data object A section of additional transaction parameters.
browser 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"
    },
    "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": null,
            "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",
        "additional_data": {
            "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:

Parameter Type Description
request object
return_url
* required
 string A URL to return the customer to when a transaction is completed.
method object A section of the payment method information.
type
* required
 string blik
customer * required
 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": []
    }
  }
}