---
title: "Cancel unpaid credit purchase"
method: POST
path: "/v1/billing/orders/{orderId}/cancel"
tags: ["Billing"]
---

# Cancel unpaid credit purchase

`POST /v1/billing/orders/{orderId}/cancel`

## Request

- Base URL: `https://api.videogen.io`
- URL: `https://api.videogen.io/v1/billing/orders/{orderId}/cancel`
- Auth: HTTP bearer

Void an unpaid order. If payment already settled, return its paid outcome; cancellation does not refund a settled payment.

## Path parameters

- `orderId` string, uuid, required

## Request body

- EmptyBillingRequest

## Response `200`

Current account or order state.

- BillingOrder
  - `orderId` string, uuid, required
  - `state` 'requires_approval' | 'requires_action' | 'processing' | 'paid_pending_fulfillment' | 'fulfilled' | 'failed' | 'canceled' | 'expired', required
  - `revision` integer, required
  - `teamId` string, required
  - `teamName` string, required
  - `seller` 'VideoGen', required
  - `product` 'credits', required
  - `credits` integer, required
  - `currency` string, required
  - `subtotalMinor` integer, required
  - `discountMinor` integer, required
  - `taxMinor` integer, required
  - `feesMinor` integer, required
  - `totalMinor` integer, required
  - `expiresAt` integer, required: Unix seconds when this quote expires.
  - `termsVersion` string, required
  - `refundTerms` string, required
  - `refundStatus` 'none' | 'requested' | 'processing' | 'succeeded' | 'failed', required
  - `verificationUrl` string, nullable: Secure VideoGen verification continuation when required. Sign in as the purchaser on the same team. This is not a checkout link.
  - `receiptUrl` string, nullable, required
  - `retryGuidance` string, required
  - `paymentHandler` object, required: Seller payment handler and merchant identity for a compatible native wallet. This does not attest to host acceptance.

## Other responses

- `default`: Error

## Changes

- **2026-11-05** `25148ccd4132`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/videogen/apis/videogen-api/changes/v1/billing/orders/:orderId/cancel/post.md)

---

[API](https://skmtc.dev/videogen/apis/videogen-api.md) - [All operations](https://skmtc.dev/videogen/apis/videogen-api/llms.txt) - [OpenAPI document](https://skmtc.dev/videogen/apis/videogen-api/revisions/25148ccd4132?raw)