Premium and prices

Settle a premium offer and apply the product

Checks the offer's invoice for settlement (LUD-21 verify at the provider) and applies the product effect EXACTLY ONCE — a replayed redeem answers applied: "already" with the account's current premium state, never a second effect. Non-refundable; time products extend from max(now, current expiry) so a second purchase stacks, and the credits product adds credits. Poll this at ~2.5 s after paying until it stops answering 202. The claim is bound to the paying account: another account's macaroon is refused, and an expired macaroon still resumes an already-paid claim. NOT gated by PREMIUM_ENABLED (a paid claim must always resolve); PAYMENTS_ENABLED off answers 503 so the poll stays alive. Rate limited 60/min/user. Every answer is private, no-store.

post/v1/premium/redeem

Request

  • Base URL: https://api.memestack.ai
  • URL: https://api.memestack.ai/v1/premium/redeem
  • Auth: HTTP bearer

Request body

product'supporter_30d' | 'ad_free_30d' | 'credits_10' | 'credits_100' | 'api_builder_30d' | 'api_growth_30d' | 'api_scale_30d' | 'api_calls_10k' required
macaroonstring required

The macaroon from the /v1/premium/purchase offer.

Response

Invoice settled. applied: true = this call applied the effect; applied: "already" = a replay, the snapshot is the account's current state.

product'supporter_30d' | 'ad_free_30d' | 'credits_10' | 'credits_100' | 'api_builder_30d' | 'api_growth_30d' | 'api_scale_30d' | 'api_calls_10k'
ad_free_untilstring date-time nullable
supporter_untilstring date-time nullable
generation_creditsinteger

Changes

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