aioheleket

Asynchronous Python library for Heleket crypto payments.

pip

pip install aioheleket

uv

uv pip install aioheleket

Documentation

Official Heleket documentation

Features

See examples

Creating payment

import asyncio

from aioheleket import HeleketClient, Currency, Network, Lifetime

async def main() -> None:
    client = HeleketClient(
        merchant_id="<merchant_id>",
        payment_api_key="<payment_api_key>"
    )
    payment_service = await client.payment()
    payment = await payment_service.create_invoice(
        currency=Currency.USDT,
        network=Network.ETH,
        order_id="order_3331",
        amount="2",
        lifetime_sec=Lifetime.HOUR_2
    )
    print(payment.url, payment.uuid)

    await client.close_session()  # <!>

if __name__ == "__main__":
    asyncio.run(main())

Transfer funds from a business wallet to a personal wallet

import asyncio

from aioheleket import HeleketClient, Currency

async def main() -> None:
    client = HeleketClient(
        merchant_id="<merchant_id>",
        payout_api_key="<payout_api_key>"
    )
    payout_service = await client.payout()
    transfer = await payout_service.personal_transfer(
        currency=Currency.USDT,
        amount="4"
    )
    print(transfer.user_wallet_transaction_uuid, transfer.user_wallet_balance)
    
    await client.close_session()  # <!>
    
if __name__ == "__main__":
    asyncio.run(main())

Creating static wallet

import asyncio

from aioheleket import HeleketClient, Network, Currency

async def main() -> None:
    client = HeleketClient(
        merchant_id="<merchant_id>",
        payment_api_key="<payment_api_key>"
    )
    wallet_service = await client.static_wallet()
    wallet = await wallet_service.create(
        currency=Currency.USDT,
        network=Network.ETH,
        order_id="wal_7342"
    )
    print(wallet.uuid, wallet.url)
    
    await client.close_session()  # <!>
    
if __name__ == "__main__":
    asyncio.run(main())

Get the current exchange rate

import asyncio

from aioheleket import HeleketClient, Currency

async def main() -> None:
    client = HeleketClient(
        merchant_id="<merchant_id>",
        payment_api_key="<payment_api_key>"
    )
    finance_service = await client.finance()
    rates = await finance_service.exchange_rate(Currency.BTC, ("RUB", Currency.TRX, "KZT"))
    print(rates)  # output BTC exchange rate only for RUB, KZT, TRX
    all_rates = await finance_service.exchange_rate(Currency.BTC)
    print(all_rates)  # output all exchange rate for BTC
    
    await client.close_session()  # <!>
    
if __name__ == "__main__":
    asyncio.run(main())