Criar assinatura com cartão de crédito

Cria uma assinatura com cartão de crédito e valida o cartão informado para utilização nas cobranças recorrentes.

A primeira cobrança ocorre em nextDueDate. Se essa data corresponder ao dia da criação, a cobrança poderá ser processada imediatamente. A validação realizada na criação não garante a aprovação das cobranças futuras.

O cartão pode ser informado com creditCard e creditCardHolderInfo ou por meio de um creditCardToken válido para o mesmo cliente da assinatura.

⚠️

Timeout e retentativas

Configure timeout mínimo de 60 segundos para esta operação.

Em caso de timeout, não repita automaticamente a criação sem avaliar o resultado anterior, pois uma nova tentativa pode gerar uma assinatura duplicada.

As cobranças geradas posteriormente possuem ciclo de vida próprio. Utilize os Webhooks de assinaturas para acompanhar a recorrência e os Webhooks de cobranças para acompanhar o processamento de cada cobrança.

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

creditCard
object
required

Informações do cartão de crédito

creditCardHolderInfo
object
required

Informações do titular do cartão de crédito

string

Token do cartão de crédito para uso da funcionalidade de tokenização de cartão de crédito. Caso informado, os campos acima não são obrigatórios.

string
required

IP de onde o cliente está fazendo a compra. Não deve ser informado o IP do seu servidor.

Responses

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