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