Configurações da aplicação

Informações referentes as configurações da aplicação disponíveis na API Open Finance.

API Open Finance

Para utilizar a API Open Finance, é recomendado definir o atributo "receberSemChave", da API Pix, como true, pois a configuração incorreta pode afetar as transações. Você pode encontrar o link para o endpoint aqui.

Configurar URLs da aplicação

Esse endpoint é utilizado para criar ou modificar uma configuração na aplicação relacionada à API Open Finance.

PUT /v1/config

Requer autorização para o escopo: gn.opb.config.write

Requisição

Configurações das URLs - mTLS

// Exemplo configurando uma URL
{
  "redirectURL": "https://client.com/redirect/here",
  "webhookURL": "https://client.com/callback/here",
  "webhookSecurity": {
    "type": "mtls"
  },
  "processPayment": "async"
}

Configurações das URLs - hmac

// Exemplo configurando uma URL
{
  "redirectURL": "https://client.com/redirect/here",
  "webhookURL": "https://client.com/callback/here",
  "webhookSecurity": {
    "type": "hmac",
    "hash": "abc123def567ghi"
  },
  "processPayment": "async"
}

Respostas

As respostas abaixo representam Sucesso(201) e Falhas/erros do consumo.

🟢 201 (mTLS)

{
  "redirectURL": "https://client.com/redirect/here",
  "webhookURL": "https://client.com/callback/here",
  "webhookSecurity": {
    "type": "mtls"
  }
}

🟢 201 (hmac)

{
  "redirectURL": "https://client.com/redirect/here",
  "webhookURL": "https://client.com/callback/here",
  "webhookSecurity": {
    "type": "hmac",
    "hash": "abc123def567ghi"
  }
}

🔴 400

{
  "nome": "redirect_url_obrigatorio",
  "mensagem": "O parâmetro redirectURL é obrigatório"
}

Ou

{
  "nome": "webhook_url_obrigatorio",
  "mensagem": "O parâmetro webhookURL é obrigatório"
}

Ou

{
  "nome": "webhook_url_mtls_obrigatorio",
  "mensagem": "O webhookURL precisa ter um mTLS válido"
}

🔴 422

{
  "nome": "conta_nao_encontrada",
  "mensagem": "A conta não foi encontrada"
}

Ou

{
  "nome": "redirect_url_invalido",
  "mensagem": "O redirectURL é inválido"
}

Ou

{
  "nome": "webhook_seguranca_invalido",
  "mensagem": "O campo webhookSecurity é inválido"
}

Ou

{
  "nome": "webhook_seguranca_hash_invalido",
  "mensagem": "O campo hash é inválido"
}

Ou

{
  "nome": "webhook_url_invalido",
  "mensagem": "webhookURL não acessível"
}

Ou

{
  "nome": "webhook_url_invalido",
  "mensagem": "Erro ao fazer handshake com mTLS no webhookURL"
}

Ou

{
  "nome": "process_payment_invalido",
  "mensagem": "O campo processPayment é inválido, permitido (async/sync)"
}

🔴 500

{
  "nome": "erro_aplicacao",
  "mensagem": "Erro interno do servidor"
}

Retornar as configurações da aplicação

Esse endpoint é utilizado para retornar as configurações da aplicação relacionada a API Open Finance, não é necessário informar nenhum parâmetro.

GET /v1/config

Requer autorização para o escopo: gn.opb.config.read

Respostas

As respostas abaixo representam Sucesso(200) e Falhas/erros do consumo.

🟢 200

{
  "redirectURL": "https://client.com/redirect/here",
  "webhookURL": "https://client.com/callback/here",
  "webhookSecurity": {
    "type": "mtls"
  }
}

🔴 404

{
  "nome": "configuracao_nao_encontrada",
  "mensagem": "Nenhuma configuração encontrada"
}

🔴 500

{
  "nome": "configuracao_nao_encontrada",
  "mensagem": "Nenhuma configuração encontrada"
}