Atualizar Assinatura

put

https://api.toktus.com/api/v1/subscriptions/{gateway}/{externalId}

Atualiza os parâmetros de uma assinatura existente. É possível alterar o valor, o método de pagamento, os dados do cartão e a data da próxima cobrança.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

gateway

string

enum

required

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:

externalId

string

required

ID do recurso no gateway (ex: cus_abc123)

Body Params

amount

integer

paymentMethod

string

enum

Método de pagamento utilizado na transação:

credit_card — Cartão de crédito (à vista ou parcelado)
debit_card — Cartão de débito (aprovação instantânea)
boleto — Boleto bancário (compensação em 1-3 dias úteis)
pix — Pagamento instantâneo via PIX (disponível 24/7)

Allowed:

nextDueDate

date

creditCard

object

Dados do cartão de crédito. Obrigatório quando paymentMethod = credit_card.

Prioridade de campos: paymentMethodId > token > dados raw (number/expMonth/expYear/cvv).

Compatibilidade por gateway:

Gateway	Token	PaymentMethod ID	Dados raw
Stripe			(requer ativação)
Pagar.me
Asaas
Mercado Pago	(obrigatório)	(alias)
PagSeguro	(encrypted)	(alias)

metadata

object

Responses

Language

Credentials

Header

Loading…

Response

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

application/json

200Default Response