Skip to main content

Quickstart

HelaMesh is a non-custodial crypto payment gateway. Funds flow directly to your wallet — HelaMesh never holds them. You create invoices via the API or dashboard, share a checkout link with your customer, and receive an HMAC-signed webhook the moment the payment confirms on chain.

Five minutes from signup to first payment:

  1. Create an account and a test client. Save the API key (shown once).
  2. Create an invoice via the API.
  3. Share the returned checkout URL with your customer.
  4. Receive a webhook at your endpoint when the payment is confirmed.

Create your first invoice​

curl
curl -X POST https://api.helamesh.com/v1/invoices \
  -H "x-api-key: hm_test_YOUR_KEY" \
  -H "content-type: application/json" \
  -d '{
    "amount": 25.00,
    "metadata": { "orderId": "1234" }
  }'

Response:

200 OK
{
  "id": "65f8a1b2c3d4e5f6a7b8c9d0",
  "amount": "25.000000",
  "token": "USDT",
  "network": "TRON",
  "status": "PENDING",
  "paymentAddress": "TUEZSdKsoDHQMeZwihtdoBiN46zxhGWYdH",
  "expiresAt": "2026-04-10T18:30:00.000Z",
  "txHash": null,
  "confirmations": 0,
  "metadata": { "orderId": "1234" },
  "simulated": false,
  "environment": "test",
  "publishableKey": "pk_test_…"
}

The hosted checkout link is https://pay.helamesh.com/pay/{id}. Share that with your customer.

Test invoices come from test keys

Because you used an hm_test_* key, the invoice is stamped with "environment": "test" and shows a yellow TEST badge on the hosted checkout. You can fast-forward it to COMPLETED without spending real USDT — see Sandbox for the full loop. Swap in an hm_live_* key to create real invoices; everything else stays the same.

Next steps​