Iugu Payment Token API
The Payment Token API from Iugu — 1 operation(s) for payment token.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/iugu:iugu-payment-token-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: tokens-e-cobrança-direta Payment Token API
version: '1.0'
servers:
- url: https://api.iugu.com/v1
security:
- sec0: []
tags:
- name: Payment Token
paths:
/payment_token:
post:
summary: Criar Token
description: 'O Token é uma representação do Cartão de Crédito, sendo totalmente seguro, de forma que não é possível que alguém consiga as informações deste cartão. O token é gerado para uma transação específica, tornando-o ainda mais seguro.
Cuidado
A API de Criação de Token não utiliza a autenticação via api_token.
Alerta de conformidade com PCI
Esta chamada API deve ser utilizada apenas em aplicações sem compatibilidade com JavaScript como por exemplo aplicações móveis. Se você efetuar esta chamada por dentro de seus servidores estará sujeito a uma auditoria do PCI. Para aplicações WEB, utilize a geração do token de cartão pelo iugu.js'
operationId: criar-token
requestBody:
content:
application/json:
schema:
type: object
required:
- account_id
- method
properties:
account_id:
type: string
description: ID de sua Conta na Iugu (<a href="https://app.iugu.com/account" target="_blank">O ID de sua conta pode ser encontrado aqui</a>)
method:
type: string
description: Método de Pagamento (atualmente somente credit_card)
test:
type: boolean
description: Valor true para criar tokens de teste. <a href="http://support.iugu.com/hc/pt-br/articles/212456346-Usar-cart%C3%B5es-de-teste-em-modo-de-teste" target="_blank">Use cartões de teste</a>
data:
properties:
number:
type: string
description: Número do Cartão de Crédito
verification_value:
type: string
description: CVV do Cartão de Crédito
first_name:
type: string
description: Nome do Cliente como está no Cartão
last_name:
type: string
description: Sobrenome do Cliente como está no Cartão
month:
type: string
description: 'Mês de Vencimento no Formato "MM" (Ex: 01, 06, 12)'
year:
type: string
description: 'Ano de Vencimento no Formato "AAAA" (Ex: 2020, 2030, 2018)'
required:
- number
- verification_value
- first_name
- last_name
- month
- year
type: object
description: Dados do Método de Pagamento
responses:
'200':
description: '200'
content:
application/json:
examples:
Result:
value: "{\n \"id\": \"ca9f3aa5-4df1-4a4c-9145-81641f1b4f6b\",\n \"method\": \"credit_card\",\n \"extra_info\": {\n \"bin\": \"411111\",\n \"year\": 2030,\n \"month\": 1,\n \"brand\": \"VISA\",\n \"holder_name\": \"FIRST LAST\",\n \"display_number\": \"XXXX-XXXX-XXXX-1111\"\n },\n \"test\": true\n}"
schema:
type: object
properties:
id:
type: string
example: ca9f3aa5-4df1-4a4c-9145-81641f1b4f6b
method:
type: string
example: credit_card
extra_info:
type: object
properties:
bin:
type: string
example: '411111'
year:
type: integer
example: 2030
default: 0
month:
type: integer
example: 1
default: 0
brand:
type: string
example: VISA
holder_name:
type: string
example: FIRST LAST
display_number:
type: string
example: XXXX-XXXX-XXXX-1111
test:
type: boolean
example: true
default: true
'400':
description: '400'
content:
application/json:
examples:
Result:
value: "{\n \"errors\": \"account_id invalido\"\n}"
schema:
type: object
properties:
errors:
type: string
example: account_id invalido
'422':
description: '422'
content:
text/plain:
examples:
Un.Entity:
value: "{\n \"errors\": {\n \"method\": [\n \"credit_cards não é suportado. (Métodos suportados: credit_card)\"\n ], \n \"number\": [\n \"is not a valid credit card number\"\n ], \n \"year\": [\n \"expired\"\n ]\n }\n}"
schema:
type: object
properties:
errors:
type: object
properties:
method:
type: array
items:
type: string
example: 'credit_cards não é suportado. (Métodos suportados: credit_card)'
number:
type: array
items:
type: string
example: is not a valid credit card number
year:
type: array
items:
type: string
example: expired
deprecated: false
security: []
tags:
- Payment Token
components:
securitySchemes:
sec0:
type: apiKey
in: query
name: api_token
x-readme-fauxas: true
x-provenance:
method: searched
source: https://dev.iugu.com/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://dev.iugu.com/reference/cobranca-direta-com-2-cartoes.md
- https://dev.iugu.com/reference/cobranca-direta.md
- https://dev.iugu.com/reference/criar-token.md
- https://dev.iugu.com/reference/listar-api-tokens.md
- https://dev.iugu.com/reference/reemissao-de-fatura-expirada.md
merge:
pages: 5
deduped: 4
conflicts_kept_first: 0