> ## Documentation Index
> Fetch the complete documentation index at: https://docs.y.uno/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Test in the sandbox first: base URL https://api-sandbox.y.uno (Test Mode in the Dashboard). Production is https://api.y.uno (Live Mode).
> Every API request needs the public-api-key and private-secret-key headers. Get them in the Dashboard at https://dashboard.y.uno/developers (Developers > Credentials); sandbox and production keys are different.
> Send an X-Idempotency-Key (a UUID) when creating payments, refunds and cancels, so retries do not create duplicates.
> Start with the Quickstart (https://docs.y.uno/docs/quickstart.md) and the agent guide (https://docs.y.uno/agents.md). To search these docs from a coding agent, connect the docs MCP server at https://docs.y.uno/mcp.

# Registrar tarjetas almacenadas para Account Updater

> Registra hasta 100 tarjetas almacenadas en Card Account Updater en una sola solicitud

Registra un lote de tarjetas ya almacenadas en [Card Account Updater](https://docs.y.uno/es/docs/additional-services/card-account-updater.md), para que sus datos se mantengan actualizados automáticamente. Envía los ids de los métodos de pago (el `vaulted_token` recibido al inscribir cada tarjeta) en una sola solicitud.

> [!NOTE]
>
> **Cómo funciona el registro**
>
> * Puedes registrar entre **1 y 100** tarjetas por solicitud; cada id debe ser un `vaulted_token` válido.
> * La validación es **todo o nada**: si algún id no es válido, se rechaza toda la solicitud.
> * El registro se ejecuta de forma **asíncrona**. Una respuesta `200` con `accepted` confirma que las tarjetas fueron aceptadas, no que la actualización ya se haya realizado; las actualizaciones se notifican más tarde mediante el webhook de inscripción.
> * Card Account Updater se habilita por organización. Si tu organización no está inscrita, la solicitud devuelve `400` con `code: BAD_REQUEST` y el mensaje `organization is not enrolled in account updater.`


## OpenAPI

````yaml openapi/es/payment-methods-direct-workflow/register-cards-for-account-updater-api.json POST /payment-methods/account-updater
openapi: 3.1.0
info:
  title: customer-api-register-payment-method
  version: 1.0.2
servers:
  - url: https://api-sandbox.y.uno/v1
    description: Sandbox
  - url: https://api.y.uno/v1
    description: Production (US)
security:
  - sec0: []
    sec1: []
    sec2: []
paths:
  /payment-methods/account-updater:
    post:
      summary: Registrar tarjetas guardadas para Account Updater
      description: >-
        Registra hasta 100 tarjetas guardadas en Card Account Updater en una
        sola solicitud, identificadas por el id de su método de pago
        (`vaulted_token`). La validación es síncrona y de todo o nada: si algún
        id es inválido, se rechaza toda la solicitud. El registro en sí se
        ejecuta de forma asíncrona, por lo que una respuesta `200` confirma que
        las tarjetas fueron aceptadas, no que la actualización haya terminado.
        Tu cuenta debe estar habilitada para Card Account Updater para usar este
        endpoint.
      operationId: register-cards-for-account-updater-api
      requestBody:
        required: true
        content:
          application/json:
            examples:
              Register cards:
                value:
                  payment_method_ids:
                    - cbdcc878-ceb4-4dd8-b0f0-49d444855de0
                    - 03c3aae1-ed42-4be6-bc24-de5487f58491
            schema:
              type: object
              required:
                - payment_method_ids
              properties:
                payment_method_ids:
                  type: array
                  description: >-
                    Lista de ids de métodos de pago guardados (`vaulted_token`)
                    para registrar en Card Account Updater. Entre 1 y 100
                    elementos; cada uno debe ser un UUID válido.
                  minItems: 1
                  maxItems: 100
                  items:
                    type: string
                    format: uuid
                    example: cbdcc878-ceb4-4dd8-b0f0-49d444855de0
      responses:
        '200':
          description: '200'
          content:
            application/json:
              examples:
                Result:
                  value:
                    accepted: 2
              schema:
                type: object
                properties:
                  accepted:
                    type: integer
                    description: >-
                      Número de tarjetas aceptadas para el registro en Card
                      Account Updater.
                    example: 2
        '400':
          description: '400'
          content:
            application/json:
              examples:
                Bad Request:
                  value:
                    code: INVALID_REQUEST
                    messages:
                      - Invalid request
                Organization not enrolled:
                  value:
                    code: BAD_REQUEST
                    messages:
                      - organization is not enrolled in account updater.
              schema:
                type: object
                properties:
                  code:
                    type: string
                    example: INVALID_REQUEST
                  messages:
                    type: array
                    items:
                      type: string
                      example: Invalid request
        '401':
          description: '401'
          content:
            application/json:
              examples:
                Result:
                  value:
                    code: INVALID_CREDENTIALS
                    messages:
                      - Invalid credentials
              schema:
                type: object
                properties:
                  code:
                    type: string
                    example: INVALID_CREDENTIALS
                  messages:
                    type: array
                    items:
                      type: string
                      example: Invalid credentials
      deprecated: false
components:
  securitySchemes:
    sec0:
      type: apiKey
      in: header
      name: public-api-key
      x-default: <Your public-api-key>
    sec1:
      type: apiKey
      in: header
      x-default: <Your private-secret-key>
      name: private-secret-key
    sec2:
      type: apiKey
      in: header
      name: X-Idempotency-Key
      x-default: <Your X-Idempotency-Key>

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.