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

# Update a payment's reimbursement classification

> Sets whether the payment is a reimbursement for tax reporting. Sending the currently stored value is idempotent. This update does not change payout processing, status, or fees.



## OpenAPI

````yaml /api-reference/openapi.json patch /payments/{payment_id}
openapi: 3.1.0
info:
  title: Karat Payout API
  description: >-
    Your gateway to seamless, automated, and scalable payment solutions. The
    Karat Payout API lets you create recipients, send payouts, track payment
    status, manage tax documents, record external payments, and subscribe to
    webhook events.
  version: 1.0.0
servers:
  - url: https://payouts.api.trykarat.com
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Account
    description: Retrieve your available balance and payout totals.
  - name: Payments
    description: Create and manage outgoing payouts to recipients.
  - name: Recipients
    description: Manage the payees you send payouts to.
  - name: Tax
    description: Retrieve recipient tax forms (W-9) and download links.
  - name: External Payments
    description: Record and manage payments made outside of Karat.
  - name: Webhooks
    description: Subscribe to event notifications for payout activity.
paths:
  /payments/{payment_id}:
    patch:
      tags:
        - Payments
      summary: Update a payment's reimbursement classification
      description: >-
        Sets whether the payment is a reimbursement for tax reporting. Sending
        the currently stored value is idempotent. This update does not change
        payout processing, status, or fees.
      operationId: updatePaymentById
      parameters:
        - name: payment_id
          in: path
          required: true
          description: The ID of the payment intent to update.
          schema:
            type: string
            format: uuid
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
              required:
                - isReimbursement
              properties:
                isReimbursement:
                  type: boolean
                  description: >-
                    The tax-only reimbursement classification to store. `null`,
                    strings, numbers, and other non-boolean values are rejected.
            example:
              isReimbursement: true
      responses:
        '200':
          description: >-
            The stored reimbursement classification. Repeating this request with
            the same value returns the same result without changing payout
            processing, status, or fees.
          content:
            application/json:
              schema:
                type: object
                additionalProperties: false
                required:
                  - data
                properties:
                  data:
                    type: object
                    additionalProperties: false
                    required:
                      - id
                      - isReimbursement
                    properties:
                      id:
                        type: string
                        format: uuid
                      isReimbursement:
                        type: boolean
              example:
                data:
                  id: 0fc50d45-faa8-4d09-aa2a-a9ceb282d7ae
                  isReimbursement: true
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
components:
  responses:
    BadRequest:
      description: The request was invalid.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error:
              message: 'amount: amount must be positive'
    Unauthorized:
      description: Missing or invalid API key.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error:
              message: Invalid api key
    NotFound:
      description: The requested resource was not found.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error:
              message: Payment intent not found
  schemas:
    Error:
      type: object
      description: Standard error envelope returned for all non-2xx responses.
      properties:
        error:
          type: object
          properties:
            message:
              type: string
            code:
              type: string
          required:
            - message
      required:
        - error
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: 'Pass your API key as a bearer token: `Authorization: Bearer <API_KEY>`.'

````