> ## 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.

# Obtener métodos de pago inscritos

> Obtiene la lista de métodos de pago que un cliente ha inscrito

Obtén la lista de métodos de pago que el usuario ha inscrito.

> [!NOTE]
>
> Los instrumentos almacenados mediante un CIT de Apple Pay o Google Pay (`vault_on_success: true`) no se incluyen en esta lista de forma intencional. El `vaulted_token` solo se devuelve en la respuesta de pago del CIT, por lo que debes guardarlo de tu lado. Un token de billetera almacenado aún se puede resolver con [Obtener método de pago inscrito por ID](https://docs.y.uno/es/reference/payment-methods-direct-workflow/retrieve-enrolled-payment-method-by-id-api.md). Consulta [Credenciales almacenadas](https://docs.y.uno/es/docs/payment-features/stored-credentials.md#wallet-originated-tokens-apple-pay-and-google-pay).

> [!NOTE]
>
> Este endpoint tiene alcance de organización: devuelve los métodos de pago inscritos del cliente sin importar desde qué cuenta lo llames, no solo la cuenta usada para inscribirlos. Consulta [Cuentas](https://docs.y.uno/es/docs/using-yuno/organization/accounts.md#customers-and-payment-methods-are-organization-scoped) para saber por qué, y qué hacer si tu organización gestiona varias empresas que necesitan registros de clientes separados.


## OpenAPI

````yaml openapi/es/payment-methods-direct-workflow/retrieve-enrolled-payment-methods-api.json GET /customers/{customer_id}/payment-methods
openapi: 3.1.0
info:
  title: customer-api
  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: []
paths:
  /customers/{customer_id}/payment-methods:
    get:
      summary: Obtener métodos de pago inscritos
      operationId: retrieve-enrolled-payment-methods-api
      parameters:
        - name: customer_id
          in: path
          description: >-
            El identificador único del cliente, creado con el endpoint [Create
            Customer](https://docs.y.uno/es/reference/customers/create-customer)
            (MAX 64; MIN 36).
          schema:
            type: string
          required: true
      responses:
        '200':
          description: '200'
          content:
            application/json:
              examples:
                Result:
                  value:
                    payment_methods:
                      - idempotency_key: null
                        name: VISA ****1111
                        description: VISA ****1111
                        icon: https://icons.prod.y.uno/visa_logosimbolo.png
                        type: CARD
                        category: CARD
                        country: US
                        status: ENROLLED
                        sub_status: null
                        vaulted_token: 46adcbc0-aa26-4867-a4e7-28a5ad9100ae
                        metadata:
                          - key: on_behalf_of
                            value: acct_1A2b3C4d5E6f7G8h
                          - key: order_ref
                            value: ABC-123
                        callback_url: null
                        action: null
                        redirect_url: null
                        created_at: '2023-08-05T14:22:06.766268Z'
                        updated_at: '2023-08-05T14:22:06.766268Z'
                        card_data:
                          iin: '41111111'
                          lfd: '1111'
                          expiration_month: 3
                          expiration_year: 27
                          number_length: 16
                          security_code_length: 3
                          brand: VISA
                          issuer: null
                          issuer_name: JPMORGAN_CHASE_BANK_NA
                          issuer_code: US_JPMORGAN_CHASE_BANK_NA
                          category: null
                          type: CREDIT
                        last_successfully_used: false
                        last_successfully_used_at: ''
                      - idempotency_key: null
                        name: VISA ****1111
                        description: VISA ****1111
                        icon: https://icons.prod.y.uno/visa_logosimbolo.png
                        type: CARD
                        category: CARD
                        country: US
                        status: ENROLLED
                        sub_status: null
                        vaulted_token: 7ced7717-f860-4705-a376-58a714953de9
                        callback_url: null
                        action: null
                        redirect_url: null
                        created_at: '2023-08-05T14:45:24.112621Z'
                        updated_at: '2023-08-05T14:45:24.112621Z'
                        card_data:
                          iin: '41111111'
                          lfd: '1111'
                          expiration_month: 3
                          expiration_year: 27
                          number_length: 16
                          security_code_length: 3
                          brand: VISA
                          issuer: null
                          issuer_name: JPMORGAN_CHASE_BANK_NA
                          issuer_code: US_JPMORGAN_CHASE_BANK_NA
                          category: null
                          type: CREDIT
                        last_successfully_used: false
                        last_successfully_used_at: ''
              schema:
                type: object
                properties:
                  payment_methods:
                    type: array
                    items:
                      type: object
                      properties:
                        idempotency_key: {}
                        name:
                          type: string
                          example: VISA ****1111
                        description:
                          type: string
                          example: VISA ****1111
                        icon:
                          type: string
                          example: https://icons.prod.y.uno/visa_logosimbolo.png
                        type:
                          type: string
                          example: CARD
                        category:
                          type: string
                          example: CARD
                        country:
                          type: string
                          example: US
                        status:
                          type: string
                          example: ENROLLED
                        sub_status: {}
                        vaulted_token:
                          type: string
                          example: 46adcbc0-aa26-4867-a4e7-28a5ad9100ae
                        metadata:
                          type: array
                        callback_url: {}
                        action: {}
                        redirect_url: {}
                        created_at:
                          type: string
                          example: '2023-08-05T14:22:06.766268Z'
                        updated_at:
                          type: string
                          example: '2023-08-05T14:22:06.766268Z'
                        card_data:
                          type: object
                          properties:
                            iin:
                              type: string
                              example: '41111111'
                            lfd:
                              type: string
                              example: '1111'
                            expiration_month:
                              type: integer
                              example: 3
                              default: 0
                            expiration_year:
                              type: integer
                              example: 27
                              default: 0
                            number_length:
                              type: integer
                              example: 16
                              default: 0
                            security_code_length:
                              type: integer
                              example: 3
                              default: 0
                            security_code_expires_in:
                              type: integer
                              example: 842
                              description: >-
                                Segundos restantes antes de que el código de
                                seguridad almacenado deje de estar disponible
                                para el proxy de reenvío PCI. Devuelve -1 una
                                vez que esa ventana se cerró, y se omite por
                                completo cuando la tarjeta no tiene código de
                                seguridad. Solo está presente para
                                organizaciones con el proxy de reenvío PCI
                                habilitado.
                            brand:
                              type: string
                              example: VISA
                            issuer: {}
                            issuer_name:
                              type: string
                              example: JPMORGAN_CHASE_BANK_NA
                            issuer_code:
                              type: string
                              example: US_JPMORGAN_CHASE_BANK_NA
                            category: {}
                            type:
                              type: string
                              example: CREDIT
                        last_successfully_used:
                          type: boolean
                          example: false
                          default: true
                        last_successfully_used_at:
                          type: string
                          example: ''
        '400':
          description: '400'
          content:
            application/json:
              examples:
                Bad Request:
                  value:
                    code: INVALID_REQUEST
                    messages:
                      - Invalid request
              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
        '403':
          description: '403'
          content:
            application/json:
              examples:
                Forbidden:
                  value:
                    code: AUTHORIZATION_REQUIRED
                    messages:
                      - The merchant has no authorization to use this API.
              schema:
                type: object
                properties:
                  code:
                    type: string
                    example: AUTHORIZATION_REQUIRED
                  messages:
                    type: array
                    items:
                      type: string
                      example: The merchant has no authorization to use this API.
      deprecated: false
components:
  securitySchemes:
    sec0:
      type: apiKey
      in: header
      name: public-api-key
      x-default: <Your public-api-key>
    sec1:
      type: apiKey
      in: header
      name: private-secret-key
      x-default: <Your private-secret-key>

````

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