Salvar Cartão

post

https://api.toktus.com/api/v1/cards/

Tokeniza e salva um cartão de crédito vinculado a um cliente. Retorna o id do cartão salvo, que pode ser reutilizado no campo creditCard.paymentMethodId em cobranças futuras.

Métodos de envio:

Prioridade	Campo	Descrição
1ª	`paymentMethodId`	ID de PaymentMethod já criado (Stripe.js)
2ª	`token`	Token gerado no frontend (MercadoPago.js, PagBank.js, Stripe.js)
3ª	Dados raw	`number`, `holderName`, `expMonth`, `expYear`, `cvv`

Mercado Pago: Aceita apenas token — dados raw retornam erro 422.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

gateway

string

enum

Identificador do gateway de pagamento:

stripe — Gateway internacional com APIs modernas
pagarme — Gateway brasileiro com boa documentação
asaas — Focado em cobranças recorrentes e boletos
mercadopago — Maior gateway da América Latina
pagseguro — Gateway tradicional do Brasil (PagBank)

Allowed:

customerId

string

required

length between 3 and 100

ID do cliente no gateway

paymentMethodId

string

length between 5 and 200

ID de PaymentMethod previamente criado no frontend (Stripe.js). No Mercado Pago, tratado como alias do token.

token

string

length between 5 and 200

Token do cartão. Obrigatório para Mercado Pago (gerado via MercadoPago.js). Stripe: tok_visa, tok_mastercard. PagSeguro: token encrypted do PagBank.js.

number

string

length between 13 and 19

^[0-9]+$

Número do cartão (13-19 dígitos, sem espaços). Não suportado pelo Mercado Pago. Aceito por Stripe (com ativação), Pagar.me, Asaas e PagSeguro.

holderName

string

length between 3 and 100

Nome impresso no cartão (letras maiúsculas)

expMonth

integer

1 to 12

Mês de validade (1–12)

expYear

integer

≥ 2025

Ano de validade (ex: 2028)

cvv

string

length between 3 and 4

^[0-9]{3,4}$

Código de segurança (3 ou 4 dígitos)

Responses

Language

Credentials

Header

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

201Default Response