Manual de migração: nova versão da API de pagamentos

Protegemos seus pagamentos sempre. Trabalhamos na nova versão de nossa API para continuar atendendo os mais altos padrões de segurança.

Neste manual, você encontrará todas as informações necessárias para poder atualizar sua API de pagamento para a nova versão (v1).

Conteúdo do manual

• Recursos migrados
  
• Versões de ferramentas para a nova versão
• Exemplos

Lembre-se:

• Desde o dia 10 de dezembro de 2018, a versão antiga não conta mais com suporte.
• Se você usa botões de pagamento ou Mercado Shops, a mudança não afeta você.
• Se você tem o seu próprio e-commerce, por favor, consulte sua equipe de tecnologia.
• Ou, se você trabalha com alguma plataforma, como Magento, Shopify ou outra, por favor, entre em contato com seu suporte técnico.

Se você usa o recurso de search de payments, você precisa de um novo recurso e incluir um novo parâmetro para obter o mesmo resultado. Para mais informações, consulte a seção de exemplos.

(i) Se continuar com a versão anterior (v0), a partir de 1 de abril, você só poderá acessar a busca de informações dos seus pagamentos dos últimos 90 dias.

Recursos migrados

A seguir, você encontrará os recursos migrados e seus equivalentes.

Versões válidas das ferramentas para a nova versão

Se você usa as nossas ferramentas, para a nova versão da API, é necessário que as versões instaladas sejam as que estão detalhadas na tabela acima.

Exemplos

Busca de um pagamento

Para a busca de pagamentos, você deve usar o endpoint /v1/payments/search Lembre-se que o resultado desta busca traz os pagamentos como payer e collector de quem a realiza.

Para manter a consistência semântica com os resultados do endpoint /payments/search, você deve adicionar o parâmetro payer.id com o seu identificador de usuário.

curl -X GET \
 "http://api.mercadopago.com/v1/payments/search?access_token=ENV_ACCESS_TOKEN&site_id=MLA&limit=50&range=date_created&end_date=NOW&begin_date=NOW-90DAYS&sort=date_created&criteria=desc&payer.id=PAYER_ID" 

Para manter a consistência semântica com os resultados do endpoint /payments/search, você deve adicionar o parâmetro payer.id com o seu identificador de usuário.

curl -X GET \
 "http://api.mercadopago.com/v1/payments/search?access_token=ENV_ACCESS_TOKEN&site_id=MLA&limit=50&range=date_created&end_date=NOW&begin_date=NOW-90DAYS&sort=date_created&criteria=desc&collector.id=COLLECTOR_ID" 

Devolução total

curl -X POST \
        -H "content-type: application/json" \
        "https://api.mercadopago.com/v1/payments/:id/refunds?access_token=ENV_ACCESS_TOKEN"

Devolução parcial

curl -X POST \
        -H 'content-type: application/json' \
        'https://api.mercadopago.com/v1/payments/12861583/refunds?access_token=ENV_ACCESS_TOKEN' \
        -d '{
                "amount": 5.0
        }'

Se precisar fazer adaptações, lembre-se que é importante fazer essa mudança antes da data limite.

Se você tiver alguma dúvida ou precisar de ajuda para fazer essas alterações, entre em contato conosco.

Equipe Mercado Pago