Referência API
Postman CollectionStatus PageReferência APIGrafeno Digital

Webhook de Pagamentos

Quando a sua conta Grafeno receber um pagamento, esta informação será enviada para a sua URL de notificação.

Os webhooks de pagamentos são notificações enviadas pela Grafeno para seu sistema sempre que ocorrer a entrada de um valor proveniente de um pagamento de cobrança em sua conta.

Body Params

ParâmetroDescriçãoFormato
signatureassinatura criptografada para garantir a origem da informação.string
changeReferência da alteração.string
data.uuidIdentificador único do pagamento.string
data.createdAtData de criação do pagamento no formato "YYY-MM-DD".Date
data.abatementValueValor de abatimento do pagamento.string
data.applicableFineMulta de atraso aplicada ao pagamento.string
data.daysWriteOffAfterDueDateQuantidade de dias para baixa após o vencimento.int
data.clientControlNumberIdentificador próprio de uso da empresa.string
data.interestTypeTipo de juros aplicado.string
data.monthlyInterestValor de juros ao mês.string
data.discountTypeTipo de desconto.string
data.discountValueValor do desconto.string
data.dueDateData de vencimento do boleto bancário.string
data.paymentMethodMétodo de pagamento utilizado.string
data.statusStatus do pagamento.string
data.valueValor do pagamento.string
data.originOrigem do pagamento. (conta Grafeno ou API).string
data.boleto.registrationMethodMétodo de registro do boleto bancário.string
data.boleto.registrationStatusStatus do registro do boleto bancário.string
data.boleto.ourNumberNosso número de controle do boleto bancário.string
data.boleto.ourNumberDvDígito do nosso número do boleto bancário.string
data.boleto.barCodeCódigo de barras do boleto bancário.string
data.boleto.lineCodeLinha digitável do boleto bancáriostring
data.boleto.yourNumberO seu número de controle.string
data.boleto.pdfURL para acesso ao .pdf do boleto bancário.string
data.boleto.quickPdfUrlURL simplificada para acesso ao .pdf do boleto bancário.string
data.boleto.emvPIX Copia e Cola. (somente em boletos na modalidade "híbrido").string
data.boleto.imageQR Code do PIX. (somente em boletos na modalidade "híbrido").string
data.payer.nameNome do pagador.string
data.payer.emailE-mail do pagador.string
data.payer.documentNumberNúmero do documento de identificação do pagador.string
data.payer.address.streetRua do endereço do pagador.string
data.payer.address.numberNúmero do endereço do pagador.string
data.payer.address.complementComplemento do endereço do pagador.string
data.payer.address.neighborhoodBairro do endereço do pagador.string
data.payer.address.cityCidade do endereço do pagador.string
data.payer.address.stateEstado em formato UF do endereço do pagador.string
data.payer.address.zipCodeCEP do endereço do pagador.string
data.payer.phone.countryCodeCódigo do país do telefone do pagador.string
data.payer.phone.areaCodeCódigo de área do telefone do pagador.string
data.payer.phone.numberTelefone do pagador.string
data.fees.kindTipo de tarifa aplicada.string
data.fees.valueValor da tarifa.string
data.payments.valueValor pago.string
data.payments.receivedAtData de recebimento do valor pago no formato "YYY-MM-DD".Date
data.payments.processedAtData do processamento do pagamento no formato "YYY-MM-DD".Date
data.payments.paymentBankCodeCódigo do banco utilizado para o pagamento.string
data.payments.paymentAgencyCódigo da agência do banco utilizado para o pagamento.string

Evento de notificação para Pagamento

EventoDescrição
pagamento-recebidoEvento que informa o recebimento de um pagamento.

Evento de notificação

