Termos mais procurados:
Isso mesmo. No link que você mandou, temos toda a documentação técnica detalhada de cada endpoint da API. Mas a utilização da SDK simplifica bastante a integração. Com ela, você só precisa chamar os métodos e passar os parâmetros necessários para criar uma cobrança Pix, por exemplo.
Olá, estou estudando a api de pix do EfiPay, até o momento estou bem feliz com tudo que estou vendo. Mas ainda estou com algumas dúvidas que são mais para confirmar se eu realmente entendi bem tudo.
# PIX + Split de pagamento
Eu tenho intenção de usar o split de pagamento juntamente com PIX. Vi que existe uma forma onde eu crie uma split config no POST /v2/gn/split/config .
- Uma vez que eu criar uma split config, não existe uma forma onde eu consiga criar o pagamento PIX já com o split config em uma única requisição?
- Eu tenho que criar o PIX e então associar o split de pagamento previamente criado? (2 requisições)
# PIX Webhooks
Outra importante parte que precisarei integrar é a api de webhook, também vi que precisa cadastrar este event jutamente com uma chave PIX. Portanto se tiver 3 chaves, serão 3 subscriptions para escutar os updates relacionados a estas chaves.
- Existe uma forma onde eu possa registrar meu webhook globalmente ao invés de registrar por chave?
O certificado para gerar a transação, criar a cobrança, acho q deveria ter em todos os endpoints... Pix, cartão, boleto...
Mas o webhook, vamos ser sinceros, muda nada...
Bom dia, @.andregomes!
Neste caso, você pode consumir diretamente os endpoints.
1- Faz a autenticação na API: https://dev.efipay.com.br/docs/api-pix/credenciais/#obter-autorização
2-Cria a cobrança Pix imediada: https://dev.efipay.com.br/docs/api-pix/cobrancas-imediatas#criar-cobrança-imediata-com-txid
3-Obtêm o QR Code da cobrança gerada: https://dev.efipay.com.br/docs/api-pix/payload-locations#gerar-qrcode-de-um-location
Oi, pra confirmar se o pix foi pago seria algo assim? (não sei muito sobre isso, to aprendendo e usei o GPT pra criar o código.)
app.post('/webhook(/pix)?', async (req, res) => {
try {
// Consultar a cobrança usando o txid
const response = await axios.get(/v2/cob/:txid, {
headers: {
Authorization: 'Bearer' + process.env.GN_CLIENT_ID // Substitua pelo token de autorização correto
}
});
// Verificar o status da cobrança na resposta
if (response.status === 200 && response.data.status === 'CONCLUIDA') {
// Enviar o código de ativação para o Supabase
const { data: insertedData, error } = await supabaseClient
.from('dominios_permitidos')
.insert([{ code: generatedCode }]); // Acesse o código gerado na rota '/api/key'
// Enviar o código de ativação junto com a resposta
return res.status(200).json({ message: 'Webhook recebido com sucesso.', code: generatedCode });
} else {
// Se a cobrança não estiver concluída, retorne uma mensagem de erro
return res.status(400).json({ error: 'Cobrança não concluída.' });
}
} catch (error) {
console.error('Erro ao consultar a cobrança:', error.message);
return res.status(500).json({ error: 'Erro ao consultar a cobrança.' });
}
});
Vou utilizar a api de envio de pix: "/v2/gn/pix/:idEnvio". Neste caso, "idEnvio" seria um txid que eu deveria criar, certo? Como eu o crio e como eu faço para ele ser único e evitar repetições? Vi em um comentário mais pra cima de alguem recomendanod utilizar epoch do momento do envio, mas poderia ter repetições dessa forma caso a requisição do pix fosse enviada no mesmo momento... E outra dúvida: o que aconteceria se fosse criado um mesmo idEnvio?
Beleza, @vdx.Então você está utilizando nosso plug-in oficial para o Pix, certo?
https://dev.efipay.com.br/docs/modulos/Bubble#32-pix
Ao tentar criar uma cobrança Pix, é apresentado alguma falha para você?
@marcelo_efi usando o endpoint de criar pix com vencimento (/v2/cobv/:txid) tenho este erro:
{"type":"https://pix.bcb.gov.br/api/v2/error/CobVOperacaoInvalida","title":"Operação Inválida","status":400,"detail":"A requisição que busca alterar ou criar uma cobrança com vencimento não respeita o schema ou está semanticamente errada.","violacoes":[{"razao":"O campo cobv.params.txid não respeita o schema.","propriedade":"cobv.params.txid"}]}
O código para geração da cobrança está assim
def criar_cobranca_pix(self, txid):
tokens = self.autorizar()
access_token = tokens['access_token']
endpoint = f"{self.url}/v2/cobv/{txid}"
cabecalho = {"Content-Type": "application/json",
"Authorization": f"Bearer {access_token}"}
dados = {
"calendario": {
"dataDeVencimento": "2022-12-01",
"validadeAposVencimento": 30
},
"devedor": {
"logradouro": "Alameda Souza, Numero 80, Bairro Braz",
"cidade": "Recife",
"uf": "PE",
"cep": "70011750",
"cpf": "12345678909",
"nome": "Francisco da Silva"
},
"valor": {
"original": "123.45",
"multa": {
"modalidade": 2,
"valorPerc": "15.00"
},
"juros": {
"modalidade": 2,
"valorPerc": "2.00"
},
"desconto": {
"modalidade": 1,
"descontoDataFixa": [
{
"data": "2022-11-30",
"valorPerc": "30.00"
}
]
}
},
"chave": "5f84a4c5-c5cb-4599-9f13-7eb4d419dacc",
"solicitacaoPagador": "Cobrança dos serviços prestados."
}
dados = json.dumps(dados)
response = requests.request("PUT", endpoint, headers=cabecalho, data=dados)
print(response.text)
return response.text
Oi boa tarde,
Ao criar um pagamento Pix, e colocando expiração o cliente ainda consegue alterar a data de pagamento para uma data futura?
No caso, uma data de pagamento posterior ao vencimento
Olá pessoal, bom dia!
Eu já sou cliente de vocês e utilizo a API PIX para realizar a cobrança de um assinatura de um aplicativo que eu possuo. Estou pretendendo criar um novo app capaz de guardar as informações da chave PIX dos meus clientes e eu observar se esse PIX já recebeu o pagamento esperado ou não, ou seja, a funcionalidade de webhook que eu já tenho no meu primeiro app, só que agora observando o PIX dos meus clientes.
Além do mais, sou iniciante nesse processo de pagamento, talvez a lógica disso possa ser manipulando pelo meu próprio PIX e transferindo o valor depois pro meu cliente, ou seja, eu faço o meio de campo entre o meu cliente e o cliente dele.
Boa tarde, @andrebarbosa_dev! O Location contém um JSON com os dados referentes a uma cobrança PIX, ao utilizar os endpoints de emissão de cobrança PIX (COB ou COBV) automaticamente será criado um location. Contudo, é possível criar esse location primeiro pelo endpoint POST /v2/loc e passar o ID do mesmo na requisição da emissão de cobrança depois, como se fosse um Two-Step.
/v2/pix/:e2eId/devolucao/:id
Este :id no final, tenho que criar? Ou é o ID do Pix?
Na documentação fala: id da devolução... Mas e aí? Kkk essa documentação é confusa em alguns pontos.
Eu estou utilizando o SDK-PHP de voces.
Cadastrei o webhook como "https://meudominio.com.br/pixefi"
Recebo os eventos da criação no endereço acima
( [{"evento":"teste_webhook","data_criacao":"2024-03-30T11:20:39.415Z"}] ).
O "index.php" nesta pasta é o mesmo do site.
Abaixo deste diretório existe uma pasta "pix" onde o mesmo "index.php"rdt's lá. ( "meusite.com.br/pixefi/pix" )
AO criar um pagamento PIX em produção e o mesmo pago, não recebo nenhuma informação de retorno da EFI.
Foi colocadouma função que salva qualquer acesso a pasta, como exemplo fiz um acesso pelo Chrome "https://meudominio.com.br/pixefi/pix" e o resultado salvo foi.
Metodo: GET
Parametros: a:2:{i:0;s:6:"pixefi";i:1;s:3:"pix";}
Body: null
Segue o parte do script "index.php" onde salva qualquer acesso a pasta
===============================================================
// Obtém o método HTTP, body e parâmetros da requisição
$metodo = $_SERVER['REQUEST_METHOD'];
$parametros = explode('/', trim($_SERVER['REQUEST_URI'], '/'));
$body = json_decode(file_get_contents('php://input'), true);
// /
$nomeArquivo = 'dados/dados_recebidos.json';
$dadosJson = "\n Metodo: " .$metodo ."\n Parametros: " .serialize($parametros) ."\n" ."Body: " .json_encode($body) ."\n";
$arquivo = fopen($nomeArquivo, 'a');
fwrite($arquivo, $dadosJson);
fclose($arquivo);
// /
try {
requisicao($metodo, $body, $parametros);
} catch (Exception $e) {
salvar ( $xdados);
resposta(400, $e->getMessage(), $e);
}
=================================================================
Estou tentando gerar cobranças no modo homologação de R$ 0,01 e não recebo notificação no modo de homologação também.
Que criação de chave Pix só no ambiente de produção, e que você está usando um método que você não precisa usar, pois é mais simples criar uma chave Pix no app/site.
Olá. Em produção utulizando a SDK NodeJso que segnifica a reposta "Forbidden" ao tentar criar uma chave pix?
"erro":["code",401,"erro","invalid_token","descricao","Invalid access token"]
o que é esse erro no retorno pra criar uma cobrança pix?
Bom dia @zekramfn é possível sim.
Você precisa consumir o endpoint PUT /v2/gn/config passando o atributo pix.chaves.suaChave.webhook.notificacao.pagador = true, segue um exemplo onde essa configuração é aplicada:
