A Safe2Pay envia notificações assíncronas (webhooks) para o endpoint do recebedor sempre que ocorrem mudanças relevantes no ciclo do Pix Automático. Isso permite que sua aplicação reaja automaticamente a eventos de autorização, agendamento e liquidação de cobrança.
Recomendamos fortemente que você leia:
- documentação completa de autorização do Pix automático.
- documentação completa de agendamento de cobrança do Pix automático
- documentação completa sobre Webhooks e Callbacks.
Entender esses pontos evita erros comuns na integração e garante que você aproveite todo o potencial da API com segurança e conformidade.
Eventos de autorização
{
"Id": 194,
"IdMerchant": 370,
"Status": "APROVADA",
"StatusHistory": [
{
"Status": "CRIADA",
"Date": "2025-08-29T20:40:47.77"
},
{
"Status": "APROVADA",
"Date": "2025-08-29T20:42:15.42"
}
],
"Contract": {
"Description": "Teste Mensal",
"Reference": "QA001",
"Customer": {
"Identity": "78497209036",
"Name": "Fulano Vinana",
"Email": "[email protected]",
"Phone": "54999999999",
"Address": {
"ZipCode": "90050101",
"Street": "Logradouro",
"Number": "123",
"Complement": "Complemento",
"District": "Higienopolis",
"StateInitials": "RS",
"CityName": "Porto Alegre",
"CountryName": "BRASIL"
}
}
},
"Calendar": {
"StartDate": "2025-08-30T00:00:00",
"EndDate": "2025-12-26T00:00:00",
"Periodicity": "MENSAL",
"RetryPolicy": "NÃO PERMITE"
},
"Amount": {
"Fixed": 0.1
},
"QrData": {
"PixCopyAndPaste": "00020101021226870014BR.GOV.BCB.PIX2565apipix.bradesco.com.br/qr/v2/122db4a2-810f-4244-9ff7-18fb9e1621d852040000530398654040.105802BR5925SAFE2PAY INSTITUICAO DE P6009SAO PAULO62070503***80870014BR.GOV.BCB.PIX2565apipix.bradesco.com.br/qr/v2/rec/332c1eedef4d4bac9f7a89a21afe3d2c6304A51A",
"QrCode": "https://images.safe2pay-h.com.br/pix/3a2523020f8d4c67ad5f7dcf3521c2b9.png"
}
}{
"Id": 194,
"IdMerchant": 370,
"Status": "CANCELADA",
"StatusHistory": [
{
"Status": "CRIADA",
"Date": "2025-08-29T20:40:47.77"
},
{
"Status": "APROVADA",
"Date": "2025-08-29T20:42:15.42"
},
{
"Status": "CANCELADA",
"Date": "2025-08-30T00:33:51.137"
}
],
"Contract": {
"Description": "Teste Mensal",
"Reference": "QA001",
"Customer": {
"Identity": "78497209036",
"Name": "Fulano Vinana",
"Email": "[email protected]",
"Phone": "54999999999",
"Address": {
"ZipCode": "90050101",
"Street": "Logradouro",
"Number": "123",
"Complement": "Complemento",
"District": "Higienopolis",
"StateInitials": "RS",
"CityName": "Porto Alegre",
"CountryName": "BRASIL"
}
}
},
"Calendar": {
"StartDate": "2025-08-30T00:00:00",
"EndDate": "2025-12-26T00:00:00",
"Periodicity": "MENSAL",
"RetryPolicy": "NÃO PERMITE"
},
"Amount": {
"Fixed": 0.1
},
"QrData": {
"PixCopyAndPaste": "00020101021226870014BR.GOV.BCB.PIX2565apipix.bradesco.com.br/qr/v2/122db4a2-810f-4244-9ff7-18fb9e1621d852040000530398654040.105802BR5925SAFE2PAY INSTITUICAO DE P6009SAO PAULO62070503***80870014BR.GOV.BCB.PIX2565apipix.bradesco.com.br/qr/v2/rec/332c1eedef4d4bac9f7a89a21afe3d2c6304A51A",
"QrCode": "https://images.safe2pay-h.com.br/pix/3a2523020f8d4c67ad5f7dcf3521c2b9.png"
}
}Eventos de agendamento de cobrança
{
"Id": 48,
"Status": "CANCELADA",
"StatusHistory": [
{
"Status": "ATIVA",
"Date": "2025-08-28T08:00:58.08Z"
},
{
"Status": "CANCELADA",
"Date": "2025-08-28T14:02:53.353Z"
}
],
"IdAuthorization": 148,
"Reference": "ABC456",
"Calendar": {
"DueDate": "2025-09-01T00:00:00",
"UsefulDayAdjustment": false
},
"IdTransaction": 5770697,
"Amount": 15.18,
"Splits": [
{
"CodeTaxType": 2,
"IdReceiver": 440,
"Amount": 0.05,
"IsPayTax": true
}
],
"Attemps": [
{
"DueDate": "2025-09-01T00:00:00",
"Status": "CANCELADA",
"StatusHistory": [
{
"Status": "SOLICITADA",
"Date": "2025-08-28T08:00:58.08Z"
},
{
"Status": "CANCELADA",
"Date": "2025-08-28T11:02:53.29Z"
}
]
}
]
}{
"Id": 37,
"Status": "CONCLUIDA",
"StatusHistory": [
{
"Status": "ATIVA",
"Date": "2025-08-26T11:46:25.667Z"
},
{
"Status": "CONCLUIDA",
"Date": "2025-08-30T11:19:08.027Z"
}
],
"IdAuthorization": 72,
"Reference": "ABC456",
"Calendar": {
"DueDate": "2025-08-30T00:00:00",
"UsefulDayAdjustment": false
},
"IdTransaction": 5770605,
"Amount": 0.05,
"Splits": [],
"Attemps": [
{
"DueDate": "2025-08-30T00:00:00",
"Status": "PAGA",
"StatusHistory": [
{
"Status": "SOLICITADA",
"Date": "2025-08-26T11:46:25.667Z"
},
{
"Status": "AGENDADA",
"Date": "2025-08-26T17:49:38.493Z"
},
{
"Status": "PAGA",
"Date": "2025-08-30T11:19:08.327Z"
}
]
}
]
}