Войти

Документация API
  • Главная
  • Получение ключей APIФормат запроса
  • Платежи
    Начало работы Создание платежа Создание статического кошелька Сгенерировать QR-код Заблокировать статический кошелек Осуществление возврата если кошелек заблокирован Информация о платеже Возврат Повторно отправить webhook Тестовый webhook Список сервисов История платежей Webhook Статусы платежей Ссылки AML
    Выплаты
    Начало работы Расчет суммы снятия Создание выплаты Информация о выплате История выплат Статусы выплат 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Достаточно ли элементов для разделения на несколько страниц (true / false)
nextCursorstring / nullКурсор на следующую страницу
previousCursorstring / nullКурсор на предыдущую страницу
perPageintegerМаксимальное количество элементов на странице

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

integer

Описание

Количество элементов на текущей странице

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

boolean

Описание

Достаточно ли элементов для разделения на несколько страниц (true / false)

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

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}
Копировать