Webhooks

Your account can be configured so that when certain events occur on your account, a HTTP POST request containing JSON data pertaining to that event is sent to one or more URLs of your choosing. These URLs can be configured inside your settings making a request to our team. Notifications of all events listed below are sent to all the configured URLs.

Types of webhooks

Type	Description
PAYMENT	When you send a pix payment.
PAYMENT FAILED	When you send a pix payment and it fails.
DEVOLUTION	When you send a pix devolution.
DEVOLUTION FAILED	When you send a pix devolution and it fails.
DEVOLUTION RECEIVED	When receive a pix devolution.
DEPOSIT	When receive a pix deposit.

Credentials (Not required)

Type	Description
Authorization Basic	base64<username:password>
Authorization Bearer	API key or token.
Signature Verification	Shared secret key.
Custom header	Header name is not previous defined , using with api key or token.
mTLS	TLS certificate.

Payloads (Version 1)

Payment

{
  "id":"4b344f93-68fb-4ddc-83b4-6288eb7c63ce",
  "type":"PAYMENT",
  "end_to_end_id":"E26264220202404171729SrlHOwU3HqB",
  "txid":null,
  "operation_id":"0f0aca83-8ea1-5ecb-9fe9-d31782ef06fb",
  "amount":"270",
  "owner_name":"Zro Bolsao",
  "owner_person_type":"CNPJ",
  "owner_document":"00000000000000",
  "beneficiary_name":"Name",
  "beneficiary_person_type":"CPF",
  "beneficiary_document":"***000000**",
  "beneficiary_bank_name":"ZRO IP S/A",
  "beneficiary_bank_ispb":"26264220",
  "created_at":"2024-04-17T17:30:00.020Z"
}

Payment Failed

{
  "id":"77198133-185e-4c08-8252-f47c9b15785b",
  "type":"PAYMENT",
  "end_to_end_id":"E26264220202404171336mckyTdpt5VZ",
  "txid":null,
  "operation_id":null,
  "amount":"3",
  "owner_name":"Zro Bolsao",
  "owner_person_type":"CNPJ",
  "owner_document":"00000000000000",
  "beneficiary_name":"Name",
  "beneficiary_person_type":"CPF",
  "beneficiary_document":"***000000**",
  "beneficiary_bank_name":"ZRO IP S/A",
  "beneficiary_bank_ispb":"26264220",
  "error_code":"NOT_ENOUGH_FUNDS",
  "error_description":"Não há saldo disponível.",
  "created_at":"2024-04-17T13:36:21.188Z"
}

Devolution

{
  "id":"0a1d863e-98bd-49a3-916d-840a1ec0609f",
  "type":"DEVOLUTION",
  "end_to_end_id":"D26264220202404171733p6FuxQmuCKp",
  "operation_id":"fbfe1a0f-011f-5edb-a01d-19e669a6d853",
  "amount":"270",
  "owner_name":"Name",
  "owner_document":"***000000**",
  "owner_bank_ispb":"26264220",
  "owner_bank_name":"ZRO IP S/A",
  "beneficiary_name":"Zro Bolsao",
  "beneficiary_document":"00000000000000",
  "beneficiary_bank_name":"ZRO IP S/A",
  "beneficiary_bank_ispb":"26264220",
  "created_at":"2024-04-17T17:33:05.523Z"
}

Devolution Failed

{
  "id":"0a1d863e-98bd-49a3-916d-840a1ec0609f",
  "type":"DEVOLUTION",
  "end_to_end_id":"D26264220202404171733p6FuxQmuCKp",
  "operation_id": null,
  "amount":"270",
  "owner_name":"Name",
  "owner_document":"***000000**",
  "owner_bank_ispb":"26264220",
  "owner_bank_name":"ZRO IP S/A",
  "beneficiary_name":"Zro Bolsao",
  "beneficiary_document":"00000000000000",
  "beneficiary_bank_name":"ZRO IP S/A",
  "beneficiary_bank_ispb":"26264220",
  "error_code":"AB03",
  "error_description":"Liquidação da transação interrompida devido a timeout no SPI.",
  "created_at":"2024-04-17T17:33:05.523Z"
}

