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.
method object A section of the payment method information.
type * required
 string blik
Request example 
{
    "request": {              
        "amount": 5000,
        "currency": "PLN",
        "description": "description",
        "return_url": "https://return.com",
        "method": {
            "type": "blik"
        }
    }
}
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": []
    }
  }
}