VIvideogen
Billing

Complete approved credit purchase

Changed on

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.

post/v1/billing/orders/{orderId}/complete

Request

  • Base URL
    https://api.videogen.io
  • Auth
    HTTP bearer

Path parameters

orderIdstring uuid required

Headers

Stripe-Shared-Payment-Tokenstring required

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 body

revisioninteger required
idempotencyKeystring required

Response

Current account or order state.

orderIdstring uuid required
state'requires_approval' | 'requires_action' | 'processing' | 'paid_pending_fulfillment' | 'fulfilled' | 'failed' | 'canceled' | 'expired' required
revisioninteger required
teamIdstring required
teamNamestring required
seller'VideoGen' required
product'credits' required
creditsinteger required
currencystring required
subtotalMinorinteger required
discountMinorinteger required
taxMinorinteger required
feesMinorinteger required
totalMinorinteger required
expiresAtinteger required

Unix seconds when this quote expires.

termsVersionstring required
refundTermsstring required
refundStatus'none' | 'requested' | 'processing' | 'succeeded' | 'failed' required
verificationUrlstring nullable

Secure VideoGen verification continuation when required. Sign in as the purchaser on the same team. This is not a checkout link.

receiptUrlstring nullable required
retryGuidancestring required
paymentHandlerobject required

Seller payment handler and merchant identity for a compatible native wallet. This does not attest to host acceptance.

Changes