COconfirmo
Crypto top-up

Update Crypto Top-Up account fields

Partially updates a Crypto Top-Up account.

patch/v3/topups/crypto/accounts/{id}

Request

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

Path parameters

idstring required

Crypto Top-Up account ID

Request body

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

Asset whose balance is increased when funds are received on this account. Null clears the current value. Omit to leave unchanged.

notifyUrlstring url nullable

Webhook URL where webhooks for this crypto funding account will be sent. Null clears the current value. Omit to leave unchanged.

referencestring nullable

Merchant-defined reference string tied to this account. Null clears the current value. Omit to leave unchanged.

status'ENABLED' | 'DISABLED'

Status of the account. Omit to leave unchanged. If the account is in a BLOCKED status, it is not possible to modify the status.

Example request

{
  "balanceAsset": "USD",
  "notifyUrl": "https://your-platform.com/webhooks",
  "reference": "my-funding-account-ref-001",
  "status": "DISABLED"
}

Response

Successfully updated 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.