Skip to navigation

Buy a Prepaid Additional Usage Credit Pack

View as Markdown

Create or replay a hosted Checkout Session for one credit pack; the paid amount becomes prepaid credit for metered usage, including free accounts. Paid plan entitlements do not change. A repeated Idempotency-Key with the same pack returns the same Session.

Authentication

AuthorizationBearer

Your aVenture API key (https://aventure.vc/settings/api-keys) or OAuth access token

Headers

Idempotency-KeystringRequired1-255 characters

Caller-chosen key, 1 to 255 characters, that makes a retry return the same Checkout Session instead of a second purchase.

Request

This endpoint expects an object.
packenumRequired

Credit pack to buy; its amount becomes prepaid credit.

Allowed values:

Response headers

X-RateLimit-Limitinteger

Requests allowed per client IP in the current rate-limit window.

X-RateLimit-Remaininginteger

Requests left before the tightest applicable rate-limit bucket rejects.

X-RateLimit-Resetinteger

Seconds until the exhausted rate-limit bucket admits another request; 0 when none is exhausted.

Response

Created
expiresAtdatetime
packenum

Prepaid additional-usage credit pack.

Allowed values:
urlstringformat: "uri"
idstring or nullOptionalformat: "uuid"

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
406
Not Acceptable Error
409
Conflict Error
415
Unsupported Media Type Error
422
Unprocessable Entity Error
429
Too Many Requests Error
500
Internal Server Error
503
Service Unavailable Error