---
title: "Nueva cuenta bancaria"
method: POST
path: "/payment-method/bank"
tags: ["Cuentas bancarias", "Bank accounts"]
---

# Nueva cuenta bancaria

`POST /payment-method/bank`

Endpoint utilizado para almacenar una cuenta bancaria. La cuenta será asociada al usuario indicado en el parámetro `customer_ext_id`.

Si se envía el campo `source_holder_verification`, será obligatorio enviar también el campo `service`, ya que la verificación del titular del medio de pago requiere ejecutarse contra un servicio de pago.

## Parameters

- `#/paths/~1/get/parameters/0` — unresolved $ref

## Request body

- object
  - `signature` Signature, required — unresolved $ref
  - `customer_ext_id` ExternalId, required — unresolved $ref
  - `account_holder` AccountHolder, required — unresolved $ref
  - `iban` Iban, required — unresolved $ref
  - `additional` Additional — unresolved $ref
  - `service` ServiceUuid — unresolved $ref
  - `source_holder_verification` SourceHolderVerification — Configuración de verificación del titular del medio de pago (Source Holder Verification - SHV) aplicada durante flujos de almacenamiento o pago.
    - `enabled` boolean, required — Activa la verificación del titular del medio de pago. Cuando se establece en `true`, la plataforma intenta realizar la comprobación SHV antes de continuar con el flujo.
    - `verification_method` 'NAME' | 'IDENTIFICATION_NUMBER' — Método utilizado para verificar la titularidad del medio de pago. Si no se especifica, se utiliza NAME.
    - `accepted_verification_results` string[] — Lista de resultados de verificación considerados aceptables para continuar con la operación. Si se omite o está vacía, el flujo continúa independientemente del resultado SHV.
    - `allow_unavailable` boolean — Permite continuar con el flujo si la verificación no ha sido realizada porque no está soportada por el banco o tipo/marca de tarjeta, o porque el banco no la ha ejecutado.
    - `allow_error` boolean — Determina el comportamiento cuando la verificación no puede completarse debido a errores o fallos transitorios (por ejemplo, timeout o indisponibilidad temporal). Si es `true`, estos errores no bloquean el flujo; si es `false`, la operación se bloquea.
    - `first_name` string — Nombre del titular utilizado para la comparación. Si no se envía, en flujos de pago se obtiene de `extra_data.profile` y, durante la creación de la tarjeta/cuenta bancaria, de `card_holder` o `account_holder`.
    - `last_name` string — Apellidos del titular utilizados para la comparación.
    - `identification_number` string — Identificador legal del titular del medio de pago (por ejemplo, NIF, DNI, pasaporte o número de registro de empresa).

## Response `200`

OK

- object
  - `message` string, required — Nombre del código HTTP de respuesta.
  - `code` number, required — Código de respuesta.
  - `current_time` string, required — Fecha y hora de la petición.
  - `Customer` Customer
    - `external_id` string, required — ID externo otorgado por el comercio para identificar de forma única a un usuario.
  - `Source` object
    - `object` Object, required — unresolved $ref
    - `uuid` string, required — Identificador de la cuenta bancaria.
    - `account_holder` AccountHolder, required — unresolved $ref
    - `iban` Iban, required — unresolved $ref
    - `additional` Additional — unresolved $ref

---

[API](https://skmtc.net/paylands/apis/documentacio-n-de-paylands.md) · [All operations](https://skmtc.net/paylands/apis/documentacio-n-de-paylands/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/paylands/documentacio-n-de-paylands/revisions/6bf9c0ba354b/schema)