openapi: 3.2.0
info:
  title: pagarme-api Tokens API
  version: '5'
servers:
- url: https://api.pagar.me/core/v5
security:
- sec0: []
tags:
- name: Tokens
paths:
  /tokens:
    post:
      summary: Criar Token cartão
      description: ''
      operationId: criar-token-cartão-1
      parameters:
      - name: appId
        in: query
        description: Chave publica da conta.
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
              - type
              - card
              properties:
                type:
                  type: string
                  description: Tipo do cartão
                card:
                  type: object
                  description: Informações do cartão a ser tokenizado.
                  required:
                  - number
                  - exp_month
                  - exp_year
                  properties:
                    number:
                      type: string
                      description: Número do cartão. Entre 13 e 19 caracteres
                    holder_name:
                      type: string
                      description: Nome do portador como está impresso no cartão. Máximo de 64 caracteres (Caracteres especiais e números não são aceitos)
                    holder_document:
                      type: string
                      description: CPF ou CNPJ do portador do cartão. Obrigatório caso o tipo do cartão seja voucher (bandeiras VR ou Pluxee).
                    exp_month:
                      type: string
                      description: Mês de validade do cartão. Valor entre 1 e 12 (inclusive)
                    exp_year:
                      type: string
                      description: 'Ano de validade do cartão. Formatos yy ou yyyy. Ex: 23 ou 2023.'
                    cvv:
                      type: string
                      description: Código de segurança do cartão. O campo aceita 4 ou 3 caracteres, variando por bandeira.
                    brand:
                      type: string
                      description: '(Opcional) Bandeira do cartão. Para cartões de crédito, temos como valores possíveis: Elo, Mastercard, Visa, Amex, ou Hipercard. Para voucher, temos como valores possíveis: Alelo, VR ou Pluxee.'
                    label:
                      type: string
                      description: Indica a label do cartão
            examples:
              Request Example:
                value:
                  type: card
                  card:
                    number: '4000000000000010'
                    holder_name: Tony Stark
                    exp_month: 1
                    exp_year: 30
                    cvv: '651'
                    label: Sua bandeira
      responses:
        '200':
          description: '200'
          content:
            application/json:
              examples:
                Result:
                  value: "{\n    \"id\": \"token_zVw7rqvHEPH8XlbE\",\n    \"type\": \"card\",\n    \"created_at\": \"2018-06-18T18:48:58Z\",\n    \"expires_at\": \"2018-06-18T18:49:58Z\",\n    \"card\": {\n        \"last_four_digits\": \"5580\",\n        \"holder_name\": \"Tony Stark\",\n        \"exp_month\": 1,\n        \"exp_year\": 30,\n        \"brand\": \"Visa\",\n        \"label\": \"Sua bandeira\"\n    }\n}"
              schema:
                type: object
                properties:
                  id:
                    type: string
                    example: token_zVw7rqvHEPH8XlbE
                  type:
                    type: string
                    example: card
                  created_at:
                    type: string
                    example: '2018-06-18T18:48:58Z'
                  expires_at:
                    type: string
                    example: '2018-06-18T18:49:58Z'
                  card:
                    type: object
                    properties:
                      last_four_digits:
                        type: string
                        example: '5580'
                      holder_name:
                        type: string
                        example: Tony Stark
                      exp_month:
                        type: integer
                        example: 1
                        default: 0
                      exp_year:
                        type: integer
                        example: 30
                        default: 0
                      brand:
                        type: string
                        example: Visa
                      label:
                        type: string
                        example: Sua bandeira
        '400':
          description: '400'
          content:
            application/json:
              examples:
                Result:
                  value: "{\n    \"message\": \"Could not renew card.\"\n}"
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: Could not renew card.
      deprecated: false
      security: []
      tags:
      - Tokens
components:
  securitySchemes:
    sec0:
      type: http
      scheme: basic
