Coins

Enable/disable auto-topup and choose the coin product

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

put/v1/coins/auto-topup

Request body

enabledboolean required

Turn auto-topup on or off

productIdstring

Localized web coin product id (equals its FunnelFox price point ident) to auto-purchase. Required when enabling.

Example request

{
  "productId": "100_coins_9_99_eur"
}

Response

enabledboolean required
thresholdCoinsnumber required

Balance threshold below which auto-topup fires (backend constant, read-only)

lastStatus'success' | 'failed' | 'pending' nullable required
lastAttemptAtstring date-time nullable required
disabledReason'payment_failed' | 'product_unavailable' | 'no_payment_method' nullable required

Why auto-topup was auto-disabled (null while enabled)

Example response

{
  "product": {
    "productId": "100_coins_9_99_eur",
    "currency": "EUR"
  }
}

Changes

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