> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gigstack.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Cancel an open account checkout

> Requires a verified Firebase or signed personal MCP user with current unblocked team membership. Team API keys and OAuth tokens cannot act as their creator. Writes and operation readback/recovery require a current billing-account administrator. Effects are shared by the billing account. Staging always uses sandbox billing; credential livemode does not choose billing environment. Requires a NEW operation_id to expire the exact original checkout. The cancellation has its own durable readback. Confirmed expiry cancels the original and releases the lock. Already completed checkout cannot be cancelled and requires subscription management. Unknown expiry retains the cancellation lock; read/reconcile its new ID rather than replaying.



## OpenAPI

````yaml openapi.json POST /teams/{id}/billing/operations/{operationId}/cancel
openapi: 3.0.3
info:
  title: gigstack API v2
  description: >
    # gigstack API v2


    Build customer, invoice and payment integrations. Start with the
    [quickstart](https://docs.gigstack.io/quickstart), then select the [issuing
    country](https://docs.gigstack.io/concepts/shared-fields).


    ## Authentication and environments


    Use Authorization: Bearer YOUR_API_KEY. Standard live and test keys use
    https://api.gigstack.io/v2. Internal staging uses
    https://gigstack-staging-9z9nnaat.uc.gateway.dev/v2 and separate keys. Test
    mode is a data mode within an environment; a body field does not switch a
    key's mode.


    See [authentication](https://docs.gigstack.io/authentication) for key
    handling, OAuth team scope and gigstack Connect. Internal partner
    provisioning is outside this public contract; health probes have their own
    security declarations. Operations marked unavailable have no configured
    public gateway route.


    ## Read the operation contract


    Response envelopes, pagination and retry rules differ by endpoint. HTTP
    success alone does not prove external fiscal completion or movement of
    money. Reconcile ambiguous writes before retrying. Use [responses and
    recovery](https://docs.gigstack.io/responses) and the operation's error
    codes; document credits and daily limits are not generic retryable rate
    limits.


    The issuing team's configuration selects Mexico or Colombia; customer
    country and currency do not. Read
    [Mexico](https://docs.gigstack.io/countries/mexico) or
    [Colombia](https://docs.gigstack.io/countries/colombia) before choosing
    fiscal fields. Accepted public input differs from a provider's direct
    payload.


    Examples and schema checks do not imply every operation has been executed
    live. [Verification coverage](https://docs.gigstack.io/verification)
    distinguishes source review, offline checks and observed staging behavior.
    Documentation describes operations and does not authorize execution.
  version: 2.0.0
  contact:
    name: Gigstack API Support
    url: https://gigstack.io
    email: support@gigstack.io
  license:
    name: Proprietary
    url: https://gigstack.io/terms
  termsOfService: https://gigstack.io/terms
servers:
  - url: https://api.gigstack.io/v2
    description: >
      Public API for standard live and test-mode keys. Test data is isolated by
      the key mode

      (`livemode: false`). Internal staging is a separate deployment and key
      store; see

      https://docs.gigstack.io/authentication#environments for its base URL.
security:
  - bearerAuth: []
externalDocs:
  description: Complete API Documentation & Guides
  url: https://docs.gigstack.io
paths:
  /teams/{id}/billing/operations/{operationId}/cancel:
    post:
      tags:
        - Account Billing
      summary: Cancel an open account checkout
      description: >-
        Requires a verified Firebase or signed personal MCP user with current
        unblocked team membership. Team API keys and OAuth tokens cannot act as
        their creator. Writes and operation readback/recovery require a current
        billing-account administrator. Effects are shared by the billing
        account. Staging always uses sandbox billing; credential livemode does
        not choose billing environment. Requires a NEW operation_id to expire
        the exact original checkout. The cancellation has its own durable
        readback. Confirmed expiry cancels the original and releases the lock.
        Already completed checkout cannot be cancelled and requires subscription
        management. Unknown expiry retains the cancellation lock; read/reconcile
        its new ID rather than replaying.
      operationId: accountBillingCheckoutCancel
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
        - name: operationId
          in: path
          required: true
          schema:
            type: string
            format: uuid
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AccountBillingCancelInput'
      responses:
        '200':
          description: Inspect the returned state before reporting completion.
          content:
            application/json:
              schema:
                type: object
                additionalProperties: false
                required:
                  - success
                  - data
                  - timestamp
                properties:
                  success:
                    type: boolean
                    enum:
                      - true
                  data:
                    $ref: '#/components/schemas/AccountBillingOperation'
                  timestamp:
                    type: number
              examples:
                unknown:
                  value:
                    success: true
                    data:
                      id: c03839fa-20e3-4b56-86ba-d41d92e67f19
                      team_id: team_example
                      billing_account_id: account_example
                      effect_scope: billing_account_shared
                      provider_environment: sandbox
                      action: checkout
                      status: outcome_unknown
                      created_at: 1791500000000
                      updated_at: 1791500000000
                      recovery_available_at: 1791500600000
                      result: null
                      error:
                        code: billing_result_unconfirmed
                        message: Read the original operation before retrying
                        retryable: false
                      resolution: null
                    timestamp: 1791500000000
                expired:
                  value:
                    success: true
                    data:
                      id: 11ea635b-3261-4f6c-b127-7a806b3db91c
                      team_id: team_example
                      billing_account_id: account_example
                      effect_scope: billing_account_shared
                      provider_environment: sandbox
                      action: checkout.cancel
                      status: completed
                      created_at: 1791500000000
                      updated_at: 1791500000000
                      recovery_available_at: 1791500600000
                      result:
                        kind: checkout_cancellation
                        checkout_operation_id: c03839fa-20e3-4b56-86ba-d41d92e67f19
                        session_id: cs_test_synthetic
                        status: expired
                      error: null
                      resolution: null
                    timestamp: 1791500000000
        '400':
          description: Invalid body, cursor or fiscal fields.
        '401':
          description: Verified Firebase or personal MCP identity required.
        '403':
          description: Current membership or billing administrator authority required.
        '404':
          description: Team, plan, or operation not found in scope.
        '409':
          description: >-
            Account lock, changed operation parameters, ambiguous customer or
            incompatible plan state. Read current state before deciding the next
            action.
        '502':
          description: >-
            Billing result unconfirmed or upstream unavailable. Read the
            original operation ID before retrying.
        '503':
          description: >-
            Runtime project, application origin or internal service
            authorization is not configured.
      security:
        - bearerAuth: []
components:
  schemas:
    AccountBillingCancelInput:
      type: object
      properties:
        operation_id:
          type: string
          pattern: >-
            ^[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-4[a-fA-F0-9]{3}-[89abAB][a-fA-F0-9]{3}-[a-fA-F0-9]{12}$
      required:
        - operation_id
      additionalProperties: false
    AccountBillingOperation:
      type: object
      additionalProperties: false
      required:
        - id
        - team_id
        - billing_account_id
        - effect_scope
        - provider_environment
        - action
        - status
        - created_at
        - updated_at
        - recovery_available_at
        - result
        - error
        - resolution
      properties:
        id:
          type: string
        team_id:
          type: string
        billing_account_id:
          type: string
        effect_scope:
          type: string
          enum:
            - billing_account_shared
        provider_environment:
          type: string
          enum:
            - sandbox
            - production
        action:
          type: string
          enum:
            - checkout
            - checkout.cancel
            - upgrade
            - portal
            - fiscal.update
        status:
          type: string
          enum:
            - processing
            - handoff_ready
            - completed
            - failed
            - outcome_unknown
            - cancelled
        created_at:
          type: number
        updated_at:
          type: number
        recovery_available_at:
          type: number
        result:
          oneOf:
            - type: object
              nullable: true
              enum:
                - null
            - type: object
              additionalProperties: false
              required:
                - kind
                - checkout_operation_id
                - session_id
                - status
              properties:
                kind:
                  type: string
                  enum:
                    - checkout_cancellation
                checkout_operation_id:
                  type: string
                session_id:
                  type: string
                status:
                  type: string
                  enum:
                    - expired
                    - complete
            - type: object
              additionalProperties: false
              required:
                - kind
                - plan_id
              properties:
                kind:
                  type: string
                  enum:
                    - free_plan
                plan_id:
                  type: string
            - type: object
              additionalProperties: false
              required:
                - kind
                - session_id
                - url
                - expires_at
              properties:
                kind:
                  type: string
                  enum:
                    - checkout
                session_id:
                  type: string
                url:
                  type: string
                  nullable: true
                expires_at:
                  type: number
                  nullable: true
            - type: object
              additionalProperties: false
              required:
                - kind
                - intent
                - url
                - expires_at
              properties:
                kind:
                  type: string
                  enum:
                    - portal
                intent:
                  type: string
                  enum:
                    - manage
                    - cancel_subscription
                    - update_payment_method
                url:
                  type: string
                expires_at:
                  type: number
                  nullable: true
                  enum:
                    - null
            - type: object
              additionalProperties: false
              required:
                - kind
                - subscription
              properties:
                kind:
                  type: string
                  enum:
                    - subscription
                subscription:
                  $ref: '#/components/schemas/AccountBillingSubscription'
            - type: object
              additionalProperties: false
              required:
                - kind
                - fiscal
              properties:
                kind:
                  type: string
                  enum:
                    - fiscal
                fiscal:
                  $ref: '#/components/schemas/AccountBillingFiscal'
        error:
          type: object
          additionalProperties: false
          properties:
            code:
              type: string
            message:
              type: string
            retryable:
              type: boolean
          required:
            - code
            - message
            - retryable
          nullable: true
        resolution:
          type: object
          additionalProperties: false
          required:
            - action
            - resolved_at
          properties:
            action:
              type: string
              enum:
                - released_for_new_operation
            resolved_at:
              type: number
          nullable: true
    AccountBillingSubscription:
      type: object
      additionalProperties: false
      required:
        - id
        - status
        - plan_id
        - billing_cycle
        - currency
        - current_period_start
        - current_period_end
        - cancel_at
        - trial_end
        - cancel_at_period_end
      properties:
        id:
          type: string
        status:
          type: string
        plan_id:
          type: string
          nullable: true
        billing_cycle:
          type: string
          nullable: true
        currency:
          type: string
          nullable: true
        current_period_start:
          type: number
          nullable: true
        current_period_end:
          type: number
          nullable: true
        cancel_at:
          type: number
          nullable: true
        trial_end:
          type: number
          nullable: true
        cancel_at_period_end:
          type: boolean
    AccountBillingFiscal:
      type: object
      additionalProperties: false
      required:
        - team_id
        - billing_account_id
        - effect_scope
        - provider_environment
        - exists
        - editable
        - source
        - customer_id
        - fiscal
        - warnings
        - stripe_synced
      properties:
        team_id:
          type: string
        billing_account_id:
          type: string
        effect_scope:
          type: string
          enum:
            - billing_account_shared
        provider_environment:
          type: string
          enum:
            - sandbox
            - production
        exists:
          type: boolean
        editable:
          type: boolean
        source:
          type: string
          enum:
            - client
            - seed
        customer_id:
          type: string
          nullable: true
        fiscal:
          type: object
          additionalProperties: false
          required:
            - legal_name
            - rfc
            - tax_system
            - use
            - email
            - phone
            - address
          properties:
            legal_name:
              type: string
              nullable: true
            rfc:
              type: string
              nullable: true
            tax_system:
              type: string
              nullable: true
            use:
              type: string
              nullable: true
            email:
              type: string
              nullable: true
            phone:
              type: string
              nullable: true
            address:
              type: object
              additionalProperties: false
              required:
                - zip
                - street
                - exterior
                - interior
                - neighborhood
                - municipality
                - city
                - state
                - country
              properties:
                zip:
                  type: string
                  nullable: true
                street:
                  type: string
                  nullable: true
                exterior:
                  type: string
                  nullable: true
                interior:
                  type: string
                  nullable: true
                neighborhood:
                  type: string
                  nullable: true
                municipality:
                  type: string
                  nullable: true
                city:
                  type: string
                  nullable: true
                state:
                  type: string
                  nullable: true
                country:
                  type: string
                  nullable: true
        warnings:
          type: array
          items:
            type: string
        stripe_synced:
          type: boolean
          nullable: true
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >
        **Authentication Method:** HTTP Bearer token.


        The runtime requires the literal `Bearer ` prefix — a bare token in the

        `Authorization` header is rejected with `401 unauthorized`.


        **Header Format:** `Authorization: Bearer YOUR_API_KEY`


        Your API key is a JWT. Live keys operate on live data (`livemode:
        true`);

        test keys operate on isolated test data (`livemode: false`).


        **Get your key at:**
        [app.gigstack.pro/settings?tab=api](https://app.gigstack.pro/settings?tab=api)


        **Errors:** credential failures are answered by the authentication layer
        with a raw

        `{ "message": … }` body, not the standardized envelope — `401` for a
        missing, malformed or

        expired token, `403` for a revoked key or a plan without API access. See
        the `Unauthorized`

        and `AuthForbidden` responses.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.