Actualizar transacción

Actualiza una transacción existente. Todos los campos son opcionales: envía solo lo que quieres cambiar.

Cuando se envían child records (items, addresses, payments, refunds, customer), reemplazan por completo los registros existentes.

Endpoint

PATCH https://api.rapidchargeback.com/api/v1/transactions/:id

Autenticación

Authorization: Basic base64(client_id:client_secret)
Content-Type: application/json

---

Parámetro de URL

Parámetro	Tipo	Descripción
id	string (UUID)	ID de la transacción (devuelto en el campo id de la respuesta de creación)

¿No guardaste el id? Encuentra la transacción por el ID de tu sistema.

---

Campos aceptados

Todos los campos aceptados por Crear transacción se pueden enviar aquí, todos opcionales:

• Los campos enviados reemplazan el valor actual
• Los campos omitidos mantienen el valor actual
• Los child records enviados (items, addresses, etc.) reemplazan por completo los existentes

---

Validaciones

• Si se cambia merchant_id, el nuevo merchant debe pertenecer a tu empresa
• Si se cambian external_id o external_source, la combinación no puede duplicar otra transacción existente
• Si la transacción ya fue usada por alguna solución (ej.: consultada por la Prevención), la actualización se bloquea con 409 Conflict

---

Ejemplo de solicitud

Actualizar solo el ARN y el auth_code

curl -X PATCH https://api.rapidchargeback.com/api/v1/transactions/00000000-0000-0000-0000-000000000042 \
  -H "Authorization: Basic Y2xpZW50X2lkOmNsaWVudF9zZWNyZXQ=" \
  -H "Content-Type: application/json" \
  -d '{
    "arn": "74537119547024600128228",
    "auth_code": "AUTH999"
  }'

Actualizar ítems (reemplaza todos los ítems existentes)

curl -X PATCH https://api.rapidchargeback.com/api/v1/transactions/00000000-0000-0000-0000-000000000042 \
  -H "Authorization: Basic Y2xpZW50X2lkOmNsaWVudF9zZWNyZXQ=" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 300.00,
    "items": [
      { "product_description": "Plano Premium", "unit_price": 150.00 },
      { "product_description": "Taxa de Setup", "unit_price": 150.00 }
    ]
  }'

---

Ejemplos de respuesta

Éxito

{
  "data": {
    "id": "00000000-0000-0000-0000-000000000042",
    "merchant_id": "00000000-0000-0000-0000-000000000001",
    "amount": 300.00,
    "transaction_items": [
      { "product_description": "Plano Premium", "unit_price": 150.00 },
      { "product_description": "Taxa de Setup", "unit_price": 150.00 }
    ]
  }
}

Transacción no encontrada

{
  "error": {
    "code": "TRANSACTION_NOT_FOUND",
    "message": "Transaction not found"
  }
}

Transacción inmutable (ya usada por una solución)

{
  "error": {
    "code": "TRANSACTION_IMMUTABLE",
    "message": "Transaction cannot be modified: it has been used by a network event"
  }
}

Duplicado de external_id

{
  "error": {
    "code": "TRANSACTION_DUPLICATE",
    "message": "Another transaction with this external_source/external_id already exists"
  }
}