TRtrytoku
Beneficiary Accounts

Actualizar datos bancarios de Beneficiary Account

Changed on

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.

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

Path parameters

id_beneficiary_accountstring uuid required

Identificador de la Beneficiary Account.

Request body

account_numberstring required

Nuevo número de la cuenta bancaria.

bank_codestring 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.

Example request

{
  "account_number": "002010077777777771",
  "bank_code": "002"
}

Response

La cuenta con sus datos bancarios actualizados.

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