Перейти к содержанию

Blik

Общий вариант интеграции

Оплата

Процесс оплаты

  1. Покупатель инициирует оплату на сайте торговца.
  2. Торговец отправляет PaySage.io запрос оплаты.
  3. PaySage.io присылает в ответе торговцу ссылку на страницу оплаты.
  4. Торговец перенаправляет покупателя на страницу оплаты.
  5. Покупатель завершает платёж.
  6. PaySage.io высылает торговцу автоматическое уведомление.

Info

 Этот вариант интеграции поддерживает только валюту `PLN`.
Запрос

Отправьте запрос оплаты, указав следующие дополнительные параметры:

object
amount
обязательный
bigInteger
Сумма транзакции в минимальных денежных единицах, например, 5000 (50 PLN).
currency
обязательный
string
PLN
description
обязательный
string(255)
Описание заказа.
return_url
обязательный
string
URL, на который будет возвращен покупатель после завершения транзакции в платёжной системе.
language
обязательный
string
Язык страницы оплаты. Доступные значения: en (английский), pl (польский), ua (украинский) и pt (португальский).
ip
обязательный
string
IP-адрес покупателя.
object
Секция параметров способа оплаты.
type
обязательный
string
blik
object
Секция информации о покупателе.
first_name
обязательный
string
Имя покупателя.
last_name
обязательный
string
Фамилия покупателя.
middle_name
string
Отчество покупателя.
external_id
string
Уникальный идентификатор покупателя в системе торговца.
country
обязательный
string
Страна покупателя в формате ISO 3166-1 alpha-2. Например, PL.
email
обязательный
string
Адрес электронной почты покупателя.
phone
обязательный
string
Номер телефона покупателя.
city
string
Город покупателя.
address
обязательный
string
Адрес покупателя.
zip
string
Почтовый индекс покупателя.
birth_date
обязательный
string
Дата рождения покупателя в формате ISO-8601 (YYYY-MM-DD).
Пример запроса
{
    "request": {
        "test": true,
        "amount": 1500,
        "currency": "PLN",
        "language": "en",
        "ip": "127.0.0.1",
        "description": "description",
        "return_url": "https://return.com",
        "method": {
            "type": "blik"            
        },
        "customer": {            
          "first_name": "John",
          "last_name": "Kohl",
          "middle_name": "James",
          "external_id": "123abc",
          "phone": "0123456789",
          "email": "email@example.com",
          "country": "GB",
          "city": "City",
          "address": "First street, 8",
          "zip": "10115",
          "birth-date": "1990-01-01"                     
        }
    }
}
Ответ

Перенаправьте покупателя с помощью данных form из ответа на запрос оплаты.

