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

# Tokenizar tarjeta

Este endpoint tokeniza de forma segura una tarjeta, reemplazando los datos confidenciales con un token único. Este token puede utilizarse en transacciones futuras, garantizando el cumplimiento de las normas de seguridad (por ejemplo, PCI DSS) y reduciendo la necesidad de almacenar o gestionar información confidencial de la tarjeta.


## OpenAPI

````yaml openapi/es/localpayment.json POST /api/card
openapi: 3.1.0
info:
  version: '1.0'
  title: Localpayment
  contact:
    name: Support
    url: mailto:support@localpayment.com
servers:
  - url: https://api.stage.localpayment.com
    description: Stage
security:
  - token: []
paths:
  /api/card:
    post:
      summary: Tokenizar tarjeta
      operationId: tokenize-card
      parameters:
        - name: Authorization
          in: header
          description: >-
            Token de acceso Bearer para la autenticación. Este token se obtiene
            de los endpoints [Get Access Token](/es/reference/get-token) o
            [Refresh Access Token](/es/reference/refresh-token).
          required: true
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                name:
                  type: string
                  description: >-
                    Nombre del titular de la tarjeta. **Obligatorio si `token`
                    no está presente.**
                number:
                  type: string
                  description: >-
                    Número de tarjeta. **Obligatorio si `token` no está
                    presente.**
                cvv:
                  type: string
                  description: >-
                    CVV de la tarjeta. **Obligatorio si `token` no está
                    presente.**
                expirationMonth:
                  type: string
                  description: >-
                    Mes de vencimiento de la tarjeta. **Obligatorio si `token`
                    no está presente.**
                expirationYear:
                  type: string
                  description: >-
                    Año de vencimiento de la tarjeta. **Obligatorio si `token`
                    no está presente.**
                token:
                  type: string
                  description: >-
                    Utiliza una tarjeta previamente tokenizada enviando el
                    token.
              required:
                - name
                - number
                - cvv
                - expirationMonth
                - expirationYear
              x-examples:
                Example 1:
                  name: NICOLAS CABRAL
                  number: '4000000000000002'
                  cvv: '123'
                  expirationMonth: '11'
                  expirationYear: '2026'
            examples:
              Save card:
                value:
                  name: John Doe
                  number: '4000000000000002'
                  cvv: '123'
                  expirationMonth: '11'
                  expirationYear: '2028'
              801 - Params error card number.:
                value:
                  name: John Doe
                  number: '400000000000000'
                  cvv: '123'
                  expirationMonth: '11'
                  expirationYear: '2028'
              820 - Unknown error Failed to save card.:
                value:
                  number: '4000000000000002'
                  cvv: '123'
                  expirationMonth: '11'
                  expirationYear: '2028'
              801 - Params error fullCardData.:
                value:
                  name: John Doe
                  number: '4000000000000002'
                  expirationMonth: '11'
                  expirationYear: '2028'
              801 - Params error expiration month, bad format.:
                value:
                  name: John Doe
                  number: '4000000000000002'
                  cvv: '123'
                  expirationYear: '2028'
              801 - Params error expiration year, bad format.:
                value:
                  name: John Doe
                  number: '4000000000000002'
                  cvv: '123'
                  expirationMonth: '11'
              Use a tokenized card:
                value:
                  token: WleV6CZ785IMx1x11SIrqzOn3JsGKcef8oBh2mbi56M%3D
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  card:
                    type: object
                    description: Información de la tarjeta.
                    properties:
                      token:
                        type: string
                        description: Token que contiene la información de la tarjeta.
                      bin:
                        type: string
                        description: Número de identificación bancaria.
                      brand:
                        type: string
                        description: Red de pago con tarjeta.
                      Country:
                        type: string
                        enum:
                          - AR
                          - BO
                          - BR
                          - CL
                          - CO
                          - CR
                          - DO
                          - EC
                          - SV
                          - GT
                          - HN
                          - MX
                          - PA
                          - PY
                          - PE
                          - UY
                        title: Country
                        description: >-
                          [País](/es/reference/country-codes). ISO 3166-1
                          alfa-2.
                      name:
                        type: string
                        description: Nombre del titular de la tarjeta.
                      last4:
                        type: string
                        description: Últimos cuatro dígitos de la tarjeta.
                      expirationYear:
                        type: integer
                        description: Año de vencimiento en formato `YYYY`.
                      expirationMonth:
                        type: integer
                        description: Mes de vencimiento en formato `MM`.
                      Installments:
                        type: integer
                        description: Pagos a plazos.
                    x-examples:
                      Example 1:
                        card:
                          token: Txf+Hf/YlDNiJOkIifR7nXDnvH0IsuZN+dwyzen5Ks0=
                          bin: '424242'
                          brand: VISA
                          country: GB
                          name: MANUEL CEDRO
                          last4: '4242'
                          expirationYear: 2025
                          expirationMonth: 11
                          installments: 0
                  errors:
                    type: array
                    description: Lista de errores que se produjeron durante la transacción.
                    items:
                      type: object
                x-examples:
                  Example 1:
                    card:
                      token: xsWMaLnYjSNL1teBwxl465%2F2d8J85FXPAgBFIKfr0FA%3D
                      bin: '400000'
                      brand: VISA
                      country: US
                      name: NICOLAS CABRAL
                      last4: '0002'
                      expirationYear: 2028
                      expirationMonth: 11
                    errors: []
              examples:
                200 - Save card.:
                  value:
                    card:
                      token: xsWMaLcYjS3L11aBwxl465%2F2d8J85FXPAaBFIKfr0Fx%3D
                      bin: '400000'
                      brand: VISA
                      country: US
                      name: John Doe
                      last4: '0002'
                      expirationYear: 2028
                      expirationMonth: 11
                    errors: []
        '400':
          description: Solicitud incorrecta.
          content:
            application/json:
              schema:
                type: object
                properties:
                  errors:
                    type: array
                    description: Lista de errores que se produjeron durante la transacción.
                    items:
                      type: object
                      properties:
                        code:
                          type: string
                          description: Código de error.
                        detail:
                          type: string
                          description: Detalles del error.
                        description:
                          type: string
                          description: Descripción del error.
                x-examples:
                  Example 1:
                    errors:
                      - code: '820'
                        description: REJECTED
                        detail: Unknown error Failed to save card.
              examples:
                820 - Unknown error Failed to save card.:
                  value:
                    errors:
                      - code: '820'
                        description: REJECTED
                        detail: Unknown error Failed to save card.
                801 - Params error card number.:
                  value:
                    errors:
                      - code: '801'
                        description: REJECTED
                        detail: Params error card number
                801 - Params error fullCardData.:
                  value:
                    errors:
                      - code: '801'
                        description: REJECTED
                        detail: Params error fullCardData
                801 - Params error expiration month, bad format.:
                  value:
                    errors:
                      - code: '801'
                        description: REJECTED
                        detail: Params error expiration month, bad format
                801 - Params error expiration year, bad format.:
                  value:
                    errors:
                      - code: '801'
                        description: REJECTED
                        detail: Params error expiration year, bad format
        '401':
          description: No autorizado.
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: string
                    description: Información adicional sobre la respuesta.
                  code:
                    type: string
                    description: Código de estado.
                  messages:
                    type: array
                    description: Lista de mensajes.
                    items:
                      type: object
                      properties:
                        token_class:
                          type: string
                          description: Clase de token.
                        token_type:
                          type: string
                          description: Tipo de token.
                        message:
                          type: string
                          description: Mensaje con información adicional.
                x-examples:
                  Example 1:
                    detail: Given token not valid for any token type
                    code: token_not_valid
                    messages:
                      - token_class: AccessToken
                        token_type: access
                        message: Token is invalid or expired
              examples:
                401 - Token is invalid or expired:
                  value:
                    detail: Given token not valid for any token type
                    code: token_not_valid
                    messages:
                      - token_class: AccessToken
                        token_type: access
                        message: Token is invalid or expired
      security:
        - token: []
      servers:
        - url: https://api.stage.localpayment.com
          description: Stage
components:
  securitySchemes:
    token:
      type: http
      scheme: bearer

````

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