---
title: "Create a Crypto Top-Up account"
method: POST
path: "/v3/topups/crypto/accounts"
tags: ["Crypto top-up"]
---

# Create a Crypto Top-Up account

`POST /v3/topups/crypto/accounts`

## Request

- Base URL: `https://confirmo.net/api`
- URL: `https://confirmo.net/api/v3/topups/crypto/accounts`
- Auth: HTTP bearer

Creates a new Crypto Top-Up account for the authenticated merchant.

## Request body

- CreateCryptoTopUpAccountTo
  - `balanceAsset` 'CZK' | 'EUR' | 'GBP' | 'USD' | 'PLN' | 'USDC' | 'USDT' | 'USDG': Asset whose balance is increased when a top-up is received on this account, with the credited amount calculated using the exchange rate at the time of the top-up. If not specified, no exchange is performed and the balance of the asset matching the incoming transaction is increased.
  - `notifyUrl` string, url: Webhook URL where crypto top-up webhooks will be sent.
  - `reference` string: Any string based on your choosing which is tied to this crypto top-up account. Whenever a new top-up is performed to this account, the reference value is also assigned to the top-up.

## Response `201`

Successfully created Crypto Top-Up account.

- CryptoTopUpAccountTo
  - `addresses` DepositAddressTo[]: List of addresses assigned to this top-up account.
    - `address` string: Address string.
    - `paymentMethodIds` string[]: List of supported crypto payment method codes usable with this address.
  - `balanceAsset` 'CZK' | 'EUR' | 'GBP' | 'USD' | 'PLN' | 'USDC' | 'USDT' | 'USDG': The asset whose balance is increased when a top-up is received on this account.
  - `createdAt` integer: Unix timestamp when the top-up account was created.
  - `id` string: Crypto top-up account identifier.
  - `notifyUrl` string, url: URL to which webhook notifications are sent when a crypto top-up is received or its status changes. If null, no notifications are sent.
  - `reference` string: Any string based on your choosing which is tied to this crypto top-up account. Whenever a new top-up is performed to this account, the reference value is also assigned to the top-up.
  - `status` 'ENABLED' | 'DISABLED' | 'BLOCKED' | 'CLOSED': Status of the top-up account. BLOCKED is set by an administrator and cannot be changed by the merchant. CLOSED is set by the system or administrator and cannot be changed by a merchant.
  - `updatedAt` integer: Unix timestamp when the top-up account was last updated.

## Other responses

- `400`: Bad Request
- `403`: Forbidden
- `409`: Conflict

---

[API](https://skmtc.dev/confirmo/apis/confirmo-api.md) - [All operations](https://skmtc.dev/confirmo/apis/confirmo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/confirmo/apis/confirmo-api/revisions/09bef7db3dd1?raw)