Пример ответа
{
  "transaction": {
    "uid": "193d6738-76de-4895-8ba7-bae9f445125d",
    "type": "payment",
    "status": "pending",
    "amount": 1500,
    "currency": "PLN",
    "description": "description",
    "created_at": "2025-01-23T14:01:09Z",
    "updated_at": "2025-01-23T14:01:09Z",
    "method_type": "blik",
    "receipt_url": "https://backoffice.paysage.io/customer/transactions/193d6738-76de-4895-8ba7-bae9f445125d/d7f9bf41df62deb99ce1bc97792e99e7d23fa72f4fef9270525a3a4a793d1e29?language=en",
    "payment": {
      "status": "pending",
      "gateway_id": 4879,
      "message": "Transaction was initialized."
    },
    "blik": {
      "type": "blik"
    },
    "customer": {
      "email": "test@example.com",
      "ip": null
    },
    "manually_corrected_at": null,
    "version": 0,
    "message": "Transaction was initialized.",
    "test": true,
    "language": "en",
    "billing_address": {
      "email": "test@example.com"
    },
    "additional_data": {
      "payment_method": {
        "type": "alternative"
      }
    },    
    "gateway": {
      "iframe": false
    },
    "form": {
      "action": "https://example/en/checkout?address=TGmEwV1RrNiF9f1Dk7By1Xk8F63P5jcbT1",
      "method": "GET",
      "fields": []
    }
  }
}
Пример ответа для варианта интеграции PW
{
    "transaction": {
        "uid": "ca03d661-39fd-46f7-bc05-2593da4596a8",
        "type": "payment",
        "status": "pending",
        "amount": 1000,
        "currency": "PLN",
        "description": "Order 1234",
        "created_at": "2026-10-29T13:27:02Z",
        "updated_at": "2026-10-29T13:27:02Z",
        "method_type": "blik",
        "receipt_url": "https://backoffice.paysage.io/customer/transactions/ca03d661-39fd-46f7-bc05-2593da4596a8/8f2b3d0751f71938b047b824098502f59260180219fcd83e5e404d878262c8cb",
        "payment": {
            "status": "pending",
            "gateway_id": 7644,
            "ref_id": "8465086589143191"
        },
        "blik": {
            "type": "blik"
        },
        "customer": {
            "zip": "00-669",
            "city": "Warsaw",
            "email": "anna@example.com",
            "phone": "+48500111222",
            "address": "Main Street 1",
            "country": "PL",
            "last_name": "Nowak",
            "birth_date": "1990-05-14",
            "first_name": "Anna",
            "external_id": "customer-1234",
            "ip": "203.0.113.10"
        },
        "manually_corrected_at": null,
        "version": 1,
        "test": false,
        "billing_address": {
            "zip": "00-669",
            "city": "Warsaw",
            "email": "anna@example.com",
            "phone": "+48500111222",
            "address": "Main Street 1",
            "country": "PL",
            "last_name": "Nowak",
            "birth_date": "1990-05-14",
            "first_name": "Anna"
        },
        "additional_data": {
            "payment_method": {
                "type": "alternative"
            }
        },
        "smart_routing_verification": {
            "status": "successful"
        },
        "gateway": {
            "iframe": false
        },
        "form": {
            "action": "link-to-payment-page",
            "fields": [
                {
                    "name": "data",
                    "value": "b5633b68-b81c-408a-b7d1-1f2a5a8f2436"
                },
                {
                    "name": "invoice_id",
                    "value": "a6c2af27-7581-40b7-9b9c-f8616f7918f5"
                },
                {
                    "name": "nonce",
                    "value": "5165d637b5b5887498f3dcd62447783c"
                },
                {
                    "name": "signature",
                    "value": "b5e4dc064829b80bfbaa2336c9cb4d65"
                },
                {
                    "name": "timestamp",
                    "value": "1788959232"
                }
            ],
            "method": "GET"
        }
    }
}

Возврат средств

Возвраты поддерживаются вариантами интеграции PW, PG и DC.

Запрос

Отправьте стандартный запрос возврата средств.

Для вариантов интеграции PG и ВС сумма возврата не должна превышать сумму родительской транзакции. Для одной транзакции оплаты можно совершить несколько транзакций возврата средств при условии, что сумма возвратов не превышает сумму соответствующей им родительской транзакции.

Для вариата интеграции PW cумма возврата должна быть равна сумме соответствующей транзакции оплаты.

Вариант интеграции MH

Оплата

Процесс оплаты

  1. Покупатель выбирает Blik в качестве способа оплаты на сайте торговца.
  2. Торговец отправляет PaySage.io запрос оплаты.
  3. PaySage.io присылает в ответе торговцу ссылку на страницу оплаты.
  4. Торговец перенаправляет покупателя на страницу оплаты.
  5. Покупатель совершает оплату.
  6. PaySage.io высылает торговцу автоматическое уведомление.
  7. Торговец отображает покупателю результат оплаты.

Info

 Этот вариант интеграции поддерживает только валюту `PLN` и `EUR`.
Запрос

Отправьте запрос оплаты, указав следующие дополнительные параметры:

object
return_url
обязательный
string
URL, на который будет возвращен покупатель после завершения транзакции в платёжной системе.
ip
string
IP-адрес покупателя.
object
Секция параметров способа оплаты.
type
обязательный
string
blik
user_id
обязательный
string
Уникальный идентификатор покупателя в системе торговца.
object
Секция информации о покупателе.
first_name
обязательный
string
Имя покупателя.
last_name
обязательный
string
Фамилия покупателя.
email
обязательный
string
Адрес электронной почты покупателя.
phone
обязательный
string
Номер телефона покупателя с кодом страны и без специальных символов.
country
обязательный
string
Страна покупателя в формате ISO 3166-1 alpha-2. Например, PL.
Пример запроса
{
  "request": {
    "amount": 500,
    "currency": "PLN",
    "description": "description",
    "test": true,
    "return_url": "https://return.com",          
    "language": "en",
    "customer": {
      "first_name": "John",
      "last_name": "Doe",
      "phone": "17777777777",
      "email": "example@example.com",
      "country": "PL"
    },
    "method": {
      "type": "blik",
      "user_id": "fdsaf345"
    }
  }
}
Ответ

