Quando uma cobrança for criada ou sofrer uma alteração de status, esta informação será enviada para a sua URL de notificação.
Os webhooks cobranças são notificações enviadas pela Grafeno para seu sistema sempre que alguma cobrança tenha o seu status alterado.
Body Params
Parâmetro | Descrição | Formato |
---|---|---|
signature | assinatura criptografada para garantir a origem da informação. | string |
change | Referência da alteração. | string |
data.abatementValue | Valor de abatimento do pagamento. | string |
data.applicableFine | Multa de atraso aplicada ao pagamento. | string |
data.boleto.barCode | Código de barras do boleto bancário. | string |
data.boleto.lineCode | Linha digitável do boleto bancário | string |
data.boleto.ourNumber | O nosso número de controle. | string |
data.boleto.pdf | URL para acesso ao .pdf do boleto bancário. | string |
data.boleto.quickPdfUrl | URL simplificada para acesso ao .pdf do boleto bancário. | string |
data.boleto.registrationMethod | Tipo de registro do boleto bancário. | string |
data.boleto.registrationStatus | Status do registro do boleto bancário. | string |
data.boleto.yourNumber | O seu número de controle. | string |
data.clientControlNumber | Identificador próprio de uso da empresa. | string |
data.createdAt | Data de criação do pagamento no formato "YYY-MM-DD". | Date |
data.daysWriteOffAfterDueDate | Quantidade de dias para baixa após o vencimento. | int |
data.discountType | Tipo de desconto. | string |
data.discountValue | Valor do desconto. | string |
data.dueDate | Data de vencimento do boleto bancário. | string |
data.interestType | Tipo de juros aplicado. | string |
data.monthlyInterest | Valor de juros ao mês. | string |
data.origin | Origem do pagamento. (conta Grafeno ou API). | string |
payer.address.city | Cidade do endereço do pagador. | string |
payer.address.complement | Complemento do endereço do pagador. | string |
payer.address.neighborhood | Bairro do endereço do pagador. | string |
payer.address.number | Número do endereço do pagador. | string |
payer.address.state | Estado em formato UF do endereço do pagador. | string |
payer.address.street | Rua do endereço do pagador. | string |
payer.address.zipCode | CEP do endereço do pagador. | string |
payer.documentNumber | Número do documento de identificação do pagador. | string |
payer.email | E-mail do pagador. | string |
payer.name | Nome do pagador. | string |
payer.phone | Telefone do pagador. | string |
data.paymentMethod | Método de pagamento utilizado. | string |
data.status | Status do pagamento. | string |
data.uuid | Identificador único do pagamento. | string |
data.value | Valor do pagamento. | string |
fees.kind | Tipo de tarifa aplicada. | string |
fees.value | Valor da tarifa. | string |
payments.value | Valor pago. | string |
payments.receivedAt | Data de recebimento do valor pago no formato "YYY-MM-DD". | Date |
payments.processedAt | Data do processamento do pagamento no formato "YYY-MM-DD". | Date |
payments.paymentBankCode | Código do banco utilizado para o pagamento. | string |
payments.paymentAgency | Código da agência do banco utilizado para o pagamento. | string |
Eventos de notificação para cobranças
Evento | Descrição |
---|---|
paga (paid) | Evento que informa o pagamento de uma cobrança. |
baixada (paid_externally) | Evento que informa a baixa de uma cobrança. |
Exemplo
{
"signature": "lpbntvqj+9fwx7TY55NmtnmckwYS1i9Zmw4EMSFH4vcPbYS2OxHwPh8RoE+f\nKRjAl+8Vg+eYlprh2xmHAbrrb74EXEoKA5zOnfqYVu6WrdNDoYVdhPvyh179\nYXgXqKuEjSdxOnGx+EoFD5aHRUWYb/6Di0sSjuQOL3exfpImBouC3mgZJeWw\nyI18IUmIcRYCQchLYzXyCqGAjMaXtiiVxTOnS9M70kT/WplKjCm0ISA6IDvO\nC2bYSOgCRTlTPEfXeg8yePsphgt+rxKxvaMG6yBozP7OdQHVZKOoeOYQ8FXv\nO3R2SsC5U4zBTviFOWXGrPBcIp2SxC5GET7A3W9LMcQVupAEvVrnWOry0N05\ngJvWDfwLR0ilu4sw3PV5SToSiTISWW1u7+Xkwko1vLBY98dxZjPQDda/K/HE\nb2MwVqcayG7ZUzjuvac9lQWJdV3j0zOsf5Ojph2i8zQUG+JbbsqwXu8Escnr\nhIvMVGf/UFs7Q3cIDMSXcBz+sSUxYdKrEDj5GKjT2MGjwJO76LglD4Lm1hoj\nFlsJqaIKuqwCp8DBN8QKeZexTSJqmHLY4O13acpdF13zTbCrbzXHwPnC7ELf\n3IXMkk/SG/23K4PAJTFq6eMeHL9iStP1k5sTnBPBh4fEBkjq36ZWVw1vWSgj\n/ISe6d9HortEs8MyP0DDufU=\n",
"change": "status-alterado",
"data": {
"abatementValue": null,
"applicableFine": "0.02",
"boleto": {
"barCode": "27496914500000251110001010000000475681246950",
"lineCode": "27490001011000000047056812469502691450000025111",
"ourNumber": 4756,
"pdf": "https://pagamentos.grafeno.be/charges/a6d92438-93ff-46d3-a0f7-2b10e3a86f5e/download_boleto",
"quickPdfUrl": "https://grafeno-pagamentos-carrierwave-staging.s3.amazonaws.com/uploads/bmp/boleto/9855/file/21-10-2022_-_VIVI_ATUAL__NF__-_Teste_Cob_LTDA_-_28406.pdf?X-Amz-Expires=259200&X-Amz-Date=20220117T124356Z&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIA6GUDBFRJDLS2JG7S%2F20220117%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-SignedHeaders=host&X-Amz-Signature=79df58531b2d501b5f5a9f8201c15253166bd7f64322ea484f85e0b3f3b08b57",
"registrationMethod": "online",
"registrationStatus": "pending",
"yourNumber": "000001"
},
"clientControlNumber": null,
"createdAt": "2022-01-17T09:40:53.229-03:00",
"daysWriteOffAfterDueDate": 90,
"discountType": null,
"discountValue": null,
"dueDate": "2022-10-21",
"interestType": null,
"monthlyInterest": null,
"origin": "api",
"payer": {
"address": {
"city": "SÃO PAULO",
"complement": "casa 2",
"neighborhood": "Jardim Paulistano",
"number": "1355",
"state": "SP",
"street": "Av Brigadeiro Faria Lima",
"zipCode": "01452011"
},
"documentNumber": "12345679891",
"email": "[email protected]",
"name": "Teste Cob LTDA",
"phone": null
},
"paymentMethod": "boleto",
"status": "paid",
"uuid": "a6d92438-93ff-46d3-a0f7-2b10e3a86f5e",
"value": "251.11",
"payments": [
{
"value": "251.11",
"receivedAt": "2022-01-17",
"processedAt": "2022-01-17T09:42:51.399-03:00",
"paymentBankCode": null,
"paymentAgency": null
}
],
"fees": [
{
"kind": "charge_boleto_online_register_cost",
"value": "0.0"
}
]
}
}