Criar assinatura com cartão de crédito

Assim como na cobrança, os dados do cartão e do portador podem ser enviados na requisição de criação da assinatura para que o pagamento já seja processado. A diferença é que no caso da cobrança o cartão do cliente é cobrado no momento da criação da mesma, já no caso da assinatura, o cartão será validado no momento da criação, porém a cobrança será feita somente no vencimento da primeira mensalidade. É importante ressaltar que a validação feita no momento a criação não garante que cobrança ocorrerá com sucesso no vencimento, pois neste meio-tempo o cartão pode ter sido cancelado, expirado, não ter limite, entre outros.

Para tal, ao executar a requisição de criação da assinatura, basta enviar os dados do cartão de crédito juntamente com os dados do titular através dos objetos creditCard e creditCardHolderInfo. Se a transação for autorizada a assinatura será criada e o Asaas retornará HTTP 200. Caso contrário a assinatura não será persistida e será retornado HTTP 400.

Uma vez criada a assinatura com cartão de crédito, a cobrança será feita mensalmente (ou outra periodicidade definida) no cartão do cliente até que ele se torne inválido ou você remova a assinatura.

🚧

Atenção

  • Caso você opte por capturar na interface do seu sistema os dados do cartão do cliente, é obrigatório o uso de SSL (HTTPS), caso contrário sua conta pode ser bloqueada para transações via cartão de crédito.
  • Para se evitar timeouts e decorrentemente duplicidades na captura, recomendamos a configuração de um timeout mínimo de 60 segundos para este request.

Tokenização de cartão de crédito

Para utilizar a tokenização de cartão de crédito na criação de assinaturas você deve seguir as mesmas instruções do Criar cobrança com cartão de crédito.

Body Params
string
required
string
enum
required
Allowed:
number
required
date
required
discount
object
interest
object
fine
object
string
enum
required
Allowed:
string
date
int32
string
split
array of objects
split
callback
object
creditCard
object
required
creditCardHolderInfo
object
required
string
string
required
Responses

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