Секция blik из ответа на запрос будет иметь те же параметры, что были присланы в запросе, а также дополнительную секцию form с необходимыми параметрами, чтобы сформировать веб-форму для осуществления оплаты.

Пример ответа
{
  "transaction": {
    "uid": "0c317a6e-6484-4d3f-9880-362e44a177b3",
    "type": "payment",
    "status": "pending",
    "amount": 500,
    "currency": "PLN",
    "description": "description",
    "created_at": "2024-03-14T12:52:34Z",
    "updated_at": "2024-03-14T12:52:34Z",
    "method_type": "blik",
    "receipt_url": "https://backoffice.paysage.io/customer/transactions/0c317a6e-6484-4d3f-9880-362e44a177b3/c464dc235b72b3cdf5cc5eee22493e13020bf89b1311aca6b9102a1f406a6d1d?language=en",
    "payment": {
      "status": "pending",
      "gateway_id": 3806,
      "ref_id": "1710420754629",
      "message": "Transaction was initialized",
      "rrn": 33761341
    },
    "blik": {
      "user_id": "fdsaf345",
      "type": "blik"
    },
    "customer": {
      "first_name": "John",
      "last_name": "Doe",
      "email": "example@example.com",
      "country": "PL",
      "phone": "17777777777",
      "ip": "null"
    },
    "manually_corrected_at": null,
    "message": "Transaction was initialized",
    "test": true,
    "language": "en",
    "billing_address": {
      "first_name": "John",
      "last_name": "Doe",
      "email": "example@example.com",
      "country": "PL",
      "phone": "17777777777"
    },
    "additional_data": {
      "payment_method": {
        "type": "alternative"
      }
    },
    "gateway": {
      "iframe": false
    },
    "form": {
      "action": "https://mh/v1/paymentpage/1298/1710420754629",
      "method": "GET",
      "fields": []
    }
  }
}

Вариант интеграции CA

Оплата

Процесс оплаты

  1. Покупатель инициирует оплату на сайте торговца.
  2. Торговец отправляет PaySage.io запрос оплаты.
  3. PaySage.io присылает в ответе торговцу ссылку на страницу оплаты.
  4. Торговец перенаправляет покупателя на страницу оплаты.
  5. Покупатель завершает платёж.
  6. PaySage.io высылает торговцу автоматическое уведомление.

Info

Этот вариант интеграции поддерживает только валюту PLN.

Запрос

Отправьте запрос оплаты, указав следующие дополнительные параметры:

object
return_url
обязательный
string
URL, на который будет возвращен покупатель после завершения транзакции в платёжной системе.
ip
обязательный
string
IP-адрес покупателя.
object
Секция параметров способа оплаты.
type
обязательный
string
blik
object
Секция информации о покупателе.
external_id
string (64)
Уникальный идентификатор покупателя в системе торговца.
first_name
обязательный
string (50)
Имя покупателя.
last_name
обязательный
string (50)
Фамилия покупателя.
email
обязательный
string
Адрес электронной почты покупателя.
phone
обязательный
string
Номер телефона покупателя.
country
обязательный
string
Страна покупателя в формате ISO 3166-1 alpha-2. Например, PL.
city
string (255)
Город покупателя.
address
string (255)
Адрес покупателя.
zip
string (10)
Почтовый индекс покупателя.
Пример запроса
{
  "request": {
    "amount": 1010,
    "currency": "PLN",
    "description": "description",
    "skip_duplicate_check": true,
    "test": false,
    "tracking_id": "189",
    "notification_url": "https://notification-url",
    "return_url": "https://return-url",
    "ip": "127.0.0.1",
    "language": "en",
    "customer": {
      "first_name": "John",
      "last_name": "Doe",      
      "country": "PL",
      "city": "Warsaw",
      "zip": "00-669",
      "email": "john@example.com",
      "address": "1st Street",
      "phone": "17777777777",     
      "external_id": "123bh7"      
    },
    "method": {
      "type": "blik"
    }
  }
}
Ответ

