The CDC bank sends notification webhooks to communicate events such as transactions (authorizations, reversals, funds transfers), opening accounts and many other events. You can check the complete list of CDC's webhooks notification events below.
The CDC will send HTTP POST requests to a specified URL endpoint hosted in your environment and configured to receive and process them.
To start using CDC's webhooks, you will need to:
- Expose an endpoint on your server
- Register your endpoint and the events you would like to subscribe
- Process CDC's notifications
Retry Logic
The CDC uses at-least-once delivery to ensure that your application has received a notification. If your application has not acknowledged a message within 7 seconds, we will keep sending the request until it is accepted.
Retry attempts will happen regularly, at increasing time intervals:
- 7 seconds (two times)
- 2 minutes
- 5 minutes
- 15 minutes
- 1 hour
- 3 hours
- Every 12 hours for the following 5 days
Your webhook endpoint might occasionally receive the same notification more than once. You can handle these cases by making your event processing idempotent using the unique code field for every event.
Prepare receive of callback
For every request received by CDC, we will send a HTTP POST requests to a specified URL endpoint hosted in your environment and configured to receive and process them by the webhook in shape of callbacks.
Account Creation
Account Creation
For call of account creation:
{
"return": true,
"message": "account approved",
"data": {
"url": "https//partner/account",
"description": "Account Creator Partner",
"name_event": "Account Creator",
"code_event": 1,
"account": {
"code": "1234567-4544-4564-6544-1231321",
"name": "Diego Nascimento",
"document": "12345678977",
"code_status_user": 7,
"status_user": "approved",
"reason_status_user": ""
},
"banking_data": {
"code": "5555555-4544-4564-6544-1231321",
"created_at": "2023-01-01 12:03",
"bank": "470",
"agency": "0001",
"account": "47000000",
"digit": "1",
"code_status_digital_account": 1,
"status_digital_account": "active"
}
}
}
Possible User Status
Identification Description 1 in_analysis 3 repproved 4 blocked 7 approved 9 blocked_judge 11 automatically approved 12 automatically blocked
TED Movement
TED Movement
For call of receive response TED
{
"return": true,
"description": "TED approved",
"data": {
"url": "https//partner/ted",
"description": "TED Movement Partner",
"name_event": "Ted Movement",
"code_event": "2",
"banking_data": {
"code": "1234567-4544-4564-6544-1231321",
"bank": "470",
"agency": "0001",
"account": "47000000",
"digit": "1",
"code_status_digital_account": 1,
"status_digital_account": "active"
},
"transaction": {
"end_to_end": "1C3CBDBB-5F4D-4831-81D7-12345678910",
"code": "STR0010R2abcd123-1313-1321-ds12-1231231",
"code_transfer_control": 1,
"transfer_control": "sent",
"code_transaction_status": 2,
"transaction_status": "approved",
"description": "TED approved",
"value": 5
}
}
}
User Status Update
User Status Update
For status update callback
{
"return": true,
"message": "Status User",
"data": {
"url": "https//partner/status_user",
"description": "Status User",
"name_event": "Status User",
"code_event": "3",
"created_at": "2024-04-18 09:29:14",
"account": {
"code": "84caed28-2a46-4e58-ad74-12345678910",
"document": "12345678910",
"name": "Teste da Silva",
"code_status_user": "4",
"status_user": "blocked",
"reason_status_user": "blocked by Bacen"
}
}
}
Boleto Payment Receipt
Boleto Payment Receipt
For boleto payment callback
{
"return": true,
"message": "boleto receipt",
"data": {
"url": "https://boleto/receipt/",
"description": "Example Webhook",
"name_event": "Bank Slip",
"code_event": "4",
"created_at": "2025-01-17 12:30:00",
"transaction": {
"code_transaction": "2a135cb6-6195-4002-a5e4-e280f2222222",
"code_transaction_status": "2",
"transaction_status": "approved",
"digitable": "23793381286008301352856000063307789840000150000",
"bar_code": "",
"value": "1500.00",
"interest_value": "0.00",
"fine_value": "0.00",
"total_fine_interest_value": "0.00",
"total_value": "1500.00",
"payment_date": "2025-01-17T12:30:00",
"compensation_date": "2025-01-17T00:00:00",
"cancellation_date": "",
"receipt": "Example receipt"
},
"receiver": {
"account": {
"name": "Recebedor",
"document": "12345678000111"
}
},
"payer": {
"account": {
"name": "Cliente CDC",
"document": "12345678910"
},
"banking_data": {
"code": "3a6515f0-6d7c-422b-9da9-d12e87111111",
"bank": "470",
"agency": "1",
"account": "47000000",
"digit": "0"
}
}
}
}
Boleto Deposit Receipt
Boleto Deposit Receipt
For boleto deposit callback
{
"return": true,
"message": "boleto receipt",
"data": {
"url": "https://boleto/deposit",
"description": "Example Deposit WebHook",
"name_event": "Deposit",
"code_event": "7",
"created_at": "2025-01-17 10:00:08",
"transaction": {
"code_boleto": "2d75923d-b5d4-4c40-8f63-18819eb12345",
"code_transaction": "2d75923d-b5d4-4c40-8f63-18819eb12345",
"code_transaction_status": "2",
"transaction_status": "approved",
"digitable": "23793381286008301352856000063307789840000150000",
"bar_code": "23797898400001500003381260083013525600006330",
"value": 1500.00,
"interest_value": 0,
"fine_value": 0,
"total_fine_interest_value": 0,
"total_value": 1500.00
},
"receiver": {
"account": {
"code": "22656cda-b173-474c-b268-289b35e12345",
"name": "Recebedor",
"document": "12345678910"
},
"banking_data": {
"code": "2cf96c10-adaa-4135-8646-77ce2f412345",
"bank": "470",
"agency": "1",
"account": "47000000",
"digit": "0"
}
},
"payer": {
"account": {
"name": "Pagador da Silva",
"document": "12345678000111"
}
},
"pix": {
"image": "data:image\/png;base64,iVBORw0KGgoAAAANSUhEUg...",
"payload": "MDAwMjAxMDEwMjEyMjY5MjAwMTRici5nb3YuYmN...",
"code_transaction_pix": "49b46a10-8e28-42fc-8788-7a61a10ca109",
"e2e_transaction_pix": "E18236120202603271833s077f7b1234"
}
}
}
Card Account Status Update
Card Account Status Update
For card account status update callback
{
"return": true,
"message": "client approved",
"data": {
"url": "https//partner/card_account_status",
"description": "Card Account Status",
"name_event": "Card Account Status",
"code_event": "5",
"created_at": "2024-05-06 14:43:03",
"card_account": {
"code": "027616f2-5f0a-4353-b560-12345678910",
"name": "Teste da Silva",
"document": "12345678910",
"status_code": "2",
"status": "approved",
"history": "[\"validated_data\"]"
}
}
}
Card Transaction
Card Transaction
For card transaction callback
{
"return": true,
"message": "transaction card approved",
"data": {
"url": "https//partner/card_transaction",
"description": "Card Transaction",
"name_event": "Card Transaction",
"code_event": "6",
"created_at": "2024-05-06 15:24:05",
"transaction_card": {
"code": "f01b31bc-1087-4866-af1c-12345678910",
"end_to_end": "F01B31bc-1087-4866-AF1C-12345678910",
"code_transfer_control": "1",
"transaction_control": "sent",
"code_transaction_status": "2",
"transaction_status": "approved",
"code_transaction_type": "11",
"transaction_type": "DEBIT CARD",
"status": "approved",
"merchant_name": "Mercado TESTE",
"mcc": "5499",
"amount": "6.00",
"spread": "0.00",
"total_amount": "6.00",
"card": {
"code": "0525cd3f-b0ff-46d8-b0c0-12345678910",
"pan_masked": "123456******1234"
},
"user": {
"name": "Teste da Silva",
"document": "12345678910"
}
}
}
}
P2P Movement
P2P Movement
For P2P movement callback
{
"return": true,
"message": "receive P2P transaction",
"data": {
"url": "https//partner/p2p_movement",
"description": "P2P Movement",
"name_event": "P2P Movement",
"code_event": "8",
"created_at": "2024-05-05 06:36:42",
"transaction": {
"code": "8083762b-962f-4988-bcb5-12345678910",
"e2e": "5E069CF5-AA73-4F9F-AB1C-12345678910",
"value": "100.00",
"description": null,
"origin_account": {
"name": "CDC Bank",
"document": "1234567891023",
"banking_data": {
"bank": "470",
"agency": "0001",
"account": "12345679",
"digit": "0",
"type": "CC"
}
},
"receiver_account": {
"name": "Teste da Silva LTDA",
"document": "1234567891024",
"banking_data": {
"bank": "470",
"agency": "1",
"account": "12345678",
"digit": "0",
"type": "CC"
}
}
}
}
}
P2P Batch Movement
P2P Batch Movement
For P2P Batch movement callback
{
"return": true,
"message": "P2P Batch",
"data": {
"url": "https://partner/p2p-batch-movement",
"description": "Example webhook",
"name_event": "Batch",
"code_event": "14",
"created_at": "2025-03-13 14:48:16",
"batch": {
"transaction_type": "P2P",
"code_transaction_type": 4,
"code": "ec7aac31-e75d-45ec-bbe5-d9415f477123",
"description": "test 5 items",
"code_status": "2",
"status": "approved",
"transactions": [
{
"code": "fd6e03be-d676-4169-9793-ae47d5c30123",
"external_code": "fda24dae-8cc3-4a16-bdba-e7075397e123",
"e2e": "EE5BC7D8-7986-4FCC-B4FD-EE94D143AAAA",
"code_transaction_status": 2,
"transaction_status": "approved",
"created_at": "2025-03-13 14:46:32",
"updated_at": "2025-03-13 14:48:05"
},
...
],
"errors": [
{
"external_code": "fda24dae-8cc3-4a16-bdba-e70753912345",
"reason": "insuficient balance",
"created_at": "2025-03-12 10:11:43",
"updated_at": "2025-03-12 10:18:20"
},
...
]
}
}
}
P2P Batch Item Success
P2P Batch Item Success
For when a P2P batch item is successful.
{
"return": true,
"message": "P2P Batch item success",
"data": {
"url": "https://partner/p2p-batch-item-success",
"description": "Batch item success",
"name_event": "Batch Item Success",
"code_event": "16",
"transaction": {
"code": "23840c27-7026-4ff7-863c-b1e430a0d123",
"external_code": "170",
"e2e": "FD7F9E0C-F3EA-491A-BACC-CB2430017123",
"code_transaction_status": 2,
"transaction_status": "approved",
"created_at": "2025-03-12 12:35:42",
"updated_at": "2025-03-12 12:35:49"
}
}
}
P2P Batch Item Error
P2P Batch Item Error
For when a P2P batch item fails.
{
"return": true,
"message": "P2P Batch item error",
"data": {
"url": "https://partner/p2p-batch-item-error",
"description": "Batch item error",
"name_event": "Batch Item Error",
"code_event": "17",
"error": {
"external_code": "76",
"reason": "insuficient balance",
"created_at": "2025-03-12 10:11:43",
"updated_at": "2025-03-12 10:18:20"
}
}
}
Pix Movement
Pix Movement
For Pix movement (cash-in or scheduled cash-out confirmation)
{
"return": true,
"message": "Pix approved",
"data": {
"url": "https//partner/pix",
"description": "Pix movement",
"name_event": "PIX Movement",
"code_event": "10",
"receiver": {
"code": "50c7764c-4703-4ceb-b908-12345678910",
"document": "12345678910",
"name": "Wellington Carvalho da Cunha Filho",
"bank": "CDC SOCIEDADE DE CREDITO",
"agency": "0001",
"account": "47000000",
"digit": "0"
},
"payer": {
"code": "",
"document": "12345678910",
"name": "Wellington Carvalho da Cunha Filho",
"bank": "ANOTHER BANK",
"agency": "0001",
"account": "47000000",
"digit": "0"
},
"transaction": {
"end_to_end": "E00416968202501090255pJMiFHxK1234",
"code": "3d8c57ee-d0bd-4f00-9d1d-12345678910",
"code_transfer_control": "2",
"transfer_control": "received",
"code_transaction_status": "2",
"transaction_status": "approved",
"description": "PIX Approved",
"message": "TRANSFERENCIA PIX ENVIADA",
"value": 10.5
}
}
}
Possible Transactions Status
Code Description 1 In Process 2 Approved 3 Canceled 4 Expired 5 Under Review 6 Pending 7 Sent For Refund 8 Refund Made 9 Paid 10 Created 11 Clearing 12 Consulted 13 Authorized
Pix Claim Key
Pix Claim Key
For pix claim key callback
{
"return": true,
"message": "PIX claim key",
"data": {
"url": "https//partner/pix_claim_key",
"description": "Pix Claim Key",
"name_event": "Pix Claim Key",
"code_event": "11",
"claim_key": {
"code": "3d8c57ee-d0bd-4f00-9d1d-12345678910",
"participation_type": "donor",
"claim_type": "ownership",
"type": "cpf",
"key": "12345678910",
"claim_status": "confirmed",
"claimed": "Y",
"active": "Y",
"created_at": "2024-05-06 23:59:59"
}
}
}
Signature Contract
Signature Contract
For signature contract callback
{
"return": true,
"message": "update status",
"data": {
"url": "https//partner/signature_contract",
"description": "Signature Contract",
"name_event": "Signature Contract",
"code_event": "9",
"created_at": "2024-05-05 06:36:42",
"signature_contract": {
"code": "8083762b-962f-4988-bcb5-12345678910",
"tag": "ABERTURA_DE_CONTA",
"status": "approved",
"validate": "2024-05-06 23:59:59",
"signatories": [
{
"code": "8083762b-962f-4988-bcb4-12345678910",
"document": "12345678910",
"status": "signed"
}
]
}
}
}
Transfer Limit
Transfer Limit
For Transfer Limit callback
{
"return": true,
"message": "transfer limit approved",
"data": {
"url": "https//partner/transfer_limit",
"description": "Transfer limit",
"name_event": "Transfer Limit",
"code_event": "12",
"created_at": "2024-04-11 15:04:25",
"transfer_limit_solicitation": {
"code": "a6fb6a59-9e87-43f6-b545-12345678910",
"turn": "D",
"transaction_type": "PIX",
"code_transactions_type": "1",
"transfer_limit_type": "pj",
"code_transfer_limit_type": "2",
"status": "approved",
"code_status": "2",
"created_at": "2024-04-11 15:01:16",
"old_amount": 3200,
"approve_amount": 5000,
"reason": "approve pix limit",
"account": {
"name": "CDC CARD TECNOLOGIA LTDA",
"document": "12345678910",
"bank": "470",
"agency": "1",
"account": "47000",
"digit": "0"
}
}
}
}
Transfer limit types
Code Description 1 PF 2 PJ 3 Secure Contacts 4 Withdraw 5 Exchange
Biometry
Biometry
Biometry callback
{
"return": true,
"message": "biometry",
"data": {
"url": "https//partner/biometry",
"description": "Biometry",
"name_event": "Biometry",
"code_event": "15",
"created_at": "2025-03-18 15:59:25",
"biometry": {
"code": "6d0742a7-2ec5-4654-81c0-d4a0f2a26331",
"status_liveness": 1,
"status_face_match": 0,
"status_biometry": true,
"score": 50,
"created_at": "2025-03-06 11:21:32",
"updated_at": "2025-03-10 15:09:13",
"account": {
"code": "a6fb6a59-9e87-43f6-b545-12345678910",
"name": "CDC SOCIEDADE DE CRÉDITO",
"document": "12345678910"
},
"banking_data": {
"code": "a6fb6a59-9e87-43f6-b545-12345678910",
"account": "470000000",
"agency": "0001",
"digit": "0",
"bank": "470"
}
}
}
}
Status Liveness
| Identification | Description |
|---|---|
| 0 | off |
| 1 | approved |
| 2 | reproved |
Status Face Match
| Identification | Description |
|---|---|
| 0 | off |
| 1 | approved |
| 2 | reproved |
Status Biometry
| Identification | Description |
|---|---|
| true | Done |
| false | Pending |
Block Balance
Block Balance
Block Balance callback
{
"return": true,
"message": "Block Balance",
"data": {
"url": "https://webhook/block_balance",
"description": "Block balance Account",
"name_event": "Block Balance",
"code_event": "13",
"created_at": "2025-05-22 22:02:13",
"transaction": {
"code": "82114a35-7f10-47a5-bcc0-12345678910",
"value": 0.01,
"description": "block balance",
"origin_account": {
"name": "Client Account Debit",
"document": "12345678910",
"banking_data": {
"bank": "470",
"agency": "0001",
"account": "47000000",
"digit": "0",
"type": "CC"
}
},
"receiver_account": {
"name": "CDC SOCIEDADE DE CREDITO DIRETO SA",
"document": "18394228000179",
"banking_data": {
"bank": "470",
"agency": "",
"account": "",
"digit": "",
"type": ""
}
}
}
}
}
If you receive a block balance credit, receiver account is a client account
Tax Transaction
Tax Transaction
Tax Transaction callback
{
"return": true,
"description": "TAX approved",
"data": {
"url": "https//partner/tax",
"description": "TAX Movement Partner",
"name_event": "TAX Movement",
"code_event": "19",
"banking_data": {
"code": "1234567-4544-4564-6544-1231321",
"bank": "470",
"agency": "0001",
"account": "47000000",
"digit": "1",
"code_status_digital_account": 1,
"status_digital_account": "active"
},
"transaction": {
"end_to_end": "1C3CBDBB-5F4D-4831-81D7-12345678910",
"code": "abcd123-1313-1321-ds12-1231231",
"code_transfer_control": 1,
"transfer_control": "sent",
"code_transaction_status": 2,
"transaction_status": "approved",
"description": "TAX approved",
"value": 8.9
}
}
}
Card Transaction SLC
Card Transaction SLC
22 - Card Transaction SLC callback
{
"return": true,
"description": "transaction card slc approved",
"data": {
"url": "https//partner/card_slc",
"description": "Card SLC Movement Partner",
"name_event": "Card Transaction SLC",
"code_event": "21",
"created_at": "2025-12-01 00:00:00",
"transaction": {
"code": "12345678-1234-1234-1234-12345678910",
"e2e": "202512312312553",
"amount": "10.00",
"spread": "0.00",
"transfer_control": "received",
"code_transfer_control": "2",
"status_transaction": "approved",
"code_status_transaction": "2",
"transaction_type": "CARD SLC",
"code_transaction_type": "17",
"card_network": "Visa",
"card_payment_method": "Credit",
"merchant": {
"code": "1245678890",
"name": "CDC Bank",
"document": "12345678910",
},
"receiver": {
"account": "47000000",
"digit": "0",
"agency": "0001",
"bank": "470",
"type": "CC",
"name": "CDC Bank",
"document": "12345678910"
}
}
}
}