Autenticação

O link de pagamento usa o login do API Gateway, o mesmo de Ambientes. Não chame o host da Minha Conta. Não há HMAC, seller-id nem header de loja no pedido do integrador.

Obter o token

POST /api/v2/auth/login

• Autenticação Basic: client_id:client_secret em Base64.
• Corpo application/x-www-form-urlencoded.
• grant_type fixo: client_credentials.
• scope: checkout.read e checkout.write, separados por espaço.

Peça à Nuvende que a aplicação tenha esses scopes e uma conta cobradora vinculada. Sem conta vinculada, o create responde 404 com Conta não encontrada.

curl --location 'https://api-h.nuvende.com.br/api/v2/auth/login' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --user '{{client_id}}:{{client_secret}}' \
  --data-urlencode 'grant_type=client_credentials' \
  --data-urlencode 'scope=checkout.read checkout.write'

O exemplo é homologação. Em produção, o host é https://api.nuvende.com.br. Os dois são o API Gateway.

Usar o token

Envie só o access_token nas chamadas do link. Não envie Account-Id, Application-Id, Partner-Id nem seller-id. O Gateway preenche isso.

Authorization: Bearer {access_token}
Accept: application/json
Content-Type: application/json

Sem o scope da rota, a API responde 403.

A conta cobradora vem do token da aplicação no Gateway. Não envie account_id no corpo. Se o campo vier, ele é ignorado.

O checkout_url é o link que o pagador abre no navegador. Essa página não usa o seu JWT e não é uma chamada de API.