Отправьте покупателя на URL, указанный в параметре form.action.

Пример ответа
{
  "transaction": {
    "uid": "b9265cbb-1a18-4276-ba32-7508a93eec4d",
    "type": "payment",
    "status": "pending",
    "amount": 1010,
    "currency": "PLN",
    "description": "description",
    "created_at": "2026-04-23T13:57:16Z",
    "updated_at": "2026-04-23T13:57:16Z",
    "method_type": "blik",
    "receipt_url": "https://backoffice.paysage.io/customer/transactions/b9265cbb-1a18-4276-ba32-7508a93eec4d/3d8e6b0e0d2a8ef787d70cc3d150496681e7a1b388f4602c36e41e77cb37c673?language=en",
    "payment": {
      "status": "pending",
      "gateway_id": 6539,
      "ref_id": "ca096dc9-4924-4b67-869f-2ed3ace1c579",
      "message": "Transaction was initialized."
    },
    "blik": {
      "type": "blik",
      "use_pending_page": true
    },
    "customer": {
      "zip": "00-669",
      "city": "Warsaw",
      "email": "john@example.com",
      "phone": "17777777777",
      "address": "1st Street",
      "country": "PL",      
      "last_name": "Doe",
      "first_name": "John",
      "external_id": "123bh7",      
      "ip": "127.0.0.1"
    },
    "manually_corrected_at": null,
    "version": 2,
    "message": "Transaction was initialized.",
    "tracking_id": "189",
    "test": false,
    "language": "en",
    "billing_address": {
      "zip": "00-669",
      "city": "Warsaw",
      "email": "john@example.com",
      "phone": "17777777777",
      "address": "1st Street",
      "country": "PL",      
      "last_name": "Doe",
      "first_name": "John"
    },
    "additional_data": {
      "payment_method": {
        "type": "alternative"
      }
    },
    "smart_routing_verification": {
      "status": "successful"
    },
    "gateway": {
      "iframe": false
    },
    "form": {
      "action": "link-to-payment-page",
      "fields": [],
      "method": "GET"
    }
  }
} 

Вариант интеграции PFN

Оплата

Этот вариант интеграции поддерживает два сценария оплаты: с передачей BLIK-кода в запросе на оплату и с перенаправлением покупателя на страницу провайдера без передачи кода. Уточните в службе поддержки или у вашего менеджера, какой сценарий доступен для вашего магазина.

Сценарий оплаты с вводом BLIK-кода на странице торговца

  1. Покупатель инициирует оплату на сайте торговца и вводит 6-значный BLIK-код.
  2. Торговец отправляет PaySage.io запрос оплаты.
  3. PaySage.io отправляет ответ со статусом pending.
  4. Покупатель подтверждает оплату в мобильном приложении банка.
  5. PaySage.io отправляет торговцу автоматическое уведомление с финальным статусом платежа.

Сценарий оплаты с перенаправлением на страницу провайдера

  1. Покупатель инициирует оплату на сайте торговца.
  2. Торговец отправляет PaySage.io запрос оплаты.
  3. PaySage.io присылает в ответе торговцу ссылку на страницу оплаты.
  4. Торговец перенаправляет покупателя на страницу оплаты.
  5. Покупатель завершает платёж.
  6. PaySage.io высылает торговцу автоматическое уведомление.

Info

Этот вариант интеграции поддерживает только валюту PLN.

Запрос

Отправьте запрос оплаты, указав следующие дополнительные параметры:

