DocumentaçãoReferência APIFórumGrafeno API Collection - Postman
Cadastro Conta StagingLogin Conta Staging

Webhook de Cobranças

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 de cobranças são notificações enviadas pela Grafeno para seu sistema sempre que ocorrer alguma alteração no status de suas cobranças.

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

Eventos de notificação para Cobranças

EventoDescrição
paga (paid)Evento que informa o pagamento de uma cobrança.
baixada (paid_externally)Evento que informa a baixa de uma cobrança.

Eventos

{
  "signature": "bway9M9HnZthzj17Pb8FeHUUrkdKCkguQdpYoqryemhw/aKcmRQ0Zj1npheP\ng3m/tB9xuxjcR5/QnoPAFVErcoGOcSZOn1W383MZBzRZ7nIKAZ2ExCDXYnf9\nhmL3rlkTUI0GDpTR6cUF/LIYr9gm0wBXxDEwO1u3dq6DuGHGsavRkq1Die9W\nRLqp7Qkt1aZ9QtO7hMkjVBow+vFC+fDI7+GiRCaBxMu1aBfK+U2GN+gklUTJ\nR2BInNp8d8hI1p0yS1shMtNCn91DgfGzwGUgHkd+63WkHWb9SgjksYdeqZlp\n1XJSG9t6NayGB1yZjlpmXK18/hVBNFv4wbjPBlY6Sr/a4wFlxqB8ZwFcgC1J\nptUNSuAKGfZOBCpsZUDiIyCDpRsYcXAimDPoX67s53JA/QW4R29T5wFKnA1w\ngn5966B4rlmOkqnT5QA2jxr9dlxoTC0IvPbl0o78WoCZ3k6b6X2l/HVBVfeu\n6cidrjhBrZ7bN7XBmMPODkb3YZmIsNRIRqQ46AVe5ajNkTMSLL4QVVHTUeoe\nKXJYmkQYFMjqkKcDqEnycxXLmDJvdwxnYnTf7WKu+4ERvm3G4QTrrHZM785m\nxiyZG+2cHNxDtolcJ1yGIw3DZ6VImxTWg+JywMv5dAZ3aguMYI6PgOWMyn6t\nCdqwXqIRnwNmEKbeWy57+60=\n",
  "change": "status-alterado",
  "data": {
    "abatementValue": "5.2",
    "applicableFine": "0.02",
    "boleto": {
      "barCode": "27491994700000699090001010000001380281246950",
      "lineCode": "27490001011000000138702812469506199470000069909",
      "ourNumber": 13802,
      "ourNumberDv": "2",
      "pdf": "https://pagamentos.grafeno.be/charges/704981bc-e9e2-4344-97be-e1040076e6da/download_boleto",
      "quickPdfUrl": "https://grafeno-pagamentos-carrierwave-staging.s3.amazonaws.com/uploads/bmp/boleto/32410/file/31-12-2024_-_VIVI_ATUAL__NF__-_Jose_do_Protesto_-_57350.pdf?X-Amz-Expires=259200&X-Amz-Date=20240205T172404Z&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIA6GUDBFRJDLS2JG7S%2F20240205%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-SignedHeaders=host&X-Amz-Signature=fbd9b150d35cf806f3b41fb1396166d86e408bc410d2d496f2cf0b5c6e742073",
      "registrationMethod": "online",
      "registrationStatus": "registered",
      "yourNumber": "11119999",
      "emv": "00020101021226970014br.gov.bcb.pix2575qr-h.cornerpix.com.br/11581339/v2/cobv/421d9819-39b4-4946-bb65-68da8b2035665204000053039865802BR5914BMP MONEY PLUS6009SAO PAULO62070503***6304213A",
      "image": "iVBORw0KGgoAAAANSUhEUgAAAhIAAAISAQAAAACxRhsSAAAE00lEQVR4nO2dQW7jOBBFf40EeCkBOUCOQt8syJHmBtJRcgNqaUDCnwVZJJXuTmPQNscTfC4SW6IeKKBQZH1W0Ub8aVv/+mMEIIYYYoghhhhiiCGGGJVhuY3nm4dhnQ+zKw5LV9YZsOvm/a93HocYYnzJCCTJCNgVh2VLnAEAA7HaCLM53+WCgSTJM+Me4xBDjC8ZW/aOfJ8H8v11B/lxIbCZJSteilMFgNb5Ptu7iPH9GJ9meliIx8gQQWC6GQMBYJvBEA/v8vf9xyGGGP+GwWW7EOt8GFa7MK9D54FYZ4D8+GzYDxqHGGK0zc1uIoANsLDcDJgACzwMYQEMacofm37t9sCzvIsY356xWgmctgsR0tL0QmAbgRAHIsSBdt1G2BVHcrP3H4cYYvy0JX9avSOzs7wZkheddmB93QFMN8P6ejOevenzvIsY35eBRmAKEUmhQuCeP6Ub3MEFA/Onyf+QJJdneRcxvi/DbW2iS6L+yQ2Tacon40DAr1URVXYqxuMZbqf1wrTnBSlQrRNAMtF4ekx2KkYfxsngph1kHEhyR7JYAGnKT+4VU3GvslMx+jEaO/X1afanyVhDslhmz5q+AuBSnpWdivFwhsdRKSoqQRKAdG0BQMbar9q14igxejPCxyWLo29px2kooT5pVwDANiazNZsPa7o827uI8Q0Z2U8Gd6o1jsrxfgRQbJKLr0/zH/lTMbow3E4jkn6aw6V0o1VNq7DKZcprVtmpGJ0YeT9qfd1HYNpHAw4jcIzA9kJr+x4j1jnSQgQtLHcdhxhifNncnxYv6qF+swGQN6BO/jRIlxKjH6PoUh7v0xefyTBxmveTEJDXp4DmfTE6MVr9FABaET96n6qpLq79A9o3FaMfo533gyukVTqtySh5U8qn/Pqs7FSMxzNKXt/NgO1lB3CMBEDDFGHYXnaE5RgtxJess+Z+g7vWZ3kXMb49Y7ULmxSUdT4MIZb809mvtRLroTxpMXoxSv5puwGVwvq6Pk39irqfm9anYnRjNHnSTf5z3uRv06KyiSZXmnemZKdidGI0ulRVozwZKjvVJq+vZEy7zio7FaMHo5HzXSbNSirKzJ4+1fxTlJIT2akYfRmbWaotBQC7bhcixMPM5sPIeFie7WvSlM5DEaMfo9FP85LT5fxTCoqHVTVPOn+VPxWjB6PNf16AJqWvKdyDJ0jVhavy+sToySh1fKfd0ibDz8P61HkpjyneF6Mjo63fz+GS31hqJ8+XyrkpExuxVXYqxuMZHriXWbwt1yvFfEmIKl40Qnl9YnRlnOtNP/nTUiENwEuiTyGU7FSMPoz2nInAmjlVKksa262F/dmpyk7F6MqwN+7IIiq8mDREP5//LeKUeNKcin7fcYghxi8azw0oaaYouabtMT44parIn4rRkdH+3sm0w95qWtQ2Ip2Azgg/YXLLJf52vfM4xBDjFy2HUB7qMx+KclqzNiFUPXBS50qK0Y9xrt8fmsI9r+Orrdb2AarfF+M/ZYR4GN9nwN4+zH44As1/pse3rB42DjHEaNsP/rSKTmdJajkfjKp9UzE6Mj6vT9uT+3Da0M+CqedOSz8VoyPj8/5++t+USfuN1rMCbVWK7FSMhzOMv+/zm7Y+y7uIIYYYYoghhhhiiPH/Z/wDN28u9T9agCkAAAAASUVORK5CYII="
    },
    "clientControlNumber": "7543649847645556555553425",
    "createdAt": "2024-02-05T14:17:13.003-03:00",
    "daysWriteOffAfterDueDate": 90,
    "discountType": "percentage",
    "discountValue": "2.0",
    "dueDate": "2024-12-31",
    "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": "704981bc-e9e2-4344-97be-e1040076e6da",
    "value": "699.09",
    "payments": [
      {
        "value": "699.09",
        "receivedAt": "2024-02-05",
        "processedAt": "2024-02-05T14:23:00.117-03:00",
        "paymentBankCode": null,
        "paymentAgency": null
      }
    ],
    "fees": [
      {
        "kind": "charge_boleto_online_canceled_cost",
        "value": "1.99"
      },
      {
        "kind": "sending_email_cost",
        "value": "0.06"
      },
      {
        "kind": "charge_boleto_pix_registered_cost",
        "value": "0.0"
      },
      {
        "kind": "charge_boleto_online_register_cost",
        "value": "0.0"
      }
    ]
  }
}

