> For the complete documentation index, see [llms.txt](https://docs.qentaz.com/documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.qentaz.com/documentation/cobros/actualizar-cobro.md).

# Actualizar cobro

Modifica o habilita un cobro previamente creado. Además, al habilitar el cobro, tendrás la opción de determinar si deseas enviar una notificación al usuario.

## &#x20;Ruta

<mark style="color:purple;">`PATCH`</mark> `/v1/merchant/transaction/{external_reference}`

## **Encabezado**

| Name                                                   | Value            |
| ------------------------------------------------------ | ---------------- |
| `Content-Type`*<mark style="color:red;">**\***</mark>* | application/json |
| `x-auth-token`*<mark style="color:red;">**\***</mark>* | {token}          |
| `child-id`                                             | {business\_id}   |

{% hint style="info" %}
El child-id es opcional y se usa para las cuentas administradas para conocer más puedes ingresa a este [enlace](https://docs.qentaz.com/documentation/cobros/terminos-de-relevancia.md#cuentas-administradas).
{% endhint %}

## **Cuerpo**&#x20;

Al actualizar o activar esta transacción, puedes completar o cambiar los siguientes campos. Ten en cuenta que los nuevos valores reemplazarán los anteriores, por lo que se perderá la información anterior.

{% hint style="warning" %}
Es importante destacar que los campos: *`payer_email`* &#x79;*`payer_phone`***no son modificables**. Si envías información para estos campos, se creará un nuevo usuario con los datos proporcionados.
{% endhint %}

### **Información general**

<table><thead><tr><th width="272">Name</th><th width="114">Type<select><option value="DaQG16MLyNu5" label="string" color="blue"></option><option value="j5g98HKBXFeM" label="numeric" color="blue"></option><option value="LfwEXDRYkgyC" label="date" color="blue"></option><option value="iU6FOMiECRYw" label="boolean" color="blue"></option></select></th><th>Description</th></tr></thead><tbody><tr><td><code>description</code></td><td><span data-option="DaQG16MLyNu5">string</span></td><td>Proporciona detalles clave sobre la transacción y es lo que se refleja en los comprobantes de pago.<br><br><em><mark style="color:blue;"><code>Ejemplo: Servicio de entrega</code></mark></em></td></tr><tr><td><code>currency</code></td><td><span data-option="DaQG16MLyNu5">string</span></td><td><p>Código que identifica la divisa del pago en formato ISO 4217.<br></p><p><mark style="color:green;"><code>COP | USD | MXN</code></mark><br></p></td></tr><tr><td><code>amount</code></td><td><span data-option="j5g98HKBXFeM">numeric</span></td><td>Es el código generado a partir del proceso de autenticación.<br><br><em><mark style="color:blue;"><code>Ejemplo: 54000</code></mark></em></td></tr><tr><td><code>status</code></td><td><span data-option="DaQG16MLyNu5">string</span></td><td>Es el estado de la transacción al momento de creación. <a href="https://docs.qentaz.com/documentation/cobros/terminos-de-relevancia.md#tipos-de-estados">Para más información de los estados.</a><br><br><mark style="color:green;"><code>pending | unlimit | scheduled | created</code></mark></td></tr><tr><td><code>reference_one</code><br><br><code>reference_two</code><br><br><code>reference_three</code><br><br><code>reference_four</code><br><br><code>reference_five</code><br><br><code>reference_six</code><br><br><code>reference_seven</code><br><br><code>reference_eight</code></td><td><span data-option="DaQG16MLyNu5">string</span></td><td>Información adicional de la transacción (número de factura, ordenes de compra, categoría), visible para los usuarios.<br><br><em><mark style="color:blue;"><code>Ejemplo: FAC123</code></mark></em></td></tr><tr><td><code>channel</code></td><td><span data-option="DaQG16MLyNu5">string</span></td><td>Es la forma como se realiza el cobro.<br><br><mark style="color:green;"><code>whatsapp | link | email</code></mark></td></tr><tr><td><code>return_url</code></td><td><span data-option="DaQG16MLyNu5">string</span></td><td>Es la url a la que quieres llevar al usuario después de completar el pago. Aplica para pagos por PSE o con link de pago.<br><br><em><mark style="color:blue;"><code>Ejemplo:https://minegocio.com/mi-aplicacion</code></mark></em></td></tr><tr><td><code>expected_amount</code></td><td><span data-option="j5g98HKBXFeM">numeric</span></td><td>Es el valor esperado de la transacción.<br><br><em><mark style="color:blue;"><code>Ejemplo: 10000</code></mark></em></td></tr><tr><td><code>expected_date</code></td><td><span data-option="LfwEXDRYkgyC">date</span></td><td>Es la fecha estimada de finalización de la transacción.<br><br><mark style="color:green;"><code>Formato: AAAA/MM/DD</code></mark><br><br><em><mark style="color:blue;"><code>Ejemplo: 2025/01/30</code></mark></em></td></tr><tr><td><code>reminder_date</code></td><td><span data-option="LfwEXDRYkgyC">date</span></td><td>Es la fecha en la que quieres enviarle un recordatorio de pago al cliente.  <br><br><mark style="color:green;"><code>Formato: AAAA/MM/DD</code></mark><br><br><em><mark style="color:blue;"><code>Ejemplo: 2025/01/30</code></mark></em></td></tr><tr><td><code>limit_date</code></td><td><span data-option="LfwEXDRYkgyC">date</span></td><td>Es la fecha en la que vence el pago para el cliente. <em>Solo aplica cuando status es igual scheduled.</em><br><br><mark style="color:green;"><code>Formato: AAAA/MM/DD</code></mark><br><br><em><mark style="color:blue;"><code>Ejemplo: 2025/01/30</code></mark></em></td></tr><tr><td><code>merchant_id_number</code></td><td><span data-option="DaQG16MLyNu5">string</span></td><td>Número de documento del usuario que genera el cobro.<br><br><em><mark style="color:blue;"><code>Ejemplo: 100110000</code></mark></em></td></tr><tr><td><code>merchant_phone</code></td><td><span data-option="DaQG16MLyNu5">string</span></td><td>Número de celular del usuario que genera el cobro (incluir el código de área del país).<br><br><em><mark style="color:blue;"><code>Ejemplo: 573112229999</code></mark></em></td></tr><tr><td><code>merchant_email</code></td><td><span data-option="DaQG16MLyNu5">string</span></td><td>Correo del cliente al que se enviarán las notificaciones.<br><br><em><mark style="color:blue;"><code>Ejemplo: usuario@minegocio.com</code></mark></em></td></tr><tr><td><code>user_notification</code></td><td><span data-option="iU6FOMiECRYw">boolean</span></td><td><p>Define si se quiere enviar una notificación del cobro al usuario. Por defecto el valor es <em><strong>true</strong></em>.</p><p><br><br><mark style="color:green;"><code>true | false</code></mark></p></td></tr><tr><td><code>process_type</code></td><td><span data-option="DaQG16MLyNu5">string</span></td><td><p>Método que se usará para el proceso de cobro. </p><p></p><p>Según el método utilizado, el estado de la transacción se ajusta automáticamente. En el caso de cash, el estado se convierte en REVIEW, para digital en PENDING, para credit en CREDIT, para return_pending en RET_PENDING y para return_success en RET_SUCCESS. <br><br><mark style="color:green;"><code>cash | digital | credit | return | express | split | direct | external</code></mark></p></td></tr><tr><td><code>expiration</code></td><td><span data-option="iU6FOMiECRYw">boolean</span></td><td>Define si la transacción debe cancelarse al alcanzar la <strong>limit date</strong>. Por defecto, este valor es <strong>false</strong>.</td></tr><tr><td><code>attachment</code></td><td><span data-option="DaQG16MLyNu5">string</span></td><td>Adjunto que funciona como soporte del cobro.</td></tr><tr><td><code>comments</code></td><td><span data-option="DaQG16MLyNu5">string</span></td><td>Comentario opcional para tener como referencia al consultar las transacciones en el dashboard.</td></tr></tbody></table>

{% hint style="info" %}
Si el campo *user\_notification* está establecido como true, **se enviará la notificación solo si el campo channel está configurado como whatsapp o email**. Además, cuando el canal es whatsapp, el campo payer.phone es obligatorio, y cuando el canal es email, el campo payer.email es obligatorio.
{% endhint %}

### **Información cliente/pagador**

<table><thead><tr><th width="249">Name</th><th width="113">Type<select><option value="tW4OOsURXuNZ" label="string" color="blue"></option></select></th><th>Description</th></tr></thead><tbody><tr><td><code>payer.phone</code></td><td><span data-option="tW4OOsURXuNZ">string</span></td><td><p>Número de celular del cliente (incluir el código de área del país).  </p><p></p><p><em>Obligatorio en caso del que el channel sea <strong>whatsapp</strong> y el status no sea <strong>created</strong>.</em><br><br><em><mark style="color:blue;"><code>Ejemplo: 573112223333</code></mark></em></p></td></tr><tr><td><code>payer.email</code></td><td><span data-option="tW4OOsURXuNZ">string</span></td><td>Correo del cliente al que se enviarán las notificaciones.<br><br><em>Obligatorio en caso del que el channel sea <strong>email</strong> y el status no sea <strong>created</strong>.</em><br><br><em><mark style="color:blue;"><code>Ejemplo: cliente@minegocio.com</code></mark></em></td></tr><tr><td><code>payer.user_id_type</code></td><td><span data-option="tW4OOsURXuNZ">string</span></td><td>Tipo de documento de identificación del cliente.<br><br><mark style="color:green;"><code>CC | CE | NIT | PASAPORTE | DNI | EIN</code></mark></td></tr><tr><td><code>payer.user_id_number</code></td><td><span data-option="tW4OOsURXuNZ">string</span></td><td>Número del documento de identificación del cliente.<br><br><em><mark style="color:blue;"><code>Ejemplo: 11119999</code></mark></em></td></tr><tr><td><code>payer.first_name</code></td><td><span data-option="tW4OOsURXuNZ">string</span></td><td>Primer nombre del cliente, el cual se usa para la validación del número de documento.<br><br><em><mark style="color:blue;"><code>Ejemplo: Andrés</code></mark></em></td></tr></tbody></table>

{% hint style="warning" %}
Los campos: *`payer.user_id_type`*, *`payer.user_id_number`* y *`payer.first_name`* deben completarse de manera conjunta en la API. Esto significa que si se proporciona uno de estos campos, los otros dos también deben ser proporcionados. Son interdependientes y necesarios para garantizar la integridad de la información del usuario en la plataforma.
{% endhint %}

### Pagos en devolución

Este objeto es obligatorio cuando el process type sea **return**.

<table><thead><tr><th width="249">Name</th><th width="113">Type<select><option value="rRB3kMFO5APd" label="string" color="blue"></option></select></th><th>Description</th></tr></thead><tbody><tr><td><mark style="color:orange;"><code>return.type</code>*</mark></td><td><span data-option="rRB3kMFO5APd">string</span></td><td>Tipo de devolución. Si se selecciona <strong>pending</strong>, el estado se actualiza a <strong>RET_PENDING</strong> y debe ser aprobado manualmente desde el dashboard para cambiar a <strong>RET_SUCCESS</strong>. En cambio, si se selecciona <strong>success</strong>, el estado se establece directamente como <strong>RET_SUCCESS</strong>.<br><br><mark style="color:green;"><code>pending | success</code></mark></td></tr><tr><td><mark style="color:orange;"><code>return.reason</code>*</mark></td><td><span data-option="rRB3kMFO5APd">string</span></td><td>Razón de la devolución.<br><br><em><mark style="color:blue;"><code>Ejemplo: No se encontró el cliente</code></mark></em></td></tr></tbody></table>

### Pagos express

Este objeto es obligatorio cuando el process type sea **express**.

<table><thead><tr><th width="249">Name</th><th width="113">Type<select><option value="rRB3kMFO5APd" label="string" color="blue"></option></select></th><th>Description</th></tr></thead><tbody><tr><td><mark style="color:yellow;"><code>express.method</code>*</mark></td><td><span data-option="rRB3kMFO5APd">string</span></td><td><p>Método de pago. En el caso de <strong>qr</strong>, la respuesta incluirá el enlace de la imagen QR en el campo <strong>qr_url</strong>.</p><p><br><mark style="color:green;"><code>nequi| daviplata | qr</code></mark></p></td></tr><tr><td><mark style="color:yellow;"><code>express.reference</code></mark></td><td><span data-option="rRB3kMFO5APd">string</span></td><td><p>Identificador del usuario al que se le realizará el cobro. Para <strong>Nequi</strong>, debe ser el número de celular; mientras que para <strong>Daviplata</strong>, debe ser el número de documento con el que el usuario se registró en la aplicación.</p><p></p><p><em>Obligatorio en caso del que el method sea <strong>nequi</strong> o <strong>daviplata</strong>.</em><br><br><em><mark style="color:blue;"><code>Ejemplo: No se encontró el cliente</code></mark></em></p></td></tr></tbody></table>

### Pagos externos

Este objeto es obligatorio cuando el process type sea **external**.

<table><thead><tr><th width="249">Name</th><th width="113">Type<select><option value="rRB3kMFO5APd" label="string" color="blue"></option></select></th><th>Description</th></tr></thead><tbody><tr><td><mark style="color:red;"><code>external.reason</code>*</mark></td><td><span data-option="rRB3kMFO5APd">string</span></td><td><p>Razón por el cual es un pago externo.</p><p><br><em><mark style="color:blue;"><code>Ejemplo: Pago directo</code></mark></em></p></td></tr></tbody></table>

### Pagos divididos

Array de objetos, es obligatorio cuando el process type sea **split**. El objeto se compone de la siguiente manera:

<table><thead><tr><th width="249">Name</th><th width="113">Type<select><option value="rRB3kMFO5APd" label="string" color="blue"></option><option value="bx1LW0Kmlvn7" label="objeto" color="blue"></option><option value="B9BHLoQ9vYyR" label="numeric" color="blue"></option></select></th><th>Description</th></tr></thead><tbody><tr><td><mark style="color:purple;"><code>split[].amount</code>*</mark></td><td><span data-option="B9BHLoQ9vYyR">numeric</span></td><td><p>Fracción o monto del pago que se va a realizar.</p><p><br><em><mark style="color:blue;"><code>Ejemplo: 5000</code></mark></em></p></td></tr><tr><td><mark style="color:purple;"><code>split[].payment_method</code>*</mark></td><td><span data-option="rRB3kMFO5APd">string</span></td><td><p>Medio de pago a través del cual se realizará la fracción del pago.</p><p><br><mark style="color:green;"><code>cash | digital | credit | return | express | direct | external</code></mark> </p></td></tr><tr><td><mark style="color:purple;"><code>split[].return</code></mark></td><td><span data-option="bx1LW0Kmlvn7">objeto</span></td><td>El objeto se compone de la misma manera que return: <a data-mention href="#pagos-en-devolucion">#pagos-en-devolucion</a><br><br><em>Obligatorio en caso del que el payment_method sea <strong>return</strong>.</em></td></tr><tr><td><mark style="color:purple;"><code>split[].express</code></mark></td><td><span data-option="bx1LW0Kmlvn7">objeto</span></td><td>El objeto se compone de la misma manera que express: <a data-mention href="#pagos-express">#pagos-express</a><br><br><em>Obligatorio en caso del que el payment_method sea <strong>express</strong>.</em></td></tr><tr><td><mark style="color:purple;"><code>split[].external</code></mark></td><td><span data-option="bx1LW0Kmlvn7">objeto</span></td><td>El objeto se compone de la misma manera que external: <a data-mention href="#pagos-externos">#pagos-externos</a><br><br><em>Obligatorio en caso del que el payment_method sea <strong>external</strong>.</em></td></tr></tbody></table>

### Distribución de ítems en pagos divididos

Permite distribuir los ítems existentes de un cobro entre los segmentos de un split. El comercio debe tener habilitada la división de cobros.

Envía `PATCH /v1/merchant/transaction/{external_reference}` con `process_type: "split"` y `items` en cada segmento. Obtén los identificadores de ítems mediante [Consultar cobro](https://docs.qentaz.com/documentation/cobros/consultar-cobro.md).

| Campo                         | Tipo   | Obligatorio | Descripción                                                                             |
| ----------------------------- | ------ | ----------- | --------------------------------------------------------------------------------------- |
| `split[].items`               | Array  | Condicional | Distribución de ítems del cobro. Si se incluye en un segmento, debe incluirse en todos. |
| `split[].items[].id`          | Number | Sí          | Identificador del ítem original, obtenido al consultar el cobro.                        |
| `split[].items[].quantity`    | Number | Sí          | Cantidad del ítem asignada a este segmento.                                             |
| `split[].items[].total_price` | Number | Sí          | Valor total del ítem asignado a este segmento.                                          |

* Cada asignación indica el `id` del ítem original, la `quantity` y el `total_price` asignados al segmento.
* Distribuye por completo todos los ítems originales: la suma de cantidades y valores asignados a cada ítem debe coincidir con sus valores originales. Cada ítem puede aparecer una sola vez por segmento.
* La suma de `total_price` de un segmento debe coincidir con su `amount`. Los montos de todos los segmentos deben sumar el monto del cobro.
* El impuesto incluido en el valor del ítem se distribuye automáticamente entre los segmentos, proporcionalmente a sus valores.
* Envía al menos dos segmentos y como máximo cuatro. No combines los `items` del split con `items` en la raíz del PATCH.
* Sin `items` dentro de `split`, se conserva el comportamiento anterior: los ítems no se distribuyen automáticamente.
* Los ítems compartidos con otros cobros no se pueden distribuir mediante esta opción.

Por ejemplo, un cobro de $3.000 tiene un ítem de cinco unidades por $2.000 con $380 de IVA y otro de una unidad por $1.000 con $190 de IVA:

{% code collapsedlinecount="10" %}

```json
{
  "process_type": "split",
  "user_notification": false,
  "split": [
    {
      "payment_method": "cash",
      "amount": 800,
      "items": [
        { "id": 101, "quantity": 2, "total_price": 800 }
      ]
    },
    {
      "payment_method": "cash",
      "amount": 2200,
      "items": [
        { "id": 101, "quantity": 3, "total_price": 1200 },
        { "id": 102, "quantity": 1, "total_price": 1000 }
      ]
    }
  ]
}
```

{% endcode %}

El primer segmento conserva la referencia del cobro original; los demás reciben referencias nuevas en la respuesta. Cuando un ítem se reparte, cada segmento contiene su parte y puede tener un ID de ítem diferente. Consulta cada cobro para obtener sus IDs actuales.

#### Errores y acciones posteriores

Una validación incorrecta devuelve `400` sin aplicar la división. La creación de segmentos, la distribución de ítems y el registro de pagos `external` se guardan en una sola transacción: si falla el registro externo, se revierte la división.

La notificación no bloquea el split. Si su envío falla o no se puede confirmar, la respuesta `200` incluye una advertencia por cada referencia afectada:

{% code collapsedlinecount="10" %}

```json
{
  "message": "Succesfully Updated",
  "external_reference": "ABC123",
  "split": [
    { "external_reference": "ABC123", "amount": 800 },
    { "external_reference": "DEF456", "amount": 2200 }
  ],
  "warnings": [
    { "code": "NOTIFICATION_FAILED", "external_reference": "ABC123" }
  ]
}
```

{% endcode %}

Antes de volver a enviar una notificación, verifica si fue recibida: un timeout no garantiza que haya fallado.

Si falla un pago `express` después de guardar el split, o no se puede confirmar su resultado, la API devuelve `502` con `code: "SPLIT_ACTION_FAILED"` y la lista completa de segmentos:

{% code collapsedlinecount="10" %}

```json
{
  "code": "SPLIT_ACTION_FAILED",
  "message": "The split was created, but a subsequent action failed or its result is unknown. Check the segment before retrying.",
  "split": [
    { "external_reference": "ABC123", "amount": 800, "payment_method": "cash", "action": "completed" },
    { "external_reference": "DEF456", "amount": 2200, "payment_method": "express", "action": "unknown" }
  ]
}
```

{% endcode %}

`completed` indica que el segmento se procesó; `unknown`, que el intento express falló o no se pudo confirmar; y `not_attempted`, que aún no se procesó la acción posterior de ese segmento. La respuesta puede incluir también `warnings` si falló una notificación anterior.

Consulta el estado de cada segmento antes de actuar. No reenvíes el split completo ni reintentes automáticamente un pago express de resultado incierto: el proveedor podría haberlo procesado.

### Información de afiliados

<table><thead><tr><th width="249">Name</th><th width="113">Type<select><option value="rRB3kMFO5APd" label="string" color="blue"></option></select></th><th>Description</th></tr></thead><tbody><tr><td><mark style="color:orange;"><code>affiliate.id_type</code></mark></td><td><span data-option="rRB3kMFO5APd">string</span></td><td>Tipo de documento de identificación del afiliado.<br><br><mark style="color:green;"><code>CC | CE | NIT | PASAPORTE | DNI | EIN</code></mark></td></tr><tr><td><mark style="color:orange;"><code>affiliate.id_number</code></mark></td><td><span data-option="rRB3kMFO5APd">string</span></td><td>Número del documento de identificación del afiliado.<br><br><em><mark style="color:blue;"><code>Ejemplo: 11119999</code></mark></em></td></tr></tbody></table>

### **Información de facturación**

<table><thead><tr><th width="249">Name</th><th width="113">Type<select><option value="CRQXJNwgXiB2" label="string" color="blue"></option></select></th><th>Description</th></tr></thead><tbody><tr><td><mark style="color:purple;"><code>invoice.provider</code></mark></td><td><span data-option="CRQXJNwgXiB2">string</span></td><td><p>Agrega el software contable con el que realizaste la integración.</p><p></p><p><em>Obligatorio para el objeto <strong>invoice</strong>.</em><br><br><mark style="color:green;"><code>alegra | siigo</code></mark></p></td></tr><tr><td><mark style="color:purple;"><code>invoice.type</code></mark></td><td><span data-option="CRQXJNwgXiB2">string</span></td><td><p>Elige el tipo de vinculación que quieres realizar para esta transacción con tu software contable.</p><p></p><p><em>Obligatorio para el objeto <strong>invoice</strong>.</em><br><br><mark style="color:green;"><code>link | balance | create</code></mark></p></td></tr><tr><td><mark style="color:purple;"><code>invoice.id</code></mark></td><td><span data-option="CRQXJNwgXiB2">string</span></td><td>Corresponde al identificador de la factura o el cliente según el tipo de vinculación definido.<br><br><em><mark style="color:blue;"><code>Ejemplo: FV-2-1234 | GR1234 |</code></mark></em><mark style="color:blue;"><code> </code><code>41515fb0-d815-40ac-86c0-4081eb642fa2</code></mark></td></tr><tr><td><mark style="color:purple;"><code>invoice.retentions</code></mark></td><td><span data-option="CRQXJNwgXiB2">string</span></td><td>Solo si la vinculación es <code>create</code>, agregar las retenciones aplicables para la creación de la factura. <strong>Tener en cuenta que el valor de la factura será el valor de la transacción mas las retenciones definidas.</strong><br><br><mark style="color:green;"><code>Formato: enviar las retenciones separadas por comas</code></mark><br><br><em><mark style="color:blue;"><code>Ejemplo: [1,2,3]</code></mark></em></td></tr></tbody></table>

### **Información de recargos**

Array de objetos, para aplicar recargos:

<table><thead><tr><th width="252.20001220703125">Name</th><th width="113">Type<select><option value="qBeT2Xqfqzst" label="string" color="blue"></option><option value="fqKgpLHMeRsK" label="array" color="blue"></option><option value="DbIS6pyjqlWy" label="numeric" color="blue"></option><option value="EjFL03h7GPMG" label="date" color="blue"></option><option value="9Yt4blEICw5U" label="boolean" color="blue"></option></select></th><th>Description</th></tr></thead><tbody><tr><td><mark style="color:yellow;"><code>late_fees[].action</code>*</mark></td><td><span data-option="DbIS6pyjqlWy">numeric</span></td><td><p>Valor correspondiente al recargo.<br><br><em>Obligatorio en caso del que el condition_type sea <strong>fixed</strong>.</em><br></p><p><mark style="color:green;"><code>add | edit | delete</code></mark></p></td></tr><tr><td><mark style="color:yellow;"><code>late_fees[].id</code></mark></td><td><span data-option="qBeT2Xqfqzst">string</span></td><td><p>Identificador que permite ubicar o referenciar el recargo que se va a actualizar.</p><p></p><p><em>Obligatorio si el action es <strong>edit</strong> o <strong>delete</strong>.</em><br><br><em><mark style="color:blue;"><code>Ejemplo: a1b2c3</code></mark></em></p></td></tr><tr><td><mark style="color:yellow;"><code>late_fees[].date</code></mark></td><td><span data-option="qBeT2Xqfqzst">string</span></td><td><p>Fecha correspondiente al recargo.</p><p></p><p><em>Obligatorio si el action es <strong>add</strong>.</em><br><br><mark style="color:green;"><code>Formato: AAAA/MM/DD</code></mark><br><br><em><mark style="color:blue;"><code>Ejemplo: 2025/01/30</code></mark></em></p></td></tr><tr><td><mark style="color:yellow;"><code>late_fees[].value</code></mark></td><td><span data-option="qBeT2Xqfqzst">string</span></td><td><p>Valor al cual se va actualizar el monto.</p><p><br><em>Obligatorio si el action es <strong>add</strong>.</em></p><p><br><em><mark style="color:blue;"><code>Ejemplo: 1234.5</code></mark></em></p></td></tr><tr><td><mark style="color:yellow;"><code>late_fees[].reminder</code></mark></td><td><span data-option="qBeT2Xqfqzst">string</span></td><td>En caso de que se desee recibir una notificación en el momento en que se aplique el incremento.</td></tr><tr><td><mark style="color:yellow;"><code>late_fees[].reminder_template</code></mark></td><td><span data-option="qBeT2Xqfqzst">string</span></td><td>Nombre del mensaje que se le envía para dicho recargo.<br><br><em>Obligatorio en caso del que el reminder sea <strong>true</strong>.</em></td></tr><tr><td><mark style="color:yellow;"><code>late_fees[].reminder_channel</code></mark></td><td><span data-option="fqKgpLHMeRsK">array</span></td><td>Canal por el cual se le va enviar la notificación.<br><br><em>Obligatorio en caso del que el reminder sea <strong>true</strong>.</em><br><br><mark style="color:green;"><code>whatsapp | email</code></mark></td></tr></tbody></table>

### **Información de pagos anticipados**

Array de objetos, para aplicar pagos anticipados:

<table><thead><tr><th width="252.20001220703125">Name</th><th width="113">Type<select><option value="qBeT2Xqfqzst" label="string" color="blue"></option><option value="fqKgpLHMeRsK" label="array" color="blue"></option><option value="DbIS6pyjqlWy" label="numeric" color="blue"></option><option value="EjFL03h7GPMG" label="date" color="blue"></option><option value="9Yt4blEICw5U" label="boolean" color="blue"></option></select></th><th>Description</th></tr></thead><tbody><tr><td><mark style="color:orange;"><code>advance_payment[].action</code>*</mark></td><td><span data-option="DbIS6pyjqlWy">numeric</span></td><td><p>Valor correspondiente al descuento.<br><br><em>Obligatorio en caso del que el condition_type sea <strong>fixed</strong>.</em><br></p><p><mark style="color:green;"><code>add | edit | delete</code></mark></p></td></tr><tr><td><mark style="color:orange;"><code>advance_payment[].id</code></mark></td><td><span data-option="qBeT2Xqfqzst">string</span></td><td><p>Identificador que permite ubicar o referenciar el descuento que se va a actualizar.</p><p></p><p><em>Obligatorio si el action es <strong>edit</strong> o <strong>delete</strong>.</em><br><br><em><mark style="color:blue;"><code>Ejemplo: a1b2c3</code></mark></em></p></td></tr><tr><td><mark style="color:orange;"><code>advance_payment[].date</code></mark></td><td><span data-option="qBeT2Xqfqzst">string</span></td><td><p>Fecha correspondiente al descuento.</p><p></p><p><em>Obligatorio si el action es <strong>add</strong>.</em><br><br><mark style="color:green;"><code>Formato: AAAA/MM/DD</code></mark><br><br><em><mark style="color:blue;"><code>Ejemplo: 2025/01/30</code></mark></em></p></td></tr><tr><td><mark style="color:orange;"><code>advance_payment[].value</code></mark></td><td><span data-option="qBeT2Xqfqzst">string</span></td><td><p>Valor al cual se va actualizar el monto.</p><p><br><em>Obligatorio si el action es <strong>add</strong>.</em></p><p><br><em><mark style="color:blue;"><code>Ejemplo: 1234.5</code></mark></em></p></td></tr><tr><td><mark style="color:orange;"><code>advance_payment[].reminder</code></mark></td><td><span data-option="qBeT2Xqfqzst">string</span></td><td>En caso de que se desee recibir una notificación en el momento en que se aplique el incentivo.</td></tr><tr><td><mark style="color:orange;"><code>advance_payment[].reminder_template</code></mark></td><td><span data-option="qBeT2Xqfqzst">string</span></td><td>Nombre del mensaje que se le envía para dicho incentivo.<br><br><em>Obligatorio en caso del que el reminder sea <strong>true</strong>.</em></td></tr><tr><td><mark style="color:orange;"><code>advance_payment[].reminder_channel</code></mark></td><td><span data-option="fqKgpLHMeRsK">array</span></td><td>Canal por el cual se le va enviar la notificación.<br><br><em>Obligatorio en caso del que el reminder sea <strong>true</strong>.</em><br><br><mark style="color:green;"><code>whatsapp | email</code></mark></td></tr></tbody></table>

## **Respuesta**

{% tabs %}
{% tab title="200" %}
{% code collapsedlinecount="10" %}

```json
{
    "message": "Succesfully Updated",
    "external_reference": "90d085",
    "link": "https://pago.qentaz.com/prueba/t/90d085",
    "created_at": "2024-08-26T20:46:25+00:00"
}
```

{% endcode %}
{% endtab %}

{% tab title="400" %}
{% code collapsedlinecount="10" %}

```json
{
    "error": "The transaction cannot be modified because it is in an unmodifiable state (REVIEW). The transaction status must be one of the following: PENDING, UNLIMIT, PROCESSING, CREATED, SCHEDULED, OVERDUE."
}
```

{% endcode %}
{% endtab %}

{% tab title="401" %}
{% code collapsedlinecount="10" %}

```bash
{
    "status": "unauthorized",
    "code": "Q103",
    "error": "El x-auth-token se encuentra vencido. Por favor genera un nuevo token y reintenta de nuevo el cobro."
}
```

{% endcode %}
{% endtab %}
{% endtabs %}

## Ejemplo

{% tabs %}
{% tab title="cURL" %}
{% code collapsedlinecount="10" %}

```bash
curl --location --request PATCH '{{base_url}}/v1/merchant/transaction/{{reference}}' \
--header 'x-auth-token: token' \
--data '{
    "amount": 2000,
    "merchant_phone": "573112222222",
    "status": "CREATED",
    "channel": "WHATSAPP",
    "expected_amount": 2000,
    "expected_date": "10/03/2024",
    "reference_one": "REFERENCIA",
    "description": "Descripción de la transacción",
    "process_type": "CASH",
    "user_notification": false,
    "payer": {
        "phone": "573112222222"
    },
    "affiliate": {
        "id_type": "CC",
        "id_number": "34000000"
    }
}'
```

{% endcode %}
{% endtab %}

{% tab title="NodeJS (Axios)" %}
{% code collapsedlinecount="10" %}

```javascript
const axios = require('axios');
let data = JSON.stringify({
  "amount": 2000,
  "merchant_phone": "573112222222",
  "status": "CREATED",
  "channel": "WHATSAPP",
  "expected_amount": 2000,
  "expected_date": "10/03/2024",
  "reference_one": "REFERENCIA",
  "description": "Descripción de la transacción",
  "process_type": "CASH",
  "user_notification": false,
  "payer": {
    "phone": "573112222222"
  },
  "affiliate": {
    "id_type": "CC",
    "id_number": "34000000"
  }
});

let config = {
  method: 'patch',
  maxBodyLength: Infinity,
  url: `${base_url}/v1/merchant/transaction/${reference}`,
  headers: { 
    'x-auth-token': token //Agregar el token
  },
  data : data
};

axios.request(config)
.then((response) => {
  console.log(JSON.stringify(response.data));
})
.catch((error) => {
  console.log(error);
});

```

{% endcode %}
{% endtab %}

{% tab title="Python" %}
{% code collapsedlinecount="10" %}

```python
import requests
import json

url = f"{base_url}/v1/merchant/transaction/{reference}" #Agregar base_url y reference

payload = json.dumps({
  "amount": 2000,
  "merchant_phone": "573112222222",
  "status": "CREATED",
  "channel": "WHATSAPP",
  "expected_amount": 2000,
  "expected_date": "10/03/2024",
  "reference_one": "REFERENCIA",
  "description": "Descripción de la transacción",
  "process_type": "CASH",
  "user_notification": False,
  "payer": {
    "phone": "573112222222"
  },
  "affiliate": {
    "id_type": "CC",
    "id_number": "34000000"
  }
})
headers = {
  'x-auth-token': token #Agregar token
}

response = requests.request("PATCH", url, headers=headers, data=payload)

print(response.text)

```

{% endcode %}
{% endtab %}
{% endtabs %}

***

## &#x20;Caso de uso&#x20;

<details>

<summary>Actualizar cobro con notificación en WhatsApp (con datos de usuario)</summary>

{% code collapsedlinecount="10" %}

```bash
curl --location --request PATCH '{base_url}/v1/merchant/transaction/be83f3' \
--header 'x-auth-token: {token}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "amount": 20900,
    "currency": "COP",
    "description": "Servicio de consultoría",
    "reference_one": "Mayo 2023",
    "reference_two": "FT1235",
    "reference_three": "Prueba 2",
    "reference_four": "C3D4",
    "channel": "whatsapp",
    "status": "pending",
    "merchant_phone": 573999999999,
    "return_url": "https://minegocio.com/resultado",

    "payer": {
        "first_name": "Prueba",
        "user_id_type": "CC",
        "user_id_number": "99999999"
    },
    
    "user_notification": true
}'
```

{% endcode %}

</details>

<details>

<summary>Actualizar cobro a programado con notificación en correo (sin datos de usuario)</summary>

{% code collapsedlinecount="10" %}

```bash
curl --location --request PATCH '{base_url}/v1/merchant/transaction/be83f3' \
--header 'x-auth-token: {token}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "amount": 34600,
    "currency": "COP",
    "description": "Servicio de consultoría",
    "reference_one": "Junio 2023",
    "reference_two": "FT4679",
    "reference_three": "Test",
    "reference_four": "E5F6",
    "channel": "email",
    "status": "scheduled",
    "merchant_phone": 573999999999,
    "return_url": "https://minegocio.com/resultado",
    
    "reminder_date": "10/31/2023",
    "limit_date": "11/05/2023",
    
    "user_notification": true
}'
```

{% endcode %}

</details>

***
