Skip to navigation
REST API ReferenceEndpointsBilling

Complete approved credit purchase

Sensitive write. Complete only this quoted order after the user approves its exact terms. Deliver the scoped one-time card token through the secure header, never model-visible text. Reuse the same order, revision, client idempotency key and credential on an identical retry. A different token cannot replace an existing claim. Payment and credit fulfillment are separate states.

Authentication

AuthorizationBearer

API key from app.videogen.io/api. The full key is only shown once when you create it.

Path parameters

orderIdstringRequiredformat: "uuid"

Headers

Stripe-Shared-Payment-TokenstringRequired<=300 characters

Scoped card-backed Stripe Shared Payment Token for this exact one-time total. Must be non-empty. Transport securely; never put it in prompts, URLs, logs or tool content. This native header is not an MPP payment challenge.

Request

This endpoint expects an object.
revisionintegerRequired>=0
idempotencyKeystringRequired16-200 characters

Response

Current account or order state.
orderIdstringformat: "uuid"
stateenum
revisioninteger
teamIdstring
teamNamestring
sellerenum
Allowed values:
productenum
Allowed values:
creditsinteger
currencystring
subtotalMinorinteger
discountMinorinteger
taxMinorinteger
feesMinorinteger
totalMinorinteger
expiresAtinteger
Unix seconds when this quote expires.
termsVersionstring
refundTermsstring
refundStatusenum
Allowed values:
receiptUrlstring or null
retryGuidancestring
paymentHandlermap from strings to any
Seller payment handler and merchant identity for a compatible native wallet. This does not attest to host acceptance.
verificationUrlstring or nullOptional
Secure VideoGen verification continuation when required. Sign in as the purchaser on the same team. This is not a checkout link.