TRtrytoku
Beneficiary Accounts

Actualizar external_id de Beneficiary Account

Changed on

Cambia únicamente el external_id de una Beneficiary Account, el identificador con que la cuenta se conoce en el sistema de origen.

Se usa cuando la cuenta se creó en Toku antes de existir en el sistema de origen y hay que enlazarlas después. El external_id debe ser único entre las cuentas de la Organization: reutilizar uno existente responde 409.

No toca los datos bancarios ni la verificación de la cuenta, así que no dispara una nueva verificación.

Límite de tasa: 1000 solicitudes por hora. Al superarlo, la API responde 429. Ver Límites de tasa.

patch/payouts-beneficiary/beneficiary-account/{id_beneficiary_account}/external-id

Request

  • Base URL
    https://api.trytoku.com
  • URL
    https://api.trytoku.com/payouts-beneficiary/beneficiary-account/{id_beneficiary_account}/external-id
  • Auth
    API key in header x-api-key

Path parameters

id_beneficiary_accountstring uuid required

Identificador de la Beneficiary Account.

Request body

external_idstring required

Nuevo identificador de la cuenta en el sistema de origen.

Example request

{
  "external_id": "CTA-000123"
}

Response

La cuenta con su nuevo external_id.

beneficiary_namestring required

Nombre del Beneficiary dueño de la cuenta.

external_idstring required

Identificador de la cuenta en el sistema de origen.

Example response

{
  "beneficiary_name": "Comercializadora Andina",
  "details": {
    "account_number": "002010077777777771",
    "bank_code": "002",
    "tokenized_account_number": "tok_5f3a90c17be24d8ab6c0e1f27d4a8395"
  },
  "external_id": "CTA-000123"
}

Changes