---
title: "Guardar una tarjeta como PaymentInstrument"
method: POST
path: "/mx/cards/instruments"
tags: ["Tarjetas"]
---

# Guardar una tarjeta como PaymentInstrument

`POST /mx/cards/instruments`

## Request

- Base URL: `https://secure.api.trytoku.com`
- URL: `https://secure.api.trytoku.com/mx/cards/instruments`
- Auth: API key in header `x-api-key`

Guarda una tarjeta en la bóveda PCI de Toku y crea el PaymentInstrument que la representa. No la cobra ni la inscribe como medio de pago.

Los parámetros obligatorios son `card_information`, con al menos el PAN de la tarjeta, e `id_customer`, el Customer dueño del PaymentInstrument. La fecha de expiración, el titular y el CVV de la tarjeta son opcionales.

Responde `201` con el identificador del PaymentInstrument y `422` cuando falta un dato obligatorio o un campo no es válido.

## Headers

- `x-org-id` string, required

## Request body

- object
  - `card_information` object, required: La tarjeta a guardar. Basta con el PAN; la fecha de expiración, el titular y el CVV son opcionales.
    - `full_name` string: Nombre del titular, tal como aparece en la tarjeta.
    - `month` string: Mes de expiración, en formato MM. Se envía junto con `year` o se omiten ambos.
    - `number` string, required: PAN de la tarjeta. Solo dígitos, mínimo 15.
    - `verification_value` string: CVV de la tarjeta.
    - `year` string: Año de expiración, en formato AAAA o AA. Se envía junto con `month` o se omiten ambos.
  - `id_customer` string, required: Identificador del Customer dueño del PaymentInstrument.

## Response `201`

PaymentInstrument creado.

- object
  - `payment_instrument_id` string, required: Identificador del PaymentInstrument que representa la tarjeta guardada.

## Other responses

- `422`: El request no se puede procesar: falta un dato obligatorio o un campo no pasa la validación.

---

[API](https://skmtc.dev/trytoku/apis/pci-compliant-api.md) - [All operations](https://skmtc.dev/trytoku/apis/pci-compliant-api/llms.txt) - [OpenAPI document](https://skmtc.dev/trytoku/apis/pci-compliant-api/revisions/9ff5e6a7d08b?raw)