A partir do dia 15/04/2024 o campo tradingName
não será mais retornado em endpoints de criação ou listagem de subcontas /v3/accounts
, nem em recuperação ou atualização de dados comerciais /v3/myAccount/commercialInfo
. Na maioria dos casos, este campo é retornado como null e não tem utilização em nenhum outro local da API.
A partir do dia 15/04/2024 o campo effectiveDate
(data de efetivação) que é retornado em Webhooks e endpoints de transferências da API terá o seu formato modificado.
O campo que é retornado no formato date
(YYYY-MM-DD) passará a ser datetime
(YYYY-MM-DD 00:00:00), no formato 24 horas (2024-03-11 15:29:12).
Saiba mais: https://docs.asaas.com/docs/webhook-para-transferencias
A partir do dia 25/03/2024 começaremos a enviar um campo com o ID dos eventos em todos os Webhooks. Isso ajudará desenvolvedores a tratarem eventos duplicados, já que os Webhooks do Asaas garantem a entrega "at least once" (ao menos uma entrega).
Confira a nova estrutura dos objetos que será aplicada:
{
"id": "evt_05b708f961d739ea7eba7e4db318f621&368604920",
"event": "PAYMENT_CREATED",
"payment": {
"object": "payment",
"id": "pay_qgddos6jdr4cdz"
...
Saiba mais: https://docs.asaas.com/docs/sobre-os-webhooks#gerencie-eventos-duplicados
Por exigência do Bacen, agora é obrigatório que todos os nossos clientes informem seu faturamento/renda mensal.
O que você precisa fazer?
- Atualize sua integração para o envio do campo
incomeValue
até 30/05/2024
O envio da renda (PF) ou faturamento mensal (PJ) através do campo incomeValue
nos endpoints de Atualização de Dados Comerciais (/v3/myAccount/commercialInfo
) e Criação de Subcontas (/v3/accounts
) passará a ser obrigatório e você precisa atualizar sua integração para que as chamadas sejam enviadas com essa informação.
A partir do dia 30/05, chamadas para estes endpoints sem essa informação retornarão erro, indicando que o campo é obrigatório.
Saiba mais:
https://docs.asaas.com/reference/atualizar-dados-comerciais
https://docs.asaas.com/reference/criar-subconta
- Atualize os dados cadastrais de todas as suas contas até 30/08 para que elas não sejam bloqueadas
É necessário que todas as contas atualizem suas informações cadastrais!
Principalmente se você utiliza White Label, solicite o faturamento/renda mensal aos seus clientes e atualize os dados através do endpoint de Atualização de Dados Comerciais (/v3/myAccount/commercialInfo
).
As contas que não forem atualizadas até 30/08 serão bloqueadas até que os dados sejam informados.
Com este endpoint é possível enviar um valor de cobrança com parcelas ou não, e receber uma simulação dos valores líquidos e taxas que serão aplicadas.
Começamos a liberação parcial da nova tela de Webhooks na aplicação web do Asaas. Com ela, será possível:
- Escolher a quantidade de eventos que você quiser para cada webhook;
- Selecionar diversos tipos de eventos dentro de um mesmo webhook;
- Definir e/ou alterar o nome de cada webhook;
- Utilizar mais de uma URL para o mesmo tipo de evento;
- Além disso, aumentamos a quantidade limite de Webhooks configurados, de 7 para 10.
Você pode habilitar a nova tela, caso ainda não tenha sido liberada, utilizando os novos endpoints de Webhooks. Ao realizar uma chamada utilizando este endpoint você automaticamente irá visualizar a nova tela de Webhooks ao acessar nossa aplicação web.
O endpoint para retornar cobranças de um parcelamento foi modificado para seguir o mesmo padrão do endpotin que retorna as cobranças de uma assinatura. O endpoint antigo ainda continuará funcionando mas foi descontinuado e não receberá novas manutenções.
Agora, além da URL de retorno através do parâmetro callback
nas cobranças avulsas, parcelamentos e links de pagamento, é possível redirecionar o seu cliente após o pagamento de Assinaturas também.
O parâmetro daysAfterDueDateToCancellationRegistration
foi adicionado no endpoint de cobranças, permitindo definir em quantos dias um boleto é baixado após o vencimento.
O evento PAYMENT_CREDIT_CARD_CAPTURE_REFUSED
será enviado sempre que houver uma falha no pagamento de uma cobrança com cartão de crédito.
Confira a lista completa de eventos de cobranças: https://docs.asaas.com/docs/webhook-para-cobrancas