> ## Documentation Index > Fetch the complete documentation index at: https://docs.didit.me/llms.txt > Use this file to discover all available pages before exploring further. # API de verificación de cuenta bancaria para pagos > Con Didit, comprueba que una cuenta bancaria pertenece a la persona o empresa que indicas antes de enviarle dinero. Sin sesión ni inicio de sesión. > [!WARNING] > > La verificación bancaria todavía no está habilitada en producción. > Mientras no lo esté, este endpoint responde `404` con `code: bank_verification_not_available` y no puedes añadir el paso de verificación bancaria a un flujo de producción. > Esta página describe cómo se comporta el endpoint una vez que esté disponible. Tu backend envía el nombre y la cuenta, y obtiene el resultado. Es la [comprobación de cuenta](https://docs.didit.me/es/core-technology/bank-verification/account-check.md) del paso de verificación bancaria, sin la persona. ## Envía la cuenta como se escribe en su país | País | `account` | | - | - | | Países con IBAN | `{"iban": "..."}` | | Reino Unido | `{"sort_code": "...", "account_number": "..."}` | | Estados Unidos | `{"routing_number": "...", "account_number": "..."}` | | Canadá | `{"transit_institution": "...", "account_number": "..."}` | | Australia | `{"bsb": "...", "account_number": "..."}` | | India | `{"ifsc": "...", "account_number": "..."}` | | Nigeria | `{"bank_code": "...", "account_number": "..."}` | | México | `{"clabe": "..."}` | | Argentina | `{"cbu_cvu": "..."}` | Algunos países también piden un `bic` y, para una cuenta de empresa, un `registration_id`. Los espacios, guiones y puntos se ignoran. Si falta una clave que necesita la comprobación del país, la respuesta es un `400` que la indica, por ejemplo `"field": "account.sort_code", "reason": "required"`. Envía `holder.full_name` para comprobar la cuenta de una persona, o `holder.business_name` para comprobar la de una empresa. ## Lee el resultado | `result` | Qué significa | Siguiente paso habitual | | - | - | - | | `match` | El banco tiene la cuenta a nombre de la persona cuyo nombre enviaste. | Envía el dinero. | | `close_match` | La cuenta está a nombre de una persona con un nombre parecido. `holder_name` es ese nombre, si el banco lo devolvió. | Compara `holder_name` o pide a la persona que lo confirme. | | `no_match` | El banco la tiene a otro nombre, o la cuenta no existe. | No envíes el dinero. | | `cannot_verify` | El banco respondió sin comparar el nombre, por ejemplo en una cuenta bloqueada o cerrada. | Aplica tu propia política, por ejemplo pide otra cuenta. | ## Facturación y reintentos Cada comprobación respondida por el banco se factura una vez al [precio de la comprobación de cuenta](https://docs.didit.me/es/getting-started/bank-verification-pricing.md) del país de la cuenta, sea cual sea el resultado. Una solicitud que recibe un error nunca se factura: un cuerpo de solicitud rechazado (`400`), falta de crédito (`402`), una cuenta para la que aún no se ofrece ninguna comprobación (`404`) o un banco que no pudo responder (`503`). No hay clave de idempotencia ni endpoint para volver a consultar una comprobación. Una solicitud reintentada ejecuta una comprobación nueva, con un `request_id` nuevo, y se factura de nuevo, así que guarda la respuesta. Didit solo guarda el cargo, con el ID de la solicitud, el país, el resultado y la cuenta enmascarada, nunca el nombre ni el número de cuenta completo. ## Pruébalo en sandbox Una clave de API de sandbox no llama a ningún banco y no genera ningún cargo. Los últimos 4 caracteres del IBAN, o en su defecto del número de cuenta, determinan la respuesta: | Termina en | Respuesta | | - | - | | `0001` | `close_match`, con un `holder_name` | | `0002` | `close_match`, `holder_name: null` | | `0003`, `0006` | `no_match` | | `0004` | `cannot_verify` | | `0005` | `503`, `account_check_unavailable` | | `0009` | `400`, `reason: rejected` | | Cualquier otro | `match` | Un IBAN, una CLABE y un CBU llevan dígitos de control: usa los [valores de sandbox](https://docs.didit.me/es/core-technology/bank-verification/account-check.md#pruébalo-en-sandbox) que superan todas las comprobaciones de formato. ## Acceso Autentícate con la clave de API `x-api-key` de tu aplicación o con su token bearer de credenciales de cliente. Una clave de API con permisos específicos necesita acceso de escritura a las sesiones. El endpoint comparte el límite de escritura de 300 solicitudes por minuto por clave de API. ## OpenAPI ````yaml es/openapi-25.json POST /v3/bank/account-check/ openapi: 3.0.0 info: version: 3.0.0 title: Didit Verification API description: API de verificación de identidad. Autentícate con el encabezado x-api-key. servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/bank/account-check/: post: tags: - Standalone APIs summary: Comprobar una cuenta bancaria description: >- **Aún no está disponible en producción.** La Verificación bancaria está desactivada en producción, así que, hasta que se active, este endpoint responde `404` con `bank_verification_not_available`. No construyas nada sobre él todavía. El resto de esta descripción explica lo que hace el endpoint cuando esté disponible. Comprueba que una cuenta bancaria pertenece a la persona o empresa que indicas antes de enviarle dinero. Sin sesión y sin inicio de sesión: envía el nombre y la cuenta, y lee el resultado. Es la [comprobación de cuenta](/es/core-technology/bank-verification/account-check) del paso de Verificación bancaria, ejecutada desde tu backend. **Qué envías.** El `country` de la cuenta (ISO 3166-1 alfa-3), la `account` tal como se escribe en ese país y el nombre del `holder`: `full_name` para una persona o `business_name` para una empresa. Un nombre de empresa comprueba una cuenta de empresa. **Qué recibes.** `result` es `match`, `close_match`, `no_match` o `cannot_verify`. En un `close_match`, `holder_name` es el nombre con el que el banco tiene registrada la cuenta, cuando el banco lo devuelve. `account` se devuelve enmascarada, mostrando solo sus últimos 4 caracteres. **Facturación.** Cada comprobación que el banco responde se factura una vez al precio de Comprobación de cuenta del país de la cuenta, sea cual sea el resultado: un `no_match`, una cuenta que no existe y un `cannot_verify` también se facturan. Una solicitud respondida con un error nunca se factura. **Cada solicitud es una comprobación nueva.** No hay clave de idempotencia ni endpoint para volver a leer una comprobación, así que una solicitud que se reintenta se ejecuta, y se factura, de nuevo. Guarda la respuesta. **Sandbox.** Donde la Verificación bancaria está disponible, una clave de sandbox no llama a ningún banco y no genera ningún cargo. Los últimos 4 caracteres del IBAN, o si no del número de cuenta, determinan la respuesta: `0001` da un `close_match` con `holder_name`, `0002` un `close_match` sin él, `0003` y `0006` un `no_match`, `0004` `cannot_verify`, `0005` un `503` y `0009` un `400`. Cualquier otra terminación da un `match`. **Claves de API.** Una clave de API con alcance limitado necesita acceso de escritura a las sesiones. operationId: post_v3_bank_account_check requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/BankAccountCheckRequest' examples: Person, United Kingdom: summary: >- Un sort code y un número de cuenta, verificados con el nombre de una persona value: country: GBR account: sort_code: 20-45-67 account_number: '31926819' holder: full_name: Maria Oliveira vendor_data: payout_20481 Company, IBAN: summary: Un IBAN, verificado con el nombre de una empresa value: country: DEU account: iban: DE89 3704 0044 0532 0130 00 holder: business_name: Northwind Trading GmbH responses: '200': description: >- El banco respondió. La comprobación se factura, sea cual sea el resultado. content: application/json: schema: $ref: '#/components/schemas/BankAccountCheckResponse' examples: Close match: summary: El banco tiene la cuenta a un nombre similar value: request_id: c2f4a9e0-7b1d-4c3a-9e55-1d0a6b8f2a47 result: close_match holder_name: MARIA R OLIVEIRA account: '****6819' vendor_data: payout_20481 created_at: '2026-10-21T14:32:08Z' Match: summary: El banco tiene la cuenta al nombre enviado value: request_id: 5b0e2d7c-41a8-4f6e-9c3b-8e7d1a2f6c90 result: match holder_name: null account: '****3000' vendor_data: null created_at: '2026-10-21T14:35:41Z' '400': description: >- Rechazado tal como se envió y no se factura. `field` indica el campo del cuerpo que hay que corregir y `reason` explica el motivo, con los mismos motivos que muestra el formulario de cuenta alojado. Solo se informa del primer campo rechazado. content: application/json: schema: $ref: '#/components/schemas/BankAccountCheckError' examples: Missing field: summary: La verificación de este país requiere un sort code value: detail: The sort code is not valid (required). code: invalid_account_input field: account.sort_code reason: required Invalid IBAN: summary: El IBAN no tiene la longitud correcta para su país value: detail: The iban is not valid (length). code: invalid_account_input field: account.iban reason: length Refused by the bank: summary: El banco rechazó la cuenta tal como se envió value: detail: The account was refused as typed (rejected). code: invalid_account_input field: account.account_number reason: rejected No name: summary: '`holder` no tiene ni `full_name` ni `business_name`' value: detail: >- Send full_name for a person or business_name for a company. code: invalid_account_input field: holder reason: required '401': description: La clave de API con alcance limitado ha expirado. content: application/json: schema: $ref: '#/components/schemas/BankAccountCheckError' examples: Expired key: summary: La fecha de caducidad de la clave ya pasó value: detail: This API key has expired. '402': description: >- La comprobación no se puede pagar, así que no se ejecutó. Recarga tu saldo y vuelve a enviarla. content: application/json: schema: $ref: '#/components/schemas/BankAccountCheckError' examples: Out of credit: summary: Tu saldo no alcanza para cubrir una comprobación value: detail: >- You don't have enough credits to perform this request. Please top up at https://business.didit.me code: insufficient_credits Not in your contract: summary: >- Tu contrato no tiene precio para la API de comprobación de cuentas value: detail: >- Your contract does not price the Account check API. Contact your account manager. code: contract_rate_missing '403': description: >- Falta el encabezado `x-api-key` o el bearer token, o no es válido; la solicitud llegó desde una dirección que no está en la lista de IP de la clave, o una clave con alcance limitado no tiene acceso de escritura a las sesiones. content: application/json: schema: $ref: '#/components/schemas/BankAccountCheckError' examples: Missing or invalid credentials: summary: No hay una clave de API o un token válidos value: detail: You do not have permission to perform this action. No sessions write: summary: >- Una clave con permisos limitados sin acceso de escritura a las sesiones value: detail: This API key has no write access to sessions. '404': description: >- Todavía ninguna comprobación de cuenta cubre esta cuenta, por lo que no se ha comprobado ni facturado nada. `country_not_covered`: ninguna cubre su país, o su tipo de cuenta (persona o empresa) en ese país. `bank_not_covered`: ninguna cubre su banco. `bank_verification_not_available`: Bank Verification aún no está habilitada en producción, y esa es la respuesta para todas las solicitudes allí hasta que se active. content: application/json: schema: $ref: '#/components/schemas/BankAccountCheckError' examples: Country not covered: summary: Ninguna comprobación de cuenta cubre el país value: detail: No account check serves this country yet. code: country_not_covered Bank not covered: summary: Ninguna comprobación de cuenta cubre el banco de la cuenta value: detail: No account check serves this account's bank yet. code: bank_not_covered '429': $ref: '#/components/responses/RateLimitedWrite' '503': description: >- El banco no pudo responder. No se comprobó ni se facturó nada; vuelve a enviar la comprobación más tarde. content: application/json: schema: $ref: '#/components/schemas/BankAccountCheckError' examples: Unavailable: summary: El banco no respondió value: detail: >- The account check is temporarily unavailable and this request was not charged. Please try again. code: account_check_unavailable security: - ApiKeyAuth: [] - BearerAuth: [] x-codeSamples: - lang: curl label: curl source: |- curl -X POST https://verification.didit.me/v3/bank/account-check/ \ -H 'x-api-key: YOUR_API_KEY' \ -H 'Content-Type: application/json' \ -d '{ "country": "GBR", "account": {"sort_code": "20-45-67", "account_number": "31926819"}, "holder": {"full_name": "Maria Oliveira"}, "vendor_data": "payout_20481" }' - lang: python label: Python source: |- from didit import Didit # Reads DIDIT_API_KEY. client = Didit() result = client.bank.account_check( country="GBR", account={ "account_number": "31926819", "sort_code": "20-45-67", }, holder={ "full_name": "Maria Oliveira", }, vendor_data="payout_20481", ) print(result) - lang: javascript label: Node.js source: |- import Didit from "@didit-protocol/sdk-node"; // Reads DIDIT_API_KEY. const didit = new Didit(); const result = await didit.bank.accountCheck({ country: "GBR", account: { account_number: "31926819", sort_code: "20-45-67", }, holder: { full_name: "Maria Oliveira", }, vendor_data: "payout_20481", }); console.log(result); - lang: go label: Go source: "ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\nresult, err := client.Bank.AccountCheck(ctx, didit.BankAccountCheckRequest{\n\tCountry: \"GBR\",\n\tAccount: didit.BankAccountCheckRequestAccount{\n\t\tAccountNumber: didit.String(\"31926819\"),\n\t\tSortCode: didit.String(\"20-45-67\"),\n\t},\n\tHolder: didit.BankAccountCheckHolder{\n\t\tFullName: didit.String(\"Maria Oliveira\"),\n\t},\n\tVendorData: didit.String(\"payout_20481\"),\n})\nif err != nil {\n\tlog.Fatal(err)\n}\nfmt.Printf(\"%+v\\n\", result)" - lang: java label: Java source: >- import me.didit.Didit; import me.didit.types.BankAccountCheckHolder; import me.didit.types.BankAccountCheckPersonHolder; import me.didit.types.BankAccountCheckRequest; // Reads DIDIT_API_KEY. Didit client = new Didit(); var result = client.bank().accountCheck(BankAccountCheckRequest.builder() .country("GBR") .account(BankAccountCheckRequest.Account.builder() .accountNumber("31926819") .sortCode("20-45-67") .build()) .holder(BankAccountCheckHolder.ofBankAccountCheckPersonHolder(BankAccountCheckPersonHolder.builder() .fullName("Maria Oliveira") .build())) .vendorData("payout_20481") .build()); System.out.println(result); - lang: php label: PHP source: |- bank->accountCheck([ 'country' => 'GBR', 'account' => [ 'account_number' => '31926819', 'sort_code' => '20-45-67', ], 'holder' => [ 'full_name' => 'Maria Oliveira', ], 'vendor_data' => 'payout_20481', ]); print_r($result->toArray()); - lang: ruby label: Ruby source: |- require "didit" # Reads DIDIT_API_KEY. didit = Didit::Client.new result = didit.bank.account_check( country: "GBR", account: { account_number: "31926819", sort_code: "20-45-67", }, holder: { full_name: "Maria Oliveira", }, vendor_data: "payout_20481" ) puts result.to_h - lang: csharp label: .NET source: >- using System; using System.Text.Json; using Didit; // Reads DIDIT_API_KEY. using var client = new DiditClient(); var result = await client.Bank.AccountCheckAsync(new BankAccountCheckRequest { Country = "GBR", Account = new() { AccountNumber = "31926819", SortCode = "20-45-67", }, Holder = new() { FullName = "Maria Oliveira", }, VendorData = "payout_20481", }); Console.WriteLine(JsonSerializer.Serialize(result)); components: schemas: BankAccountCheckRequest: type: object required: - country - account - holder properties: country: type: string minLength: 3 maxLength: 3 description: >- El país de la cuenta, como código ISO 3166-1 alfa-3, por ejemplo `GBR`. Se aceptan minúsculas. example: GBR account: type: object description: >- La cuenta tal como la escribe su país: un `iban`, o un `account_number` con el código de banco o de sucursal que necesita el país (`sort_code`, `routing_number`, `transit_institution`, `bsb`, `ifsc`, `bank_code` o `bic`). México admite una `clabe` y Argentina un `cbu_cvu`, que ya identifican el banco. Una cuenta de empresa añade un `registration_id` cuando el país lo exige. Se ignoran los espacios, guiones y puntos. Se ignoran las claves que la comprobación del país no utiliza; si falta una clave que necesita, se devuelve un `400` que la indica. properties: iban: type: string maxLength: 64 description: El IBAN, en un país que usa IBAN. Debe pertenecer a `country`. account_number: type: string maxLength: 64 description: >- El número de cuenta, en un país que escribe la cuenta con un código de banco o de sucursal aparte. sort_code: type: string maxLength: 64 description: 'Reino Unido: el sort code de 6 dígitos.' routing_number: type: string maxLength: 64 description: 'Estados Unidos: el número de ruta ABA de 9 dígitos.' transit_institution: type: string maxLength: 64 description: 'Canadá: el número de tránsito e institución de 8 dígitos.' bsb: type: string maxLength: 64 description: 'Australia: el BSB de 6 dígitos.' ifsc: type: string maxLength: 64 description: 'India: el IFSC de 11 caracteres.' bank_code: type: string maxLength: 64 description: >- El código del banco, cuando el país lo requiere, por ejemplo en Nigeria. bic: type: string maxLength: 64 description: El BIC del banco, cuando la comprobación del país lo requiere. clabe: type: string maxLength: 64 description: 'México: la CLABE de 18 dígitos. Ya identifica al banco.' cbu_cvu: type: string maxLength: 64 description: 'Argentina: el CBU o CVU de 22 dígitos. Ya identifica el banco.' registration_id: type: string maxLength: 64 description: >- El número de registro de una cuenta de empresa, cuando el país lo exige. additionalProperties: type: string maxLength: 64 example: sort_code: 20-45-67 account_number: '31926819' holder: $ref: '#/components/schemas/BankAccountCheckHolder' vendor_data: type: string nullable: true description: Tu propia referencia para esta comprobación, devuelta sin cambios. example: payout_20481 BankAccountCheckResponse: type: object required: - request_id - result - holder_name - account - vendor_data - created_at properties: request_id: type: string format: uuid description: El ID de esta comprobación. result: type: string enum: - match - close_match - no_match - cannot_verify description: >- `match`: el banco tiene la cuenta registrada con el nombre que enviaste. `close_match`: con un nombre parecido, por ejemplo, sin el segundo nombre o con una errata. `no_match`: con otro nombre, o no existe esa cuenta. `cannot_verify`: el banco respondió sin comparar el nombre, por ejemplo, en una cuenta bloqueada o cerrada. holder_name: type: string nullable: true description: >- Solo en un `close_match`, y solo cuando el banco lo devolvió: el nombre de la cuenta tal como lo tiene registrado el banco. `null` en caso contrario. account: type: string description: La cuenta, enmascarada salvo sus últimos 4 caracteres. vendor_data: type: string nullable: true description: Tu propia referencia, tal como la enviaste. created_at: type: string format: date-time description: Cuándo se ejecutó la comprobación, en UTC. BankAccountCheckError: type: object required: - detail properties: detail: type: string description: Qué falló, en inglés. code: type: string description: >- Un código estable sobre el que ramificar la lógica. No está presente en `401` ni en `403`. field: type: string description: >- Solo con `400`: el campo del cuerpo que hay que corregir, como ruta con puntos, por ejemplo `account.sort_code`. reason: type: string enum: - required - length - format - checksum - country_mismatch - rejected description: >- Solo con `400`: el motivo por el que se rechazó el campo. `required`, `length`, `format`, `checksum` y `country_mismatch` (un IBAN de otro país) son comprobaciones propias de Didit; `rejected` significa que el banco rechazó la cuenta tal como se envió. BankAccountCheckHolder: description: >- El nombre con el que se verifica la cuenta. Envía exactamente uno de `full_name` y `business_name`. oneOf: - $ref: '#/components/schemas/BankAccountCheckPersonHolder' - $ref: '#/components/schemas/BankAccountCheckBusinessHolder' BankAccountCheckPersonHolder: type: object description: La persona que debería ser titular de la cuenta. required: - full_name properties: full_name: type: string maxLength: 255 description: El nombre completo de la persona que debe ser titular de la cuenta. example: Maria Oliveira BankAccountCheckBusinessHolder: type: object description: >- La empresa que debería ser titular de la cuenta. Verifica una cuenta de empresa. required: - business_name properties: business_name: type: string maxLength: 255 description: >- El nombre de la empresa que debería ser titular de la cuenta. Verifica una cuenta de empresa. responses: RateLimitedWrite: description: >- Se superó el límite de escritura compartido de 300 solicitudes por minuto por clave de API. Respeta `Retry-After` antes de reintentar. content: application/json: schema: type: object required: - detail properties: detail: type: string example: detail: >- Write request rate limit exceeded. You can make up to 300 requests per minute. securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- La clave de API de tu aplicación, que encontrarás en Developers -> API keys en la Business Console. La clave principal tiene acceso completo. Una clave con nombre puede tener un alcance limitado: ninguno, lectura o escritura por recurso, limitada a algunos flujos o a sesiones aprobadas, a una lista de direcciones IP y a una fecha de caducidad. 401 significa que la clave es incorrecta, se revocó o expiró; 403 significa que no se envió ninguna clave, que la clave no tiene acceso a este recurso o acción, o que la solicitud provino de una dirección fuera de su lista de IP; 404 en una ruta de sesión significa que la sesión está fuera de los flujos o estados de la clave. Una clave sin acceso a contenido multimedia recibe las URL de imágenes, videos y PDF como null, y una clave sin permiso de escritura en sesiones recibe los enlaces y tokens de sesión como null. Consulta https://docs.didit.me/console/api-keys. BearerAuth: type: http scheme: bearer description: El token de acceso de credenciales de cliente de la aplicación. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.