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

# Request credit purchase refund

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

## Request

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

Sensitive write. Record a support-reviewed refund request for a paid order. A requested refund is not an approved or completed refund.

## Path parameters

- `orderId` string, uuid, required

## Request body

- BillingRefundRequest
  - `reason` string, required: Why the purchaser wants a refund. Must be non-empty.

## 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/refund/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)