Transactions

Eliminar Transactions externas en lote

Changed on

Elimina un lote de Transactions externas y deja sus Invoices impagos.

Se usa para revertir muchos registros de pagos hechos por fuera: el cuerpo lleva los identificadores en id_transactions, con un máximo de 100 por llamada. Por cada Transaction eliminada, los Invoices que saldaba vuelven a quedar impagos.

Cada elemento se procesa por separado, así que la llamada responde 200 incluso si algunos no se pudieron eliminar: response_counts resume el resultado y transaction_ids agrupa los identificadores por resultado —eliminados, no encontrados y con error—.

Límite de tasa: 1 solicitud por segundo. Al superarlo, la API responde 429. Ver Límites de tasa.

put/transactions/external/bulk/delete

Request

  • Base URL
    https://api.trytoku.com
  • URL
    https://api.trytoku.com/transactions/external/bulk/delete
  • Auth
    API key in header x-api-key

Headers

x-account-keystring

Llave de API de una Account, para operar sobre esa Account en lugar de la principal.

Request body

id_transactionsstring[] required

Identificadores públicos de las Transactions externas a eliminar; hasta 100 por llamada.

Example request

{
  "id_transactions": [
    "trs_kR3nQ8sT1vX7yZ2aB5cD9eF4gH6jK0mN"
  ]
}

Response

Resultado del lote, con el recuento por categoría y los ids agrupados por resultado.

successboolean required

Indica que el lote se procesó; los resultados por elemento van en los demás campos.

Example response

{
  "response_counts": {
    "duplicates": 0,
    "error": 0,
    "format_error": 0,
    "not_found": 1,
    "success": 1,
    "unchanged": 0
  },
  "success": true,
  "transaction_ids": {
    "duplicates_ids": [],
    "error_ids": [],
    "format_error_ids": [],
    "not_found_ids": [
      "trs_4mN6pR8tV0xZ2bD4fH6jL8nQ0sU2wY4a"
    ],
    "success_ids": [
      "trs_kR3nQ8sT1vX7yZ2aB5cD9eF4gH6jK0mN"
    ]
  }
}

Changes