Account

Create a crypto top-up invoice

Generates an AddFunds invoice routed to the btcpayinline gateway. Open payment_url to complete payment with Bitcoin (BTC), Monero (XMR), TRX, or USDT-TRC20. Once the gateway confirms payment, the client account balance is credited automatically.

Use GET /account/topup/{invoice_id} to poll status.

post/account/topup

Request

Base URL: https://api.imprezahost.com/v1
URL: https://api.imprezahost.com/v1/account/topup
Auth: API key in header X-API-Key and API key in header X-API-Secret

Request body

amountnumber float required

Amount in the client's account currency.

method'btc' | 'xmr' | 'trx' | 'usdt' | 'usdt_trc20'

Optional preferred payment method. Forwarded to the gateway as a hint; the gateway may still display alternatives if the preferred method is unavailable.

Example request

{
  "amount": 50,
  "method": "xmr"
}

Response

Top-up invoice created successfully

successboolean

Example response

{
  "success": true,
  "data": {
    "invoice_id": 12345,
    "amount": 50,
    "currency": "USD",
    "method": "xmr",
    "status": "pending",
    "payment_url": "https://portal.imprezahost.com/viewinvoice.php?id=12345&method=xmr",
    "expires_at": "2026-05-08T16:30:00Z"
  },
  "meta": {
    "request_id": "req_a1b2c3d4e5f6g7h8",
    "timestamp": "2026-03-30T14:05:00Z"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.