--- title: "Actualizar datos bancarios de Beneficiary Account" method: PATCH path: "/payouts-beneficiary/beneficiary-account/{id_beneficiary_account}/account-data" tags: ["Beneficiary Accounts"] --- # Actualizar datos bancarios de Beneficiary Account `PATCH /payouts-beneficiary/beneficiary-account/{id_beneficiary_account}/account-data` ## Request - Base URL: `https://api.trytoku.com` - URL: `https://api.trytoku.com/payouts-beneficiary/beneficiary-account/{id_beneficiary_account}/account-data` - Auth: API key in header `x-api-key` Reemplaza los datos bancarios de una Beneficiary Account: número de cuenta, código de banco y tipo de cuenta. La operación reemplaza el bloque completo, no fusiona campo a campo. El número y el tipo de cuenta son obligatorios; el código de banco solo se usa en los países cuyo número de cuenta no lo lleva, y en esos es obligatorio: en México se ignora y se toma de los tres primeros dígitos de la CLABE, y por eso una CLABE con formato inválido se rechaza con `422`. Si la cuenta ya estaba verificada, el cambio la devuelve a `PENDING_VERIFICATION` y deja la nueva cuenta bancaria en cola para verificarse, porque lo verificado antes ya no corresponde a los datos vigentes. **Límite de tasa:** 1000 solicitudes por hora. Al superarlo, la API responde `429`. Ver [Límites de tasa](/reference/limites-de-tasa). ## Path parameters - `id_beneficiary_account` string, uuid, required: Identificador de la Beneficiary Account. ## Request body - PatchBeneficiaryAccountDataPayload: Input payload for PATCH account data. ``bank_code`` is ignored for Mexico, where it is derived from the CLABE. - `account_number` string, required: Nuevo número de la cuenta bancaria. - `bank_code` string, nullable: Nuevo código del banco. Solo se usa en los países donde el número de cuenta no lo lleva, y en esos es obligatorio: en México se ignora, porque se toma de los tres primeros dígitos de la CLABE. - `type` 'BANK_ACCOUNT' | 'CASH_ACCOUNT' | 'DEBIT_CARD' | 'CIE_AGREEMENT' | 'INTERNATIONAL_ACCOUNT' | 'BBVA_ACCOUNT' | 'CHECKING_ACCOUNT' | 'VISTA_ACCOUNT' | 'SAVINGS_ACCOUNT', required: Tipo de la cuenta de destino de un Beneficiary Account. Qué valores se aceptan depende del país de la cuenta: en Chile, `CHECKING_ACCOUNT` (cuenta corriente), `VISTA_ACCOUNT` (cuenta vista) y `SAVINGS_ACCOUNT` (cuenta de ahorro); en México, `BANK_ACCOUNT`, cuyo número de cuenta es una CLABE de 18 dígitos; `CIE_AGREEMENT`, un convenio CIE de BBVA de 7 dígitos; `INTERNATIONAL_ACCOUNT`, una cuenta internacional de 20 a 30 dígitos cuyo `bank_code` es el código ABA del banco, de 9 a 11 dígitos; `BBVA_ACCOUNT`, una cuenta BBVA de 10 u 11 dígitos; y `CASH_ACCOUNT` (cuenta de efectivo), que paga al beneficiario en efectivo y por eso no tiene cuenta bancaria de destino. `DEBIT_CARD` quedó como valor heredado y hoy se rechaza en los dos países. ## Response `200` La cuenta con sus datos bancarios actualizados. - PatchBeneficiaryAccountResponse: Response for PATCH external-id and PATCH account-data: beneficiary name, bank details and external_id. - `beneficiary_name` string, required: Nombre del Beneficiary dueño de la cuenta. - `details` BeneficiaryAccountBankDetailsResponse, required: Bank/account details for PATCH responses. - `account_number` string, nullable: Número de la cuenta bancaria. Viene `null` en una cuenta de efectivo, que paga al beneficiario en efectivo y no tiene cuenta bancaria de destino. - `bank_code` string, nullable: Código del banco donde está la cuenta. En México son los tres primeros dígitos de la CLABE, así que lo determina el número de cuenta. Viene `null` en una cuenta de efectivo, que no tiene cuenta bancaria de destino. - `tokenized_account_number` string, nullable: Token que reemplaza al número de cuenta cuando la cuenta ya fue tokenizada. Viene `null` mientras no lo esté y en una cuenta de efectivo, que no tiene número que tokenizar. - `type` 'BANK_ACCOUNT' | 'CASH_ACCOUNT' | 'DEBIT_CARD' | 'CIE_AGREEMENT' | 'INTERNATIONAL_ACCOUNT' | 'BBVA_ACCOUNT' | 'CHECKING_ACCOUNT' | 'VISTA_ACCOUNT' | 'SAVINGS_ACCOUNT', required: Tipo de la cuenta de destino de un Beneficiary Account. Qué valores se aceptan depende del país de la cuenta: en Chile, `CHECKING_ACCOUNT` (cuenta corriente), `VISTA_ACCOUNT` (cuenta vista) y `SAVINGS_ACCOUNT` (cuenta de ahorro); en México, `BANK_ACCOUNT`, cuyo número de cuenta es una CLABE de 18 dígitos; `CIE_AGREEMENT`, un convenio CIE de BBVA de 7 dígitos; `INTERNATIONAL_ACCOUNT`, una cuenta internacional de 20 a 30 dígitos cuyo `bank_code` es el código ABA del banco, de 9 a 11 dígitos; `BBVA_ACCOUNT`, una cuenta BBVA de 10 u 11 dígitos; y `CASH_ACCOUNT` (cuenta de efectivo), que paga al beneficiario en efectivo y por eso no tiene cuenta bancaria de destino. `DEBIT_CARD` quedó como valor heredado y hoy se rechaza en los dos países. - `external_id` string, required: Identificador de la cuenta en el sistema de origen. ## Other responses - `404`: No existe una Beneficiary Account con ese identificador. - `409`: Ya existe otra Beneficiary Account con esos datos bancarios. - `422`: El cuerpo de la solicitud no cumple el formato esperado. ## Changes - **2026-11-03** `a6ef070075b1`: 1 info - endpoint added [Operation history](https://skmtc.dev/trytoku/apis/toku-api/changes/payouts-beneficiary/beneficiary-account/:id_beneficiary_account/account-data/patch.md) --- [API](https://skmtc.dev/trytoku/apis/toku-api.md) - [All operations](https://skmtc.dev/trytoku/apis/toku-api/llms.txt) - [OpenAPI document](https://skmtc.dev/trytoku/apis/toku-api/revisions/a6ef070075b1?raw)