Skip to main content
POST
Finalize gateway billing group

Authorizations

Authorization
string
header
required

Use a JWT bearer token or a Veryfront API key in the Authorization header.

Headers

x-veryfront-project-reference
string

Canonical project selector: a UUID or slug for model access, inference and billing context. A signed project scope takes precedence. Otherwise, send only one project selector header.

Required string length: 1 - 255
x-veryfront-project-id
string

Compatibility selector accepting a project UUID. Prefer x-veryfront-project-reference.

Required string length: 1 - 255
x-veryfront-project-slug
string

Compatibility selector accepting a project slug. Prefer x-veryfront-project-reference.

Required string length: 1 - 255

Body

application/json
billing_group_id
string
required
Required string length: 1 - 255
Pattern: ^[A-Za-z0-9._:-]+$

Response

Direct gateway charges for the user-facing billing group, reconciled from server-recorded usage

ok
enum<boolean>
required
Available options:
true
billing_group_id
string
required
already_finalized
boolean
required
request_count
integer
required
Required range: x >= 0
charged_credits
number
required
Required range: x >= 0
target_credits
number
required
Required range: x >= 0
adjustment_credits
number
required
Required range: x >= 0
adjustment
enum<string>
required
Available options:
none,
refund,
spend
provider_cost_usd
number
required
Required range: x >= 0
veryfront_charge_usd
number
required
Required range: x >= 0
veryfront_billed_usd
number
required
Required range: x >= 0
usage_capture_status
enum<string>
required
Available options:
complete,
partial,
missing
funding
enum<string>
Available options:
customer,
mixed