---
title: "Invoice Actions"
method: POST
path: "/v1/installations/{integrationConfigurationId}/billing/invoices/{invoiceId}/actions"
tags: ["marketplace"]
---

# Invoice Actions

`POST /v1/installations/{integrationConfigurationId}/billing/invoices/{invoiceId}/actions`

## Request

- Base URL: `https://api.vercel.com`
- URL: `https://api.vercel.com/v1/installations/{integrationConfigurationId}/billing/invoices/{invoiceId}/actions`
- Auth: HTTP bearer

This endpoint allows the partner to request a refund for an invoice to Vercel. The invoice is created using the [Submit Invoice API](#submit-invoice-api).

## Path parameters

- `integrationConfigurationId` string, required
- `invoiceId` string, required

## Request body

- object
  - `action` 'refund', required
  - `reason` string, required: Refund reason.
  - `total` string, required: The total amount to be refunded. Must be less than or equal to the total amount of the invoice.

## Response `204`

## Other responses

- `400`: One of the provided values in the request body is invalid. One of the provided values in the request query is invalid.
- `401`: The request is not authorized.
- `403`: You do not have permission to access this resource.
- `404`
- `409`
- `410`

## Changes

- **2026-07-21** `2ae10ee9d21c`: 1 info
  - added the non-success response with the status `410`
- **2026-06-11** `14b4658f819e`: 1 warning
  - changed the pattern of the request property `oneOf[subschema #1]/total` from `^[0-9]+(\\.[0-9]+)?$` to `^[0-9]+(\.[0-9]+)?$`
- **2026-01-22** `c12186034433`: 1 breaking
  - request body became required
- **2025-10-09** `50caddad4ae7`: 1 breaking, 3 warning, 2 info
  - the request's body type changed from `object` to no type
  - removed the request property `action`
  - removed the request property `reason`
  - removed the request property `total`
  - …2 more
- **2025-03-19** `37b482c58c92`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/vercel/apis/vercel-api/changes/v1/installations/:integrationConfigurationId/billing/invoices/:invoiceId/actions/post.md)

---

[API](https://skmtc.dev/vercel/apis/vercel-api.md) - [All operations](https://skmtc.dev/vercel/apis/vercel-api/llms.txt) - [OpenAPI document](https://skmtc.dev/vercel/apis/vercel-api/revisions/60686c0e1f6a?raw)