Goldmine
Billing

Create a credit top-up checkout

POST
/billing.v1.Billing/CreateBillingTopUpCheckout

Creates an idempotent hosted Checkout payment for the exact requested USD credit amount. Reuse the operation identifier when retrying. Provider integration is test mode only. A redirect never credits the balance; confirmed provider movements are reconciled by the server.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://loading/billing.v1.Billing/CreateBillingTopUpCheckout" \  -H "Content-Type: application/json" \  -d '{}'
{
  "checkout": {
    "operationId": "string",
    "status": "string",
    "url": "string"
  }
}
{
  "code": "invalid_argument",
  "message": "The request was malformed, such as a missing required field or an unparseable cursor."
}
{
  "code": "unauthenticated",
  "message": "The request lacks a valid API key in the Authorization header."
}
{
  "code": "permission_denied",
  "message": "The API key is not allowed to perform this action on this workspace."
}
{
  "code": "internal",
  "message": "An internal server error occurred."
}

CreateBillingInvoiceCheckout

Creates an idempotent hosted Checkout payment for an outstanding workspace invoice. Reuse the operation identifier when retrying. Provider integration is test mode only; settlement requires confirmed provider movements.

GetBillingExport

Returns previously persisted CSV bytes and the JSON manifest only within the selected workspace. Retrieving an export does not recompute it from current history.