Autenticação

Produção:

POSThttps://oauth2.validapay.com.br/auth/token

Sandbox:

POSThttps://oauth2-sandbox.validapay.com.br/auth/token

Escopos disponíveis

Informe o escopo desejado no parâmetro scope ao solicitar o token. Para múltiplos escopos, separe por espaço.

Escopo	Descrição
`pix.cob/write`	Criar cobranças Pix imediatas
`pix.cob/read`	Consultar cobranças Pix
`accounts/write`	Operações de escrita na conta
`accounts/read`	Consultar dados da conta
`checkouts/write`	Criar links, sessões e cobranças de checkout
`checkouts/read`	Consultar links e sessões de checkout
`products/write`	Criar e alterar produtos e preços
`products/read`	Consultar produtos e preços
`customers/write`	Criar e alterar clientes
`customers/read`	Consultar clientes
`customers/delete`	Remover clientes
`subscriptions/write`	Alterar assinaturas existentes
`subscriptions/read`	Consultar assinaturas
`proposals/write`	Enviar propostas de onboarding de subcontas
`proposals/read`	Consultar status de propostas de onboarding
`subaccounts/write`	Criar e atualizar subcontas
`subaccounts/read`	Listar subcontas e suas cobranças
`wallet/write`	Saques, devoluções e simulação de pagamento em sandbox
`wallet/read`	Consultar saldo e extrato
`nota.fiscal/write`	Emitir, cancelar e reenviar notas fiscais
`nota.fiscal/read`	Consultar notas fiscais e configurações
`webhooks/write`	Criar, atualizar e remover webhooks
`webhooks/read`	Consultar webhooks cadastrados
`payment.methods/write`	Tokenizar cartão de crédito
`payment.methods/read`	Consultar cartões tokenizados

Body

application/x-www-form-urlencoded

Content-Type:application/x-www-form-urlencoded

grant_typetextobrigatório

- Tipo de autenticação. Valor fixo: client_credentials

client_credentials

client_idtextobrigatório

{{client_id}}(variável)

client_secrettextobrigatório

{{client_secret}}(variável)

scopetextobrigatório

{{scope}}(variável)

Detalhes da cobrança

const url = 'https://oauth2.validapay.com.br/auth/token';

const options = {
  method: 'POST',
  headers: {
    'Content-Type': 'application/x-www-form-urlencoded'
  },
  body: 'grant_type=client_credentials&client_id=%7B%7Bclient_id%7D%7D&client_secret=%7B%7Bclient_secret%7D%7D&scope=%7B%7Bscope%7D%7D'
};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));

Response Examples

200200▾

JSON

{
    "access_token": "eyJraWQiOiJleGVtcGxvIiwiYWxnIjoiUlMyNTYifQ.eyJzdWIiOiIwMDAwMDAwMC0wMDAwLTAwMDAtMDAwMC0wMDAwMDAwMDAwMDAiLCJ0b2tlbl91c2UiOiJhY2Nlc3MiLCJzY29wZSI6ImFjY291bnQvcmVhZCIsImNsaWVudF9pZCI6ImV4ZW1wbG9jbGllbnRpZDEyMzQ1Njc4OTAiLCJpc3MiOiJodHRwczovL2NvZ25pdG8taWRwLnVzLWVhc3QtMS5hbWF6b25hd3MuY29tL3VzLWVhc3QtMV9FWEVNUExPIiwiZXhwIjoxOTAwMDAwMDAwLCJpYXQiOjE4OTk5OTY0MDB9.ASSINATURA_DE_EXEMPLO",
    "expires_in": 3600,
    "token_type": "Bearer"
}

Detalhes da cobrança