Roteiro de Venda

Roteiro de funcionamento das operações de pagamento de contas

Fluxo de Venda — Pagamento de Contas Bradesco

Sumário

  1. Introdução
  2. Fluxo de Consulta (pré-venda)
  3. Fluxo de Pagamento (venda)
  4. Fluxo de Status (pós-venda)
  5. Pendência / Confirmação
  6. 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)

  1. Montar requisição de consulta de status (varia por tipo de boleto).
  2. Enviar ao Bradesco e interpretar retorno.
  3. 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 SimuladorHTTP Status
01Sucesso200 OK
02Timeout408 Request Timeout
03Código de barras inválido400 Bad Request
04Não autorizado401 Unauthorized
05Erro de pagamento400 Bad Request
06Erro interno500 Internal Server Error
07Falha na pré-condição412 Precondition failed
08Título não encontrado404 Not Found
09Pagamento duplicado409 Conflict
10Título bloqueado403 Forbidden
11Recebimento bloqueado403 Forbidden
12Pagamento não permitido403 Forbidden
13Título protestado409 Conflict
14Data inválida400 Bad Request
15Valor inválido400 Bad Request
16Valor fora do limite400 Bad Request
17CPF/CNPJ inválido400 Bad Request
18Dados informados inconsistentes400 Bad Request