Увійти

Документація API
  • Головний
  • Отримання ключів APIФормат запиту
  • Виплати
    Починаємо Створення рахунку -фактури Створення статичного гаманця Генерувати QR-код Блокуйте статичний гаманець Повернення платежів за заблокованою адресою Інформація про оплату Повернути Зустріньте WebHook Тестовий webhook Список послуг Історія платежів Webhook Статус платежу Посилання на боротьбу з відмиванням грошей
    Виплата
    Починаємо Розрахунок суми виведення Створення виплат Інформація про виплату Історія виплат Статус виплат Webhook Список послуг Перекладіть на особистий гаманець Перейдіть на бізнес -гаманець
  • PHP SDK
  • Модулі CMS
  • Оплата знижок
    Список знижок Встановіть знижку на метод оплати
  • Список обмінних курсівБалансуватиДовідник

Головний

/

Виплати

/

Історія платежів

FAQAPIКонтакти

Ⓒ 2026 Heleket

Privacy policy

Terms of use

AML

FAQAPIКонтакти

Історія платежів

Повертає список рахунків -фактур

post
https://api.heleket.com/v1/payment/list
Копіювати

Прохання

Параметри запиту

НазваТип параметраЗначення за замовчуваннямВизначення
date_fromstringformat: YYYY-MM-DD H:mm:ssnullФільтрування за датою створення, від
date_tostringformat: YYYY-MM-DD H:mm:ssnullФільтрування за датою створення, до

Тип параметра

stringformat: YYYY-MM-DD H:mm:ss

Визначення

Фільтрування за датою створення, від

Тип параметра

stringformat: YYYY-MM-DD H:mm:ss

Визначення

Фільтрування за датою створення, до

Приклад запиту


curl https://api.heleket.com/v1/payment/list \
-X POST \
-H 'merchant: 8b03432e-385b-4670-8d06-064591096795' \
-H 'sign: f80fa426a89eb62bd53997326865d850' \
-H 'Content-Type: application/json' \
Копіювати

Фільтрувати рахунки -фактури до дати створення з 4 по 16 травня.


curl https://api.heleket.com/v1/payment/list \
-X POST \
-H 'merchant: 8b03432e-385b-4670-8d06-064591096795' \
-H 'sign: f80fa426a89eb62bd53997326865d850' \
-H 'Content-Type: application/json' \
-d '{
	"date_from": "2023-05-04 00:00:00"
	"date_to": "2023-05-16 23:59:59"
}'
Копіювати

Реакція

Параметри відповіді

НазваВизначення
itemsМасив рахунків -фактур. Структура предмета
paginate

Визначення

Масив рахунків -фактур. Структура предмета

Визначення

Структура пагінувати

НазваТип параметраВизначення
countintegerКількість елементів на поточній сторінці
hasPagesbooleanЧи достатньо елементів, щоб розділити на кілька сторінок (правда / хибна)
nextCursorstring / nullКурсор на наступну сторінку
previousCursorstring / nullКурсор на попередню сторінку
perPageintegerМаксимальна кількість елементів на сторінку

Тип параметра

integer

Визначення

Кількість елементів на поточній сторінці

Тип параметра

boolean

Визначення

Чи достатньо елементів, щоб розділити на кілька сторінок (правда / хибна)

Тип параметра

string / null

Визначення

Курсор на наступну сторінку

Тип параметра

string / null

Визначення

Курсор на попередню сторінку

Тип параметра

integer

Визначення

Максимальна кількість елементів на сторінку
Щоб отримати наступні/попередні записи сторінки, вкажіть наступний/попередній хеш -курсор у параметрах запиту (?cursor=nextCursorHash)

Приклад:


1curl https://api.heleket.com/v1/payment/list?cursor=eyJpZCI6MjEyLCJ fcG9pbnRzVzVG9OZhXh0SXRlbXMiOnRydWV9 \
2-X POST \
3-H 'merchant: 8b03432e-385b-4670-8d06-064591096795' \
4-H 'sign: f80fa426a89eb62bd53997326865d850' \
5-H 'Content-Type: application/json' \
6
Копіювати