Devolution Received

{
  "id":"10b66e97-c747-4dcb-92ad-da1420a0a6b9",
  "type":"DEVOLUTION_RECEIVED",
  "end_to_end_id":"D26264220202404171733p6FuxQmuCKp",
  "txid":null,
  "operation_id":"fbfe1a0f-011f-5edb-a01d-19e669a6d853",
  "original_id":"4b344f93-68fb-4ddc-83b4-6288eb7c63ce",
  "original_end_to_end_id":"E26264220202404171729SrlHOwU3HqB",
  "amount":"270",
  "owner_name":"Name",
  "owner_document":"***000000**",
  "owner_bank_name":"ZRO IP S/A",
  "owner_bank_ispb":"26264220",
  "beneficiary_name":"Zro Bolsao",
  "beneficiary_document":"00000000000000",
  "beneficiary_bank_name":"ZRO IP S/A",
  "beneficiary_bank_ispb":"26264220",
  "created_at":"2024-04-17T17:33:05.712Z"
}

Deposit

{
  "id":"a839f358-0e39-409e-b9a5-5a56b18ba3f2",
  "type":"DEPOSIT",
  "end_to_end_id":"E26264220202404171333Hq7F9SWyvUE",
  "txid":null,
  "operation_id":"7da84c17-d40c-5bc1-9b69-867d1460736b",
  "amount":"63",
  "owner_name":"Zro Bolsao",
  "owner_document":"00000000000",
  "owner_bank_name":"ZRO IP S/A",
  "owner_bank_ispb":"26264220",
  "beneficiary_name":"Name",
  "beneficiary_account_number":"000000",
  "beneficiary_document":"***000000**",
  "beneficiary_bank_name":"ZRO IP S/A",
  "beneficiary_bank_ispb":"26264220",
  "created_at":"2024-04-17T13:33:41.071Z"
}

Payloads (Version 2)

Devolution Received

{
   "id":"10b66e97-c747-4dcb-92ad-da1420a0a6b9",
   "type":"DEVOLUTION_RECEIVED",
   "end_to_end_id":"D26264220202404171733p6FuxQmuCKp",
   "txid":null,
   "operation_id":"fbfe1a0f-011f-5edb-a01d-19e669a6d853",
   "original_id":"4b344f93-68fb-4ddc-83b4-6288eb7c63ce",
   "original_end_to_end_id":"E26264220202404171729SrlHOwU3HqB",
   "amount":"270",
   "owner_name":"Name",
   "owner_document":"***000000**",
   "owner_bank_name":"ZRO IP S/A",
   "owner_bank_ispb":"26264220",
   "beneficiary_name":"Name",
   "beneficiary_account_number":"000000",
   "beneficiary_branch_number":"0000",
   "beneficiary_document":"***000000**",
   "beneficiary_bank_name":"ZRO IP S/A",
   "beneficiary_bank_ispb":"26264220",
   "created_at":"2024-04-17T17:33:05.712Z"
}

Deposit

{
   "id":"a839f358-0e39-409e-b9a5-5a56b18ba3f2",
   "type":"DEPOSIT",
   "end_to_end_id":"E26264220202404171333Hq7F9SWyvUE",
   "txid":null,
   "operation_id":"7da84c17-d40c-5bc1-9b69-867d1460736b",
   "amount":"63",
   "owner_name":"Zro Bolsao",
   "owner_document":"00000000000",
   "owner_bank_name":"ZRO IP S/A",
   "owner_bank_ispb":"26264220",
   "beneficiary_name":"Name",
   "beneficiary_account_number":"000000",
   "beneficiary_branch_number":"0000",
   "beneficiary_document":"***000000**",
   "beneficiary_bank_name":"ZRO IP S/A",
   "beneficiary_bank_ispb":"26264220",
   "created_at":"2024-04-17T13:33:41.071Z"
}