{
  "signature": "Ftz2Ay+LmD7MOZRahuHOgEHvE6cIa73hl5VsvT7dlcRiOwuvtYeAnfgZATqJ\no66ymDsm5t5BMPrR1u+djKyt1g3VZOYQQFm3Ec6AqYtuEjKgGIsQglWGySe0\n8ODYZBntIoVa/TLgtJkJPOKOXPQKgYFSokHJl4UX1VgFgPvpOxyvktdbeC2j\nxa1mkEcU/g2ZLx256H9AJuXObcCRgE87nFcEL3dOe2yi4hVM1VsPnw/XZa6k\nYgAR/UPkH8dbJXpNNZj9HIhHaNFflzRQSyi5u85rbKsGOgEwgZ4kt+RLg6Kb\n7zjRfQgW3hzEX+1V/iXQegi8wlD/NOjNDiZHrECOx0Ha10b0jvL/+rtO1hJu\nTau7taC5hpu33t55DHzHclxKBfB2qAlODBS3c+QdOpWJZ+Ol3RRKFxaqgNsm\nagTsKaePwNP/mFavUtkPIoUh6v1u9Lxnuxq94H1i5KHM5Qx2Zj11LNQl3+qQ\njH0WYGmdgIf/ujq+UAc6hGdZWq2u6Ljr++coxbK3wPS0Fp0cUUBYYYDHFgE8\n4SKtfesbnKsiSF5Mp9tDRzILL+p9BfdPYTL6LhENjDxZFuTZQyFAZR1FKIvD\nouikSVAgadQI/a94ytazmId3BoMbICrnXnhD7CR2/2qvo3yvkAS375HKkWKB\n1vPnnsz8ThQRSJTpcQHHePg=\n",
  "change": "pagamento-recebido",
  "data": {
    "abatementValue": "5.2",
    "applicableFine": "0.02",
    "boleto": {
      "barCode": "27499994700000699090001010000001379881246950",
      "lineCode": "27490001011000000137998812469504999470000069909",
      "ourNumber": 13798,
      "ourNumberDv": "0",
      "pdf": "https://pagamentos.grafeno.be/charges/ce936f49-7767-443f-ab58-32d13e33891a/download_boleto",
      "quickPdfUrl": "https://grafeno-pagamentos-carrierwave-staging.s3.amazonaws.com/uploads/bmp/boleto/32387/file/31-12-2024_-_VIVI_ATUAL__NF__-_Jose_do_Protesto_-_57327.pdf?X-Amz-Expires=259200&X-Amz-Date=20240205T180421Z&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIA6GUDBFRJDLS2JG7S%2F20240205%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-SignedHeaders=host&X-Amz-Signature=dcb467cfc4dde29fc34734c4db25ce5123b573b5b175dfda167c948df9e4fcd1",
      "registrationMethod": "online",
      "registrationStatus": "registered",
      "yourNumber": "11119999",
      "emv": "00020101021226970014br.gov.bcb.pix2575qr-h.cornerpix.com.br/11581339/v2/cobv/ef9b28f3-c9bb-4948-991b-5bfd8004b1e05204000053039865802BR5914BMP MONEY PLUS6009SAO PAULO62070503***63048242",
      "image": "iVBORw0KGgoAAAANSUhEUgAAAhIAAAISAQAAAACxRhsSAAAE0UlEQVR4nO2dzY3jOBCFXy0F+CgBG0CHImWwMXVIm4EUSmcgHQ1IeHsgi6Q8np4FxuZ6jceD4RblDxRQqP9SG/G7a/njtxGAGGKIIYYYYoghhhhiFIal1cGmrYOZdcAyHAZsaQPAYTYBsGnz+6cHn0MMMb5ljCTJFcAyAJzz/jIEYuQOs7hxGGcEkiTPjEecQwwxvmVsrh3HFbAp6s5Am5DEljMCsQzpftexjz6HGGL8S8ZhUb3Omxm5HmY2HG7jAZRvzz2HGGLk1d38zagxtz93AwADAIx/Xwhs3W7j1+0PHnQOMcT4dkVHM/mngRjXQKAnAYS4ASCkXfTpvupn86s8ixhvz1jMzGzwq+NXFz1VYOuyz5o2bMIRw/3Hn0MMMe6uaMZL8ZTYAAJXA3AY0O/A8rGDywDDMgQA/bnY+irPIsb7MpLdz4ae5A5yRfzwFZiC/n5HvGUGILsvRlvGuCLKn5ldaBNCVJmce5Jzf7XoBoxfF9YpqUefQwwx7q8YEc03gomU3Y8f+b6kQOOVFExJn4rxfEYlf0UISe4eR/U76t1+R4r8JaditGMkfco1VZzStz6p0iiYM9xdTeo1VFkryakYz2d4HIWkRf3DY6ssrO7C0pOoyp+K0Y7h+jT3oYxMlr0E/e69BiZfIIb/svtiNGakLr1+B+ftEtWrTQg0G0LWtlfj55ATVv1VeX4xWjGyPk1+Z7Tx6Pc6wIKH/yWOchdW+lSMFoxTXipX9YHa7qPETDyLrey+GG0YOTTySGnua3EsVajYoJK7VOSfitGS4Tox10Mro74WsS1pqizFsvtitGPECqiNXx284TQA2LrYkWKxBbVfadgG2LgeXjPd1M8vRjNG1qe5KLUi2ngvnmaf1XP/dU+q9KkYTRmbWaUil48dKfMU+08PQxTWrUO65oX/13sWMd6WEaUupqRIzjhcbGP/KUmuh6UWlH73qelHn0MMMe4vL0WldL53n7gvEK95taoamC4bsvtiPJ2R86c3LX15OL/PPdFraaQKivfFaMo490vV6rX8iTLRV/WkeoZKcirG8xmVnCb/FGW8xBOruUaa1Kvy/GI0ZngZf0Vlz93Q5/JoMfRrnpAGZPfFaMU4q83cXFrlT7MbClT50zLELzkVox1juzAlUXHEDr/Y5vc5BGIxszrjj8OwfOyw6eHnEEOMu8ur9WUCimRV0Efd+ueuKdwDkD4Vowmj7pdKq2RS3Rcdzw2n1TCV5FSMJoxzv1T2VHNBH33dHe1BP0+O66s8ixjvy6jmo1yBnjbm3ITKNYdVq/SpGG0ZVT2q+KcujiEnrOpqlecF1M8vRjNGHoMqetJXCvDhM6h5Qjotze+L0YxxmovmaTg/5wC8HTXX93l+g8qrPIsY784o/++E89YBS/6Wmvuulqb8Yp413fLwc4ghxk+W233yFCll1zTr2JugP78eRfpUjOcz7tb3i7WP99Seat3wJ7svxn/EiBpzsQ7p3Sck+Tkclrr5NrMq1HreOcQQo14//PuS5a8VTK88X/3idonzpkC/dwaE3Urd6mWeRYz3Zfzgn8LrUSwFfVbTU/WLUeWfitGIUb1XEmX8GcD5zX2hDpxuKwOv8ixivC/D+Ot7frGWV3kWMcQQQwwxxBBDDDH+/4x/AFXeM3zOxX7QAAAAAElFTkSuQmCC"
    },
    "clientControlNumber": "7543649847645556555553425",
    "createdAt": "2024-02-03T10:53:57.976-03:00",
    "daysWriteOffAfterDueDate": 90,
    "discountType": "percentage",
    "discountValue": "2.0",
    "dueDate": "2024-02-04",
    "interestType": "percentage",
    "monthlyInterest": "2.0",
    "origin": "api",
    "payer": {
      "address": {
        "city": "São Paulo",
        "complement": "Apt 222",
        "neighborhood": "Santa Cecília",
        "number": "2222",
        "state": "SP",
        "street": "Rua Dr. Albuquerque Lins",
        "zipCode": "01230-000"
      },
      "documentNumber": "38227157351",
      "email": "[email protected]",
      "name": "Dwight Schrute",
      "phone": {
        "countryCode": "55",
        "areaCode": "51",
        "number": "995566778"
      }
    },
    "paymentMethod": "boleto",
    "status": "paid",
    "uuid": "ce936f49-7767-443f-ab58-32d13e33891a",
    "value": "699.09",
    "payments": [
      {
        "value": "699.09",
        "receivedAt": "2024-02-05",
        "processedAt": "2024-02-05T15:04:21.758-03:00",
        "paymentBankCode": null,
        "paymentAgency": null
      }
    ],
    "fees": [
      {
        "kind": "sending_email_cost",
        "value": "0.06"
      },
      {
        "kind": "charge_boleto_online_canceled_cost",
        "value": "1.99"
      },
      {
        "kind": "charge_boleto_pix_registered_cost",
        "value": "0.0"
      },
      {
        "kind": "charge_boleto_online_register_cost",
        "value": "0.0"
      }
    ]
  }
}