Histórico de mensagens sobre cobrança de api em pix

EXIBINDO CONVERSAS RECENTES:

Texto: cobrança de api
Canal: pix
Avatar discord do usuario guilherme_efi

guilherme_efi

Ver Respostas

Boa tarde, @davicolet! Como vai?
Basta vincular uma chave Pix a uma URL de retorno como webhook através do endpoint PUT /v2/webhook/:chave, que então pagamentos provenientes de cobranças dinâmicas ou estáticas que possuir ID da transação, irá acionar sua URL, além de reembolsos, caso houverem.
Pontuando que, para registrar um webhook, esta URL deverá atender alguns requisitos

Você encontra mais detalhes em nossa documentação: https://dev.gerencianet.com.br/docs/api-pix-endpoints#webhooks"

Avatar discord do usuario lucasbernieri

lucasbernieri

Ver Respostas

Bom dia pessoal, estou com algumas dúvidas relacionadas com a integração via API para o PIX.

Usando o SDK PHP, já consegui gerar as cobranças, associadas com uma chave PIX gerada dentro da minha conta, mas estou um pouco confuso sobre a parte de webhooks de notificação e diferenças entre homologação e produção.

Sobre a parte de Webhooks, eu entendi que preciso cadastrar via API qual é a URL que o Gerencianet deverá notificar quando houver algum evento relacionado com a chave PIX. Até consegui realizar alguns testes utilizando a coleção do postman, gerando a cobrança e recebendo a notificação post da Gerencianet.

Um ponto relacionado com a aplicação que estou trabalhando é que o cliente está em um servidor compartilhado. Vi na documentação que é possível utilizar o parâmetro

x-skip-mtls-checking: true
e verificar no meu sistema se a requisição veio do Gerencianet. Isso funciona para o ambiente de produção também?

Outra dúvida, tem algum passo extra que eu precise fazer para colocar a integração via PIX para funcionar no ambiente de produção? É preciso solicitar da Gerencianet alguma autorização ou aprovação?

O sistema só irá gerar cobranças via PIX e esperar o Webhook de notificação, nada além desse fluxo.

Avatar discord do usuario toninhomurakami

toninhomurakami

Ver Respostas

Boa tarde Senhores. Estou conseguindo fazer cobrança com API Pix, mas senti falta de, na consulta, obter o valor da taxa cobrado pelo banco. Há uma forma de obter essa informação consultando pela API ?

Avatar discord do usuario joao_efi

joao_efi

Boa tarde @rafaelribeiro.sp tudo certo?
Para o Split de pix você vai precisar criar uma configuração de pagamento Pix, definindo a porcentagem de divisão para cada conta
https://dev.gerencianet.com.br/docs/api-pix-endpoints#configura%C3%A7%C3%A3o-de-um-split-de-pagamento-sem-passar-id

Então precisa criar uma cobrança:
https://dev.gerencianet.com.br/docs/api-pix-endpoints#criar-cobran%C3%A7a-imediata-sem-txid

E vinculá-la a configuração de split criada anteriormente:
https://dev.gerencianet.com.br/docs/api-pix-endpoints#vincular-uma-cobran%C3%A7a-a-um-split-de-pagamento

Avatar discord do usuario guilherme_efi

guilherme_efi

Ver Respostas