object
ip
обязательный
string
IP-адрес покупателя.
return_url
обязательный
string
URL, на который будет возвращен покупатель после завершения транзакции в платёжной системе.
object
Секция параметров способа оплаты.
type
обязательный
string
blik
password
условно обязательный
string (6)
6-значный BLIK-код. Параметр обязателен, если для вашего магазина активирована опция оплаты без перенаправления на страницу провайдера. Уточните у службы поддержки или у вашего менеджера, активирована ли такая опция для вашего магазина.
object
Секция информации о покупателе.
external_id
обязательный
string
Уникальный идентификатор покупателя в системе торговца.
first_name
обязательный
string
Имя покупателя.
last_name
обязательный
string
Фамилия покупателя.
birth_date
обязательный
string
Дата рождения покупателя в формате ISO-8601 (YYYY-MM-DD).
email
обязательный
string
Адрес электронной почты покупателя.
phone
обязательный
string
Номер телефона покупателя с кодом страны без + и без пробелов. Например, 48500111222.
city
обязательный
string
Город покупателя.
address
обязательный
string
Адрес покупателя.
zip
обязательный
string
Почтовый индекс покупателя.
Пример запроса
{
  "request": {
    "amount": 100,
    "currency": "PLN",
    "description": "Order description",    
    "test": false,
    "tracking_id": "Tracking-123",
    "notification_url": "https://example.com/notification",
    "return_url": "https://example.com/return",
    "ip": "127.0.0.1",
    "language": "en",
    "customer": {
      "first_name": "John",
      "last_name": "Doe",
      "birth_date": "1990-01-25",
      "email": "john@example.com",
      "phone": "48500111222",          
      "city": "Warsaw",
      "address": "Main Str. 1",
      "zip": "00669",
      "external_id": "123bh7"
    },
    "method": {
      "type": "blik",
      "password": "123456"
    }
  }
}
Ответ
Пример ответа
{
    "transaction": {
        "uid": "0fa0eb13-d58b-4cac-b39a-0fb9604410e6",
        "type": "payment",
        "status": "pending",
        "amount": 100,
        "currency": "PLN",
        "description": "Order description",
        "created_at": "2026-09-30T08:18:04Z",
        "updated_at": "2026-09-30T08:18:04Z",
        "method_type": "blik",
        "receipt_url": "https://backoffice.paysage.io/customer/transactions/0fa0eb13-d58b-4cac-b39a-0fb9604410e6/ba9a1640045b7feca38c200475eb1cf2f16e2f779e0ecaa0111b1b2d2d8d0262?language=en",
        "payment": {
            "status": "pending",
            "gateway_id": 7371,
            "ref_id": "665735860496205854",
            "message": "Transaction was initialized."
        },
        "blik": {
            "type": "blik"
        },
        "customer": {
            "zip": "00669",
            "city": "Warsaw",
            "email": "john@example.com",
            "phone": "48500111222",
            "address": "Main Str. 1",                
            "last_name": "Doe",
            "birth_date": "1990-01-25",
            "first_name": "John",
            "external_id": "123bh7",
            "ip": "127.0.0.1"
        },
        "manually_corrected_at": null,
        "version": 1,
        "message": "Transaction was initialized.",
        "tracking_id": "Tracking-123",
        "test": false,
        "language": "en",
        "billing_address": {
            "zip": "00669",
            "city": "Warsaw",
            "email": "john@example.com",
            "phone": "48500111222",
            "address": "Main Str. 1",               
            "last_name": "Doe",
            "birth_date": "1990-01-25",
            "first_name": "John"
        },
        "additional_data": {
            "payment_method": {
                "type": "alternative"
            }
        },
        "smart_routing_verification": {
            "status": "skipped"
        },
        "gateway": {
            "iframe": false
        }
    }
}

Вариант интеграции APR

Оплата

Процесс оплаты

  1. Покупатель инициирует оплату на сайте торговца и вводит 6-значный BLIK-код.
  2. Торговец отправляет PaySage.io запрос оплаты.
  3. PaySage.io отправляет ответ со статусом pending.
  4. Покупатель подтверждает оплату в мобильном приложении банка.
  5. PaySage.io отправляет торговцу автоматическое уведомление с финальным статусом платежа.

Info

Этот вариант интеграции поддерживает только валюту PLN.

Запрос

Отправьте запрос оплаты, указав следующие данные:

