Transfer to Personal Wallet — guide to sending funds

Main

Payouts

Transfer to personal wallet

Transfer funds from your business wallet to your personal wallet

post

https://api.heleket.com/v1/transfer/to-personal

Copy

Request

Query parameters

Name	Parameter type	Definition
amount*	string	Amount to transfer
currency*	string	Currency code. Only cryptocurrency code is allowed.

Parameter type string Definition Amount to transfer
Parameter type string Definition Currency code. Only cryptocurrency code is allowed.

* - mandatory parameter

Request example


curl https://api.heleket.com/v1/transfer/to-personal \
-X POST \
-H 'merchant: 8b03432e-385b-4670-8d06-064591096795' \
-H 'sign: fe99035f86fa436181717b302b95bacff1' \
-H 'Content-Type: application/json' \
-d '{
        "amount": "15",
        "currency": "USDT"
    }'

Copy

Response

Response parameters

Name	Definition
user_wallet_transaction_uuid	Uuid of Personal wallet transaction
user_wallet_balance	Personal wallet balance
merchant_transaction_uuid	Uuid of Business wallet transaction
merchant_balance	Business wallet balance

Definition Uuid of Personal wallet transaction
Definition Personal wallet balance
Definition Uuid of Business wallet transaction
Definition Business wallet balance

Response example


1{
2	"state": 0,
3	"result": {
4		"user_wallet_transaction_uuid": "26109ba0-b05b-4ee0-93d1-fd62c822ce95",
5		"user_wallet_balance": "15.00000000",
6		"merchant_transaction_uuid": "95bfcabb-a0ab-48f1-80b3-ce3bc2dbb653",
7		"merchant_balance": "20.00000000"
8	}
9}

Copy

Possible errors

Validation errors

code : 422

example responses:

If some parameter is required and not passed:


1{
2	"state": 1,
3	"errors": {
4		"amount": ["validation.required"]
5	}
6}

Copy

If the payout is blocked on your user, you will receive this error message. This happens, for example, when you change your password and payouts are blocked for 24 hours.


1{
2    "state": 1,
3    "message": "You are forbidden"
4}

Copy

If there is no active personal wallet with provided currency:


1{
2    "state": 1,
3    "message": "No found user wallet"
4}

Copy

If there are not enough funds on your personal wallet to transfer the amount:


1{
2    "state": 1,
3    "message": "Not enough funds"
4}

Copy

If the transfer amount is less than the minimum supported amount for cryptocurrency, you will receive this error message


1{
2    "state": 1,
3    "message": "Minimum amount 0.5 USDT"
4}

Copy

If the transfer amount is greater than the maximum supported amount for cryptocurrency, you will receive this error message:


1{
2    "state": 1,
3    "message": "Maximum amount 10000000 USDT"
4}

Copy

Internal server error

code : 500

example responses:


1{
2	"message": "Server error, #1",
3	"code": 500,
4	"error": null
5}

Copy