Descrição #
Serviço de notificações para os clientes do banco Semear das movimentações financeiras e abertura de contas descritos nessa documentação.
Essas notificações serão enviadas através de uma requisição HTTP POST para o WebHook do cliente informado para o banco Semear no momento do Onboarding.
Estrutura da Notificação #
EXEMPLOS DE TIPO: #
CREDITO_INTERNO | Pix Cashin com sucesso (origem de uma chave interna) |
CREDITO_EXTERNO | Pix Cashin com sucesso (origem de uma chave externa) |
DEBITO_INTERNO | Pix Cashout com sucesso (destino para uma chave interna) |
DEBITO_EXTERNO | Pix Cashout com sucesso (destino para uma chave externa) |
CREDITO_EXTERNO_CANCELADO | Pix Cashin não efetuado (origem de uma chave externa) |
CREDITO_INTERNO_CANCELADO | Pix Cashin não efetuado (origem de uma chave interna) |
DEBITO_INTERNO_CANCELADO | Pix Cashout não efetuado (destino para uma chave interna) |
CREDITO_DEVOLUCAO | Devolução PIX recebida com sucesso |
DEBITO_DEVOLUCAO | Devolução PIX enviada com sucesso |
CREDITO_DEVOLUCAO_CANCELADO | Devolução pix a receber não efetuada |
DEBITO_DEVOLUCAO_CANCELADO | Devolução PIX enviada não efetuada |
PIX – CASH-IN #
“Type”: “MOVIMENTO”,
“tipo”: “CREDITO_INTERNO” ou “CREDITO_EXTERNO”,
“naturezaMovimento”: “C”,
{
"ClientId": "9c7f1e43-90cf-400f-b9e9-9297b2608b60",
"WebhookUri": "https://webhook.site/baas-notification",
"Type": "MOVIMENTO",
"Message": {
"NotificationType": "MOVIMENTO",
"CpfCnpj": "01111111111",
"Message": {
"parte": {
"codIspb": "00795423",
"codAgencia": "0001",
"digitoAgencia": "9",
"nroConta": "0011011111",
"tipoConta": "CACC",
"cpfCnpj": "01111111111",
"nome": "ANTERO ROBERTO SILVA"
},
"contraparte": {
"codIspb": "00795423",
"codAgencia": "0001",
"digitoAgencia": "9",
"nroConta": "0111111112",
"tipoConta": "CACC",
"cpfCnpj": "11111101012",
"nome": "CHARLIE PARKER NÃO MEXER NESSA MASS"
},
"endToEnd": "E00795423202411141734OMEY3pO88s4",
"txId": null,
"tipo": "CREDITO_INTERNO",
"valor": 6,
"reasons": null,
"dataHoraMovimento": "2024-11-14T14:34:23.8480434",
"endToEndOriginal": null,
"chave": "01111111111",
"nroMovimento": "900681360",
"origemMovimento": "CHAVE",
"naturezaMovimento": "C",
"indDevolucao": "false",
"campoLivre": "Teste em homologação Webhook",
"codOperacao": "01027",
"infoDevolucao": null,
"infoErro": null,
"campoExtra": null,
"ehAgendado": false,
"idIdempotente": "0e9b7e50-38c7-4c29-b3bd-1d15077b5c0e",
"canalEntrada": "APP_CD",
"idDevolucao": null,
"cnpjIniciadoraPagamento": null,
"dataNotificacaoAutbank": "2024-11-14T14:34:24.8590306-03:00"
}
},
"Retry": 0
}
PIX – CASH-OUT #
“Type”: “MOVIMENTO”,
“tipo”: “DEBITO_INTERNO” ou “DEBITO_EXTERNO”,
“naturezaMovimento”: “D”,
{
"ClientId": "9c7f1e43-90cf-400f-b9e9-9297b2608b60",
"WebhookUri": "https://webhook.site/baas-notification",
"Type": "MOVIMENTO",
"Message": {
"NotificationType": "MOVIMENTO",
"CpfCnpj": "11111111111",
"Message": {
"parte": {
"codIspb": "00795423",
"codAgencia": "0001",
"digitoAgencia": "9",
"nroConta": "0110111111",
"tipoConta": "CACC",
"cpfCnpj": "11111101012",
"nome": "CHARLIE PARKER NÃO MEXER NESSA MASS"
},
"contraparte": {
"codIspb": "00795423",
"codAgencia": "0001",
"digitoAgencia": "9",
"nroConta": "0011011111",
"tipoConta": "CACC",
"cpfCnpj": "01111111111",
"nome": "ANTERO ROBERTO SILVA"
},
"endToEnd": "E00795423202411141734OMEY3pO88s4",
"txId": null,
"tipo": "DEBITO_INTERNO",
"valor": 6,
"reasons": null,
"dataHoraMovimento": "2024-11-14T14:34:23.8480434",
"endToEndOriginal": null,
"chave": "01381794688",
"nroMovimento": "900681359",
"origemMovimento": "CHAVE",
"naturezaMovimento": "D",
"indDevolucao": "false",
"campoLivre": "Teste em homologação Webhook",
"codOperacao": "01031",
"infoDevolucao": null,
"infoErro": null,
"campoExtra": null,
"ehAgendado": false,
"idIdempotente": "0e9b7e50-38c7-4c29-b3bd-1d15077b5c0e",
"canalEntrada": "APP_CD",
"idDevolucao": null,
"cnpjIniciadoraPagamento": null,
"dataNotificacaoAutbank": "2024-11-14T14:34:26.0644948-03:00"
}
},
"Retry": 0
}
EXCLUSÃO DE CHAVE PIX #
“Type”: “DIRETORIO”,
“Status”: “EXCLUDED”
{
"ClientId": "9c7f1e43-90cf-400f-b9e9-9297b2608b60",
"WebhookUri": "https://webhook.site/baas-notification",
"Type": "DIRETORIO",
"Message": {
"NotificationType": "DIRETORIO",
"CpfCnpj": "11111111111",
"Message": {
"Key": "11111111111",
"KeyType": "CPF",
"Account": {
"Participant": "00795423",
"Branch": "0001",
"AccountNumber": "0110378387",
"AccountType": "CACC",
"OpeningDate": "2024-11-14T14:54:53.223Z"
},
"Owner": {
"Type": "NATURAL_PERSON",
"TaxIdNumber": "11111111111",
"Name": "CHARLIE PARKER NÃO MEXER NESSA MASS",
"TradeName": null
},
"CreationDate": "2024-11-14T14:54:54.593Z",
"KeyOwnershipDate": "2023-09-01T15:33:59.98Z",
"Status": "EXCLUDED"
}
},
"Retry": 0
}
CRIAÇÃO DE CHAVE PIX #
“Type”: “DIRETORIO”,
“Status”: “CREATED”
{
"ClientId": "9c7f1e43-90cf-400f-b9e9-9297b2608b60",
"WebhookUri": "https://webhook.site/baas-notification",
"Type": "DIRETORIO",
"Message": {
"NotificationType": "DIRETORIO",
"CpfCnpj": "11111111111",
"Message": {
"Key": "11111111111",
"KeyType": "CPF",
"Account": {
"Participant": "00795423",
"Branch": "0001",
"AccountNumber": "0110378387",
"AccountType": "CACC",
"OpeningDate": "2024-11-14T17:43:07.02Z"
},
"Owner": {
"Type": "NATURAL_PERSON",
"TaxIdNumber": "11111111111",
"Name": "CHARLIE PARKER NÃO MEXER NESSA MASS",
"TradeName": null
},
"CreationDate": "2024-11-14T17:43:07.667Z",
"KeyOwnershipDate": "2023-09-01T15:33:59.98Z",
"Status": "CREATED"
}
},
"Retry": 0
}
REIVINDICAÇÃO E PORTABILIDADE DE CHAVE PIX #
DE INSTITUIÇÃO BANCÁRIA EXTERNA PARA O BANCO SEMEAR #
REIVINDICAÇÃO
{
"cpfCnpj": "06847046686",
"tipoNotificacao": "REIVINDICACAO",
"mensagem": {
"isDonorPerson": true,
"type": "REIVINDICACAO",
"key": "+5531987036400",
"keyType": "PHONE",
"donorAccount": {
"participant": "00795423",
"branch": "0001",
"accountNumber": "0011014393",
"accountType": "CACC",
"openingDate": "2019-10-28T00:00:00.000Z"
},
"donor": {
"type": "NATURAL_PERSON",
"taxIdNumber": "06847046686",
"name": "ANSELMO LIMA LIMA"
},
"participant": "18236120",
"donorParticipant": "00795423",
"id": "04fd64d5-61cb-4dd2-a717-c3de9ef4d045",
"status": "OPEN",
"resolutionPeriodEnd": "2024-11-25T15:24:00.000Z",
"lastModified": "2024-11-18T15:23:36.507Z"
}
}
AGUARDANDO SOLUÇÃO
{
"ClientId": "b26976bc-c90f-4460-87ce-ac1bfb5f4780",
"WebhookUri": "https://webhook.site/Campos-Corporation",
"Type": "REIVINDICACAO",
"Message": {
"NotificationType": "REIVINDICACAO",
"CpfCnpj": "11106831012",
"Message": {
"IsDonorPerson": true,
"IsClaimerPerson": false,
"Type": "REIVINDICACAO",
"Key": "11106831012",
"KeyType": "CPF",
"ClaimerAccount": null,
"Claimer": null,
"DonorAccount": {
"Participant": "00795423",
"Branch": "0001",
"AccountNumber": "0110381311",
"AccountType": "CACC",
"OpeningDate": "2024-11-18T19:46:51.827Z"
},
"Donor": {
"Type": "NATURAL_PERSON",
"TaxIdNumber": "11106831012",
"Name": "Rafael Seixas QA",
"TradeName": null
},
"Participant": "14388334",
"DonorParticipant": "00795423",
"Id": "7e1bdd9b-3821-4586-a632-7160738b46ec",
"Status": "WAITING_RESOLUTION",
"CompletionPeriodEnd": "0001-01-01T00:00:00",
"ResolutionPeriodEnd": "2024-11-25T20:20:00Z",
"LastModified": "2024-11-18T20:21:01.397Z",
"ConfirmReason": null,
"CancelReason": null,
"CancelledBy": null
}
},
"Retry": 0
}
PORTABILIDADE NEGADA/CANCELADA
{
"ClientId": "b26976bc-c90f-4460-87ce-ac1bfb5f4780",
"WebhookUri": "https://webhook.site/Campos-Corporation",
"Type": "PORTABILITY",
"Message": {
"NotificationType": "PORTABILITY",
"CpfCnpj": "11106831012",
"Message": {
"IsDonorPerson": true,
"IsClaimerPerson": false,
"Type": "PORTABILITY",
"Key": "11106831012",
"KeyType": "CPF",
"ClaimerAccount": null,
"Claimer": null,
"DonorAccount": {
"Participant": "00795423",
"Branch": "0001",
"AccountNumber": "0110381311",
"AccountType": "CACC",
"OpeningDate": "2024-11-18T19:46:51.827Z"
},
"Donor": {
"Type": "NATURAL_PERSON",
"TaxIdNumber": "11106831012",
"Name": "Rafael Seixas QA",
"TradeName": null
},
"Participant": "14388334",
"DonorParticipant": "00795423",
"Id": "7e1bdd9b-3821-4586-a632-7160738b46ec",
"Status": "CANCELLED",
"CompletionPeriodEnd": "0001-01-01T00:00:00",
"ResolutionPeriodEnd": "2024-11-25T20:20:00Z",
"LastModified": "2024-11-19T14:04:26.437Z",
"ConfirmReason": null,
"CancelReason": "USER_REQUESTED",
"CancelledBy": "DONOR"
}
},
"Retry": 0
}
PORTABILIDADE CONCLUÍDA/SUCESSO
{
"cpfCnpj": "01111111111",
"tipoNotificacao": "PORTABILITY",
"mensagem": {
"isDonorPerson": true,
"type": "PORTABILITY",
"key": "+5531987036400",
"keyType": "PHONE",
"donorAccount": {
"participant": "00795423",
"branch": "0001",
"accountNumber": "0011014393",
"accountType": "CACC",
"openingDate": "2019-10-28T00:00:00.000Z"
},
"donor": {
"type": "NATURAL_PERSON",
"taxIdNumber": "01111111111",
"name": "ANSELMO LIMA LIMA"
},
"participant": "18236120",
"donorParticipant": "00795423",
"id": "6b4e7903-c178-4213-9e98-7abbe4ed6553",
"status": "COMPLETED",
"resolutionPeriodEnd": "2024-11-25T15:32:00.000Z",
"lastModified": "2024-11-18T15:33:50.530Z",
"confirmReason": "USER_REQUESTED"
}
}
DO BANCO SEMEAR PARA UMA INSTITUIÇÃO BANCÁRIA EXTERNA #
REIVINDICAÇÃO
{
"cpfCnpj": "01111111111",
"tipoNotificacao": "REIVINDICACAO",
"mensagem": {
"isClaimerPerson": true,
"type": "REIVINDICACAO",
"key": "+5531987036400",
"keyType": "PHONE",
"claimerAccount": {
"participant": "00795423",
"branch": "0001",
"accountNumber": "0011014393",
"accountType": "CACC",
"openingDate": "2019-10-28T00:00:00.000Z"
},
"claimer": {
"type": "NATURAL_PERSON",
"taxIdNumber": "06847046686",
"name": "ANSELMO LIMA LIMA"
},
"participant": "00795423",
"donorParticipant": "18236120",
"id": "b16d71ca-1888-4c34-bb9f-37c1fa7fe47e",
"status": "OPEN",
"resolutionPeriodEnd": "2024-11-25T15:10:40.163Z",
"lastModified": "2024-11-18T15:10:40.163Z"
}
}
PORTABILIDADE NEGADA/CANCELADA
{
"cpfCnpj": "01111111111",
"tipoNotificacao": "PORTABILITY",
"mensagem": {
"isClaimerPerson": true,
"type": "PORTABILITY",
"key": "+5531987036400",
"keyType": "PHONE",
"claimerAccount": {
"participant": "00795423",
"branch": "0001",
"accountNumber": "0011014393",
"accountType": "CACC",
"openingDate": "2019-10-28T00:00:00.000Z"
},
"claimer": {
"type": "NATURAL_PERSON",
"taxIdNumber": "01111111111",
"name": "ANSELMO LIMA LIMA"
},
"participant": "00795423",
"donorParticipant": "18236120",
"id": "b16d71ca-1888-4c34-bb9f-37c1fa7fe47e",
"status": "CANCELLED",
"resolutionPeriodEnd": "2024-11-25T15:10:40.163Z",
"lastModified": "2024-11-18T15:11:00.420Z",
"cancelReason": "USER_REQUESTED",
"cancelledBy": "DONOR"
}
}
PORTABILIDADE CONCLUÍDA/SUCESSO
{
"cpfCnpj": "01111111111",
"tipoNotificacao": "PORTABILITY",
"mensagem": {
"isClaimerPerson": true,
"type": "PORTABILITY",
"key": "+5531987036400",
"keyType": "PHONE",
"claimerAccount": {
"participant": "00795423",
"branch": "0001",
"accountNumber": "0011014393",
"accountType": "CACC",
"openingDate": "2019-10-28T00:00:00.000Z"
},
"claimer": {
"type": "NATURAL_PERSON",
"taxIdNumber": "01111111111",
"name": "ANSELMO LIMA LIMA"
},
"participant": "00795423",
"donorParticipant": "18236120",
"id": "6ef00772-f0ca-4779-a869-07738c7f9a9c",
"status": "COMPLETED",
"resolutionPeriodEnd": "2024-11-25T15:16:47.437Z",
"lastModified": "2024-11-18T15:19:03.137Z",
"confirmReason": "USER_REQUESTED"
}
}
ABERTURA DE CONTA PF #
SUCESSO #
{
"ClientId": "9c7f1e43-90cf-400f-b9e9-9297b2608b60",
"WebhookUri": "https://webhook.site/baas-notification",
"Type": "ABERTURA DE CONTA PF",
"Message": {
"Document": "24092546084",
"AccountNumber": "1023243565",
"TempPassword": "123212",
"Message": "Conta aberta com sucesso.",
"Code": 20100
}
}
ERRO #
{
"ClientId": "9c7f1e43-90cf-400f-b9e9-9297b2608b60",
"WebhookUri": "https://webhook.site/baas-notification",
"Type": "ABERTURA DE CONTA PF",
"Message": {
"Document": "24092546084",
"Code": 42201,
"Message": "Falha para abrir a conta para o documento: 24092546084"
},
"Retry": 0
}
ABERTURA DE CONTA PJ #
SUCESSO #
{
"ClientId": "9c7f1e43-90cf-400f-b9e9-9297b2608b60",
"WebhookUri": "https://webhook.site/baas-notification",
"Type": "ABERTURA DE CONTA PJ",
"Message": {
"Document": "24092546084",
"Cnpj": "56465187000153"
"AccountNumber": "1023243565",
"TempPassword": "123212",
"Message": "Conta aberta com sucesso.",
"Code": 20100
}
}
ERRO #
{
"ClientId": "9c7f1e43-90cf-400f-b9e9-9297b2608b60",
"WebhookUri": "https://webhook.site/baas-notification",
"Type": "ABERTURA DE CONTA PJ",
"Message": {
"Document": "24092546084",
"Cnpj": "56465187000153"
"Code": 42201,
"Message": "Falha para abrir a conta para o documento: 24092546084"
},
"Retry": 0
}
Bloqueio de saldo #
IDENTIFICADORES DOS CAMPOS: #
CODAGENCIA | Código da agência da conta |
NROCONTA | Número da conta |
VALORBLOQ | Valor bloqueio |
DATABLOQUEIO | Data do bloqueio |
IDBLOQUEIO | Chave única bloqueio |
TIPO | Bloqueado – Desbloqueado – Efetivado |
TIPO–>BLOQUEADO | Fica bloqueado saldo em conta até efetivar ou desbloquear |
TIPO–>DESBLOQUEADO | Se não for encontrado recurso para o bloqueio |
TIPO–>EFETIVADO | Se for encontrado recurso para efetuar o bloqueio |
NOTIFICAÇÃO DE BLOQUEIO #
{
"CODAGENCIA": "Codigo da Agencia",
"NROCONTA": "identificador da conta de pagamento",
"VALORBLOQ": "valor bloqueado",
"DATABLOQUEIO": "Data do bloqueio",
"IDBLOQUEIO": "Chave unica Bloqueio",
"TIPO": "Bloqueado - Desbloqueado - Efetivado"
}
Status da conta #
IDENTIFICADORES DOS CAMPOS: #
CODAGENCIA | Código da agência da conta |
NROCONTA | Número da conta |
VALORBLOQ | Valor bloqueado em conta (em caso de bloqueios judiciais ou administrativos será informado valor total aqui) |
DATABERTURA | Data da abertura da conta |
CPFCGC | CPF/CNPJ Titular da conta |
SITUCACONTA_ATUAL | Situação atual da conta |
SITUCACONTA_ANT | Situação Anterior da conta |
LIMITE | Limite adicional para conta (Cheque Especial) |
SALDODISPONIVEL | Saldo Disponível para movimentação |
Situações possíveis
- Ativa: conta ativa
- Inativa: após 60 dias sem movimentação a mesma passa a inativa
- Paralisada: após 180 dias sem movimentação a mesma passa a inativa
- Bloqueada: conta bloqueada para movimentação
- Encerrada: conta encerrada
NOTIFICAÇÃO STATUS DA CONTA #
{
"CODAGENCIA": "Codigo da Agencia",
"NROCONTA": "identificador da conta de pagamento",
"CPFCGC": "CPF/CNPJ Titular da conta",
"DATABERTURA": "Data da abertura da conta",
"SITUCACONTA_ATUAL": "Situação atual da conta",
"SITUCACONTA_ANT": "Situação Anterior da conta"
"VALORBLOQ": "Valor Bloqueado em conta( em caso de bloqueios judiciais ou administrativos sera informado valor total aqui)"
"LIMITE": "Limite adicional para conta ( Cheque Especial)"
"SALDODISPONIVEL": "Saldo Disponivel para movimentação"
}