Pular para o conteúdo principal
Todo endpoint da Partner API V2 exige um token OAuth2 com o scope dv.partner no header Authorization. O passo a passo para obter e renovar o token está em Autenticação. Peça o token com client_credentials e scope=dv.partner, depois que o parceiro ou a revenda autorizou o seu app, e envie-o em toda chamada:

Alcance do token

O token enxerga os parceiros e as revendas que autorizaram o seu app, e tudo o que está abaixo deles. POST /{partnerId}/resales e GET /{partnerId}/resales/invoices são exclusivos de parceiro: com o ID de uma revenda, respondem 403.

Header x-partners

Nas rotas pelo recurso (/merchants, /merchants/sales, /resales e afins), o header x-partners restringe a resposta a parceiros ou revendas específicos. Aceita IDs separados por vírgula ou headers repetidos. Se algum ID estiver fora do alcance do token, a resposta é 403 com os IDs no title. Veja Filtrar por Partners.

Erros

Os erros seguem o formato {"status": "<código>", "title": "<mensagem ou erros por campo>"}.