Termos mais procurados:
Sim, você precisa fornecer a sua URL no atributo webhookUrl, que deve estar pronta para receber as notificações da nossa parte. O cadastro do webhook ocorre apenas uma vez. Assim que for cadastrado, sempre que houver um pagamento associado à sua chave, você será notificado automaticamente.
Eu li isso mas não consegui entender exatamente o que fazer, esse é o corpo que devo enviar nesse PUT, certo?
{
"webhookUrl": "https://exemplo-pix/webhook"
}
Mas em qual momento eu devo fazer isso?
Onde eu cadastro a url para receber o webhook?
Boa tarde, @hlyras!
Sugerimos as duas formas de validação a seguir, mas recomendamos fortemente que as utilize em conjunto:
Verifique o IP de comunicação: Você pode restringir a comunicação ao domínio do webhhook cadastrado para aceitar apenas mensagens do IP utilizado pela Efí.
IP utilizado atualmente em nossas comunicações: '34.193.116.226'.
Adicione uma hash à URL cadastrada no webhook: Crie um hmac (uma identificação própria) que será acrescentado ao final da URL no momento do cadastro do webhook. Essa hash será utilizada para validar a origem da notificação. Assim, todos os webhooks enviados ao seu servidor terão essa identificação final e sua aplicação deve validar a presença da mesma.
Exemplo:
URL de notificação original: https://seu_dominio.com.br/webhook
Como deverá ser cadastrada com a hash: https://seu_dominio.com.br/webhook?hmac=xyz&ignorar=. O termo ignorar= servirá para tratar a adição do /pix no final da URL.
Porém quando uso a nova base url é retornado um erro de socket e a requisição simplesmente falha.
A Base URL para a configuração de split e para setar a configuração em uma transação continua sendo (https://api-pix.gerencianet.com.br) ?
Tentei utilizar a https://pix.api.efipay.com.br e os endpoints /v2/gn/split/config e /v2/gn/split/cob/:txid/vinculo/:split_id não funcionam.
Sim, feita dentro do ambiente do banco selecionado.
Não tem uma URL especifica e fixa, esta URL é disponibilizada pela instituição selecionada no momento da inicialização do pagamento.
Então a autorização é feita fora da aplicação? Se sim, tem alguma URL específica?
Se o atendedor é /webhook/pix, vc deve passar /webhook na URL
´´´
{
"message": "Erro interno do servidor",
"erro": {
"nome": "webhook_invalido",
"mensagem": "A URL informada respondeu com o código HTTP 400"
}
}
´´´
uma duvida, chamei POST : https://pix-h.api.efipay.com.br/v2/cob
mas havia colocado o metadata para a url de notificacao, tomei erro
{"nome":"json_invalido","mensagem":"Valores ou tipos de campo inválidos","erros":[{"chave":"additionalProperties","caminho":".body","mensagem":"não são permitidas propriedades adicionais"}]}
"metadata": { "notification_url": "http:\/\/webhook.site.com.br" }
e vendo na doc, realmente nao da suporte para metadata, entao como fazer para ligar o webhook do pix via notification_url ?
deixa eu ver se compreendi
no cadastro do webhook eu coloquei {
"webhookUrl": "https://blablbabla/pix" class="link-msg">https://blablbabla/pix"
}
o certo seria https://blablbabla/
Sim. Pq se vc configurou a URL como https://exemplo.com.br , a Efí vai fazer o teste em https://exemplo.com.br , mas o efetivo acionamento será em https://exemplo.com.br/pix
Vc está tratando a URL que vc configurou mais /pix ?
no caso eu to tentando configurar o webhook, eu faço a requisição paraefe enviando a url e a efi tem que testar se a url é valida, o retono que o web hook vem da efi, quando eu faço pelo postman ele fa respondendo normal
Se vc chamar curl http://localhost/webhoook o que acontece ?
{
"message": "Erro interno do servidor",
"erro": {
"nome": "webhook_invalido",
"mensagem": "A URL informada respondeu com o código HTTP 400"
}
}
Bom dia, @agenciadiz! Tudo bem?
O erro que você está enfrentando é comum quando o PHP não consegue verificar o certificado SSL do servidor remoto, no caso o da nossa API. Isso pode ser devido a uma configuração inadequada do PHP 8.0 na sua máquina.
Uma solução seria atualizar o pacote de certificados CA do seu sistema para que seu PHP passe a reconhecer a cadeia de certificado da nossa API. Você pode fazer isso baixando o arquivo ‘cacert.pem’ mais recente do site oficial do cURL (aqui) e configurando o PHP para usá-lo. Para fazer isso, você precisará adicionar ou editar a seguinte linha no seu arquivo ‘php.ini’:
Estou com um erro com o PHP 8.0: cURL error 60: SSL certificate problem: unable to get local issuer certificate (see https://curl.haxx.se/libcurl/c/libcurl-errors.html) for https://cobrancas-h.api.efipay.com.br/v1/authorize
No 8.2 roda normal, acredito que seja na versão o problema? ou o que poderia ser? Tem como rodar sem o certificado?
Bom dia @rian2965, tudo bem?
Você pode consumir o endpoint POST /v1/plan/:id/subscription/one-step para emitir a cobrança e ao mesmo tempo atribuir a URL de notificação com o atributo metadata.
Uma vez que a cobrança tenha uma URL de notificação, todas as alterações nela irão fazer com que seja disparado um POST para sua URL, nesta notificação terá um token que deve ser consultado para verificar a situação da cobrança
