Log in

API Documentation
  • Main
  • Getting API keysRequest format
  • Payments
    Getting started Creating an invoice Creating a Static wallet Generate a QR-code Block static wallet Refund payments on blocked address Payment information Refund Resend webhook Testing webhook List of services Payment history Webhook Payment statuses AML links
    Payouts
    Getting started Calculation of the withdrawal amount Creating a payout Payout information Payout history Payout statuses Webhook List of services Transfer to personal wallet Transfer to business wallet
  • PHP SDK
  • CMS Modules
  • Discount Payment
    List of discounts Set discount to payment method
  • Exchange rates listBalanceReference

Main

/

Payouts

/

Payout history

FAQAPIContacts

Ⓒ 2026 Heleket

Privacy policy

Terms of use

AML

FAQAPIContacts

Payout history

post
https://api.heleket.com/v1/payout/list
Copy

Request

Query parameters

NameParameter typeDefault valueDefinition
date_fromstringformat: YYYY-MM-DD H:mm:ssnullFiltering by creation date, from
date_tostringformat: YYYY-MM-DD H:mm:ssnullFiltering by creation date, to

Parameter type

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

Definition

Filtering by creation date, from

Parameter type

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

Definition

Filtering by creation date, to

Request example


curl https://api.heleket.com/v1/payout/list \
-X POST \
-H 'merchant: 8b03432e-385b-4670-8d06-064591096795' \
-H 'sign: f80fa426a89eb62bd53997326865d850' \
-H 'Content-Type: application/json'
Copy

To filter payouts by creation date from may 4 to may 16.


curl https://api.heleket.com/v1/payout/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"
}'
Copy

Response

Response parameters

NameDefinition
merchant_uuidMerchant's Uuid
itemsArray of Payouts. Structure
paginateData for pagination. Structure

Definition

Merchant's Uuid

Definition

Array of Payouts. Structure

Definition

Data for pagination. Structure

Structure of item

NameDefinition
uuiduuid of the payout
amountPayout amount in currency
currencyCurrency code for the payout
networkThe code of the blockchain network in which the payout is made
addressThe address of the wallet to which the payment is made
txidTransaction ID in the blockchain
statusPayout status statuses
is_finalWhether the payout is finalizedThe payout process is considered finalized once it has been successfully paid or if it has failed. In the event of a payout failure, the funds will be returned to your balance, requiring you to initiate the payout process again.
balanceThe remaining funds on the merchant's wallet.
created_atCreation date of the payout. Timezone is UTC+3
updated_atLast payout updated date. Timezone is UTC+3

Definition

uuid of the payout

Definition

Payout amount in currency

Definition

Currency code for the payout

Definition

The code of the blockchain network in which the payout is made

Definition

The address of the wallet to which the payment is made

Definition

Transaction ID in the blockchain

Definition

Payout status statuses

Definition

Whether the payout is finalizedThe payout process is considered finalized once it has been successfully paid or if it has failed. In the event of a payout failure, the funds will be returned to your balance, requiring you to initiate the payout process again.

Definition

The remaining funds on the merchant's wallet.

Definition

Creation date of the payout. Timezone is UTC+3

Definition

Last payout updated date. Timezone is UTC+3
To get next/previous page entries, specify the next/previous cursor hash in the query parameters (?cursor=nextCursorHash)

Example:


1curl https://api.heleket.com/v1/payout/list?cursor=eyJpZCI6MjEyLCJf cG9pbnRzVzVG9OZXh0SXRlbXMiOnRydWV9 \
2-X POST \
3-H 'merchant: cb2131ff-a3d4-46dd-94c6-3714fae65f89' \
4-H 'sign: f80fa426a89eb62bd53997326865d850' \
5-H 'Content-Type: application/json' \
6
Copy

Response example


1{
2"state": 0,
3"result": {
4	"items": [{
5		"uuid": "a7c0caec-a594-4aaa-b1c4-77d511857594",
6		"amount": "3",
7		"currency": "USDT",
8		"network": "TRON",
9		"address": "TJ...",
10		"txid": null,
11		"status": "process",
12		"is_final": false,
13		"balance": "129.00000000",
14		"created_at": "2023-06-21T17:25:55+03:00",
15		"updated_at": "2023-06-21T17:34:38+03:00"
16	}, {
17		"uuid": "92c39264-d180-4503-9c16-ee16f083bbb8",
18		"amount": "5.40000000",
19		"currency": "DOGE",
20		"network": "doge",
21		"address": "DEw8CJLfxg9fhumeXP1zvVNjZicsqtDv7V",
22		"txid": "5e5810946152ea569d2a2aa9aa32a45c0e4223a4f9aad8e31d2fc660d2cdedb8",
23		"order_id": null,
24		"payment_status": null,
25		"status": "paid",
26		"is_final": true,
27		"balance": "26.77966652",
28		"created_at": "2023-07-21T17:25:55+03:00",
29		"updated_at": "2023-07-21T17:34:38+03:00"
30	},
31	...
32	],
33	"paginate": {
34		"count": 15,
35		"hasPages": true,
36		"nextCursor": "eyJpZCI6MjkxNTU0MywiX3BvaW50c1RvTmV4dEl0ZW1zIjp0cnVlfQ",
37		"previousCursor": null,
38		"perPage": 15
39	}
40}
41}
Copy

Possible errors

Validation errors

code : 422

example responses:

If the date_from or date_to parameter is passed in the wrong format.


1{
2	"state": 1,
3	"errors": {
4	"date_from": ["validation.regex"]
5	}
6}
Copy