---
title: "Create processor correction"
method: POST
path: "/api/v1/processor-corrections"
tags: ["API"]
---

# Create processor correction

`POST /api/v1/processor-corrections`

## Request

- Base URL: `https://api.lapyme.com.ar`
- URL: `https://api.lapyme.com.ar/api/v1/processor-corrections`
- Auth: HTTP bearer

Record a dated refund, chargeback or charge correction against a payment or settlement. Requires Idempotency-Key. Same payload replays; changed payload conflicts with HTTP 409. Fees and withholdings use reported amounts only.

## Headers

- `Idempotency-Key` string, required

## Request body

- object
  - `customerPaymentId` string, uuid
  - `paymentSplitId` string, uuid
  - `settlementId` string, uuid
  - `creditNoteId` string, uuid
  - `bankAccountId` string, uuid
  - `bankDelta` integer
  - `chargeSource` 'payment' | 'settlement'
  - `eventKind` 'refund' | 'chargeback' | 'fee_correction' | 'withholding_correction', required
  - `occurredAt` string, date, required
  - `principalAmount` integer, required
  - `feeDelta` integer, required
  - `withholdingDeltas` object[], required
    - `taxKind` 'iibb' | 'vat' | 'income_tax' | 'suss' | 'stamps', required
    - `deductionType` 'tax_withholding' | 'tax_perception', required
    - `jurisdiction` string
    - `amount` integer, required
  - `integrationSource` string
  - `integrationId` string

## Response `201`

Committed resource or replay

- object
  - `request_id` string, required
  - `data` object, required
    - `object` 'processor_correction', required
    - `id` string, uuid, required

## Other responses

- `400`: Request could not be completed
- `401`: Request could not be completed
- `403`: Request could not be completed
- `404`: Request could not be completed
- `409`: Idempotency or state conflict
- `422`: Request could not be completed
- `429`: Request could not be completed
- `503`: Request could not be completed Verificación de credenciales temporalmente ocupada; reintentá sin cambiar la operación ni su Idempotency-Key.

## Changes

- **2026-11-03** `ed0d46e68fbe`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/lapyme/apis/la-pyme-api/changes/api/v1/processor-corrections/post.md)

---

[API](https://skmtc.dev/lapyme/apis/la-pyme-api.md) - [All operations](https://skmtc.dev/lapyme/apis/la-pyme-api/llms.txt) - [OpenAPI document](https://skmtc.dev/lapyme/apis/la-pyme-api/revisions/067bbb55f421?raw)