x-readme-fauxas: true
x-provenance:
  method: searched
  source: https://docs.pagar.me/reference
  harvested: '2026-10-14'
  tool: harvest-readme-openapi.py
  note: Assembled verbatim from the OpenAPI definition ReadMe embeds in each operation page of the provider's developer portal; paths and components merged by API title, nothing authored.
  assembled_from:
  - https://docs.pagar.me/reference/ativar-faturamento-manual-1.md
  - https://docs.pagar.me/reference/atualizar-code-de-recebedor.md
  - https://docs.pagar.me/reference/cancelar-assinatura-1.md
  - https://docs.pagar.me/reference/cancelar-fatura-1.md
  - https://docs.pagar.me/reference/cancelar-um-link-de-pagamento.md
  - https://docs.pagar.me/reference/create-link.md
  - https://docs.pagar.me/reference/criar-assinatura-avulsa.md
  - https://docs.pagar.me/reference/criar-assinatura-de-plano-1.md
  - https://docs.pagar.me/reference/criar-cliente-1.md
  - https://docs.pagar.me/reference/criar-fatura-1.md
  - https://docs.pagar.me/reference/criar-link-recebedor.md
  - https://docs.pagar.me/reference/criar-link.md
  - https://docs.pagar.me/reference/criar-pedido-2.md
  - https://docs.pagar.me/reference/criar-pedido-com-antifraude.md
  - https://docs.pagar.me/reference/criar-pedido-com-split-1.md
  - https://docs.pagar.me/reference/criar-pedido-multicompradores.md
  - https://docs.pagar.me/reference/criar-pedido-multimeios.md
  - https://docs.pagar.me/reference/criar-plano-1.md
  - https://docs.pagar.me/reference/criar-recebedor-1.md
  - https://docs.pagar.me/reference/criar-token-cart%C3%A3o-1.md
  - https://docs.pagar.me/reference/deletar-item.md
  - https://docs.pagar.me/reference/desativar-faturamento-manual-1.md
  - https://docs.pagar.me/reference/editar-cliente-1.md
  - https://docs.pagar.me/reference/editar-item-1.md
  - https://docs.pagar.me/reference/editar-item-do-pedido.md
  - https://docs.pagar.me/reference/editar-item.md
  - https://docs.pagar.me/reference/editar-meio-de-pagamento-da-assinatura.md
  - https://docs.pagar.me/reference/editar-metadados-da-assinatura-1.md
  - https://docs.pagar.me/reference/editar-metadados-da-fatura-1.md
  - https://docs.pagar.me/reference/editar-metadados-do-plano-1.md
  - https://docs.pagar.me/reference/editar-minimum-price-da-assinatura.md
  - https://docs.pagar.me/reference/editar-plano-1.md
  - https://docs.pagar.me/reference/editar-recebedor-1.md
  - https://docs.pagar.me/reference/enviar-webhook.md
  - https://docs.pagar.me/reference/excluir-plano-1.md
  - https://docs.pagar.me/reference/fechar-um-pedido.md
  - https://docs.pagar.me/reference/incluir-desconto-1.md
  - https://docs.pagar.me/reference/incluir-incremento-1.md
  - https://docs.pagar.me/reference/incluir-item-1.md
  - https://docs.pagar.me/reference/incluir-item-2.md
  - https://docs.pagar.me/reference/incluir-item.md
  - https://docs.pagar.me/reference/incluir-uso.md
  - https://docs.pagar.me/reference/listar-assinaturas-1.md
  - https://docs.pagar.me/reference/listar-ciclos-1.md
  - https://docs.pagar.me/reference/listar-clientes-1.md
  - https://docs.pagar.me/reference/listar-descontos-2.md
  - https://docs.pagar.me/reference/listar-faturas-1.md
  - https://docs.pagar.me/reference/listar-incrementos.md
  - https://docs.pagar.me/reference/listar-pedidos.md
  - https://docs.pagar.me/reference/listar-planos-1.md
  - https://docs.pagar.me/reference/listar-recebedores-1.md
  - https://docs.pagar.me/reference/listar-uso.md
  - https://docs.pagar.me/reference/listar-webhooks.md
  - https://docs.pagar.me/reference/obter-assinatura-1.md
  - https://docs.pagar.me/reference/obter-ciclo-1.md
  - https://docs.pagar.me/reference/obter-cliente-1.md
  - https://docs.pagar.me/reference/obter-desconto-1.md
  - https://docs.pagar.me/reference/obter-fatura-1.md
  - https://docs.pagar.me/reference/obter-incremento-1.md
  - https://docs.pagar.me/reference/obter-item-do-pedido.md
  - https://docs.pagar.me/reference/obter-link.md
  - https://docs.pagar.me/reference/obter-links.md
  - https://docs.pagar.me/reference/obter-pedido.md
  - https://docs.pagar.me/reference/obter-plano-1.md
  - https://docs.pagar.me/reference/obter-recebedor-1.md
  - https://docs.pagar.me/reference/obter-saldo.md
  - https://docs.pagar.me/reference/obter-webhook.md
  - https://docs.pagar.me/reference/remover-desconto-1.md
  - https://docs.pagar.me/reference/remover-incremento-1.md
  - https://docs.pagar.me/reference/remover-item-1.md
  - https://docs.pagar.me/reference/remover-item.md
  - https://docs.pagar.me/reference/remover-todos-os-itens.md
  - https://docs.pagar.me/reference/remover-uso.md
  - https://docs.pagar.me/reference/renovar-ciclo-1.md
  - https://docs.pagar.me/reference/retornando-pagamentos-por-recebedor.md
  - https://docs.pagar.me/reference/retornando-pagamentos.md
  - https://docs.pagar.me/reference/retornando-um-pagamento.md
  - https://docs.pagar.me/reference/retornando-urs-de-um-recebedor-v5.md
  merge:
    pages: 78
    deduped: 82
    conflicts_kept_first: 0