object
amount
обязательный
bigInteger
Сумма транзакции в минимальных денежных единицах, например, 5000 (50 PLN).
currency
обязательный
string
PLN.
description
обязательный
string
Описание заказа.
return_url
обязательный
string
URL, на который будет возвращен покупатель после завершения транзакции в платёжной системе.
object
Секция параметров способа оплаты.
type
обязательный
string
blik.
password
обязательный
string (6)
6-значный BLIK-код.
object
Секция информации о покупателе.
external_id
обязательный
string (255)
Уникальный идентификатор покупателя в системе торговца.
first_name
обязательный
string (60)
Имя покупателя.
last_name
обязательный
string (60)
Фамилия покупателя.
birth_date
обязательный
string
Дата рождения покупателя в формате ISO-8601 (YYYY-MM-DD).
email
обязательный
string
Адрес электронной почты покупателя.
phone
обязательный
string (200)
Номер телефона покупателя с кодом страны без + и без пробелов. Например, 48500111222.
city
обязательный
string (120)
Город покупателя.
address
обязательный
string (510)
Адрес покупателя.
zip
обязательный
string (40)
Почтовый индекс покупателя.
Пример запроса
{
  "request": {
    "amount": 100,
    "currency": "PLN",
    "description": "Заказ 1234",
    "return_url": "https://example.com/return",
    "customer": {
      "external_id": "customer-1234",
      "first_name": "Anna",
      "last_name": "Nowak",
      "birth_date": "1990-01-25",
      "email": "anna@example.com",
      "phone": "48500111222",
      "city": "Warsaw",
      "address": "Main Street 1",
      "zip": "00669"
    },
    "method": {
      "type": "blik",
      "password": "123456"
    }
  }
}
Ответ

Сначала платёж получает статус pending. Покупатель подтверждает оплату в мобильном приложении банка. Финальный статус придёт в автоматическом уведомлении.

Пример ответа
{
    "transaction": {
        "uid": "0be95466-c46d-47d8-a1d9-e7570ed65316",
        "type": "payment",
        "status": "pending",
        "amount": 100,
        "currency": "PLN",
        "description": "Order 1234",
        "created_at": "2026-10-02T09:14:27Z",
        "updated_at": "2026-10-02T09:14:27Z",
        "method_type": "blik",
        "receipt_url": "https://backoffice.paysage.io/customer/transactions/0be95466-c46d-47d8-a1d9-e7570ed65316/d5da7a2d71df1bba2fefb78f9bf059a25d42ff8bd14b3cff02fa934c09245342",
        "payment": {
            "status": "pending",
            "gateway_id": 7494,
            "ref_id": "30066568314",
            "message": "Transaction was initialized."
        },
        "blik": {
            "type": "blik"
        },
        "customer": {
            "zip": "00669",
            "city": "Warsaw",
            "email": "anna@example.com",
            "phone": "48500111222",
            "address": "Main Street 1",
            "last_name": "Nowak",
            "birth_date": "1990-01-25",
            "first_name": "Anna",
            "external_id": "customer-1234",
            "ip": null
        },
        "manually_corrected_at": null,
        "version": 1,
        "message": "Transaction was initialized.",
        "test": false,
        "billing_address": {
            "zip": "00669",
            "city": "Warsaw",
            "email": "anna@example.com",
            "phone": "48500111222",
            "address": "Main Street 1",
            "last_name": "Nowak",
            "birth_date": "1990-01-25",
            "first_name": "Anna"
        },
        "additional_data": {
            "payment_method": {
                "type": "alternative"
            }
        },
        "smart_routing_verification": {
            "status": "skipped"
        },
        "gateway": {
            "iframe": true
        }
    }
}

Вариант интеграции PPZ

Оплата

Процесс оплаты

  1. Покупатель инициирует оплату на сайте торговца и вводит шестизначный BLIK-код.
  2. Торговец отправляет PaySage.io запрос оплаты.
  3. PaySage.io отправляет ответ со статусом pending.
  4. Покупатель подтверждает оплату в мобильном приложении банка.
  5. PaySage.io отправляет торговцу автоматическое уведомление с финальным статусом платежа. Торговец также может отправить запрос получения статуса транзакции.

Info

Этот вариант интеграции поддерживает только валюту PLN. Минимальная сумма оплаты — 5 PLN.

Запрос

Отправьте запрос оплаты со следующими данными:

