Public integration guide. API base URL: https://api.toknex.space. Confirm network settings and one-time fees in your merchant account.

Getting started

Toknex lets your website or app accept USDT on BNB Smart Chain (BEP-20). Each of your customers gets a permanent personal deposit address. We watch the blockchain, confirm payments, notify your server by webhook, and settle the money to your own wallet. You never run a node, hold private keys or pay gas.

This page takes you from sign-up to your first live payment. Most merchants finish it in under an hour.

What you need: a server-side application (PHP, Node.js, Python or anything that can make HTTPS requests), a public HTTPS endpoint for webhooks, and a BSC wallet that holds USDT to pay the one-time fee.

1. Create your merchant account

Open https://api.toknex.space/merchant/register.
Enter your name, business name, work email, website and a password (at least 10 characters). You can add a payout address now or later.
Accept the terms and click Create account. You are signed in and taken to Get started, your onboarding checklist.

2. Confirm your email

We send a confirmation link to your work email. Click it to unlock the payment step. If it doesn't arrive within a few minutes, check your spam folder or press Resend email on the Get started page.

3. Pay the one-time fee in USDT

Fee	Amount
Registration	account-configured registration fee USDT
Setup	account-configured setup fee USDT
Total, one-time	account-configured total fee USDT

The Get started page shows a QR code and a payment address that belongs to your account only.

Send USDT on BNB Smart Chain (BEP-20) from any wallet or exchange. Tokens on other networks (Ethereum, TRON, Polygon…) cannot be credited.
You can pay in several transfers. The page shows what is still due.
Anything you send above the total is added to your merchant balance, not lost.
The fee amounts are fixed when you register. A later price change does not affect you.

Automatic activation: after your transfer reaches account-configured confirmations confirmations (usually about a minute), your account switches to Active by itself. The page refreshes and you receive an email. No one has to approve it manually.

4. Create an API key

Go to API keys → Create key. Copy the key (sk_live_…) straight into your server's secret configuration, for example an environment variable called GATEWAY_API_KEY. It is shown only once: we keep only a hash of it.

Never put the key in browser JavaScript, mobile apps or public repositories. Read Security best practices.

5. Configure your webhook

Go to Webhooks, enter the HTTPS URL that should receive payment events (for example https://yourshop.com/webhooks/usdt) and save. A signing secret (whsec_…) is shown once; store it as GATEWAY_WEBHOOK_SECRET. Then press Send test event and check that your endpoint answers with HTTP 200. See Webhooks.

6. Set your payout address

Under Account, set the BSC wallet address where your settlements are paid in USDT. Use a wallet you control.

7. Integrate

Follow the Integration guide. In short:

When a customer signs up (or reaches checkout), call POST /api/v1/users with your own customer id as external_id. The response contains their permanent deposit_address.
Show the address and its QR code, or send the customer to our hosted page using POST /api/v1/users/{id}/portal-link.
When the deposit.confirmed webhook arrives, credit the customer in your system and fulfil the order.

8. Test and go live

Work through the Testing & go-live checklist, then switch your production configuration to your live key. Request payouts under Settlements whenever you like; see Fees & settlements.

Need help?

Read the FAQ & troubleshooting page, or contact support from your dashboard with your merchant email and, if relevant, the transaction hash.