Billing Request

Billing request data structure for replacements and refunds

Billing Request

Billing requests represent user requests for account replacements or refunds. Replacement requests for first-time accounts are auto-approved; all other requests require admin review.

interface BillingRequest {
  id: string;
  org_id: string;
  account_id: string;
  type: 'replacement' | 'refund';
  status: 'pending' | 'approved' | 'denied';
  reason: string | null;
  created_at: string;    // ISO 8601
  resolved_at: string | null;  // ISO 8601
}

Fields

id · string

Unique identifier for the billing request

org_id · string

Organization ID the request belongs to

account_id · string

Account ID the request is about

type · 'replacement' | 'refund'

Type of billing request:

• replacement — Request to replace an account with a new one
• refund — Request for a refund on an account

status · 'pending' | 'approved' | 'denied'

Current status of the request:

• pending — Awaiting admin review
• approved — Request was approved
• denied — Request was denied

reason · string | null

User-provided reason for the request

created_at · string

ISO 8601 timestamp of when the request was created

resolved_at · string | null

ISO 8601 timestamp of when the request was approved or denied. null if still pending.

NPM Package Type

import type { BillingRequestInfo } from 'ugcinc';