Skip to content
hidden

Crypto checkout API

Accept crypto on your site

Create a payment with one API call. Your buyer pays on a Hidden payment page and comes back to your site. You get a signed webhook, and the money goes to your balance.

Start for freeRead the docs
  • No platform fee
  • USDT, BTC, ETH and more
  • Signed webhooks
  • Test mode

How it works

Three steps to your first payment

  1. Create a payment

    Send the amount in USD and your order reference. Hidden returns a payment link.

  2. Send your buyer to the link

    They pick a coin and a network and pay. The page shows the exact amount and a QR code for their wallet.

  3. Get paid

    When the network confirms, Hidden sends payment.paid to your server and adds the money to your balance.

create-payment.shbash
curl -X POST https://api.sellhidden.com/v1/payments \
  -H "Authorization: Bearer $HIDDEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"amountUsd": 49, "reference": "order-1042", "returnUrl": "https://shop.example.com/thanks"}'
response.jsonjson
{
  "ok": true,
  "payment": {
    "id": "NOVA-7K2Q-9XHD",
    "url": "https://sellhidden.com/order/NOVA-7K2Q-9XHD",
    "status": "pending",
    "amountUsd": 49,
    "reference": "order-1042",
    …
  }
}

The answer is a link to the Hidden payment page, never a deposit address or an amount in coins. The payments API in the docs

The payment page

The Hidden payment page

Every payment is made on a page Hidden hosts, with your store name and logo and the Hidden mark. On the Enterprise plan the Hidden mark is left out, so the page shows only your store.

  • No account needed

    Buyers open the link and pay. Nothing to sign up for.

  • Made for phones

    Coin, network, exact amount and a QR code, on any screen size.

  • 12 languages

    The page opens in the buyer's language.

  • Paid means confirmed

    It says paid only when the network has confirmed the payment.

What it costs

  • No platform fee, on every plan, Free included.
  • The buyer pays the network fee on top of the amount, or you can choose to pay it.
  • Withdrawals to your USDT (BEP20) wallet cost a flat $0.85, the same on every plan.

Pricing

Built for developers

  • Signed webhooks with automatic retries
  • Idempotency keys and your own reference, so a retry never charges twice
  • Test payments that move no money
  • OpenAPI, plus code samples in curl, Node, Python and PHP

API reference

Limits and payouts

New stores start with lower limits and a short hold before API payments can be withdrawn. We raise both as your store grows. Your limits are always shown in your dashboard.

Terms for API payments

Questions

Common questions

No. They open the link, pay and return to your site.

USDT, USDC, BTC, ETH, LTC, SOL, TRX and the other coins on the payment page, on the networks it lists.

No. Buyers always pay on the Hidden payment page, so every buyer can see where the payment is made.

A small shortfall within your tolerance counts as paid. Otherwise the buyer can send the rest from the same page for 48 hours, or you can accept what arrived.

Crypto payments are final. If you refund a buyer, you send the money yourself.

Yes. Create a payment with test set to true. The page lets you mark it paid or expired, and your server receives the events. No money moves.

Start taking crypto payments today

Create a free storeTurn on payments