{
  "signature": "mshYqDbWCITaMI7AtJFmyU45Ukfg26F2by+gOdKTH0mj3QC4hHdu5/Bdy3j9\nRGRyW+T3lIYjaynh2lxnwBa1UFy3rayEb748kbhef4+MT4B3wBwFkILRK4YN\nuq74aiRpsBzM0B8LGyMgtotkQi1PGAOwDxtyPOqQeIGmwKafs8GssSnMG84Z\nAn0CfzBfTaxmjCKXeDMl7vKBKLjHS7AM/0Zn3oDBbfkABHBtBKOPIJ6ZYYh/\nUmIIkljYsGG+ymsEXC6iaMgeav+ujww5kS0Ym4oP4N3WaPN7hD1e7Ou7Tm8C\n67xdRYaF1nMq+NnXNx66jSZ8n/RMETF5NEISuaR8FKXfkZra80HYP7T0QsyN\nj22nP3smzIQU6DYbHUbMel6FnLXO+s8xWANhVixvc1tCLoamC8v7H4z5jJc2\nga4VarBc0OX0yLGtPKbHniOaGwHxwelWw2/Pjv6BLNGqvPJWhnz5u/E6kqSN\nbS/gN/ughfAXzj1LvBubA/c5PCFpJ1s1r8moCXGc/fLaDR7lqCEHyOsUoQu1\ntLFE7ST9nyce+R0Gn9Ca4Nag2w+O81+ocIqBknhdeIj7CPuQbuqLJBN1sSDT\nYvlwFS3o/CQ940TcRzoZy5zQr0Xxi85QPnK2Y5fuuKUgqtVl66ydJ4Luxi6N\nvctvHcmNBJmOPU1j7y3bvOc=\n",
  "change": "status-alterado",
  "data": {
    "abatementValue": "6.66",
    "applicableFine": "0.06",
    "boleto": {
      "barCode": "27491994700000699090001010000001378881246950",
      "lineCode": "27490001011000000137988812469505199470000069909",
      "ourNumber": 13788,
      "ourNumberDv": "3",
      "pdf": "https://pagamentos.grafeno.be/charges/30290ba2-dd28-4095-949a-879aa8e3b22a/download_boleto",
      "quickPdfUrl": "https://grafeno-pagamentos-carrierwave-staging.s3.amazonaws.com/uploads/bmp/boleto/32377/file/31-12-2024_-_VIVI_ATUAL__NF__-_Jose_do_Protesto_-_57322.pdf?X-Amz-Expires=259200&X-Amz-Date=20240205T175338Z&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIA6GUDBFRJDLS2JG7S%2F20240205%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-SignedHeaders=host&X-Amz-Signature=49d3daae7363a15306fed618f917d81939f7b46a54eb3c5235bd343932cb7782",
      "registrationMethod": "online",
      "registrationStatus": "registered",
      "yourNumber": "11119999",
      "emv": "00020101021226970014br.gov.bcb.pix2575qr-h.cornerpix.com.br/11581339/v2/cobv/af7ea24f-d29d-4bd1-9450-4977bd2108f05204000053039865802BR5914BMP MONEY PLUS6009SAO PAULO62070503***6304CF38",
      "image": "iVBORw0KGgoAAAANSUhEUgAAAhIAAAISAQAAAACxRhsSAAAErElEQVR4nO2dTW7jOBCFX40EZEkBOUAfhb7BHCnIkfoG0lFygAaopQEJNQuyyJKSnp5B2xyP8bgIbJn5IAGF+i9KFL+7lj9+GwGQQQYZZJBBBhlkkEFGY0hZI7BMuwDYBctkP1ywS96+TIBcVtt/ufF9kEHGT5aqqiKqqmoa1K5t0DmoIto1IKgi6gbVNKj7t/lRnoWM52WYnCYAMcvfBp0BFLENGxC1SKzOYbMfMFBOyejFGE/fBQAkKiBxvooCUCzTj1Gx2pb4/fb3QQYZ/4aRrf0y7YJFXtS7odgF8eMs2He6DzLI+IoRVHUGIBcTR52xi5n8ut/2qep2j/sgg4y/YSwiIjIBiB8v2fmUtzQosI4A1heVCwaVyzpCLtiznr39fZBBxpcrm/FWPFWsuyhwFV2+XSXHUcu3DUC4in06Flsf5VnIeF5GifcBoAX9JfKvKamYcwBDyUvNwf4o430yujBqXqomndSnSVti9VM2CiWJSjkl4/4M06dBixDCMqQ6AyWnOuetg4uotC3KKRl3Z5jAJRTzXuN4ncMGoKlNDNpqVJRTMnoyvH9aNWYz+Sa7ZvxnAKoJVrKinJLRhWGyFnxBvxj6Fi5ZbJXzp175Uk7J6MFwdr/1l7TSvmnb1nhSZLcEWJRTMrowXL9UE8xi40O5hhxgoVRVnXqNlFMyujDMducvg5rzWTunQtGizl2tTgL1KRmdGIc4Kughejrk+fMfnMWWckpGD4Y39JoAtERUCbDMIaia1T5Rn5LRjeHjqLkF8wlm3oFaNwVc7r8E/ZRTMnowjv4pUCz7qb6f4Lr92z7qUzI6MWoB9OhyoupOc1dL62l1YWG/Uk7JuD+jtOcvfyYVrK9ZWwpCgsQ0AfnaOkGxjpvk+n7eN2xyu/sgg4x/xNit13TaBTHZ19J/qioy7ZJ7/PNsXzKV+3jPQsbTMfy8KYDii9aSqd+XhsMECkC7T0YvhquM+ua+vCzZX0S5jUlvcE1TlFMy7s6o/aeHbj6f7Lfy1Ny6qay9n3JKRieGi/d905Ra6+lce6fzp6p3qU/J6Mg490v5kZMENwvV8lLuK+WUjD4MP3fitGioBajmEKBNoFizNOWUjD6MWo8aDvMkVo9yGX/UeVNlHEVGZ4bLSzUPwBf0DwUoc1LNIaCcktGH4fr6Dmqz5VQH1y/lPVWe10dGP4br6/MnnGqLlOqBp+nUUkW7T0Y3hhvEb6OmrhPVFaVC2wLOR5HRleH7+mLNUPlM6kGBzgDa0CnllIxODHdQj43m+XqUrWrjTzV/yikZXRj+AJ4isbWMWiuoqJ397hh0zu+T0Ztxet+JzuuLNZ6sY+6hkrfmuK4j4PpVHutZyHhihnNN8xG9gL5PrSd1UKC+nKdcA+Ry6/sgg4yvVwv1/Tt4AJx7TVHPQcsrMN4n479kWHn0fQIstrcAC6t8PrP/gZ+FjCdhfPH6kl2AdQJiet2AVQBggC7TjxExvW6yyLBpHaZ6nGch4/kZwSdRAQx5IArLBCDq1b2SRzVPT135HgkyejE+n3/aBk1MYkuPv52NZj1UrJuS0Y0h+us9v1jLozwLGWSQQQYZZJBBBhn/f8ZfHJd+El92aAgAAAAASUVORK5CYII="
    },
    "clientControlNumber": "7543649847645556555553425",
    "createdAt": "2024-02-02T16:40:49.414-03:00",
    "daysWriteOffAfterDueDate": 90,
    "discountType": "percentage",
    "discountValue": "2.0",
    "dueDate": "2024-12-31",
    "interestType": "percentage",
    "monthlyInterest": "6.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_externally",
    "uuid": "30290ba2-dd28-4095-949a-879aa8e3b22a",
    "value": "699.09",
    "payments": [],
    "fees": [
      {
        "kind": "charge_boleto_online_canceled_cost",
        "value": "1.99"
      },
      {
        "kind": "charge_boleto_pix_updated_cost",
        "value": "0.0"
      },
      {
        "kind": "charge_boleto_online_updated_cost",
        "value": "1.99"
      },
      {
        "kind": "charge_boleto_pix_registered_cost",
        "value": "0.0"
      },
      {
        "kind": "charge_boleto_online_register_cost",
        "value": "0.0"
      }
    ]
  }
}