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

# Update ACH Authorization Revocation

> Updates revocation on one exact tenant-owned bank payment method. true revokes the current authorization. false never restores revoked consent; a new authorization must be captured.

Updates the revocation status for one exact bank-account payment method owned by an
already-shared customer. `customerId` is your external customer reference;
`paymentMethodId` is the payment-method UUID returned by this API. Both are checked against
the company identified by the API key.

```json theme={null}
{
  "revokeAuthorization": true
}
```

`true` revokes the current ACH authorization and removes the payment method's default status.
Repeating `true` is idempotent. Omitted or `null` makes no change.

`false` cannot restore consent. It is an idempotent no-op while the method still has an active
authorization, but returns `422` after revocation. Capture a new customer authorization through
the normal authorization workflow to clear the revoked-authorization status. A payment method
with no active or historical ACH authorization returns `409` for `true`.

This endpoint accepts bank-account payment methods only. It never applies the revocation to a
different payment method or to every method on the customer.


## OpenAPI

````yaml PUT /customers/{customerId}/payment-methods/{paymentMethodId}/ach-authorization
openapi: 3.1.0
info:
  title: Finosu API
  description: Finosu API
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.finosu.com
security:
  - apiKeyAuth: []
paths:
  /customers/{customerId}/payment-methods/{paymentMethodId}/ach-authorization:
    put:
      summary: Update ACH Authorization Revocation
      description: >-
        Updates revocation on one exact tenant-owned bank payment method. true
        revokes the current authorization. false never restores revoked consent;
        a new authorization must be captured.
      parameters:
        - name: customerId
          in: path
          description: External customer reference ID
          required: true
          schema:
            type: string
        - name: paymentMethodId
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: Payment-method UUID returned by this API
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateACHAuthorization'
      responses:
        '200':
          description: Authorization revocation status
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ACHAuthorizationStatus'
        '404':
          description: Customer/payment method not found for authenticated company
        '409':
          description: No active authorization exists to revoke
        '422':
          description: Invalid method type or attempted consent restoration
components:
  schemas:
    UpdateACHAuthorization:
      type: object
      description: Partial revocation update for an exact ACH payment method.
      properties:
        revokeAuthorization:
          description: >-
            true revokes the active authorization. false is a no-op only while
            authorization remains active; it cannot restore revoked consent.
            Omitted or null makes no change.
          type:
            - boolean
            - 'null'
    ACHAuthorizationStatus:
      type: object
      required:
        - customerId
        - paymentMethodId
        - revokeAuthorization
      properties:
        customerId:
          type: string
        paymentMethodId:
          type: string
          format: uuid
        revokeAuthorization:
          type: boolean
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key

````

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