Account

Get crypto payment details for a top-up invoice

Returns the address, exact crypto amount and payment URI for an AddFunds invoice raised by POST /account/topup, so a caller can show the customer what to pay without opening the clientarea.

Which rail answers depends on the coin: BTC and XMR settle through BTCPay, TRX and USDT-TRC20 through TronPay. Pass crypto to pick one; omit it for the account default. Poll GET /account/topup/{invoice_id} for confirmation — this endpoint describes the payment, it does not wait for it.

Treat the response as sensitive: the address identifies the payment.

get/account/topup/{invoice_id}/payment

Request

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

Path parameters

invoice_idinteger required

Query parameters

crypto'BTC' | 'XMR' | 'TRX' | 'USDT_TRC20'

Preferred coin. Omit for the account default.

Response

Payment details

successboolean

Example response

{
  "success": true,
  "data": {
    "crypto": "XMR",
    "network": "monero",
    "currency": "USD",
    "status": "pending"
  },
  "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.