> ## 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 Cartão

Este endpoint tokeniza um cartão de forma segura, substituindo os dados sensíveis do cartão por um token exclusivo. O token pode ser usado em transações futuras, garantindo a conformidade com os padrões de segurança (por exemplo, PCI DSS) e reduzindo a necessidade de armazenar ou manusear informações confidenciais do cartão.


## OpenAPI

````yaml openapi/pt-br/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 Cartão
      operationId: tokenize-card
      parameters:
        - name: Authorization
          in: header
          description: >-
            Token de acesso Bearer para autenticação. Este token é obtido nos
            endpoints [Obter token de acesso](/pt-br/reference/get-token) ou
            [Renovar token de acesso](/pt-br/reference/refresh-token).
          required: true
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                name:
                  type: string
                  description: >-
                    Nome do titular do cartão. **Obrigatório se `token` não
                    estiver presente.**
                number:
                  type: string
                  description: >-
                    Número do cartão. **Obrigatório se `token` não estiver
                    presente.**
                cvv:
                  type: string
                  description: >-
                    Código CVV do cartão. **Obrigatório se `token` não estiver
                    presente.**
                expirationMonth:
                  type: string
                  description: >-
                    Mês de validade do cartão. **Obrigatório se `token` não
                    estiver presente.**
                expirationYear:
                  type: string
                  description: >-
                    Ano de validade do cartão. **Obrigatório se `token` não
                    estiver presente.**
                token:
                  type: string
                  description: Utilize um cartão previamente tokenizado enviando o 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: Informações do cartão.
                    properties:
                      token:
                        type: string
                        description: Token que contém as informações do cartão.
                      bin:
                        type: string
                        description: Número de identificação bancária.
                      brand:
                        type: string
                        description: Rede de pagamento com cartão.
                      Country:
                        type: string
                        enum:
                          - AR
                          - BO
                          - BR
                          - CL
                          - CO
                          - CR
                          - DO
                          - EC
                          - SV
                          - GT
                          - HN
                          - MX
                          - PA
                          - PY
                          - PE
                          - UY
                        title: País
                        description: >-
                          [País](/pt-br/reference/country-codes). ISO 3166-1
                          alfa-2.
                      name:
                        type: string
                        description: Nome do titular do cartão.
                      last4:
                        type: string
                        description: Últimos quatro dígitos do cartão.
                      expirationYear:
                        type: integer
                        description: Ano de validade no formato `YYYY`.
                      expirationMonth:
                        type: integer
                        description: Mês de validade no formato `MM`.
                      Installments:
                        type: integer
                        description: Parcelamento.
                    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 erros que ocorreram durante a transação.
                    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: Solicitação inválida.
          content:
            application/json:
              schema:
                type: object
                properties:
                  errors:
                    type: array
                    description: Lista de erros que ocorreram durante a transação.
                    items:
                      type: object
                      properties:
                        code:
                          type: string
                          description: Código de erro.
                        detail:
                          type: string
                          description: Detalhes do erro.
                        description:
                          type: string
                          description: Descrição do erro.
                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: Não autorizado.
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: string
                    description: Informações adicionais sobre a resposta.
                  code:
                    type: string
                    description: Código de status.
                  messages:
                    type: array
                    description: Lista de mensagens.
                    items:
                      type: object
                      properties:
                        token_class:
                          type: string
                          description: Classe Token.
                        token_type:
                          type: string
                          description: Tipo de token.
                        message:
                          type: string
                          description: Mensagem com informações adicionais.
                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.