COconfirmo
Crypto top-up

Create a Crypto Top-Up account

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

post/v3/topups/crypto/accounts

Request

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

Request body

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.

notifyUrlstring url

Webhook URL where crypto top-up webhooks will be sent.

referencestring

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.

Example request

{
  "balanceAsset": "USD",
  "notifyUrl": "https://your-platform.com/webhooks"
}

Response

Successfully created Crypto Top-Up account.

balanceAsset'CZK' | 'EUR' | 'GBP' | 'USD' | 'PLN' | 'USDC' | 'USDT' | 'USDG'

The asset whose balance is increased when a top-up is received on this account.

createdAtinteger

Unix timestamp when the top-up account was created.

idstring

Crypto top-up account identifier.

notifyUrlstring 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.

referencestring

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.

updatedAtinteger

Unix timestamp when the top-up account was last updated.

Example response

{
  "addresses": [
    {
      "address": "0xd46faFF817D27c8C10edC580eB573cd4E8fC424d",
      "paymentMethodIds": [
        "ETHEREUM_BLOCKCHAIN_MAINNET_ETH_CURRENCY",
        "ETHEREUM_BLOCKCHAIN_MAINNET_USDC_STANDARD"
      ]
    }
  ],
  "balanceAsset": "USD",
  "createdAt": 1772539200,
  "id": "dac1a2b3c4d5e7f8",
  "reference": "topup-account-reference",
  "status": "ENABLED",
  "updatedAt": 1772539200
}

Changes

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