Payload webhook

[navossoc]

Opa, considerando que a documentação dos caras não é exatamente uma maravilha, você teria alguns exemplos de payload dos boletos?

Eu fiz a implementação dos boletos já, mas não consegui testar ainda o retorno dos pagamentos dos boletos.
Se tiver, ajuda ;)

[]'s

[marivaldojr]

Você deseja um exemplo de como emitir um boleto?

Um exemplo básico de payload:

$payload = [
    'seuNumero' => '001', // aqui é um número gerado por você
    'valorNominal' => 10.55,
    'dataVencimento' => '2023-04-30',
    'numDiasAgenda' => 0,
    'pagador' => [
        'cpfCnpj' => 'numero-cpf',
        'tipoPessoa' => 'FISICA',
        'nome' => 'nome completo da pessoa',
        'endereco' => 'endereço',
        'cidade' => 'nome da cidade',
        'uf' => 'sigla do estado',
        'cep' => 'cep sem traço',
    ],
]

Utilizando o pacote, ficaria assim:

$seuNumero = "001";
$dataVencimento = new \DateTime('2023-04-30');
$pagador = new Payer(
    "numero-cpf",
    "FISICA",
    "nome completo da pessoa",
    "endereço",
    "nome da cidade",
    "sigla do estado",
    "cep sem traço"
);
$valor = 10.90;
$diasParaExpirar = 0;
$boleto = $this->client->bankSlipApi()->create($seuNumero, $valor, $dataVencimento, $diasParaExpirar, $pagador);

echo $boleto->seuNumero; // 001
echo $boleto->nossoNumero; // Número, atribuído automaticamente pelo banco na emissão do título.

O retorno da API na emissão do boleto tem os seguintes atributos:

{
    "seuNumero": "001",
    "nossoNumero": "00000000000000000000000000000000000",
    "codigoBarras": "00000000000000000000000000000000000",
    "linhaDigitavel": "00000000000000000000000000000000000"
}

[navossoc]

Ah sim, mas isso é o pedido de emissão.
Digo após o boleto ser pago, o payload que é enviado para o webhook.

Pela documentação deles deveria ser algo assim:

[
    {
        "idSolicitacao": "",
        "nossoNumero": "",
        "seuNumero": "",
        "motivoCancelamento": "",
        "situacao": "",
        "dataHoraSituacao": "",
        "valorNominal": "",
        "valorTotalRecebimento": "",
        "codigoBarras": "",
        "linhaDigitavel": ""
    }
]

Agora não sei qual o fluxo das notificações. Acredito que deve vir um apenas com situação = pago.
Aparentemente não é enviada nenhuma ao criar o boleto e eu não sei o boleto é cancelado ao atingir o vencimento+numDiasAgenda...

[]'s

[marivaldojr]

Ah entendi. Realmente não testei a parte de webhook ainda.
Se descobrir eu posto aqui.

[navossoc]

Estou nessa também...

O de cancelamento eu sei que é assim:

[
    {
        "nossoNumero": "009xxxxxxxx",
        "seuNumero": "TESTE001",
        "motivoCancelamento": "APEDIDODOCLIENTE",
        "situacao": "CANCELADO",
        "dataHoraSituacao": "2023-04-03",
        "valorNominal": 2.50,
        "codigoBarras": "077xxxx0000000002500001112xxxxxx0009xxxxxxxx",
        "linhaDigitavel": "077900011612xxxxxx00609xxxxxxxx4993000000000250"
    }
]

Como é uma array ali, fica a dúvida se durante o pagamento pode vir um lote com vários boletos de uma só vez, saca?

Enfim, se eu descobrir algo eu aviso.

[navossoc]

Paguei 3 boletos ontem...

As confirmações vieram individuais (1 postback pra cada boleto).

[
    {
        "nossoNumero": "0097xxxxxxx",
        "seuNumero": "TESTE006",
        "situacao": "PAGO",
        "dataHoraSituacao": "2023-04-03",
        "valorNominal": 6.00,
        "valorTotalRecebimento": 6.00,
        "codigoBarras": "0779493110000000600000111203064300097xxxxxxx",
        "linhaDigitavel": "0779000xxxxxxxxxxxx06097xxxxxxx3493110000000600"
    }
]

Todas as respostas foram nesse formato.
Ainda não descarto a possibilidade de vir mais de um pagamento no mesmo requests, enfim, melhor tratar né? ^^

Vou aguardar alguns vencerem agora e atingir o numDiasAgenda para ver se existe mais algum tipo de notificação.

PS: Ah e todos os requests, seja do boleto ou pix estão vindo com mTLS.

[]'s