Menú

Referencia de la API · Partners

Transiciones de facturación

partners · billing_transitions · 5 operaciones

GET/v1/partners/billing-transitionsList billing transition requests GET/v1/partners/billing-transitions/{request_id}Get one billing transition request POST/v1/partners/billing-transitionsAsk an account to move its billing to the agency POST/v1/partners/billing-transitions/{request_id}/rejectReject a billing transition request (the account)POST/v1/partners/billing-transitions/{request_id}/cancelCancel a pending billing transition request

GET/v1/partners/billing-transitions

List billing transition requests

partners.billing_transitions.list

LecturaIdempotenteDesde 2026-11-01

Lists the requests to move an account's billing to the agency (direction to_parent_pays: from paying its own subscription, self_pays, to being paid by the workspace, parent_pays), newest first, paginated by cursor (limit up to 200). From a workspace, the requests it sent to its accounts; from an account, the ones it received. status: active (default: pending and scheduled, what the app shows), all, or one of pending, scheduled, completed, cancelled, rejected. Each request: the workspace and the account (id and name), who requested it and when, status, scheduled_for (when a scheduled one takes effect: the end of the account's paid period), and who accepted, rejected or cancelled it and when. Owners and admins only.

Alcance: partners:read
Permiso: Ver el módulo · Solo owner, admin
Tool del MCP: partners_billing_transitions_listEn la superficie completa; en la compacta, mb_execute_operation con id: "partners.billing_transitions.list".

Costo declarado: hasta 202 lecturas y 0 escrituras por llamada (cuentan en el cupo diario).

Parámetros

limitintegerqueryopcional

How many items this page brings at most (see the maximum and the default in the schema).

Por defecto: 50

cursorstringqueryopcional

The next_cursor of the previous page, exactly as it came (only for the same list and filters); without it, the first page.

statusenumqueryopcional

active (pending and scheduled, the default: what the app shows), all, or one status.

Valores: active, all, pending, scheduled, completed, cancelled, rejected · Por defecto: "active"

Respuesta

dataarray<object>

has_moreboolean

next_cursorstring

Errores

role_required invalid_input unknown_field authentication_required scope_insufficient module_access_denied operation_not_found rate_limited quota_exceeded

Ejemplo

curl "https://api.mb-suite.com/v1/partners/billing-transitions" \
  -H "Authorization: Bearer $MB_API_KEY"

Probar con tu API key de prueba

Con una API key de prueba el pedido va siempre a tu organización de práctica: datos de ejemplo que puedes reiniciar.

curl "https://api.mb-suite.com/v1/partners/billing-transitions" \
  -H "Authorization: Bearer $MB_TEST_KEY"

GET/v1/partners/billing-transitions/{request_id}

Get one billing transition request

partners.billing_transitions.get

LecturaIdempotenteDesde 2026-11-01

Returns one billing transition request that involves this organization (as the requesting workspace or as the account), with the same fields as partners.billing_transitions.list. Any other organization gets billing_transition_not_found. Owners and admins only.

Alcance: partners:read
Permiso: Ver el módulo · Solo owner, admin
Tool del MCP: partners_billing_transitions_getEn la superficie completa; en la compacta, mb_execute_operation con id: "partners.billing_transitions.get".

Costo declarado: hasta 1 lecturas y 0 escrituras por llamada (cuentan en el cupo diario).

Parámetros

request_idstringrutarequerido

The billing change request id (partners.billing_transitions.list).

Respuesta

idstring

statusenum

Valores: pending, accepted, scheduled, completed, cancelled, rejected

direction"to_parent_pays"

parent_org_idstring

parent_org_namestring

child_org_idstring

child_org_namestring

requested_bystring

requested_by_namestring

created_atnumber

scheduled_fornumber | null

accepted_atnumber | null

accepted_bystring | null

completed_atnumber | null

rejected_atnumber | null

rejected_bystring | null

rejected_by_namestring | null

cancelled_atnumber | null

cancelled_bystring | null

cancelled_by_namestring | null

Errores

billing_transition_not_found role_required invalid_input unknown_field authentication_required scope_insufficient module_access_denied operation_not_found rate_limited quota_exceeded

Ejemplo

curl "https://api.mb-suite.com/v1/partners/billing-transitions/{request_id}" \
  -H "Authorization: Bearer $MB_API_KEY"

Probar con tu API key de prueba

Con una API key de prueba el pedido va siempre a tu organización de práctica: datos de ejemplo que puedes reiniciar.

curl "https://api.mb-suite.com/v1/partners/billing-transitions/{request_id}" \
  -H "Authorization: Bearer $MB_TEST_KEY"

POST/v1/partners/billing-transitions

Ask an account to move its billing to the agency

partners.billing_transitions.request

EscrituraDesde 2026-11-01

From a workspace, asks one of its accounts that pays its own subscription (billing mode self_pays; account_id, or child_org_id) to let the agency pay for it (parent_pays). It changes nothing yet: the account's owners and admins get an email (Amazon SES) and accept or reject it in MB Suite. If they accept, an account on a trial (or without a subscription) moves at once; one with an active subscription moves when its paid period ends (partners.billing_transition.scheduled, then .completed). Errors: partners_workspace_only, partner_account_not_found (not an account of this workspace), billing_transition_requires_self_pays (409), billing_transition_exists (409, one pending or scheduled already; details.request_id), billing_transition_account_past_due (409: the account must settle its debt first). A direct owner or admin of the workspace. It emails the account: confirm with the person first. Returns the request.

