Criar nova assinatura

Cria uma nova assinatura para gerar cobranças recorrentes conforme a periodicidade configurada.

As cobranças futuras são geradas gradualmente ao longo da recorrência e não são criadas todas no momento da criação da assinatura. Cada cobrança possui seu próprio ID, status e ciclo financeiro.

A resposta representa a assinatura criada e inclui seu ID, utilizado nas operações posteriores relacionadas à recorrência.

📘

Acompanhamento da recorrência

A criação da assinatura não confirma nenhum pagamento.

Utilize os Webhooks de assinaturas para acompanhar o ciclo de vida da assinatura e os Webhooks de cobranças para acompanhar as cobranças geradas e seus pagamentos.

Para informar os dados do cartão diretamente na criação, utilize Criar assinatura com cartão de crédito.

Conteúdos relacionados

Guides

Body Params
string
required

Identificador único do cliente no Asaas

string
enum
required

Forma de pagamento

Allowed:
number
required

Valor da assinatura

date
required

Vencimento da primeira cobrança

discount
object

Informações de desconto

interest
object

Informações de juros para pagamento após o vencimento

fine
object

Informações de multa para pagamento após o vencimento

string
enum
required

Periodicidade da cobrança

Allowed:
string

Descrição da assinatura (máx. 500 caracteres)

date

Data limite para vencimento das cobranças

int32

Número máximo de cobranças a serem geradas para esta assinatura

string

Identificador da assinatura no seu sistema

split
array of objects

Informações de split

split
callback
object

Informações de redirecionamento automático após pagamento do link de pagamento

Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json