Roteiro de funcionamento das operações de pagamento de contas
Fluxo de Venda — Pagamento de Contas Bradesco
Sumário
- Introdução
- Fluxo de Consulta (pré-venda)
- Fluxo de Pagamento (venda)
- Fluxo de Status (pós-venda)
- Pendência / Confirmação
- Tabela para cenários de erros (simulador)
Introdução
Esta documentação descreve o fluxo de venda (pagamento) da integração Bradesco no módulo payments, dentro do contexto de Pagamento de Contas / WhiteLabel.
Fluxo de Consulta (pré-venda)
Endpoint: https://sandbox.cardway.com.br/pagamentos/consulta-dados/{estabelecimento}/{codbarras}\/{valor}
Exemplo de request params: https://sandbox.cardway.com.br/pagamentos/consulta-dados/81AA1C20B1688E4C7424C4E000334DD4/34195133500000006101095059448685863055173000/3000
Exemplo de Response:
{
"payload": {
"workspaceId": "1191874",
"barCode": "34195133500000006101095059448685863055173000",
"reduction": 0.0,
"discount": 0.0,
"fees": 0.0,
"fine": 0.0,
"originalValue": 6.1,
"totalUpdated": 6.1,
"minValue": 0.0,
"maxValue": 6.1,
"dueDate": "23/01/2026",
"allowsPartialPayment": false,
"recipient": "MOVILWAY MG LTDA",
"recipientDocument": "10620535083",
"payer": "HOST",
"payerDocument": "20509296000188",
"finalPayer": "HOST",
"bank": 341,
"bankName": "ITAU UNIBANCO S.A.",
"typeOfCharge": "BOLETO OU TITULO",
"uri": "/pagamentos/boleto/pagar"
}
}Fluxo de Pagamento (venda)
Exemplos:
Endpoint para pagamento tributo/convenio: https://sandbox.cardway.com.br/pagamentos/tributo/pagar
Exemplo de body request:
{
"estabelecimento": "81AA1C20B1688E4C7424C4E000334DD4",
"idExterno": "pgto-contas-white-02",
"dataHoraCliente": "2026-01-23T16:30:00",
"valor": "3000",
"codigoBarras": "84890000000392701622026012015076649204711188",
"cpfCnpj": "20509296000188"
}Endpoint para pagamento boleto: https://sandbox.cardway.com.br/pagamentos/boleto/pagar
Exemplo de body request:
{
"estabelecimento": "81AA1C20B1688E4C7424C4E000334DD4",
"idExterno": "pgto-contas-white-04",
"dataHoraCliente": "2026-01-23T16:30:00",
"valor": "3000",
"codigoBarras": "34195133500000006101095059448685863055173000",
"cpfCnpj": "20509296000188"
}Fluxo de Status (pós-venda)
Objetivo
Consultar o status de uma transação para confirmar resultado final ou acompanhar pagamentos pendentes.
Passo a passo (visão de processo)
- Montar requisição de consulta de status (varia por tipo de boleto).
- Enviar ao Bradesco e interpretar retorno.
- Padronizar status para o modelo interno.
Exemplo de Endpoint para consulta status tributo: https://sandbox.cardway.com.br/pagamentos/consulta-status/81AA1C20B1688E4C7424C4E000334DD4/84890000000392701622026012015076649204711188/000000129
Exemplo de Endpoint para consulta status boleto: https://sandbox.cardway.com.br/pagamentos/consulta-status/81AA1C20B1688E4C7424C4E000334DD4/34195133500000006101095059448685863055173000/000000129
Tabela para cenários de erros (simulador)
| Centavos (valor) | Resultado do Simulador | HTTP Status |
|---|---|---|
| 01 | Sucesso | 200 OK |
| 02 | Timeout | 408 Request Timeout |
| 03 | Código de barras inválido | 400 Bad Request |
| 04 | Não autorizado | 401 Unauthorized |
| 05 | Erro de pagamento | 400 Bad Request |
| 06 | Erro interno | 500 Internal Server Error |
| 07 | Falha na pré-condição | 412 Precondition failed |
| 08 | Título não encontrado | 404 Not Found |
| 09 | Pagamento duplicado | 409 Conflict |
| 10 | Título bloqueado | 403 Forbidden |
| 11 | Recebimento bloqueado | 403 Forbidden |
| 12 | Pagamento não permitido | 403 Forbidden |
| 13 | Título protestado | 409 Conflict |
| 14 | Data inválida | 400 Bad Request |
| 15 | Valor inválido | 400 Bad Request |
| 16 | Valor fora do limite | 400 Bad Request |
| 17 | CPF/CNPJ inválido | 400 Bad Request |
| 18 | Dados informados inconsistentes | 400 Bad Request |
