Saltar al contenido principal
PATCH
/
workspaces
/
{workspaceId}
/
billing-accounts
/
{billingAccountId}
Actualizar una cuenta de facturación
curl --request PATCH \
  --url https://api.altostrat.io/workspaces/{workspaceId}/billing-accounts/{billingAccountId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "ACME Corp (Internacional)",
  "email": "global.billing@acme.com",
  "phone": "+15559876543",
  "description": "Cuenta principal para toda la facturación internacional.",
  "address": {
    "country": "US",
    "line1": "123 Calle Principal",
    "line2": "Suite 456",
    "city": "San Francisco",
    "state": "CA",
    "postal_code": "94105"
  }
}'
{
  "id": "cus_a1b2c3d4e5f6g7h8",
  "workspace_id": "ws_a1b2c3d4e5f6g7h8",
  "name": "Facturación ACME Corp",
  "email": "billing@acme.com",
  "phone": "+15551234567",
  "description": "Para operaciones con sede en EE. UU.",
  "currency": "usd",
  "address": {
    "country": "US",
    "line1": "123 Calle Principal",
    "line2": "Suite 456",
    "city": "San Francisco",
    "state": "CA",
    "postal_code": "94105"
  },
  "created_at": "2025-10-29T00:40:06.000000Z",
  "updated_at": "2025-10-29T00:40:06.000000Z"
}

Authorizations

Authorization
string
header
required

Introduzca su JWT en el formato: Bearer {token}

Path Parameters

workspaceId
string
required

El ID del espacio de trabajo.

Example:

"ws_a1b2c3d4e5f6g7h8"

billingAccountId
string
required

El ID de la cuenta de facturación, que corresponde a un ID de Cliente de Stripe (cus_...).

Example:

"cus_a1b2c3d4e5f6g7h8"

Body

application/json
name
string

El nuevo nombre para la cuenta de facturación.

Example:

"ACME Corp (Internacional)"

email
string<email>

La nueva dirección de correo electrónico de facturación principal.

Example:

"global.billing@acme.com"

phone
string | null

El nuevo número de teléfono de contacto de facturación.

Example:

"+15559876543"

description
string | null

Una descripción actualizada para la cuenta de facturación.

Example:

"Cuenta principal para toda la facturación internacional."

address
object

Response

El objeto de la cuenta de facturación actualizada.

id
string

Identificador único para la cuenta de facturación (ID de Cliente de Stripe), con prefijo cus_.

Example:

"cus_a1b2c3d4e5f6g7h8"

workspace_id
string

El ID del espacio de trabajo al que pertenece esta cuenta de facturación.

Example:

"ws_a1b2c3d4e5f6g7h8"

name
string

El nombre de la cuenta de facturación.

Example:

"Facturación ACME Corp"

email
string<email>

La dirección de correo electrónico de facturación principal.

Example:

"billing@acme.com"

phone
string | null

El número de teléfono de contacto de facturación.

Example:

"+15551234567"

description
string | null

Una descripción opcional para la cuenta de facturación.

Example:

"Para operaciones con sede en EE. UU."

currency
enum<string>

El código de moneda ISO de tres letras para la cuenta de facturación.

Opciones disponibles:
usd,
zar,
eur,
gbp,
aud
Example:

"usd"

address
object
created_at
string<date-time>

La marca de tiempo de cuándo se creó la cuenta de facturación.

Example:

"2025-10-29T00:40:06.000000Z"

updated_at
string<date-time>

La marca de tiempo de la última actualización de la cuenta de facturación.

Example:

"2025-10-29T00:40:06.000000Z"