Isso mesmo, @conexao_cefet. Conforme comentado pelo Rubens, após o tempo de expiração sem o pagamento a cobrança Pix permanece com o status "ATIVO", pois lhe permite ainda aumentar o tempo de expiração.
Nesse cenário então, você pode fazer isso mesmo. Monitorar o tempo, se não receber o webhook com o pagamento, consulta a cobrança para confirmar o status, e depois usa o endpoint PATCH /v2/cob/:txid (https://dev.gerencianet.com.br/docs/api-pix-endpoints#revisar-cobran%C3%A7a) para alterar o status do Pix para "REMOVIDA_PELO_USUARIO_RECEBEDOR", que irá cancelar o Pix.

Avatar discord do usuario gabriel_efi

gabriel_efi

Bom dia, @brun06830! Requisições via API Pix não aparecem no histórico de requisições, você pode utilizar os endpoints de consulta da API para isso, e verificar seu Webhook. No ambiente de homologação você pode testar as cobranças -> sendo um ambiente de simulação se o valor da cobrança estiver entre R$0,01 e R$10,00 a cobrança é confirmada, com a informação enviada via Webhook. Se o valor da cobrança for superior a R$10,00 a cobrança permanece ativa, sem confirmação. Conforme descrito na documentação: https://dev.gerencianet.com.br/docs/api-pix-endpoints
imagem enviada na mensagem pelo usuario gabriel_efi

Avatar discord do usuario brun06830

brun06830

E preciso testar o meu webhook do pagamento do pix, na documentação consta que: "Caso você precise testar os endpoints de cobrança Pix Cob, temos um ambiente de homologação funcional em que é possível simular todos os status retornados pela nossa API e webhook.", onde encontro ambiente de homologação funcional?

Avatar discord do usuario brun06830

brun06830

Bom dia, tenho gerado algumas cobranças e qrCodes com as chaves de homologação da minha aplicação, porém elas não aparecem listadas no "histórico de requisições" em "API > Aplicações > Minha Aplicação"

Avatar discord do usuario gabriel_efi

gabriel_efi

A API retorna os dados e você pode montar seu checkout com os dados de acordo com a necessidade. Este exemplo é um link pronto baseado em uma cobrança PIX, presente na nossa documentação: https://dev.gerencianet.com.br/docs/api-pix-endpoints

Avatar discord do usuario Julia Efí

Julia Efí

Ver Respostas

Além do webhook também é possível saber se uma cobrança pix foi paga através do endpoint GET/v2/cob/:txid, segue a documentação: https://dev.gerencianet.com.br/docs/api-pix-endpoints#consultar-cobran%C3%A7a. O exemplo que eu tinha dado anteriormente era para boletos/bolix

Avatar discord do usuario palloma_efi

palloma_efi

Ver Respostas

Olá @sendfacil ! Boa tarde. Tudo bem? A maneira recomendada para verificar o status das cobranças Pix, é utilizando um webhook, onde, o seu servidor ficará configurado para receber notificações automaticamente a cada alteração de status na cobrança Pix. Neste link da nossa documentação disponibilizamos mais detalhes: https://dev.gerencianet.com.br/docs/api-pix-endpoints#webhooks

Avatar discord do usuario jessica_efi

jessica_efi

Ver Respostas

Você pode utilizar o GET/v2/pix onde lista todos o s pix recebidos em um período informado, por exemplo - https://dev.gerencianet.com.br/docs/api-pix-endpoints#consultar-pix-recebidos" class="link-msg">https://dev.gerencianet.com.br/docs/api-pix-endpoints#consultar-pix-recebidos . Ou você pode buscar por um pix especifico passando o e2eId - https://dev.gerencianet.com.br/docs/api-pix-endpoints#consultar-pix . Caso não saiba esse e2eid, você pode buscar pelo txid da cobrança - https://dev.gerencianet.com.br/docs/api-pix-endpoints#consultar-cobran%C3%A7a que este endpoint retornará os dados da cobrança, inclusive o e2eid, que é o identificador do pagamento.

Avatar discord do usuario palloma_efi

palloma_efi

Ver Respostas

Bom dia @joandervieira ! Tudo bem?
Para criação de Cobranças Pix, você pode seguir este exemplo aqui: https://github.com/gerencianet/gn-api-sdk-go/blob/master/examples/pix/cob/pixCreateCharge.go
Nele detalhamos como deve ser o body da requisição.

Avatar discord do usuario joandervieira

joandervieira

Ver Respostas

Olá pessoal, bom dia.
Estou tentando implementar a cobrança de pix usando GoLang. (quero gerar um link para pagamento do pix com um id de transação para eu saber se foi foi pago e quem pagou).
Acredito ser este Ednpoint:

PUT
/v2/cob/
:txid
Endpoint para cadastrar uma cobrança com um identificador de transação (txid).
No SDK GoLang o método mais próximo que encontrei que acredito chamar este endpoint é este:
gn.CreateCharge(body)

Estou tentando chamar com este método com este body:
body := map[string]interface{}{
"calendario": map[string]interface{}{
"expiracao": 3600,
},
"devedor": map[string]interface{}{
"cpf": efiPaymentDTO.PayerIdentifier,
"nome": efiPaymentDTO.PayerName,
},
"valor": map[string]interface{}{
"original": formatAmount(efiPaymentDTO.Amount),
},
"chave": config.ComandoPixKey,
"solicitacaoPagador": "Checkout Comando",
}

Porém estou recebendo este erro:
(EXTRA []string=[{\"code\":3500034,\"error\":\"validation_error\",\"error_description\":\"A propriedade [items] é obrigatória.\"}])

Algumas dúvidas:
- Este método CreateCharge() realmente corresponde ao endpoint /v2/cob/ ?
- Qual o body correto para este método ? usei o mesmo indicado na documentação para /v2/cob/;
- Este método CreateCharge() não aceita o transactionID, como passar este txid ?

Desde já muito obrigado !

Avatar discord do usuario softvix

softvix

Ver Respostas

E como fica a cobrança de taxa sobre o recebimento se for pela API PIX? 1,19%? Se sim, acaba ficando mais caro dependendo do valor que está sendo cobrando.

Avatar discord do usuario gabriel_efi

gabriel_efi

No caso de cobranças só com o PIX temos a API PIX para criação de cobranças imediatas, QR Code e Copia-e-Cola. O QR Code do Bolix tem o intuito de facilitar e agilizar o recebimento de cobranças de boletos, sendo vinculado ao mesmo pela API de Emissões.

Avatar discord do usuario marcelo_efi

marcelo_efi

Ver Respostas

Bom dia @rodrigoaes , tudo bem ? Sim, com a cobV você só consegue definir o dia. Para criar cobranças que você consegue definir o horário você pode usar a cob: https://dev.gerencianet.com.br/docs/api-pix-endpoints#cobran%C3%A7as-imediatas

Avatar discord do usuario guilherme_efi

guilherme_efi

Ver Respostas

O webhook é acionado sempre quando há alguma alteração na cobrança Pix. Então você recebe a notificação quando for paga, e se tiver devolução.
Então ao receber a notificação com os detalhes em Json, sua aplicação poderá tratar estes dados.
https://dev.gerencianet.com.br/docs/api-pix-endpoints#recebendo-callbacks

Avatar discord do usuario guilherme_efi

guilherme_efi

Ver Respostas

Bom dia, @leonardo.amaral! Como vai?
Você consegui sim fazer testes em homologação, mas para isso você irá precisar da sua conta para obter as credenciais Cliente_Id, Client_Secret e certioficado para autenticação.
O processo será basicamente o seguinte:
1 Criar cobrança em homologação (https://dev.gerencianet.com.br/docs/api-pix-endpoints#criar-cobran%C3%A7a-imediata-com-txid)
Se o valor da cobrança está entre R$ 0.01 à R$ 10.00: A cobrança é confirmada, informação virá via Webhook.
Se o valor da cobrança é maior que R$ 10.00: A cobrança permanece ativa, sem confirmação. Como não há webhook nesses casos, nada é feito
2
para obter o Pix copia e cola, você pode fazer como o Rubens mencionou, usar uma biblioteca que monta o BRCode, ou usar um endpoit que já entregarmos pronto, junto com a imagem e um link de pagamento também. (https://dev.gerencianet.com.br/docs/api-pix-endpoints#gerar-qrcode-de-um-location)

Para facilitar ainda mais esse processo de integração, você ainda pode usar uma de nossas SDKs (https://github.com/gerencianet).