---
title: "Get crypto payment details for a top-up invoice"
method: GET
path: "/account/topup/{invoice_id}/payment"
tags: ["Account"]
---

# Get crypto payment details for a top-up invoice

`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`

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.

## Path parameters

- `invoice_id` integer, required

## Query parameters

- `crypto` 'BTC' | 'XMR' | 'TRX' | 'USDT_TRC20'

## Response `200`

Payment details

- object
  - `success` boolean
  - `data` object
    - `invoice_id` integer
    - `rail` 'btcpay' | 'tronpay'
    - `crypto` string
    - `network` string
    - `address` string: Deposit address for this invoice.
    - `crypto_amount` string: Exact amount to send, as a decimal string.
    - `fiat_amount` number, float
    - `currency` string
    - `payment_uri` string: Wallet URI, for rendering a QR code.
    - `expires_at` string, date-time
    - `status` string
  - `meta` Meta
    - `request_id` string
    - `timestamp` string, date-time

## Other responses

- `400`: Not a top-up invoice, already paid, or the gateway refused

---

[API](https://skmtc.dev/imprezahost/apis/impreza-host-public-api.md) · [All operations](https://skmtc.dev/imprezahost/apis/impreza-host-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/imprezahost/apis/impreza-host-public-api/revisions/db86511f604f?raw)