Bom dia @ghhwer ! Tudo bem? É possível sim, através da rota PUT /v1/charge/:id/metadata.
Neste link da documentação tem mais detalhes.
Termos mais procurados:
Histórico de mensagens sobre notification_url
PROCURE NO HISTÓRICO
CANAIS DE TEXTO
DISCUSSÕES
- Conceito de Payload Locations no PIX
- Autenticação com Certificado em NextJS
- Acionamento de Webhooks em Pagamentos e Devoluções
- Especificação da URL do Webhook no Exemplo Pix
- Consulta de Chave PIX na API de Envio
- Cobrança em Período de Teste Grátis de 7 dias
- Inserção automática do formato do Pix copia e cola pelo WhatsApp
- Configuração de URLs para Recebimento de Status
- Recebimento de Pagamentos via QR Code e Arduino
- Implementação da SDK do Pix em Next.js ou React
- Implementação do Módulo Gerencianet no Perfex CRM
- Repetição do Processo de Criação com txid
- Tempo Médio de Análise de Documentos na Abertura de Conta
- Problemas com Token em Ambiente de Homologação
- Integrações com o Laravel e SDK de PHP da EFI
- Funcionamento do Webhook em Ambiente de Homologação
- Teste de Status de Pagamento em Ambiente de Homologação
- Geração de Link de Pagamento e Reembolso
- Resolução de Delay nas Chamadas de Geração de QR Code e Pix em Node
- Cancelamento de Boleto e Remoção do DDA
- Retenção de Pagamento no PIX em Marketplace
- Implementação de método em C# para cálculo de CRC16
- Integração de Pix no Bubble (Plataforma No-Code)
- Possibilidade de Split na API de Pix
- Interpretação do Campo 'Solicitação ao Pagador' no Webhook GN
EXIBINDO CONVERSAS RECENTES:
Texto: notification_url
@cleitonconceicao_ você pode informar diretamente na emissão, sem usar outro endpoint
Por exemplo:
js
{
"items": [
{
"name": "Produto ",
"amount": 1,
"value": 10542
}
],
"metadata": {
"notification_url": "https://SUAURL.COM.BR"
},
"payment": {
"banking_billet": {
"expire_at": "2024-10-28",
"customer": {
"name": "João testes de emisão",
"cpf": "1234567890"
}
}
},
}
O campo custom_id é opcional para inserir identificadores do seu proprio sistema.{
"items": [
{
"name": "Produto ",
"amount": 1,
"value": 10542
}
],
"metadata": {
"notification_url": "https://SUAURL.COM.BR"
},
"payment": {
"banking_billet": {
"expire_at": "2024-10-28",
"customer": {
"name": "João testes de emisão",
"cpf": "1234567890"
}
}
},
}
O endpoint update Metadata é voltado para os boletos que já foram emitidos sem URL
Bom dia @cleitonconceicao_ tudo certo?
Isso mesmo!
Em relação aos boletos você precisa informar a URL de notificação no momento da emissão através do atributo notification_url
Bom dia,
estou tendo o seguinte erro ao criar uma charge pix com location e notification_url usando a sdk pra Go, ambiente homolog
{"nome":"json_invalido","mensagem":"Valores ou tipos de campo inválidos","erros":[{"chave":"additionalProperties","caminho":".body","mensagem":"não são permitidas propriedades adicionais"}]}
go
// Go
PUT /v2/cob/:txid
map[string]interface{}{
"calendario": map[string]interface{}{
"expiracao": 600,
},
"valor": map[string]interface{}{
"original": "0.01",
},
"loc": map[string]interface{}{
"id": 97,
},
"metadata": map[string]interface{}{
"notification_url": "https://meudominio:10021/efi/homolog/webhook",
},
"chave": "71cdf9ba-c695-4e3c-b010-abb521a3f1be",
"solicitacaoPagador": "Teste",
}
// Go
PUT /v2/cob/:txid
map[string]interface{}{
"calendario": map[string]interface{}{
"expiracao": 600,
},
"valor": map[string]interface{}{
"original": "0.01",
},
"loc": map[string]interface{}{
"id": 97,
},
"metadata": map[string]interface{}{
"notification_url": "https://meudominio:10021/efi/homolog/webhook",
},
"chave": "71cdf9ba-c695-4e3c-b010-abb521a3f1be",
"solicitacaoPagador": "Teste",
}
Se eu removo o campo "metadata" e seu conteúdo, funciona.
Não é mais possível criar a cobrança e registrar a callback na mesma chamada, ou seria de outra forma?
Bom dia @joaomarcos.faleiro ! Tudo bem? Verifique se no campo notification_url você está inserindo uma URL sintaticamente correta, por favor.
{
"code": 3500034,
"error": "validation_error",
"error_description": {
"property": "/metadata/notification_url",
"message": "A string não corresponde ao modelo: ^https?://.+."
}
}
Bom dia @juizmill ! Sim, são ambientes separados. Você pode cadastrar um webhook em homologação e realizar os testes.
A API de Cobranças é separada da API Pix. Na API de Cobranças, você cadastra a URL de Notificação através do atributo notification_url. Já na API Pix, o webhook é atrelado a uma chave Pix, e você pode cadastra-lo uma única vez.
Bom dia estou com uma dúvida a respeito da atualização do webhook,
1 - Ambiente de produção e homologação são separados para este caso (objetivo: quero fazer testes)
2 - Ao atualizar este webhook terá impacto nas notificações por boleto e cartão? Ou é isolado as notificações por boleto e cartão através da tag "notification_url" ?
notification_url , igual o boleto.
Exatamente, @cesarmarinhorj2516. Ao definir um notification_url, iremos enviar notificações quando houver alteração de status da assinatura, das cobranças que foram emitidas e também quando tiver a emissão de novas cobranças. Então com base nestas informações, você realiza as devidas ações de acordo com sua regra de negócio.
quando eu gero uma assinatura, é possível usar um notification_url que vai me informar dos status do que está acontecendo, correto?
mas essa notificação é feita em background ao processo que está acontecendo ali pro usuário, correto, somo se fosse um robô acessando e me mandando informações.
Eu tenho que receber e agir de acordo, é isso?
let body = {
metadata: {
custom_id: "1264",
notification_url: "sua_url"
},
payment: {
banking_billet: {
expire_at: expireAt,// '2024-09-20',
customer: {
name: name,//'Gorbadoc Oldbuck',
email: email,// '[email protected]',
cpf: cpf,//'94271564656',
birth: birth,// '1977-01-15',
phone_number: phoneNumber,//'5144916523',
},
},
},
items: [
{
name: nameProduct,
value: parseInt(total),
amount: 1,
},
],
shippings: [
{
name: 'Frete grátis',
value: 0,
},
],
}
const result = await efipay.createOneStepCharge([], body);
metadata: {
custom_id: "1264",
notification_url: "sua_url"
},
payment: {
banking_billet: {
expire_at: expireAt,// '2024-09-20',
customer: {
name: name,//'Gorbadoc Oldbuck',
email: email,// '[email protected]',
cpf: cpf,//'94271564656',
birth: birth,// '1977-01-15',
phone_number: phoneNumber,//'5144916523',
},
},
},
items: [
{
name: nameProduct,
value: parseInt(total),
amount: 1,
},
],
shippings: [
{
name: 'Frete grátis',
value: 0,
},
],
}
const result = await efipay.createOneStepCharge([], body);
Boa tarde @adenilson2703 ! Seria algo assim:
let body = {
"metadata": {
"custom_id": "1264",
"notification_url": "sua_url"
},
}
"metadata": {
"custom_id": "1264",
"notification_url": "sua_url"
},
}
outra dúvida é possível criar as cobranças e assinaturas já com metadata e notification_url sem ter que fazer duas requisiçoes?
O correto seria:
.
.
metadata: {
notification_url: ''
}
.
.
Segue um exemplo de emissão oneStep na SDK em PHP: https://github.com/efipay/sdk-php-apis-efi/blob/main/examples/charges/billet/createOneStepBillet.php