Quando um pagamento for criado ou sofrer uma alteração de status, esta informação será enviada para a sua URL de notificação.
Os webhooks pagamentos são notificações enviadas pela Grafeno para seu sistema sempre que algum pagamento 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 pagamentos
Evento | Descrição |
---|---|
pagamento-recebido | Evento que informa o recebimento de um pagamento. |
Exemplo
{
"signature": "J/DpHzRFW/fg37gCZ3U1Cu1iV6lNgeP1fgwwGAaNT3YzphYXta0P+FSn1Lc8\nGRbEwwRaGmnQAfpoF/EypnuTnNqaALYbDtT5zwtT7E2MyXjjNf3q4MlzKJU4\nmTCmEfrrY1CvvdEdLYO/rib9LyNGHY5aPXRkL4juaxPDnw+WD+J9h3R23TQw\nMuTJ0bA56hFkHbrzhdQ0XklXKZnYQlUvOtWotB+/Wx4B1DainrA/GHgtgY8h\nKfAwOTgu0jicCxlGCJUBVAm99akoTbngzcSx5CfPtYUYUjq5yXy7zYh/I3El\nRaLo8FM7sspW9YksK+aFE5Et+dpKtl7bujefHGzxxhMcDXhmqtploqBNcuN1\nFbWfwAnVz/gkWkb8xr5yCfwAuYL+yyy48joGqJp3v6HInIlIq84dPR+WaKb/\nPYh9yF1jMVZfzpDAU6XGGdf9hFJ394eP3VFSFYCHoXcZQgvauw7vuhPPyURX\nmtsgjFsX7qqNnP8o0dB5Hkk8LPsoEUxlaL7wcuQDwDSQPzAdM1h84cW+BTcF\nCDFfwBoLcNGXEqXYE/NuP5P/utTSlUDVd4OphoeSmPDgayWflE4H4lqzy8HP\n9+kDmVxeESJoZLu/YLvG7qIwELRpxEbvO6t57f3+ARDZBAIxz6XKP6tgd08T\n5Opm4d1dApyFE/2Zkrr1tM4=\n",
"change": "pagamento-recebido",
"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=20220117T124251Z&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIA6GUDBFRJDLS2JG7S%2F20220117%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-SignedHeaders=host&X-Amz-Signature=f7799687bbb046410a6759c978275b809395d6ca13d8026cd214d6c5d74ca82b",
"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": "pending",
"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"
}
]
}
}