Crear sesión del portal de facturación de Stripe

POST

/billing/portal

curl --request POST \
  --url https://api.dev.lade.com.mx/billing/portal \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "teamId": "550e8400-e29b-41d4-a716-446655440000", "returnUrl": "https://app.lade.com.mx/dashboard/my-suscription" }'

• Development environment (dominio custom)
• QA environment
• Production environment
• Development environment (legacy — execute-api URL directo)

Crea una sesión del Stripe Customer Portal para que el equipo administre su método de pago, facturas y cancelación. Requiere rol OWNER o ADMIN y que el equipo ya tenga un Stripe Customer (haber pasado por checkout al menos una vez).

Authorizations

• cognitoAuth

Request Body^required

Media typeapplication/json

object

teamId

required

string format: uuid

returnUrl

required

string format: uri

Example

{
  "teamId": "550e8400-e29b-41d4-a716-446655440000",
  "returnUrl": "https://app.lade.com.mx/dashboard/my-suscription"
}

Responses

200

Sesión del portal creada

Media typeapplication/json

object

portalUrl

string format: uri

Example

{
  "portalUrl": "https://billing.stripe.com/p/session/a1b2c3..."
}

400

Solicitud inválida

Media typeapplication/json

object

error

required

string

message

string

field

string

Example

{
  "error": "Validation failed",
  "field": "email",
  "message": "Invalid email format"
}

403

Sin permisos

Media typeapplication/json

object

error

required

string

message

string

field

string

Example

{
  "error": "Forbidden",
  "message": "You don't have permission to access this resource"
}

404

Recurso no encontrado

Media typeapplication/json

object

error

required

string

message

string

field

string

Example

{
  "error": "Not found",
  "message": "Resource not found"
}