---
title: "Enable/disable auto-topup and choose the coin product"
method: PUT
path: "/v1/coins/auto-topup"
tags: ["Coins"]
---

# Enable/disable auto-topup and choose the coin product

`PUT /v1/coins/auto-topup`

Enabling requires a productId from the coin paywall (localized web coin product id). Re-enabling clears the auto-disable state.

## Request body

- UpdateAutoTopupDto
  - `enabled` boolean, required — Turn auto-topup on or off
  - `productId` string — Localized web coin product id (equals its FunnelFox price point ident) to auto-purchase. Required when enabling.

## Response `200`

- AutoTopupResponseDto
  - `enabled` boolean, required
  - `product` AutoTopupProductDto, required
    - `productId` string, required
    - `coinsAmount` number, required
    - `priceAmount` number, required — Price in the currency minor units
    - `currency` string, required
  - `thresholdCoins` number, required — Balance threshold below which auto-topup fires (backend constant, read-only)
  - `lastStatus` 'success' | 'failed' | 'pending', nullable, required
  - `lastAttemptAt` string, date-time, nullable, required
  - `disabledReason` 'payment_failed' | 'product_unavailable' | 'no_payment_method', nullable, required — Why auto-topup was auto-disabled (null while enabled)

---

[API](https://skmtc.dev/miaai/apis/backend-template-api.md) · [All operations](https://skmtc.dev/miaai/apis/backend-template-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/miaai/backend-template-api/revisions/2a8d88a5124f/schema)