Platforms and integrators
A top-up API for your shop, your bot or your platform
Connect your system server to server and sell the Hexz Distribution catalog without opening the portal: read the catalog and balance, create orders and get notified when they are delivered.
Catalog with your price
GET /catalog returns your products with your current price, their region and the data each one needs.
No duplicate orders
Every order carries an Idempotency-Key: if you repeat the request, you get the same order and it is not charged twice.
Check the ID first
POST /player/validate checks the player ID and, when possible, returns the account name.
Signed webhooks
We notify you right away when an order is delivered, partially delivered or not delivered.
Test keys
With an hxd_test_ key you test with simulated balance and the same responses as in production, with no charges.
Security
HMAC signing with timestamp and nonce, allowed IPs per key and HTTPS only. The key must never be used in the browser.
Sample order
curl https://distribution.hexzrecargas.com/api/v1/orders \
-H "Authorization: Bearer hxd_test_…" \
-H "Idempotency-Key: pedido-000123" \
-H "Content-Type: application/json" \
-d '{"items":[{"product_id":"…","quantity":1,"target":{"player_id":"123456789"}}]}'
# 201 Created
{ "id": "…", "reference_code": "HXD-…", "status": "processing", "total_amount": "…" }The full documentation, with examples in Node, Python, PHP and cURL, is inside the portal, in English and Spanish. Keys are created there once your account is enabled.
Access request
Open your distributor account
Fill in the request and we will contact you. Opening the account is free, for businesses and individuals alike.
- 01
We review your request
If we accept it, we let you know on WhatsApp and by email.
- 02
You create your password
The acceptance email has a link to finish signing up and create your password.
- 03
You add balance
From the “Balance” section, with Binance Pay or with USDT or USDC on a blockchain network.
We will never ask for your password, verification codes or API keys. Payments are made only inside the portal, with your account.