Skip to content

Buy a pack of 1 000 Plune AI credits for $80

POST
/v1/settings/ai/credits/packs
curl --request POST \
--url https://beta-api.plune.ai/v1/settings/ai/credits/packs \
--header 'Content-Type: application/json' \
--cookie plune_session=<plune_session> \
--data '{ "provider": "monopay" }'

#1427 (D9–D11, frame 01). Answers the page to pay on: Paddle’s checkout (US dollars), a Monopay invoice, or our LiqPay page that posts its signed form — the hryvnia amount is $80 × monobank’s selling rate of today, rounded up to the hryvnia. The pack is pending until the provider’s signed webhook says it is paid; then ONE grant of 1 000 credits, usable 12 months from the payment, is written (a repeated webhook writes nothing more). Paid plans only (D11): Free gets 409 paid_plan_required. The project owner, from the signed-in session, who owns the plan (the account itself, or the company’s owner). The link lives 24 hours. Ten a minute.

Media type application/json
object
provider
required
string
Allowed values: paddle monopay liqpay
Examples
Example monopay

In hryvnias through monobank

{
"provider": "monopay"
}

The page to pay on, and the pack waiting for it

Media type application/json
object
url
required
string
pack
required

#1427: one purchase of a Plune AI credit pack — 1 000 credits for $80, usable 12 months from its payment (D9–D12).

object
id
required
string
provider
required
string
Allowed values: paddle monopay liqpay
status
required

pending: asked of the provider, not paid yet; paid: its credits granted; failed: nothing was charged.

string
Allowed values: pending paid failed
auto
required

Bought by overage (D12), not by a click.

boolean
credits
required
integer
usdCents
required
integer
uahKopiyky
required

What Monopay or LiqPay charges, in kopiyky: $80 × monobank’s selling rate of that day (D9). null for Paddle, or before the amount is fixed.

integer
nullable
payUrl
required

The page to pay it on while it is pending and its link lives (24 hours) — a checkout, or a Monopay overage invoice; else null.

string
nullable
createdAt
required
string format: date-time
paidAt
required
string format: date-time
nullable
validUntil
required

12 months from paidAt; null until paid.

string format: date-time
nullable
Example
{
"url": "https://pay.mbnk.biz/inv-1",
"pack": {
"id": "pack-1",
"provider": "monopay",
"status": "pending",
"auto": false,
"credits": 1000,
"usdCents": 8000,
"uahKopiyky": 331000,
"payUrl": "https://pay.mbnk.biz/inv-1",
"createdAt": "2026-09-16T09:12:04.151Z",
"paidAt": null,
"validUntil": null
}
}

Not JSON, or a provider that is not paddle, monopay or liqpay

Media type application/json
object
error
required
string
Example
{
"error": "validation failed — provider: must be paddle, monopay or liqpay"
}

No / invalid session

A member asked (project owner only); an API token (session_required); not the plan’s own owner — the account itself, or the company’s owner (owner_only). A reader is refused by the project guard.

Media type application/json
object
error
required
string
Example
{
"error": "only the owner of the plan pays for its Plune AI credits",
"code": "owner_only"
}

paid_plan_required: the plan is Free (D11)

Media type application/json
object
error
required
string
Example
{
"error": "Plune AI credit packs and overage are for paid plans — move to Personal or Team first",
"code": "paid_plan_required"
}

Rate-limited: the per-route throttle, or the per-minute request limit of the plan an API token counts by (#1442; the body names the plan, #2092). Retry-After carries the seconds until the window rolls over.

Media type application/json
object
error
required
string
Example generated
{
"error": "example"
}
Retry-After
integer

Seconds until the window rolls over

provider_error: the provider refused to open a page; nothing is pending

Media type application/json
object
error
required
string
Example
{
"error": "the payment provider refused to open a checkout",
"code": "provider_error"
}

provider_not_configured (Paddle also needs PADDLE_PRICE_CREDIT_PACK), provider_unreachable, rate_unavailable (no USD/UAH rate); or no credits ledger on this server

Media type application/json
object
error
required
string
Example
{
"error": "packs through paddle are not configured on this server",
"code": "provider_not_configured"
}