object
amount
обязательный
bigInteger
Сумма транзакции в минимальных денежных единицах, например, 500 (5 PLN).
currency
обязательный
string (3)
PLN.
return_url
обязательный
string
URL, на который будет возвращен покупатель после завершения транзакции.
description
обязательный
string
Описание заказа.
ip
обязательный
string
IP-адрес покупателя.
object
Секция параметров способа оплаты.
type
обязательный
string
blik.
password
обязательный
string (6)
Шестизначный BLIK-код.
object
Секция информации о покупателе.
first_name
обязательный
string (60)
Имя покупателя.
last_name
обязательный
string (60)
Фамилия покупателя.
email
обязательный
string
Адрес электронной почты покупателя.
external_id
string (255)
Идентификатор покупателя в системе торговца.
phone
string (200)
Номер телефона покупателя, включая код страны.
address
string (510)
Платёжный адрес покупателя.
city
string (120)
Город покупателя.
state
string (40)
Штат или регион покупателя. Обязателен, если значение customer.country — AU, US или CA.
zip
string (40)
Почтовый индекс покупателя.
country
string (2)
Страна покупателя в формате ISO 3166-1 alpha-2.
object
Секция дополнительных данных оплаты.
object
Секция данных браузера.
user_agent
обязательный
string
Строка агента пользователя текущего браузера. Соответствует параметру navigator.userAgent в JavaScript.
Пример запроса
{
    "request": {
        "amount": 500,
        "currency": "PLN",
        "return_url": "https://example.com/return",
        "description": "Order 1234",
        "ip": "203.0.113.10",
        "method": {
            "type": "blik",
            "password": "123456"
        },
        "customer": {
            "first_name": "Anna",
            "last_name": "Nowak",
            "email": "anna@example.com",
            "external_id": "customer-1234",
            "phone": "+48500111222",
            "address": "Main Street 1",
            "city": "Warsaw",
            "zip": "00-669",
            "country": "PL"
        },
        "additional_data": {
            "browser": {
                "user_agent": "Mozilla/5.0 (iPhone)"
            }
        }
    }
}
Ответ

Сначала платёж получает статус pending. Покупатель подтверждает оплату в мобильном приложении банка. Получите финальный статус из автоматического уведомления или с помощью запроса получения статуса транзакции.

Пример ответа
{
    "transaction": {
        "uid": "68c9b124-8c36-4cfb-bbba-4b6f39efe30f",
        "type": "payment",
        "status": "pending",
        "amount": 500,
        "currency": "PLN",
        "description": "Order 1234",
        "created_at": "2026-10-02T14:59:05Z",
        "updated_at": "2026-10-02T14:59:06Z",
        "method_type": "blik",
        "receipt_url": "https://backoffice.paysage.io/customer/transactions/68c9b124-8c36-4cfb-bbba-4b6f39efe30f/22fd22ec6dedc1d8e83fa0300a749dd4cdfb9bc2d1563b1f502f0f7dc9e6973d",
        "payment": {
            "status": "pending",
            "gateway_id": 7514,
            "ref_id": "248797710577",
            "message": "Transaction was initialized."
        },
        "blik": {
            "type": "blik"
        },
        "customer": {
            "zip": "00-669",
            "city": "Warsaw",
            "email": "anna@example.com",
            "phone": "+48500111222",
            "address": "Main Street 1",
            "country": "PL",
            "last_name": "Nowak",
            "first_name": "Anna",
            "external_id": "customer-1234",
            "ip": "203.0.113.10"
        },
        "manually_corrected_at": null,
        "version": 1,
        "message": "Transaction was initialized.",
        "test": false,
        "billing_address": {
            "zip": "00-669",
            "city": "Warsaw",
            "email": "anna@example.com",
            "phone": "+48500111222",
            "address": "Main Street 1",
            "country": "PL",
            "last_name": "Nowak",
            "first_name": "Anna"
        },
        "additional_data": {
            "browser": {
                "user_agent": "Mozilla/5.0 (iPhone)"
            },
            "payment_method": {
                "type": "alternative"
            }
        },
        "smart_routing_verification": {
            "status": "skipped"
        },
        "gateway": {
            "iframe": false
        }
    }
}

Возврат средств

Запрос

Отправьте стандартный запрос возврата средств. Сумма возврата должна быть равна сумме соответствующей транзакции оплаты. Для одной транзакции оплаты возможен только один полный возврат средств.