API · processModification

API v1

Una herramienta del MCP envuelve esta operación: Ventas y transacciones.

POST /api/v1/processModification

Qué hace#

Permite modificar una transacción ya procesada: captura, reembolso o reverso.

Requiere el token bearer del API en el header Authorization — ver autenticación.

orderNumberstringrequerido#

Número de la orden que se envió en el cobro original.

typestringrequerido#

Tipo de modificación.

amountstringrequerido#

Monto que se desea modificar.

keystringrequerido#

Llave relacionada con el cliente. Se obtiene en Panel administrativo · Integración con plataformas.

Los valores <...> son marcadores: reemplazalos por tus credenciales y datos.

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

type: "100" indica que la modificación se procesó; el resultado está en ReasonCode y ReasonCodeDescription. 1101 = aprobada.

Aprobada:

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

Rechazada:

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

Error (type 300 o 400):

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

typestring#

"100" indica que la modificación se procesó.

transactionIdnumber#

Identificador de la transacción.

ReasonCodestring#

Código de resultado de la modificación.

ReasonCodeDescriptionstring#

Texto del resultado.

OrderHashstring#

Hash de la orden. Ver la nota sobre orderHash en webhooks.

Para interpretar una respuesta que no es de éxito, ver cómo leer una respuesta de error.

Última verificación: 2026-10-22