---
title: "Guardar tarjeta crédito/débito"
method: POST
path: "/payment-method/card"
tags: ["Tarjetas", "Cards"]
---

# Guardar tarjeta crédito/débito

`POST /payment-method/card`

Endpoint utilizado para almacenar una tarjeta de crédito, que se podrá utilizar para realizar un pago por WebService. La tarjeta será asociada al usuario indicado en el parámetro `customer_ext_id`.

Los campos `validate`, `service` y `source_holder_verification` solo deben enviarse cuando se desee realizar comprobaciones adicionales contra el servicio de pago durante el proceso de tokenización:

  - `validate` permite validar la tarjeta contra el servicio para comprobar si existe o si dispone de fondos en el momento de la validación.
  - `source_holder_verification` permite verificar que el titular indicado coincide con el titular real del medio de pago (SHV).

Cuando se utilice cualquiera de estas funcionalidades, será obligatorio enviar el campo `service`.
  
**Nota**: Es posible que una tarjeta no pueda ser tokenizada si se encuentra bajo sospecha de fraude. En esos casos, el servicio devolverá una respuesta de error con código `400`.

## Parameters

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

## Request body

- object
  - `signature` Signature, required — unresolved $ref
  - `card_holder` Holder, required — unresolved $ref
  - `card_pan` CardPan, required — unresolved $ref
  - `card_expiry_month` ExpireMonth, required — unresolved $ref
  - `card_expiry_year` ExpireYear, required — unresolved $ref
  - `customer_ext_id` ExternalId, required — unresolved $ref
  - `additional` Additional — unresolved $ref
  - `url_post` UrlPost — unresolved $ref
  - `validate` boolean, nullable — Sólo necesario si se quiere validar la tarjeta. Si se envía, el campo `service` es obligatorio, y el campo `card_cvv` puede enviarse para validar también el CVV.
  - `service` ServiceUuid — unresolved $ref
  - `card_cvv` CardCvv — 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` Source — unresolved $ref

## Other responses

- `400` — Bad Request

---

[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)