# API · processModification

> Capture, refund and reversal of a transaction with processModification.

- kind: api-operation
- status: stable
- api_version: v1
- last_verified: 2026-10-22
- url: https://tilopay.com/en/developers/api/procesos-operativos/process-modification

```http
POST /api/v1/processModification
```

## What it does [#que-hace]

Modifies an already processed transaction: capture, refund or reversal.

## Authentication [#autenticacion]

Requires the API bearer token in the `Authorization` header — see [authentication](/en/developers/api/autenticacion).

## Parameters [#parametros]

<Param id="process-modification-parametro-ordernumber" name="orderNumber" type="string" required>
Number of the order sent in the original charge.
</Param>

<Param id="process-modification-parametro-type" name="type" type="string" required>
Type of modification.

| Code | Value |
| --- | --- |
| 1 | Capture |
| 2 | Refund |
| 3 | Reversal |
</Param>

<Param id="process-modification-parametro-amount" name="amount" type="string" required>
Amount to modify.
</Param>

<Param id="process-modification-parametro-key" name="key" type="string" required>
Key associated with the customer. Obtained in Admin panel · Platform integrations.
</Param>

## Request example [#request]

The `<...>` values are placeholders: replace them with your own credentials and data.

```json
{
  "orderNumber": "1214352",
  "type": "2",
  "amount": "1.00",
  "key": "<api_key>"
}
```

## Response [#respuesta-modificacion]

`type: "100"` means the modification was processed; its outcome is in `ReasonCode` and `ReasonCodeDescription`. `1101` = approved.

Approved:

```json
{"type":"100","transactionId":954183,"ReasonCode":"1101","ReasonCodeDescription":"Transaccion aprobada","OrderHash":"<order_hash>"}
```

Rejected:

```json
{"type":"100","transactionId":954183,"ReasonCode":"3","ReasonCodeDescription":"Invalid Retrieval reference number","OrderHash":"<order_hash>"}
```

Error (`type` 300 or 400):

```json
{"type":"400","message":"Order number: TYP974_172 does not exist"}
```

<Param id="modification-type" name="type" type="string">
`"100"` indicates that the modification was processed.
</Param>

<Param id="modification-transactionid" name="transactionId" type="number">
Transaction identifier.
</Param>

<Param id="modification-reasoncode" name="ReasonCode" type="string">
Result code of the modification.
</Param>

<Param id="modification-reasoncodedescription" name="ReasonCodeDescription" type="string">
Result text.
</Param>

<Param id="modification-orderhash" name="OrderHash" type="string">
Order hash. See the note about `orderHash` in [webhooks](/en/developers/api/webhooks#verificacion).
</Param>

To interpret a response that is not a success, see [how to read an error response](/en/developers/api/procesos-operativos/errors).