post cover image

A API Collections será descontinuada

Estamos trabalhando na descontinuação da API Collections [/collections/notifications/] que é utilizada por algumas integrações para validar o estado de seus pagamentos. A data oficial de descontinuação será em 02/10/2024, mas estamos comunicando com antecedência, pois será necessário realizar algumas atualizações em sua integração.

Este recurso atualmente é informado através das notificações IPN do tópico de pagamentos, no campo "resource", da seguinte forma:


{
  "resource": "https://api.mercadolibre.com/collections/notifications/{payment_id}",
  "topic": "payment"
}

Quando for descontinuado, o corpo da notificação IPN conterá no "resource" apenas o ID do pagamento:


{
  "resource": {payment_id},
  "topic": "payment"
}

A API que substitui o /collections/notifications/, e que permitirá validar os pagamentos, é a API de Pagamentos, onde você poderá obter as informações necessárias para continuar com a operação sem sofrer nenhum impacto.

Se desejar, pode acessar um mapeamento dos campos da API Collections e seus equivalentes na API de Pagamentos, para facilitar a localização das informações ao realizar esta mudança e, se tiver alguma dúvida, pedimos que entre em contato com nossos canais de suporte.