Instrucciones para agentes

Tell the person the account's owners and admins were emailed and must accept the request in MB Suite; nothing changes in billing until they do.

Pide confirmación: primero dry_run: true (vista previa y confirm_token, que vale 10 minutos y una sola vez), después el mismo cuerpo con confirm_token. En unas pocas, solo con ciertos datos: la descripción dice cuándo. Por qué y cómo: Vista previa y confirmación.

Alcance: partners:write
Permiso: Editar en el módulo · Solo owner, admin
Tool del MCP: partners_billing_transitions_requestEn la superficie completa; en la compacta, mb_execute_operation con id: "partners.billing_transitions.request".
Eventos que puede emitir: partners.billing_transition.requested

Costo declarado: hasta 2 lecturas y 1 escrituras por llamada (cuentan en el cupo diario). Toca una plataforma externa (ses): cuenta en el cupo de operaciones externas.

Parámetros

account_idstringcuerpoopcional

The Account (of this workspace, paying for itself) to move to the workspace's billing (platform.orgs.list); child_org_id is accepted too.

child_org_idstringcuerpoopcional

Same as account_id.

Respuesta

request_idstring

requestobject

Errores

confirmation_required role_required external_rejected external_unavailable external_rate_limited external_outcome_unknown sandbox_external_unavailable invalid_input unknown_field authentication_required scope_insufficient crm_action_denied idempotency_key_reused rate_limited quota_exceeded

Ejemplo

curl -X POST "https://api.mb-suite.com/v1/partners/billing-transitions" \
  -H "Authorization: Bearer $MB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "dry_run": true
}'

Probar con tu API key de prueba

Con una API key de prueba el pedido va siempre a tu organización de práctica: datos de ejemplo que puedes reiniciar. En la práctica esta operación no se simula (toca otra plataforma): responde 409 sandbox_external_unavailable.

POST/v1/partners/billing-transitions/{request_id}/reject

Reject a billing transition request (the account)

partners.billing_transitions.reject

EscrituraDesde 2026-11-01

From the account, rejects a pending request of its agency to take over its billing: the account keeps paying its own subscription and the workspace's owners and admins get an email (Amazon SES). Only a direct owner or admin of the account answers for it: a workspace (billing_transition_account_only) or an agency user acting on the account (403 role_required, details.scope direct) cannot. Only pending requests (billing_transition_not_pending, 409). Accepting is done in the MB Suite app (it changes the account's subscription in Stripe). Returns the request.

Alcance: partners:write
Permiso: Editar en el módulo · Solo owner, admin
Tool del MCP: partners_billing_transitions_rejectEn la superficie completa; en la compacta, mb_execute_operation con id: "partners.billing_transitions.reject".
Eventos que puede emitir: partners.billing_transition.rejected

Costo declarado: hasta 2 lecturas y 1 escrituras por llamada (cuentan en el cupo diario). Toca una plataforma externa (ses): cuenta en el cupo de operaciones externas.

Parámetros

request_idstringrutarequerido

The billing change request id (partners.billing_transitions.list).

Respuesta

requestobject

Errores

billing_transition_not_found confirmation_required role_required external_rejected external_unavailable external_rate_limited external_outcome_unknown sandbox_external_unavailable invalid_input unknown_field authentication_required scope_insufficient crm_action_denied idempotency_key_reused rate_limited quota_exceeded

Ejemplo

curl -X POST "https://api.mb-suite.com/v1/partners/billing-transitions/{request_id}/reject" \
  -H "Authorization: Bearer $MB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "dry_run": true
}'

Probar con tu API key de prueba

POST/v1/partners/billing-transitions/{request_id}/cancel

Cancel a pending billing transition request

partners.billing_transitions.cancel

EscrituraDesde 2026-11-01

Cancels a pending billing transition request, from either side (a direct owner or admin of the workspace or of the account; an agency owner or admin acting on the account counts as the workspace): nothing changes in billing and the other side's owners and admins get an email (Amazon SES). A request already scheduled (accepted, waiting for the end of the account's paid period) is cancelled only in the MB Suite app, because it re-enables the renewal of the account's subscription in Stripe (billing_transition_scheduled_app_only, 409). Completed, rejected or cancelled requests: billing_transition_not_cancellable (409). Returns the request.

Alcance: partners:write
Permiso: Editar en el módulo · Solo owner, admin
Tool del MCP: partners_billing_transitions_cancelEn la superficie completa; en la compacta, mb_execute_operation con id: "partners.billing_transitions.cancel".
Eventos que puede emitir: partners.billing_transition.cancelled

Costo declarado: hasta 3 lecturas y 2 escrituras por llamada (cuentan en el cupo diario). Toca una plataforma externa (ses): cuenta en el cupo de operaciones externas.

Parámetros

request_idstringrutarequerido

The billing change request id (partners.billing_transitions.list).

Respuesta

requestobject

Errores

Ejemplo

curl -X POST "https://api.mb-suite.com/v1/partners/billing-transitions/{request_id}/cancel" \
  -H "Authorization: Bearer $MB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "dry_run": true
}'