Criando um link de pagamentos

Para criar um link de pagamentos, basta chamar o endpoint de link de pagamentos.

POST /v3/paymentLinks
Confira a referência completa deste endpoint.

{
  "name": "Venda de livros",
  "description": "Qualquer livro por apenas R$: 50,00",
  "value": 50.00,
  "billingType": "UNDEFINED",
  "chargeType": "DETACHED",
  "dueDateLimitDays": 10
}

No exemplo acima, uma nova cobrança avulsa de R$ 50 será criada cada vez que um cliente preencher este link de pagamentos. Ele ficará ativo até que seja desabilitado ou deletado.

Também é possível criar link de pagamentos para pagamentos parcelados, nesse sentido você apenas informa qual a quantidade máxima de parcelas disponíveis e o cliente irá escolher qual forma deseja fazer o pagamento.

POST /v3/paymentLinks
Confira a referência completa deste endpoint.

{
  "billingType": "CREDIT_CARD",
  "chargeType": "INSTALLMENT",
  "name": "Venda de eletrônicos",
  "description": "Qualquer produto em até 10x de R$ 50,00",
  "value": 500.00,
  "maxInstallmentCount": 10,
  "notificationEnabled": false
}

No exemplo acima, como não temos BOLETO no billingType não foi necessário informar o campo dueDateLimitDays. Também definimos o notificationEnabled como false, dessa forma os clientes que preencherem este link de pagamento não terão notificações ativas.

Da mesma forma, também é possível criar links de pagamentos que criam assinaturas. Bastando informar o chargeType como RECURRENT.

POST /v3/paymentLinks
Confira a referência completa deste endpoint.

{
  "billingType": "CREDIT_CARD",
  "chargeType": "RECURRENT",
  "name": "Assinatura de livros",
  "description": "Receba um livro todo mês por R$: 50,00",
  "value": 50.00,
  "subscriptionCycle": "MONTHLY"
}

Como saber se um link de pagamentos foi pago?

Toda vez que um link de pagamentos é pago, você recebe um evento no Webhook para Cobranças. No JSON retornado você terá acesso ao campo paymentLink com o ID do seu link de pagamento.

Neste mesmo JSON você terá acesso ao customer com o ID do seu cliente, e poderá pegar os dados do mesmo caso precise usando o endpoint "Recuperar um único cliente".

Adicionando imagens em um link de pagamentos

É possível adicionar até 5 imagens em um link de pagamentos e você pode fazer isso chamando o endpoint abaixo:

POST /v3/paymentLinks/{id}/images
Confira a referência completa deste endpoint

Você pode definir se a imagem é a principal, com o campo main sendo enviado como true. O envio dos arquivos deve ser com o header Content-Type: multipart/form-data.

🚧

Duplicação de clientes em links de pagamento

No Asaas, é possível criar clientes com CPF/CNPJ duplicados. Pelo link de pagamento, como o cliente é sempre criado no momento da geração da cobrança, caso ele já exista no Asaas, o cliente será cadastrado novamente, aparecendo duas ou mais vezes (a depender da quantidade de vezes que gerou a cobrança).