Blik
Вариант интеграции QP
Оплата
Процесс оплаты
- Покупатель инициирует оплату на сайте торговца.
- Торговец отправляет Freepayment запрос оплаты.
- Freepayment присылает в ответе торговцу ссылку на страницу оплаты.
- Торговец перенаправляет покупателя на страницу оплаты.
- Покупатель завершает оплату.
Info
Этот вариант интеграции поддерживает только валюту PLN.
Запрос
Отправьте запрос оплаты, указав следующие дополнительные параметры:
|
|||||||||||||||||||||||||||
Пример запроса
{
"request":{
"amount":13500,
"currency":"PLN",
"description":"description",
"test":false,
"tracking_id":"your_uniq_number",
"language":"en",
"notification_url":"https://example.com/notification",
"return_url":"https://example.com/return/",
"ip": "127.200.00.0",
"customer":{
"email":"jan@example.com",
"first_name": "Jan",
"last_name" : "Kowalski"
},
"method":{
"type":"blik"
}
}
}
Ответ
Отправьте покупателя на URL, указанный в параметре form.action.
Пример ответа
{
"transaction": {
"uid": "9b32fcba-f5eb-47bf-9ae5-4bbb8cf10072",
"type": "payment",
"status": "pending",
"amount": 13500,
"currency": "PLN",
"description": "description",
"created_at": "2024-10-09T12:29:57Z",
"updated_at": "2024-10-09T12:29:59Z",
"method_type": "blik",
"receipt_url": "https://account.freepayment.online/customer/transactions/9b32fcba-f5eb-47bf-9ae5-4bbb8cf10072/042ad10c16b31828f97ea0e3a71c3371f6f1653a1100ba4e5ab3b00586dbeaaf?language=en",
"payment": {
"status": "pending",
"gateway_id": 4544,
"message": "Transaction was initialized.",
"bank_code": ""
},
"blik": {
"type": "blik"
},
"customer": {
"first_name": "Jan",
"last_name": "Kowalski",
"email": "jan@example.com",
"ip": "127.200.00.0"
},
"manually_corrected_at": null,
"version": 0,
"message": "Transaction was initialized.",
"tracking_id": "your_uniq_number",
"test": false,
"language": "en",
"billing_address": {
"first_name": "Jan",
"last_name": "Kowalski",
"email": "jan@example.com"
},
"additional_data": {
"payment_method": {
"type": "alternative"
}
},
"gateway": {
"iframe": false
},
"form": {
"action": "https://payment-page/redirect/to/269/251354/01T7HwrLOiTpujB6lpX6eiGOJruWdKbLr4iY4cpfvlTRceqsrXDy3UH7_9VU5r9ECz",
"method": "GET",
"fields": []
}
}
}
Вариант интеграции SS
Оплата
Процесс оплаты
- Покупатель инициирует оплату на сайте торговца.
- Торговец отправляет Freepayment запрос оплаты.
- Freepayment присылает в ответе торговцу ссылку на страницу оплаты.
- Торговец перенаправляет покупателя на страницу оплаты.
- Покупатель завершает платёж.
- Freepayment высылает торговцу автоматическое уведомление.
Info
Этот вариант интеграции поддерживает только валюту PLN.
Запрос
Отправьте запрос оплаты, указав следующие дополнительные параметры:
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||
Пример запроса
{
"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
}
}
}
}
Ответ
Отправьте покупателя на URL, указанный в параметре form.action.
Пример ответа
{
"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://account.freepayment.online/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": []
}
}
}