Приклад відповіді


1{
2	"state": 0,
3	"result": {
4		"items": [{
5			"uuid": "ac1af391-8e98-4335-b9d7-7b6f6b40f268",
6			"order_id": "20fe59c4601dd174985e497e3f6bbcd2",
7			"amount": "20.00",
8			"payment_amount": "0.00000000",
9			"payer_amount": "0.00064860",
10			"discount_percent": 0,
11			"discount": "0.00000000",
12			"payer_currency": "BTC",
13			"currency": "USD",
14			"merchant_amount": null,
15			"comments": null,
16			"network": "btc",
17			"address": "bc1qxm6ehuy6mz2l2h3ag88frcjvl2xxlr9hvnq835",
18			"from": null,
19			"txid": null,
20			"payment_status": "cancel",
21			"url": "https:\/\/pay.heleket.com\/pay\/ac1af391-8e98-4335-b9d7-7b6f6b40f268",
22			"expired_at": 1689172103,
23			"status": "cancel",
24			"is_final": true,
25			"additional_data": null,
26			"created_at": "2023-07-12T16:28:24+03:00",
27			"updated_at": "2023-07-12T17:30:16+03:00"
28		}, {
29			"uuid": "1bb48358-2905-4e98-b681-5f1948e818d1",
30			"order_id": "a3329f462eb036dad12b5409147809a3",
31			"amount": "15.00",
32			"payment_amount": "0.00",
33			"payer_amount": "14.25",
34			"discount_percent": 5,
35			"discount": "0.75",
36			"payer_currency": "USDT",
37			"currency": "USDT",
38			"merchant_amount": "15.43500000",
39			"comments": null,
40			"network": "tron",
41			"address": "TSChodGNEJ6D31d9uueFxJAVH9NxiJjTwC",
42			"from": null,
43			"txid": null,
44			"payment_status": "cancel",
45			"url": "https:\/\/pay.heleket.com\/pay\/1bb48358-2905-4e98-b681-5f1948e818d1",
46			"expired_at": 1689099958,
47			"status": "cancel",
48			"is_final": true,
49			"additional_data": null,
50			"created_at": "2023-07-11T20:25:58+03:00",
51			"updated_at": "2023-07-11T21:26:18+03:00"
52		}, {
53			"uuid": "70b8db5c-b952-406d-af26-4e1c34c27f15",
54			"order_id": "65bbe87b4098c17a31cff3e71e515243",
55			"amount": "15.00",
56			"payment_amount": "0.00",
57			"payer_amount": "15.75",
58			"discount_percent": -5,
59			"discount": "-0.75",
60			"payer_currency": "USDT",
61			"currency": "USDT",
62			"merchant_amount": "15.43500000",
63			"comments": null,
64			"network": "tron",
65			"address": "TXhfYSWt2oKRrHAJVJeYRuit6ZzKuoEKXj",
66			"from": null,
67			"txid": null,
68			"payment_status": "cancel",
69			"url": "https:\/\/pay.heleket.com\/pay\/70b8db5c-b952-406d-af26-4e1c34c27f15",
70			"expired_at": 1689099831,
71			"status": "cancel",
72			"is_final": true,
73			"additional_data": null,
74			"created_at": "2023-07-11T20:23:52+03:00",
75			"updated_at": "2023-07-11T21:24:17+03:00"
76		},
77		...
78],
79		"paginate": {
80			"count": 15,
81			"hasPages": true,
82			"nextCursor": "eyJpZCI6MjkxNTU0MywiX3BvaW50c1RvTmV4dEl0ZW1zIjp0cnVlfQ",
83			"previousCursor": null,
84			"perPage": 15
85		}
86	}
87}
Копіювати

Можливі помилки

Помилки перевірки

кодування : 422

Приклад відповіді:

Якщо date_from або параметр Date_to передається в неправильному форматі:


1{
2	"state": 1,
3	"errors": {
4		"date_from": ["validation.regex"]
5	}
6}
Копіювати